claude-apprentice 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/CHANGELOG.md +112 -0
  2. package/LICENSE +21 -0
  3. package/README.md +311 -0
  4. package/bin/apprentice.js +196 -0
  5. package/install.sh +92 -0
  6. package/package.json +38 -0
  7. package/templates/CLAUDE.md +60 -0
  8. package/templates/commands/backend.md +18 -0
  9. package/templates/commands/frontend.md +18 -0
  10. package/templates/commands/fullstack.md +18 -0
  11. package/templates/commands/scan-todos.md +123 -0
  12. package/templates/commands/spec.md +88 -0
  13. package/templates/memory/architecture.md +55 -0
  14. package/templates/memory/backend-standards.md +84 -0
  15. package/templates/memory/business-logic.md +59 -0
  16. package/templates/memory/frontend-standards.md +89 -0
  17. package/templates/memory/issues.md +34 -0
  18. package/templates/memory/learned-lessons.md +78 -0
  19. package/templates/memory/superpowers-config.md +46 -0
  20. package/templates/rules/INDEX.md +63 -0
  21. package/templates/rules/coding-standards.md +25 -0
  22. package/templates/rules/git-safety.md +9 -0
  23. package/templates/rules/superpowers-workflow.md +15 -0
  24. package/templates/scripts/auto-review.sh +77 -0
  25. package/templates/scripts/health-check.sh +189 -0
  26. package/templates/scripts/init.sh +2476 -0
  27. package/templates/settings.json +23 -0
  28. package/templates/skills/backend-workflow.md +87 -0
  29. package/templates/skills/code-review/SKILL.md +253 -0
  30. package/templates/skills/code-review/standards.md +189 -0
  31. package/templates/skills/frontend-workflow.md +75 -0
  32. package/templates/skills/fullstack-workflow.md +121 -0
  33. package/templates/specs/SPEC-GUIDE.md +99 -0
  34. package/templates/specs/active/README.md +7 -0
  35. package/templates/specs/archived/README.md +10 -0
  36. package/templates/usage-guides/README.md +84 -0
  37. package/templates/usage-guides/bottleneck-navigation.md +146 -0
  38. package/templates/usage-guides/usage-guide-v5.8.md +1261 -0
  39. package/templates/workflow/WORKFLOW-GUIDE.md +78 -0
