forge

Category: Tools & Productivity | Uploader: yike-gunshi | Downloads: 0 | Version: v1.0（Latest）

Forge 工作流总入口。检查项目状态，推荐下一步该用哪个 skill。任何时候不知道下一步该干什么，就用 /forge。触发方式：用户说"forge"、"下一步"、"接下来做什么"、"继续"（在没有明确上下文时）。

Changelog: Source: GitHub https://github.com/yike-gunshi/forge-skills

Directory Structure

Current level: tree/main/

📁 _archive/
- 📁 复盘/
  - 📄 2026-03-22-文档驱动开发Skill生态构建.md 19.5 KB
- 📄 CHANGELOG.md 8.3 KB
- 📄 document-driven-dev-guide-original.md 15.5 KB
- 📄 PRD.md 10.0 KB
- 📄 README-v1.md 2.5 KB
- 📄 使用手册.md 19.0 KB
- 📄 多会话并行规范.md 10.7 KB
📁 assets/
- 📄 forge-architecture.svg 5.3 KB
- 📄 forge-deliver-comparison.svg 5.3 KB
- 📄 forge-deliver-v2-flow.svg 5.0 KB
- 📄 forge-design-gating.svg 3.1 KB
- 📄 forge-eng-internals.svg 6.5 KB
- 📄 forge-workflow.svg 6.4 KB
- 📄 v1-architecture-whiteboard.png 182.1 KB
- 📄 v1-workflow-whiteboard.png 171.3 KB
📁 docs/
- 📄 architecture.md 11.3 KB
- 📄 design-skill-audit-report.md 10.5 KB
- 📄 design-skill-fusion-methodology.md 11.5 KB
- 📄 external-tools-analysis.md 15.7 KB
- 📄 forge-deliver-analysis.md 4.3 KB
- 📄 forge-qa-v3-research.md 22.5 KB
- 📄 forge-user-guide.md 22.8 KB
- 📄 glossary.md 3.5 KB
- 📄 openspec-research.md 9.2 KB
- 📄 skills-reference.md 14.4 KB
- 📄 superpowers-comparison.md 4.5 KB
- 📄 workflow-guide.md 5.9 KB
📁 skills/
- 📁 forge-brainstorm/
  - 📄 SKILL.md 15.4 KB
- 📁 forge-bugfix/
  - 📁 docs/
    
    📄 README.md 5.0 KB
  - 📄 SKILL.md 18.0 KB
- 📁 forge-deliver/
  - 📄 README.md 6.6 KB
  - 📄 SKILL.md 18.4 KB
- 📁 forge-design/
  - 📁 data/
    
    📄 charts.csv 18.9 KB
    
    📄 colors.csv 31.7 KB
    
    📄 landing.csv 16.3 KB
    
    📄 products.csv 56.6 KB
    
    📄 styles.csv 139.3 KB
    
    📄 typography.csv 48.5 KB
    
    📄 ui-reasoning.csv 51.8 KB
    
    📄 ux-guidelines.csv 18.3 KB
  - 📁 references/
    
    📄 design-template.md 5.2 KB
  - 📁 scripts/
    
    📄 core.py 11.2 KB
    
    📄 design_system.py 42.6 KB
    
    📄 search.py 5.4 KB
  - 📄 SKILL.md 27.4 KB
- 📁 forge-design-impl/
  - 📄 SKILL.md 5.9 KB
- 📁 forge-dev/
  - 📄 SKILL.md 25.8 KB
- 📁 forge-doc-release/
  - 📄 SKILL.md 12.3 KB
- 📁 forge-eng/
  - 📁 references/
    
    📄 engineering-template.md 6.6 KB
    
    📄 tdd-guide.md 5.6 KB
    
    📄 verification-checklist.md 4.9 KB
    
    📄 worktree-guide.md 4.9 KB
  - 📄 SKILL.md 24.2 KB
- 📁 forge-fupan/
  - 📄 SKILL.md 15.2 KB
- 📁 forge-prd/
  - 📁 references/
    
    📄 feature-spec-template.md 4.1 KB
    
    📄 prd-template.md 3.6 KB
    
    📄 project-claude-md-template.md 4.4 KB
  - 📄 SKILL.md 23.9 KB
- 📁 forge-qa/
  - 📁 docs/
    
    📄 README.md 14.1 KB
  - 📁 references/
    
    📄 qa-template.md 6.1 KB
    
    📄 test-dimensions.md 62.6 KB
  - 📁 scripts/
    
    📄 qa-runner.mjs 32.5 KB
  - 📄 SKILL.md 45.9 KB
- 📁 forge-review/
  - 📄 SKILL.md 6.5 KB
- 📁 forge-ship/
  - 📄 SKILL.md 5.8 KB
📄 .gitignore 29 B
📄 install.sh 1.5 KB
📄 LICENSE 1.0 KB
📄 README.md 14.1 KB
📄 SKILL.md 4.8 KB

SKILL.md

---
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` | 复盘 | 知识沉淀和方法论迭代 |

---

## 重要规则

1. **不做具体工作** — forge 只做状态检测和推荐，不写代码、不改文档
2. **快速** — 整个流程应该在 10 秒内完成（跑脚本 + 判断 + 展示）
3. **不强制** — 推荐不是命令，用户可以选"其他"做任何事
4. **每个 forge-* skill 也有出口建议** — 完成后会推荐下一步，形成链式引导

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

forge

Directory Structure

SKILL.md

Report

Notice