{"id":"f4167ca1-b00e-4ca2-a45e-55906d067e23","shortId":"zh8tDz","kind":"skill","title":"forge","tagline":"Forge 工作流总入口。检查项目状态，推荐下一步该用哪个 skill。任何时候不知道下一步该干什么，就用 /forge。触发方式：用户说\"forge\"、\"下一步\"、\"接下来做什么\"、\"继续\"（在没有明确上下文时）。","description":"# /forge：工作流总入口\n\n不知道下一步该干什么？打 `/forge`。\n\n全程中文。\n\n---\n\n## 执行流程\n\n### 第1步：检测项目状态\n\n```bash\n_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)\necho \"项目根目录: $_ROOT\"\n\n# 检测文档状态\necho \"--- 文档状态 ---\"\nls \"$_ROOT\"/brainstorm-*.md 2>/dev/null && echo \"[BRAINSTORM] 发现思考文档（根目录）\"\nls \"$_ROOT\"/docs/brainstorm-*.md 2>/dev/null && echo \"[BRAINSTORM] 发现思考文档（docs/）\"\n[ -f \"$_ROOT/docs/PRD.md\" ] && echo \"[PRD] 发现 PRD\" && grep -m1 \"^## v\" \"$_ROOT/docs/PRD.md\" 2>/dev/null\n[ -f \"$_ROOT/docs/DESIGN.md\" ] && echo \"[DESIGN] 发现 DESIGN.md\"\n[ -f \"$_ROOT/docs/ENGINEERING.md\" ] && echo \"[ENGINEERING] 发现 ENGINEERING.md\"\n[ -f \"$_ROOT/docs/QA.md\" ] && echo \"[QA] 发现 QA.md\"\n\n# 检测代码状态\necho \"--- 代码状态 ---\"\ngit status --short 2>/dev/null | head -10\ngit log --oneline -3 2>/dev/null\n\n# 检测 Worktree\necho \"--- Worktree ---\"\ngit worktree list 2>/dev/null\n\n# 只读检测 Dev Server（如项目提供统一入口）\necho \"--- Dev Server ---\"\nif [ -f \"$_ROOT/package.json\" ] && (cd \"$_ROOT\" && npm run 2>/dev/null | grep -q \"dev:status\"); then\n  (cd \"$_ROOT\" && npm run dev:status 2>/dev/null) || true\nelif [ -x \"$_ROOT/scripts/dev-stack.sh\" ]; then\n  (cd \"$_ROOT\" && bash scripts/dev-stack.sh status 2>/dev/null) || true\nelse\n  echo \"未发现统一 dev server 状态入口\"\nfi\n\n# 检测分支\necho \"--- 分支 ---\"\ngit branch --show-current 2>/dev/null\n```\n\n### 第2步：状态判断 + 推荐\n\n根据检测结果，按以下决策树判断：\n\n```\n无任何文档 + 用户没有明确任务\n  → \"看起来是一个新开始。建议先跑 /forge-brainstorm 理清思路。\"\n\n有思考文档，无 PRD\n  → \"发现思考文档 [{文件名}]。建议下一步：\n     A) /forge-prd — 将思考转化为正式 PRD\n     B) /forge-dev — 跳过 PRD，直接进轻量开发模式\n     C) /forge-brainstorm — 继续讨论，还没想清楚\"\n\n有 PRD，无 DESIGN.md（且项目含前端）\n  → \"PRD 就绪（{版本号}），但还没有设计文档。建议：\n     A) /forge-dev — 启动开发调度（会自动触发设计）\n     B) /forge-design — 单独做设计规划\"\n\n有 PRD + DESIGN.md，无 ENGINEERING.md\n  → \"设计已就绪。建议：\n     A) /forge-dev — 启动开发调度\n     B) /forge-eng — 单独做工程实现\"\n\n有 ENGINEERING.md，代码有改动未测试\n  → \"代码已改动。建议：\n     A) /forge-qa — 验收测试\n     B) /forge-eng — 继续工程实现\"\n\n代码改动已测试，在 feature 分支上\n  → \"看起来可以收尾了。建议：\n     A) /forge-review — PR 审查\n     B) /forge-ship — 发布\n     C) /forge-fupan — 先复盘再发布\"\n\n在 Worktree 中\n  → \"当前在 Worktree [{分支名}] 中。建议：\n     A) 继续当前工作（列出未完成任务）\n     B) /forge-eng — 继续工程实现\n     C) 收尾 Worktree — merge/PR/keep/discard\"\n\n主分支，一切就绪\n  → \"项目状态良好。你想做什么？\n     A) /forge-brainstorm — 讨论新想法\n     B) /forge-prd — 迭代现有需求\n     C) /forge-bugfix — 修个 bug\n     D) /forge-fupan — 复盘最近的工作\"\n```\n\n### 第3步：AskUserQuestion\n\n基于判断，通过 AskUserQuestion 展示推荐：\n\n```\n当前项目状态：\n  {项目名} | {分支} | {文档状态摘要}\n\n推荐下一步：【{推荐的 skill}】— {理由}\n\n选项：\nA) {推荐选项}（推荐）\nB) {备选1}\nC) {备选2}\nD) 其他 — 告诉我你想做什么\n```\n\n### 第4步：执行\n\n用户选择后：\n- 如果选择了某个 forge-* skill → 提示用户调用对应 skill（如\"请运行 /forge-brainstorm\"）\n- 如果选择\"其他\" → 听用户描述，重新判断\n\n---\n\n## Forge 体系完整 Skill 清单\n\n供参考，当用户问\"有哪些工具\"时展示：\n\n| Skill | 用途 | 何时使用 |\n|-------|------|---------|\n| `/forge-brainstorm` | 头脑风暴 | 有想法要讨论时 |\n| `/forge-prd` | PRD 管理 | 需要正式需求文档时 |\n| `/forge-dev` | 开发调度 | 从需求到交付的完整流程 |\n| `/forge-design` | 设计规划 | 需要 UI/UX 设计时 |\n| `/forge-design-impl` | 设计实现 | 将设计文档转为代码 |\n| `/forge-eng` | 工程实现 | 写代码（含 TDD + Worktree） |\n| `/forge-qa` | QA 验收 | 测试+报告（不修代码） |\n| `/forge-bugfix` | Bug 修复 | 系统性调试和修复 |\n| `/forge-review` | PR 审查 | 上线前代码审查 |\n| `/forge-ship` | 发布 | 合并+推送+创建 PR |\n| `/forge-deliver` | 端到端交付 | 全自动从需求到发布 |\n| `/forge-fupan` | 复盘 | 本地 Workbench 学习确认 + 知识沉淀 |\n| `/forge-status` | 并行会话巡检 | 扫 `.forge/active.md`，按硬信号清理僵尸 |\n\n---\n\n## 重要规则\n\n1. **不做具体工作** — forge 只做状态检测和推荐，不写代码、不改文档\n2. **快速** — 整个流程应该在 10 秒内完成（跑脚本 + 判断 + 展示）\n3. **不强制** — 推荐不是命令，用户可以选\"其他\"做任何事\n4. **每个 forge-* skill 也有出口建议** — 完成后会推荐下一步，形成链式引导\n5. **视觉决策提示** — 如果当前任务涉及前端设计、人类判断或复盘学习图，推荐链路中优先提示对应 skill 使用 `skills/_shared/visual-decision-layer.md`，但 /forge 本身不生成图片","tags":["forge","skills","yike-gunshi","agent-skills","ai-development","claude-code","skill-md","skillsmp"],"capabilities":["skill","source-yike-gunshi","skill-forge-skills","topic-agent-skills","topic-ai-development","topic-claude-code","topic-forge","topic-skill-md","topic-skillsmp"],"categories":["forge-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/yike-gunshi/forge-skills","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add yike-gunshi/forge-skills","source_repo":"https://github.com/yike-gunshi/forge-skills","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 11 github stars · SKILL.md body (3,533 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-25T19:02:43.948Z","embedding":null,"createdAt":"2026-04-24T07:03:37.668Z","updatedAt":"2026-04-25T19:02:43.948Z","lastSeenAt":"2026-04-25T19:02:43.948Z","tsv":"'-10':103 '-3':107 '/brainstorm-':46 '/dev/null':36,49,59,75,101,109,118,134,147,159,177 '/docs/brainstorm-':56 '/forge':9,17,21,446 '/forge-brainstorm':187,205,288,335,351 '/forge-bugfix':294,381 '/forge-deliver':395 '/forge-design':223,361 '/forge-design-impl':366 '/forge-dev':200,219,233,358 '/forge-eng':236,247,277,369 '/forge-fupan':263,298,398 '/forge-prd':196,291,354 '/forge-qa':244,375 '/forge-review':256,385 '/forge-ship':260,389 '/forge-status':404 '1':410 '10':419 '2':35,48,58,74,100,108,117,133,146,158,176,416 '3':424 '4':430 '5':437 'askuserquest':301,304 'b':199,222,235,246,259,276,290,318 'bash':26,155 'brainstorm':51,61 'branch':172 'bug':296,382 'c':204,262,279,293,320 'cd':129,140,153 'current':175 'd':297,322 'design':79 'design.md':81,211,227 'dev':120,124,137,144,164 'doc':63 'echo':38,42,50,60,66,78,84,90,95,112,123,162,169 'elif':149 'els':161 'engin':85 'engineering.md':87,229,239 'f':64,76,82,88,127 'featur':251 'fi':167 'forg':1,2,12,329,340,412,432 'forge/active.md':407 'git':28,97,104,114,171 'grep':70,135 'head':102 'list':116 'log':105 'ls':44,54 'm1':71 'md':47,57 'merge/pr/keep/discard':282 'npm':131,142 'onelin':106 'pars':31 'pr':257,386,394 'prd':67,69,191,198,202,209,213,226,355 'pwd':37 'q':136 'qa':91,376 'qa.md':93 'rev':30 'rev-pars':29 'root':27,40,45,55,130,141,154 'root/docs/design.md':77 'root/docs/engineering.md':83 'root/docs/prd.md':65,73 'root/docs/qa.md':89 'root/package.json':128 'root/scripts/dev-stack.sh':151 'run':132,143 'scripts/dev-stack.sh':156 'server':121,125,165 'short':99 'show':33,174 'show-curr':173 'show-toplevel':32 'skill':6,312,330,332,342,348,433,442 'skill-forge-skills' 'skills/_shared/visual-decision-layer.md':444 'source-yike-gunshi' 'status':98,138,145,157 'tdd':373 'topic-agent-skills' 'topic-ai-development' 'topic-claude-code' 'topic-forge' 'topic-skill-md' 'topic-skillsmp' 'toplevel':34 'true':148,160 'ui/ux':364 'v':72 'workbench':401 'worktre':111,113,115,266,269,281,374 'x':150 '一切就绪':284 '上线前代码审查':388 '下一步':13 '不修代码':380 '不做具体工作':411 '不写代码':414 '不强制':425 '不改文档':415 '不知道下一步该干什么':19 '且项目含前端':212 '中':267,271 '主分支':283 '也有出口建议':434 '人类判断或复盘学习图':440 '从需求到交付的完整流程':360 '代码已改动':241 '代码改动已测试':249 '代码有改动未测试':240 '代码状态':96 '任何时候不知道下一步该干什么':7 '会自动触发设计':221 '但':445 '但还没有设计文档':216 '体系完整':341 '何时使用':350 '你想做什么':286 '使用':443 '供参考':344 '修个':295 '修复':383 '做任何事':429 '先复盘再发布':264 '全程中文':22 '全自动从需求到发布':397 '其他':323,337,428 '写代码':371 '分支':170,308 '分支上':252 '分支名':270 '列出未完成任务':275 '创建':393 '判断':422 '单独做工程实现':237 '单独做设计规划':224 '发布':261,390 '发现':68,80,86,92 '发现思考文档':52,62,192 '只做状态检测和推荐':413 '只读检测':119 '合并':391 '含':372 '听用户描述':338 '启动开发调度':220,234 '告诉我你想做什么':324 '在':250,265 '在没有明确上下文时':16 '基于判断':302 '备选1':319 '备选2':321 '复盘':399 '复盘最近的工作':299 '头脑风暴':352 '如':333 '如果当前任务涉及前端设计':439 '如果选择':336 '如果选择了某个':328 '如项目提供统一入口':122 '学习确认':402 '完成后会推荐下一步':435 '审查':258,387 '将思考转化为正式':197 '将设计文档转为代码':368 '就用':8 '就绪':214 '展示':423 '展示推荐':305 '工作流总入口':3,18 '工程实现':370 '并行会话巡检':405 '建议':217,231,242,254,272 '建议下一步':194 '建议先跑':186 '开发调度':359 '当前在':268 '当前项目状态':306 '当用户问':345 '形成链式引导':436 '快速':417 '打':20 '执行':326 '执行流程':23 '扫':406 '报告':379 '按以下决策树判断':182 '按硬信号清理僵尸':408 '接下来做什么':14 '推荐':180,317 '推荐下一步':310 '推荐下一步该用哪个':5 '推荐不是命令':426 '推荐的':311 '推荐选项':316 '推荐链路中优先提示对应':441 '推送':392 '提示用户调用对应':331 '收尾':280 '整个流程应该在':418 '文件名':193 '文档状态':43 '文档状态摘要':309 '无':190,210,228 '无任何文档':183 '时展示':347 '有':208,225,238 '有哪些工具':346 '有思考文档':189 '有想法要讨论时':353 '未发现统一':163 '本地':400 '本身不生成图片':447 '根据检测结果':181 '根目录':53 '检查项目状态':4 '检测':110 '检测代码状态':94 '检测分支':168 '检测文档状态':41 '检测项目状态':25 '每个':431 '测试':378 '清单':343 '版本号':215 '状态入口':166 '状态判断':179 '理清思路':188 '理由':313 '用户可以选':427 '用户没有明确任务':184 '用户说':11 '用户选择后':327 '用途':349 '直接进轻量开发模式':203 '看起来可以收尾了':253 '看起来是一个新开始':185 '知识沉淀':403 '秒内完成':420 '端到端交付':396 '第1步':24 '第2步':178 '第3步':300 '第4步':325 '管理':356 '系统性调试和修复':384 '继续':15 '继续工程实现':248,278 '继续当前工作':274 '继续讨论':206 '视觉决策提示':438 '触发方式':10 '讨论新想法':289 '设计实现':367 '设计已就绪':230 '设计时':365 '设计规划':362 '请运行':334 '跑脚本':421 '跳过':201 '还没想清楚':207 '迭代现有需求':292 '选项':314 '通过':303 '重新判断':339 '重要规则':409 '需要':363 '需要正式需求文档时':357 '项目名':307 '项目根目录':39 '项目状态良好':285 '验收':377 '验收测试':245","prices":[{"id":"375831ad-b483-4bb5-a5d3-20c628535084","listingId":"f4167ca1-b00e-4ca2-a45e-55906d067e23","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"yike-gunshi","category":"forge-skills","install_from":"skills.sh"},"createdAt":"2026-04-24T07:03:37.668Z"}],"sources":[{"listingId":"f4167ca1-b00e-4ca2-a45e-55906d067e23","source":"github","sourceId":"yike-gunshi/forge-skills","sourceUrl":"https://github.com/yike-gunshi/forge-skills","isPrimary":false,"firstSeenAt":"2026-04-24T07:03:37.668Z","lastSeenAt":"2026-04-25T19:02:43.948Z"}],"details":{"listingId":"f4167ca1-b00e-4ca2-a45e-55906d067e23","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"yike-gunshi","slug":"forge-skills","github":{"repo":"yike-gunshi/forge-skills","stars":11,"topics":["agent-skills","ai-development","claude-code","forge","skill-md","skillsmp"],"license":"mit","html_url":"https://github.com/yike-gunshi/forge-skills","pushed_at":"2026-04-25T10:22:48Z","description":"Forge — 文档驱动的 AI 辅助开发框架 | Document-driven AI development framework with 14 Skills covering brainstorm → PRD → design → engineering → QA → review → ship → retrospective","skill_md_sha":"fb90154bea1336a907906283dd79a57eed77e287","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/yike-gunshi/forge-skills"},"layout":"root","source":"github","category":"forge-skills","frontmatter":{"name":"forge","description":"Forge 工作流总入口。检查项目状态，推荐下一步该用哪个 skill。任何时候不知道下一步该干什么，就用 /forge。触发方式：用户说\"forge\"、\"下一步\"、\"接下来做什么\"、\"继续\"（在没有明确上下文时）。"},"skills_sh_url":"https://skills.sh/yike-gunshi/forge-skills"},"updatedAt":"2026-04-25T19:02:43.948Z"}}