核心用法
Chief Feature Workflow 是一套完整的AI驱动开发流程，核心围绕 chief CLI 工具展开：
1. PRD创建：运行 chief new <prd-name> 进入交互式模式，Claude Code 以PRD-writer角色提问澄清需求，最终生成 .chief/prds/<name>/prd.{md,json}
2. 隔离开发环境：使用 git worktree 创建独立工作目录和特性分支，避免污染主工作区
3. 自动化实现：两种方式执行
- 推荐：子代理模式：生成子代理自动运行
chief <prd-name>，输入s启动循环，代理自动处理bash授权提示、轮询进度至100%、提交并开PR - 手动模式：直接在TUI中按
s启动，逐故事执行测试验证与自动提交
4. 交付闭环：自动提交 progress.md，推送分支，通过 gh pr create 创建PR
显著优点
- 结构化AI协作：将模糊需求转化为标准化PRD（用户故事格式），降低沟通成本
- 原子化交付：每个用户故事独立提交，可追溯、可回滚
- 并行开发：支持2-3个并发子代理，加速多特性并行推进
- 自动化程度高：从需求澄清到PR创建的全链路自动化，减少人工介入
- 安全隔离：worktree机制确保实验性开发不影响主分支
局限与风险
- 成本敏感：底层调用Claude Code，多并行运行易触达API限流，单任务成本较高
- TUI交互脆弱：依赖特定按键序列（
s启动、1/2授权、hex0d处理卡住），自动化需精确模拟 - 验证依赖项目配置：依赖项目内置的
make test、pnpm typecheck等命令，若配置缺失则验证失败 - JSON格式敏感：
prd.json若结构异常会导致Chief解析失败 - gitignore陷阱：
prd.json默认被忽略，团队需明确文档化哪些文件需提交
适合人群
- 采用Git工作流的中大型团队，需要标准化AI辅助开发流程
- 维护多特性并行开发的Tech Lead或高级开发者
- 已熟悉Claude Code和终端TUI操作的工程师
常规风险
- 授权疲劳：频繁的bash授权提示若处理不当会导致流程中断
- 状态丢失：强制删除worktree或未提交的progress可能导致进度丢失
- 分支管理：feat/* 分支命名冲突、清理遗漏造成远程分支堆积