91 行
3.2 KiB
Markdown
91 行
3.2 KiB
Markdown
# Playbook: New Project From Scaffold
|
||
|
||
## Purpose
|
||
为全新项目提供一条从 `Setup -> Research -> Spec -> Code -> Alignment` 的标准启动路径，先固化规则，再进入实现。
|
||
|
||
## When to Use
|
||
- 绿地项目
|
||
- 现有目录几乎为空，需要从标准脚手架和规范开始
|
||
- 团队希望统一技术轨道、模型路由和阶段产物
|
||
|
||
## Inputs
|
||
- 项目目标
|
||
- 原始会议纪要
|
||
- 初始目录
|
||
- 目标交付范围
|
||
|
||
## Outputs
|
||
- `CLAUDE.md`
|
||
- `.ralphy/config.yaml`
|
||
- `.research/*.md`
|
||
- `SPECS/*.md`
|
||
- 第一轮实施计划与任务清单
|
||
|
||
## Primary Agent/Model
|
||
主控/计划 agent + `GPT-5.4 Pro xhigh`
|
||
|
||
## Secondary Agent/Model
|
||
研究/审查 agent + `Claude Opus 4.6`
|
||
|
||
## Required Skills
|
||
- `ralphy-initializing`
|
||
- `spec-tasking`
|
||
- `spec-reviewing`
|
||
- `tdd-planning`
|
||
- `tdd-implementing`
|
||
|
||
## Steps
|
||
1. 跑 `Setup`，清洗会议、固定技术轨道、生成 `CLAUDE.md`。
|
||
2. 跑 `Research`，对照参考仓库生成主题化研究报告。
|
||
3. 跑 `Spec`，形成 `SPECS/*.md` 并完成人工审核。
|
||
4. 跑 `Code`，用 TDD 和检查点重构实施第一轮代码。
|
||
5. 跑 `Alignment`，补齐遗漏和偏离。
|
||
|
||
## Exit Criteria
|
||
- 项目已形成可复用的规范层和可执行实施层
|
||
- 新成员可从 `CLAUDE.md`、`SPECS/*.md` 和 `TODO.yaml` 直接接手
|
||
|
||
## Failure Recovery
|
||
- 如果参考仓库质量不足，先补 Research，不要提前写 Spec
|
||
- 如果 Spec 审核不过，禁止进入 Code
|
||
|
||
## Related Templates
|
||
- [`../templates/claude-md-template.md`](../templates/claude-md-template.md)
|
||
- [`../templates/analysis-template.md`](../templates/analysis-template.md)
|
||
- [`../templates/spec-template.md`](../templates/spec-template.md)
|
||
- [`../templates/todo-yaml-template.md`](../templates/todo-yaml-template.md)
|
||
|
||
## Stable Knowledge Vs Runtime Context
|
||
- 稳定知识：技术栈白名单、阶段流程、模板、handoff 契约
|
||
- 运行时上下文：当前项目目标、当前会议决策、当前参考仓库结论
|
||
|
||
## First-Round Prompt Kit
|
||
|
||
### Prompt 1: Setup
|
||
```text
|
||
基于当前项目会议纪要和目录，按知识库的 Setup 流程生成项目初始化产物。固定技术轨道，只保留一个主路径；输出清洗后的会议要点、CLAUDE.md 草案、.ralphy/config.yaml 草案，以及进入 Research 的 handoff。
|
||
```
|
||
|
||
### Prompt 2: Research
|
||
```text
|
||
基于 CLAUDE.md、已选技术轨道和 .references/ 参考仓库，生成 ANALYSIS.md 和 TODO.yaml，并按主题产出 .research/*.md。只保留与当前项目目标相关的方案比较、推荐做法和拒绝理由。
|
||
```
|
||
|
||
### Prompt 3: Spec
|
||
```text
|
||
基于 .research/*.md 和业务目标，生成 SPECS/*.md。先生成 ANALYSIS.md 与 TODO.yaml，再产出 Spec；完成后执行 spec-reviewing，并整理出等待人工审核的问题清单。
|
||
```
|
||
|
||
## Stage Deliverables
|
||
- Setup：`.meetings/`, `.ralphy/config.yaml`, `CLAUDE.md`
|
||
- Research：`ANALYSIS.md`, `TODO.yaml`, `.research/*.md`
|
||
- Spec：`SPECS/*.md`, 审查结论, 人工审核结论
|
||
- Code：`.plans/*.md`, 代码与测试
|
||
- Alignment：缺口分析、补齐实现、重构检查点结果
|
||
|
||
## Acceptance Checklist
|
||
- 技术轨道只有一个主路线
|
||
- `CLAUDE.md` 已固定规则与禁用项
|
||
- `SPECS/*.md` 已通过人工审核
|
||
- 第一轮代码实施与 Alignment 已经形成闭环
|