workflow

工作流

高效的单人开发。从想法到上线，当天完成。

Agent 能力

能力	用途	必需	备用方案
文件读写	规格说明、配置、历史记录	是	—
代码搜索（grep/glob）	探索、上下文分析	是	—
Shell/命令执行	质量门禁（lint、build、test）	是	列出命令供用户运行
代码库智能分析（npx codebase-intelligence）	TS/TSX 项目的结构分析（图、指标、影响范围）	否	grep/glob/read（手动探索）
任务/待办跟踪	阶段管理	推荐	在规格说明的 Progress 部分跟踪
用户交互	卡住时升级处理、风险标记	推荐	在规格说明的 Notes 部分记录决策
Web/文档搜索	查找模式	否	使用内置模式

备用规则： 如果 Agent 不具备某项能力，请使用备用方案。绝不跳过工作流步骤——调整执行方式。

命令

命令	操作	参考
plan {idea}	创建规格说明	plan.md
spike {question}	限时探索	spike.md
ship / ship {idea}	实现 + 验证	ship.md
fix / fix {bug}	科学调试 + 回归修复	fix.md
review	可移植的多视角审查规格，覆盖逐行审查 + 逐规则审查	review.md
spec-review	对抗式规格分析	spec-review.md
focus	优先级分析 + 任务提议	focus.md
done	验证 + 复盘 + 归档	done.md
drop	放弃并保留经验	drop.md
workflow	显示状态 + 建议下一步	状态（下方）

无需标志参数。Agent 会根据上下文自动识别意图：

• “review the spec” → 暂停以便手动审查
• “skip tests” → 跳过测试门禁（需记录）
• “fix this bug” → 专项修复缺陷并添加回归测试
• “emergency fix” → 绕过规格流程
• “production ready” → 生产环境验证

流程

Features: focus → plan {idea} → ship → [implement/review/fix loop] → done
Bug fixes: fix {bug} → [investigate/TDD/validate] → done

快速模式（<2h）：ship {idea} → done 不知道该做什么：focus

理念

• 规格优先：所有工作都需要规格说明（缺少时创建）
• 交付循环：构建 → 审查 → 修复，直到没有问题
• 质量门禁：lint → typecheck → build → test → E2E → 覆盖率（按项目自动检测）
• E2E 优先测试：默认使用 E2E 测试。单元测试仅用于纯函数
• 强制 TDD：按 AC 执行 RED → GREEN → REFACTOR。实现前编写测试（阻塞）
• 模拟边界：优先使用真实系统。仅在第三方 API 没有沙盒时才模拟（最后手段）
• 由 AC 驱动的覆盖率：每个 Must Have + Error AC 都要在场景注册表中对应一个 E2E 测试
• 防止回归：缺陷修复必须添加 E2E 回归测试 + 级联影响检查差异（阻塞）
• 故障模式测试：每个 HIGH/MED 故障假设都要添加防护性 E2E 测试
• 由人控制部署：Agent 编写代码，你负责推送/部署
• 当天完成：范围限定为今天可以交付的内容
• 自行规划：绝不使用宿主 Agent 内置的计划模式（EnterPlanMode 等）。此技能会将实际规格文件写入 specs/active/。

规格等级

等级	规模	规格说明	任务跟踪
trivial	<5 LOC	无——直接执行	否
micro	<30 LOC	代码内联注释	否
mini	<100 LOC	规格文件，精简版	是（如可用）
standard	100+ LOC	包含检查清单的完整规格	是（如可用）

操作路由

User input
  │
  ├─ "plan", "spec", "design"           → Load references/actions/plan.md
  ├─ "spike", "explore", "investigate"   → Load references/actions/spike.md
  ├─ "ship", "implement", "build"         → Load references/actions/ship.md
  ├─ "fix", "debug", "repair"            → Load references/actions/fix.md
  ├─ "review", "check code"              → Load references/actions/review.md
  ├─ "review spec", "analyze spec",
  │  "challenge spec"                    → Load references/actions/spec-review.md
  ├─ "focus", "what should i do",
  │  "prioritize", "overwhelmed"         → Load references/actions/focus.md
  ├─ "done", "finish", "complete"        → Load references/actions/done.md
  ├─ "drop", "abandon"                   → Load references/actions/drop.md
  └─ "workflow", "what's next", "what now",
     "what's up", "whats up", "status"  → Status Action (below)

加载规则： 执行前先读取操作文件。该文件包含所需的全部逻辑、任务模板和参考资料。

状态操作

没有单独的操作文件——逻辑内嵌于此。检测当前状态并建议下一步操作：

1. Check specs/active/ for active spec
2. Check git status for uncommitted work
3. Check task list for in-progress items

State → Suggestion:
  No spec, no changes    → "Ready. Run: plan {idea}"
  Active spec, no code   → "Spec ready. Run: ship"
  Active spec, code WIP  → "In progress. Run: ship (resumes)"
  Active spec, code done → "Ready to close. Run: done"
  No spec, dirty tree    → "Uncommitted work. Run: ship (creates spec) or done"

输出：参阅 status-output.md。

项目结构

specs/
  active/       ← Current work (0-1 specs)
  backlog/      ← Queued work from focus
  shipped/      ← Completed features
  dropped/      ← Abandoned with learnings
  history.log   ← One-line per feature shipped/dropped

配置

直接编辑技能文件即可配置所有行为。

要更改的内容	编辑
操作逻辑、关卡、限制	references/actions/{action}.md
输出格式	references/templates/{action}-output.md
规范结构	references/spec-template.md
质量门禁命令/级别	references/quality-gates.md
会话恢复、卡住检测	references/session-management.md

参考资料

操作：

• 规划 | 发布 | 修复 | 审查 | 规范审查 | 聚焦 | 完成 | 丢弃 | 探索

输出模板：

• 规划 + 规范审查 | 发布 | 修复 | 审查 | 聚焦 | 完成 | 丢弃 | 探索 | 状态

审查标准：

• 核心可移植审查规范 | 执行器模式 | 生产标准

可移植审查规范为规范性文件。执行器模式是可选的实现指南。

规范与门禁：

• 规范模板 | 质量门禁 | 会话管理 | 记忆更新 | 测试自动化 | 端到端场景 | 代码库智能

模式：

• 实现 | 规划 | 调试 | 决策 | 分解 | 回归测试