@wwkit/harness 1.0.10 → 1.0.12

package/skills/read-docs/references/superpowers/workflow.md

@@ -0,0 +1,83 @@
+# 主工作流
+
+## 完整流程
+
+```
+brainstorming → writing-plans → using-git-worktrees →
+subagent-driven-development (or executing-plans) →
+requesting-code-review → finishing-a-development-branch
+```
+
+## Brainstorming 阶段
+
+**触发**：用户说"构建 X" 或 "实现功能 Y"
+
+**流程**：
+1. 探索项目上下文（文件、文档、最近提交）
+2. 逐个提问澄清需求（一次一个问题）
+3. 提出 2-3 种方案 + 权衡 + 推荐
+4. 分段展示设计，每段后获用户确认
+5. 写设计文档到 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`
+6. 自审 spec（占位符扫描、一致性、范围、歧义）
+7. 用户审查 spec
+8. 调用 `writing-plans` 技能
+
+**硬门控**：在设计获批前，禁止写任何代码。
+
+## Writing Plans 阶段
+
+**输入**：已批准的 spec
+
+**产出**：实现计划文件 `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
+
+**计划格式**：
+```markdown
+# [Feature] Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development
+
+**Goal:** [一句话]
+**Architecture:** [2-3 句]
+**Tech Stack:** [技术栈]
+
+## Global Constraints
+[项目级约束 — 版本、命名、平台要求等]
+
+### Task N: [Component Name]
+**Files:** Create/Modify/Test 路径
+**Interfaces:** Consumes/Produces
+- [ ] Step 1: Write the failing test
+- [ ] Step 2: Run test to verify it fails
+- [ ] Step 3: Write minimal implementation
+- [ ] Step 4: Run test to verify it passes
+- [ ] Step 5: Commit
+```
+
+**关键原则**：
+- 每步 2-5 分钟
+- 无占位符（"TBD"、"add error handling" 等是计划失败）
+- 每步包含完整代码
+- TDD：先写失败测试，再实现
+
+## 执行选择
+
+计划完成后，提供两种执行方式：
+
+| 方式 | 条件 | 特点 |
+|------|------|------|
+| Subagent-Driven Development（推荐） | 有 subagent 能力 | 每任务一个 fresh subagent + 两阶段 review |
+| Executing Plans（inline） | 无 subagent | 批量执行 + 人工检查点 |
+
+## Finishing 阶段
+
+1. 运行全量测试
+2. 检测环境（normal repo / worktree / detached HEAD）
+3. 确认 base branch
+4. 呈现选项：
+   - Merge back to base locally
+   - Push and create PR
+   - Keep as-is
+5. 执行用户选择
+6. 清理工作区（仅 Superpowers 创建的 worktree）
+
+**关键**：集成决策是用户的，agent 只呈现菜单等待回答。