package/templates/workflow/WORKFLOW-GUIDE.md ADDED
@@ -0,0 +1,78 @@
1
+ # 流程定义指南
2
+
3
+ 本文件定义了各工作流的标准阶段、角色分工、输入输出和流转规则。
4
+
5
+ ---
6
+
7
+ ## 后端标准流程
8
+
9
+ | 阶段 | 触发 Skill | 输入 | 输出 | 前进条件 | 可回退到 |
10
+ |------|-----------|------|------|---------|---------|
11
+ | 需求入口 | using-superpowers | 用户描述 | 复杂度判断 | 自动判定 | - |
12
+ | 需求澄清 | brainstorming | 复杂度 ≥ 中等 | `specs/active/*.md` | 用户确认 spec | 需求入口 |
13
+ | 方案设计 | writing-plans | 复杂度 = 复杂 | 任务拆解计划 | 用户确认计划 | 需求澄清 |
14
+ | 工作空间隔离 | using-git-worktrees | 复杂度 = 复杂 | worktree 分支 | 创建成功 | - |
15
+ | 实现 | executing-plans | spec + 计划 | DAO → Service → Controller | 构建+测试通过 | 方案设计 |
16
+ | 代码评审 | code-review | 复杂度 ≥ 中等 | 评审报告（MD/Excel） | 无高危问题 | 实现 |
17
+ | 收尾 | finishing-a-development-branch | 验证通过 | spec 归档 + 分支合并 | - | - |
18
+
19
+ ## 前端标准流程
20
+
21
+ | 阶段 | 触发 Skill | 输入 | 输出 | 前进条件 | 可回退到 |
22
+ |------|-----------|------|------|---------|---------|
23
+ | 需求入口 | using-superpowers | 用户描述 | 复杂度判断 | 自动判定 | - |
24
+ | 需求澄清 | brainstorming | 复杂度 ≥ 中等 | `specs/active/*.md` | 用户确认 spec | 需求入口 |
25
+ | 方案设计 | writing-plans | 复杂度 = 复杂 | 组件设计 + API 定义 | 用户确认 | 需求澄清 |
26
+ | 实现 | executing-plans | spec + 计划 | 组件 → API 模块 → 页面 | lint+构建通过 | 方案设计 |
27
+ | 代码评审 | code-review | 复杂度 ≥ 中等 | 评审报告 | 无高危问题 | 实现 |
28
+ | 收尾 | finishing-a-development-branch | 验证通过 | spec 归档 | - | - |
29
+
30
+ ## 全栈标准流程
31
+
32
+ | 阶段 | 触发 Skill | 输入 | 输出 | 前进条件 | 可回退到 |
33
+ |------|-----------|------|------|---------|---------|
34
+ | 需求入口 | using-superpowers | 用户描述 | 复杂度判断 | 自动判定 | - |
35
+ | 需求澄清 | brainstorming | 复杂度 ≥ 中等 | `specs/active/*.md` | 用户确认 spec | 需求入口 |
36
+ | 方案设计 | writing-plans | 复杂度 = 复杂 | 完整任务计划（含前后端） | 用户确认 | 需求澄清 |
37
+ | 工作空间隔离 | using-git-worktrees | 复杂度 = 复杂 | worktree 分支 | 创建成功 | - |
38
+ | 后端实现 | executing-plans | spec | DB → DAO → Service → Controller | 构建+测试通过 | 方案设计 |
39
+ | 前端实现 | executing-plans | spec + 后端 API | API 模块 → 组件 → 页面 | lint+构建通过 | 后端实现 |
40
+ | 联调验证 | verification-before-completion | 前后端代码 | 联调结果 | 接口调通 | 前端实现 |
41
+ | 代码评审 | code-review | 复杂度 ≥ 中等 | 评审报告 | 无高危问题 | 联调验证 |
42
+ | 收尾 | finishing-a-development-branch | 验证通过 | spec 归档 + 分支合并 | - | - |
43
+
44
+ ---
45
+
46
+ ## 简单任务流程
47
+
48
+ 简单任务（单文件修改，< 30 分钟）跳过所有中间阶段，直接实现 → 验证 → 完成。
49
+
50
+ ## 通用规则
51
+
52
+ 1. **下游不能修改上游产出** — 实现阶段不能修改 spec，只能通过 PM（即用户）打回到需求阶段
53
+ 2. **每个阶段必须有明确的"完成"定义** — 不能口头说"做完了"，必须通过验证
54
+ 3. **连续 3 次回退到同一阶段** — 暂停流程，由人做最终决策
55
+ 4. **验证是硬门禁** — 构建失败、测试失败、评审有高危问题，流程必须回退
56
+ 5. **spec 是唯一的真相来源** — AI 从文件读约束，不靠聊天记录
57
+
58
+ ## 阶段产物规范
59
+
60
+ | 产物 | 文件位置 | 谁产出 | 谁消费 | 状态流转 |
61
+ |------|---------|--------|--------|---------|
62
+ | Spec | `specs/active/` → `specs/archived/` | brainstorming | 所有下游阶段 | Proposed → Applied → Completed |
63
+ | 任务计划 | 对话上下文（不落文件） | writing-plans | executing-plans | - |
64
+ | 代码 | 项目源码目录 | executing-plans | code-review | - |
65
+ | 评审报告 | `.claude/reports/` | code-review | 用户 + finishing | - |
66
+
67
+ ## 与 Superpowers 配置的关系
68
+
69
+ 各阶段的 Skill 触发条件由 `memory/superpowers-config.md` 控制：
70
+
71
+ | Skill | 触发条件 | 对应阶段 |
72
+ |-------|---------|---------|
73
+ | brainstorming | complexity ≥ medium | 需求澄清 |
74
+ | writing-plans | complexity ≥ complex | 方案设计 |
75
+ | using-git-worktrees | complexity ≥ complex | 工作空间隔离 |
76
+ | test-driven-development | complexity ≥ medium | 实现阶段内 |
77
+ | code-review | complexity ≥ complex | 代码评审 |
78
+ | finishing-a-development-branch | complexity ≥ medium | 收尾 |