/forge：工作流总入口

Description

--- name: forge description: 'Forge 工作流总入口。检查项目状态，推荐下一步该用哪个 skill。任何时候不知道下一步该干什么，就用 /forge。触发方式：用户说"forge"、"下一步"、"接下来做什么"、"继续"（在没有明确上下文时）。' --- # /forge：工作流总入口 不知道下一步该干什么？打 `/forge`。 全程中文。 --- ## 执行流程 ### 第1步：检测项目状态 ```bash _ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd) echo "项目根目录: $_ROOT" # 检测文档状态 echo "--- 文档状态 ---" ls "$_ROOT"/brainstorm-*.md 2>/dev/null && echo "[BRAINSTORM] 发现思考文档（根目录）" ls "$_ROOT"/docs/brainstorm-*.md 2>/dev/null && echo "[BRAINSTORM] 发现思考文档（docs/）" [ -f "$_ROOT/docs/PRD.md" ] && echo "[PRD] 发现 PRD" && grep -m1 "^## v" "$_ROOT/docs/PRD.md" 2>/dev/null [ -f "$_ROOT/docs/DESIGN.md" ] && echo "[DESIGN] 发现 DESIGN.md" [ -f "$_ROOT/docs/ENGINEERING.md" ] && echo "[ENGINEERING] 发现 ENGINEERING.md" [ -f "$_ROOT/docs/QA.md" ] && echo "[QA] 发现 QA.md" # 检测代码状态 echo "--- 代码状态 ---" git status --short 2>/dev/null | head -10 git log --oneline -3 2>/dev/null # 检测 Worktree echo "--- Worktree ---" git worktree list 2>/dev/null # 检测分支 echo "--- 分支 ---" git branch --show-current 2>/dev/null ``` ### 第2步：状态判断 + 推荐 根据检测结果，按以下决策树判断： ``` 无任何文档 + 用户没有明确任务 → "看起来是一个新开始。建议先跑 /forge-brainstorm 理清思路。" 有思考文档，无 PRD → "发现思考文档 [{文件名}]。建议下一步： A) /forge-prd — 将思考转化为正式 PRD B) /forge-dev — 跳过 PRD，直接进轻量开发模式 C) /forge-brainstorm — 继续讨论，还没想清楚" 有 PRD，无 DESIGN.md（且项目含前端） → "PRD 就绪（{版本号}），但还没有设计文档。建议： A) /forge-dev — 启动开发调度（会自动触发设计） B) /forge-design — 单独做设计规划" 有 PRD + DESIGN.md，无 ENGINEERING.md → "设计已就绪。建议： A) /forge-dev — 启动开发调度 B) /forge-eng — 单独做工程实现" 有 ENGINEERING.md，代码有改动未测试 → "代码已改动。建议： A) /forge-qa — 验收测试 B) /forge-eng — 继续工程实现" 代码改动已测试，在 feature 分支上 → "看起来可以收尾了。建议： A) /forge-review — PR 审查 B) /forge-ship — 发布 C) /forge-fupan — 先复盘再发布" 在 Worktree 中 → "当前在 Worktree [{分支名}] 中。建议： A) 继续当前工作（列出未完成任务） B) /forge-eng — 继续工程实现 C) 收尾 Worktree — merge/PR/keep/discard" 主分支，一切就绪 → "项目状态良好。你想做什么？ A) /forge-brainstorm — 讨论新想法 B) /forge-prd — 迭代现有需求 C) /forge-bugfix — 修个 bug D) /forge-fupan — 复盘最近的工作" ``` ### 第3步：AskUserQuestion 基于判断，通过 AskUserQuestion 展示推荐： ``` 当前项目状态： {项目名} | {分支} | {文档状态摘要} 推荐下一步：【{推荐的 skill}】— {理由} 选项： A) {推荐选项}（推荐） B) {备选1} C) {备选2} D) 其他 — 告诉我你想做什么 ``` ### 第4步：执行 用户选择后： - 如果选择了某个 forge-* skill → 提示用户调用对应 skill（如"请运行 /forge-brainstorm"） - 如果选择"其他" → 听用户描述，重新判断 --- ## Forge 体系完整 Skill 清单 供参考，当用户问"有哪些工具"时展示： | Skill | 用途 | 何时使用 | |-------|------|---------| | `/forge-brainstorm` | 头脑风暴 | 有想法要讨论时 | | `/forge-prd` | PRD 管理 | 需要正式需求文档时 | | `/forge-dev` | 开发调度 | 从需求到交付的完整流程 | | `/forge-design` | 设计规划 | 需要 UI/UX 设计时 | | `/forge-design-impl` | 设计实现 | 将设计文档转为代码 | | `/forge-eng` | 工程实现 | 写代码（含 TDD + Worktree） | | `/forge-qa` | QA 验收 | 测试+报告（不修代码） | | `/forge-bugfix` | Bug 修复 | 系统性调试和修复 | | `/forge-review` | PR 审查 | 上线前代码审查 | | `/forge-ship` | 发布 | 合并+推送+创建 PR | | `/forge-deliver` | 端到端交付 | 全自动从需求到发布 | | `/forge-fupan` | 复盘 | 知识沉淀和方法论迭代 | | `/forge-status` | 并行会话巡检 | 扫 `.forge/active.md`，按硬信号清理僵尸 | --- ## 重要规则 1. **不做具体工作** — forge 只做状态检测和推荐，不写代码、不改文档 2. **快速** — 整个流程应该在 10 秒内完成（跑脚本 + 判断 + 展示） 3. **不强制** — 推荐不是命令，用户可以选"其他"做任何事 4. **每个 forge-* skill 也有出口建议** — 完成后会推荐下一步，形成链式引导

Security Status