首席功能工作流

Chief 是一个由 AI 驱动的开发闭环：读取 prd.json，逐条实现用户故事（通过 Claude Code），每次实现后提交变更，并持续追踪进度。

完整工作流

1. 克隆 / 验证仓库

确认项目已本地克隆。

2. 创建新的 PRD

在项目根目录下以交互方式运行：

cd 
chief new 

Chief 将以 PRD-writer 模式启动 Claude Code。它会提出若干澄清性问题，并为每个问题提供带字母编号的选项。请提供：

• 完整的功能描述 / 规格说明
• 对澄清性问题的回答（例如："1A, 2C, 3D"）

当 Chief 提问 "Do you want to create prd.md?" 时，请批准（选择选项 1 或 2）。

Chief 在收到 /exit 命令后，将 prd.md 转换为 prd.json。请留意以下成功提示：

✓ PRD converted successfully

生成的文件位于：.chief/prds//prd.md 和 prd.json

3. 创建 worktree + 分支

git worktree add ../- -b feat/
mkdir -p ../-/.chief/prds/
cp .chief/prds//prd.{md,json} ../-/.chief/prds//

4. 提交 PRD

cd ../-
git add .chief/prds//prd.md
git commit -m "docs: add  PRD"

仅提交 prd.md —— prd.json 通常被 Git 忽略（存在于 .gitignore 中）。

5. 委派给子代理（推荐用于长时间运行）

不建议手动运行 Chief 并轮询状态；可启动一个子代理，全自动完成整个实现流程：

启动一个子代理，执行如下任务：
- 工作目录：~/-
- 运行 `chief `，并设置 pty:true
- 按 `s` 键启动循环
- 对 Bash 提示符输入 `1` + Enter（或 `2` 表示始终允许）
- 若卡在某个提示符上，发送十六进制字符 `0d`（即 Enter 键）
- 持续轮询，直至所有用户故事均显示 ✓（完成率 100%）
- 提交 progress.md、推送代码、创建 PR
- 完成后播报 PR URL

子代理完全隔离运行，并在完成后自动播报结果。你可以**并行启动多个子代理**——每个 PRD / worktree 对应一个子代理——从而支持并发功能开发。

并行运行建议：2–3 个并发子代理是实际使用的最佳平衡点。每个 Chief 实例均为 API 密集型（底层调用 Claude Code），超过 3 个并发实例易触发 API 速率限制，并显著增加费用。

5b. 手动运行 Chief（替代方案）

若你倾向直接监督执行过程：

chief 

在 TUI 界面中按 s 键启动。Chief 将按优先级顺序依次处理各用户故事，运行验证（如 make test、pnpm typecheck 等），每项通过的故事单独提交，并更新 progress.md。

可通过 PTY 会话中的 process(action=poll) 监控执行状态。留意日志中出现 **US-00X is complete** 的提示。

6. 提交进度并推送

git add .chief/prds//progress.md
git commit -m "docs: add  progress"
git push -u origin feat/

7. 创建 PR

gh pr create 
  --title "feat: " 
  --body "Implements the  PRD. See .chief/prds//prd.md for spec." 
  --base main

8. 清理 worktree

PR 合并后执行：

cd 
git worktree remove ../-
git branch -d feat/

若目录中存在未提交的更改，请使用 git worktree remove --force 强制移除。

使用技巧

• TUI 中的 Bash 提示符：输入 1（是）或 2（是，始终允许）
• 若卡在权限提示符上，可通过 process(send-keys) 发送 hex: ["0d"]（即 Enter 键）
• 若某用户故事失败，Chief 将自动重试，或在 progress.md 中记录失败详情
• prd.json 通常被 gitignore，仅需提交 prd.md 和 progress.md
• Chief 支持断点续跑：重启后将自动从最后一个已完成的用户故事继续执行

参考文档

CLI 命令、TUI 键盘快捷键及官方链接详见 references/chief-commands.md。

关于 Chief

Chief 是由 minicodemonkey 开发的开源 AI 驱动开发闭环工具。

• 官网：https://chiefloop.com/
• GitHub：https://github.com/minicodemonkey/chief