sdd-full 3.2.0 → 4.2.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 (127) hide show
  1. package/bin.js +63 -31
  2. package/package.json +1 -1
  3. package/skills/brainstorming/SKILL.md +164 -0
  4. package/skills/brainstorming/scripts/frame-template.html +214 -0
  5. package/skills/brainstorming/scripts/helper.js +88 -0
  6. package/skills/brainstorming/scripts/server.cjs +338 -0
  7. package/skills/brainstorming/scripts/start-server.sh +153 -0
  8. package/skills/brainstorming/scripts/stop-server.sh +55 -0
  9. package/skills/brainstorming/spec-document-reviewer-prompt.md +48 -0
  10. package/skills/brainstorming/visual-companion.md +286 -0
  11. package/skills/chinese-code-review/SKILL.md +277 -0
  12. package/skills/chinese-commit-conventions/SKILL.md +364 -0
  13. package/skills/chinese-documentation/SKILL.md +448 -0
  14. package/skills/chinese-git-workflow/SKILL.md +510 -0
  15. package/skills/design-planning/enterprise-spec/SKILL.md +3 -52
  16. package/skills/design-planning/flutter-av/SKILL.md +34 -44
  17. package/skills/design-planning/flutter-map/SKILL.md +31 -41
  18. package/skills/design-planning/ui-sdd-specialized/SKILL.md +40 -46
  19. package/skills/development-execution/flutter-errors/SKILL.md +34 -44
  20. package/skills/dispatching-parallel-agents/SKILL.md +182 -0
  21. package/skills/executing-plans/SKILL.md +175 -0
  22. package/skills/finishing-a-development-branch/SKILL.md +200 -0
  23. package/skills/mcp-builder/SKILL.md +255 -0
  24. package/skills/quality-assurance/bdd-acceptance/SKILL.md +37 -44
  25. package/skills/receiving-code-review/SKILL.md +213 -0
  26. package/skills/requesting-code-review/SKILL.md +105 -0
  27. package/skills/requesting-code-review/code-reviewer.md +146 -0
  28. package/skills/requirement-analysis/sdd-full/SKILL.md +36 -717
  29. package/skills/requirement-analysis/unified-flow/SKILL.md +26 -128
  30. package/skills/rules/skill-map.md +97 -0
  31. package/skills/rules/user_rules.md +69 -223
  32. package/skills/special-tools/env-check/SKILL.md +34 -40
  33. package/skills/subagent-driven-development/SKILL.md +277 -0
  34. package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +26 -0
  35. package/skills/subagent-driven-development/implementer-prompt.md +113 -0
  36. package/skills/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  37. package/skills/systematic-debugging/CREATION-LOG.md +119 -0
  38. package/skills/systematic-debugging/SKILL.md +296 -0
  39. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
  40. package/skills/systematic-debugging/condition-based-waiting.md +115 -0
  41. package/skills/systematic-debugging/defense-in-depth.md +122 -0
  42. package/skills/systematic-debugging/find-polluter.sh +63 -0
  43. package/skills/systematic-debugging/root-cause-tracing.md +169 -0
  44. package/skills/systematic-debugging/test-academic.md +14 -0
  45. package/skills/systematic-debugging/test-pressure-1.md +58 -0
  46. package/skills/systematic-debugging/test-pressure-2.md +68 -0
  47. package/skills/systematic-debugging/test-pressure-3.md +69 -0
  48. package/skills/test-driven-development/SKILL.md +371 -0
  49. package/skills/test-driven-development/testing-anti-patterns.md +299 -0
  50. package/skills/using-git-worktrees/SKILL.md +218 -0
  51. package/skills/using-superpowers/SKILL.md +134 -0
  52. package/skills/using-superpowers/references/codex-tools.md +25 -0
  53. package/skills/using-superpowers/references/gemini-tools.md +33 -0
  54. package/skills/verification-before-completion/SKILL.md +139 -0
  55. package/skills/workflow-runner/SKILL.md +172 -0
  56. package/skills/writing-plans/SKILL.md +152 -0
  57. package/skills/writing-plans/plan-document-reviewer-prompt.md +49 -0
  58. package/skills/writing-skills/SKILL.md +654 -0
  59. package/skills/writing-skills/anthropic-best-practices.md +1149 -0
  60. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  61. package/skills/writing-skills/graphviz-conventions.dot +172 -0
  62. package/skills/writing-skills/persuasion-principles.md +187 -0
  63. package/skills/writing-skills/render-graphs.js +168 -0
  64. package/skills/writing-skills/testing-skills-with-subagents.md +384 -0
  65. package/skills/README.md +0 -97
  66. package/skills/call-adaptation/SKILL.md +0 -23
  67. package/skills/call-adaptation/call-adaptation-guide.md +0 -136
  68. package/skills/call-adaptation/claude-code-call-spec.md +0 -50
  69. package/skills/call-adaptation/trae-call-spec.md +0 -56
  70. package/skills/checklist.md +0 -154
  71. package/skills/design-planning/ai-coding-rules/SKILL.md +0 -52
  72. package/skills/design-planning/design-to-code/SKILL.md +0 -53
  73. package/skills/design-planning/function-sdd/SKILL.md +0 -54
  74. package/skills/design-planning/sdd-code/SKILL.md +0 -347
  75. package/skills/design-planning/sdd-deploy/SKILL.md +0 -501
  76. package/skills/design-planning/sdd-ops/SKILL.md +0 -306
  77. package/skills/design-planning/sdd-test/SKILL.md +0 -383
  78. package/skills/design-planning/ui-sdd/SKILL.md +0 -291
  79. package/skills/design-planning/writing-plans/SKILL.md +0 -144
  80. package/skills/development-execution/sdd-add/SKILL.md +0 -540
  81. package/skills/development-execution/systematic-debugging/SKILL.md +0 -298
  82. package/skills/development-execution/test-driven-development/SKILL.md +0 -373
  83. package/skills/development-execution/verification-before-completion/SKILL.md +0 -141
  84. package/skills/knowledge-precipitation/claudeception/SKILL.md +0 -96
  85. package/skills/knowledge-precipitation/mempalace-auto-saver/SKILL.md +0 -302
  86. package/skills/quality-assurance/flutter-test/SKILL.md +0 -56
  87. package/skills/quality-assurance/quality-gate/SKILL.md +0 -350
  88. package/skills/quality-assurance/security-audit/SKILL.md +0 -386
  89. package/skills/release-ops/finishing-a-development-branch/SKILL.md +0 -202
  90. package/skills/release-ops/release-flow/SKILL.md +0 -404
  91. package/skills/requirement-analysis/brainstorming/SKILL.md +0 -166
  92. package/skills/requirement-analysis/competitive-brief/SKILL.md +0 -121
  93. package/skills/requirement-analysis/market-research/SKILL.md +0 -143
  94. package/skills/requirement-analysis/prd-write/SKILL.md +0 -111
  95. package/skills/requirement-analysis/requirement-completion-officer/SKILL.md +0 -124
  96. package/skills/requirement-analysis/sdd/SKILL.md +0 -1044
  97. package/skills/rules/project_rules.md +0 -167
  98. package/skills/sdd-framework/SKILL.md +0 -90
  99. package/skills/special-tools/receiving-code-review/SKILL.md +0 -215
  100. package/skills/special-tools/requesting-code-review/SKILL.md +0 -107
  101. package/skills/special-tools/using-superpowers/SKILL.md +0 -117
  102. package/skills/templates/API-SDD.md +0 -31
  103. package/skills/templates/Andrej Karpathy AI/347/274/226/347/240/201/350/247/204/345/210/231/350/220/275/345/234/260SDD.md" +0 -117
  104. package/skills/templates/BDD/351/243/216/346/240/274/351/252/214/346/224/266/346/240/207/345/207/206SDD.md +0 -147
  105. package/skills/templates/Base-SDD.md +0 -38
  106. package/skills/templates/Brain-SDD.md +0 -36
  107. package/skills/templates/Code-SDD.md +0 -41
  108. package/skills/templates/Competitor-SDD.md +0 -34
  109. package/skills/templates/Env-SDD.md +0 -37
  110. package/skills/templates/Flutter/345/205/250/347/261/273/345/236/213/346/265/213/350/257/225/347/255/226/347/225/245SDD.md +0 -162
  111. package/skills/templates/Flutter/345/234/260/345/233/276/345/257/274/350/210/252/344/270/232/345/212/241SDD.md +0 -136
  112. package/skills/templates/Flutter/345/270/270/350/247/201/345/274/202/345/270/270/344/270/223/351/241/271SDD.md +0 -159
  113. package/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md +0 -121
  114. package/skills/templates/PRD-SDD.md +0 -45
  115. package/skills/templates/SKILL.md +0 -29
  116. package/skills/templates/Test-SDD.md +0 -34
  117. package/skills/templates/UI-SDD.md +0 -38
  118. package/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -141
  119. package/skills/templates/UI/350/265/204/346/272/220/346/217/220/347/244/272/350/257/215/347/224/237/346/210/220SDD.md +0 -67
  120. package/skills/templates//344/274/201/344/270/232/347/272/247/345/205/250/346/240/210/345/267/245/347/250/213/350/247/204/350/214/203SDD.md +0 -152
  121. package/skills/templates//345/212/237/350/203/275SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -132
  122. package/skills/templates//347/216/257/345/242/203/351/242/204/346/243/200/346/240/207/345/207/206/345/214/226SDD.md +0 -153
  123. package/skills/templates//351/253/230/344/277/235/347/234/237/350/256/276/350/256/241/350/275/254/344/273/243/347/240/201SDD.md +0 -119
  124. package/skills//345/256/214/346/225/264/345/274/200/345/217/221/346/265/201/347/250/213/346/211/213/345/206/214.md +0 -408
  125. package/skills//346/212/200/350/203/275/344/275/223/347/263/273/345/256/214/345/226/204/345/273/272/350/256/256.md +0 -305
  126. package/skills//346/212/200/350/203/275/344/275/277/347/224/250/346/214/207/345/215/227.md +0 -265
  127. package/skills//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md +0 -294
@@ -1,167 +0,0 @@
1
- # 项目规则 - SDD全流程开发技能体系(团队共享)
2
-
3
- ## 一、项目概述
4
-
5
- 本项目是一个完整的SDD(Software Design Document)全流程开发技能包,包含从需求分析到发布运维的全流程技能,支持Trae和Claude Code双调用机制。
6
-
7
- ## 二、核心流程规范
8
-
9
- ### 2.1 新项目开发流程
10
- ```
11
- 需求收集 → 头脑风暴 → 市场调研 → PRD编写 → SDD拆分 → UI设计 → 代码设计 → 测试设计 → 开发 → 测试 → 质量检查 → 发布 → 复盘
12
- ```
13
-
14
- ### 2.2 Bug修复流程
15
- ```
16
- 问题定位 → Test-SDD补充回归用例 → 代码修复 → 验证 → 质量检查 → 经验沉淀
17
- ```
18
-
19
- ### 2.3 小型功能迭代流程
20
- ```
21
- 需求澄清 → SDD快速拆分 → 开发 → 验证 → 质量检查 → 发布
22
- ```
23
-
24
- ## 三、技能使用规范
25
-
26
- ### 3.1 技能分类与职责
27
- | 分类 | 技能 | 职责描述 |
28
- |------|------|---------|
29
- | 需求分析 | brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full | 需求收集、分析、拆分 |
30
- | 设计规划 | ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans | 设计方案制定 |
31
- | 开发执行 | sdd-add, test-driven-development, systematic-debugging, verification-before-completion | 代码实现 |
32
- | 质量保障 | quality-gate, security-audit | 质量把关 |
33
- | 发布运维 | finishing-a-development-branch, release-flow | 发布管理 |
34
- | 知识沉淀 | claudeception, mempalace-auto-saver | 经验积累 |
35
-
36
- ### 3.2 强制使用技能
37
- - ✅ **所有发布前必须通过 quality-gate**
38
- - ✅ **所有需求必须经过 sdd/sdd-full 拆分**
39
- - ✅ **所有Bug修复必须经过 systematic-debugging**
40
- - ✅ **发布后必须进行 claudeception 经验沉淀**
41
-
42
- ## 四、文档规范
43
-
44
- ### 4.1 SDD模板规范
45
- 项目使用9种标准化SDD模板:
46
- 1. **Base-SDD** - 全局通用基线规范
47
- 2. **Brain-SDD** - 头脑风暴文档
48
- 3. **Competitor-SDD** - 竞品分析文档
49
- 4. **PRD-SDD** - 产品需求文档
50
- 5. **UI-SDD** - UI设计文档
51
- 6. **Code-SDD** - 代码实现文档
52
- 7. **API-SDD** - 接口设计文档
53
- 8. **Env-SDD** - 环境配置文档
54
- 9. **Test-SDD** - 测试设计文档
55
-
56
- ### 4.2 文档命名规范
57
- ```
58
- {项目名称}-{模板名称}-{版本}.md
59
- 示例:个人备忘录APP-Base-SDD-v1.0.md
60
- ```
61
-
62
- ### 4.3 文档归档规范
63
- ```
64
- docs/
65
- ├── specs/ # SDD规范文档
66
- │ ├── ui/ # UI-SDD
67
- │ ├── function-implementation-sdd/ # Code-SDD
68
- │ └── test/ # Test-SDD
69
- ├── stories/ # 用户故事
70
- ├── architecture/ # 架构文档
71
- ├── database/ # 数据库设计
72
- ├── api/ # API契约
73
- └── deploy/ # 部署文档
74
- ```
75
-
76
- ## 五、质量标准
77
-
78
- ### 5.1 代码质量标准
79
- - 单元测试覆盖率 ≥ 80%
80
- - 代码审查必须通过
81
- - 无 P0/P1 级别 Bug
82
-
83
- ### 5.2 文档质量标准
84
- - 所有SDD模板必须完整填写
85
- - 文档版本管理规范
86
- - 文档与代码同步更新
87
-
88
- ### 5.3 发布标准
89
- - 所有测试用例通过
90
- - quality-gate 检查通过
91
- - security-audit 无高危漏洞
92
-
93
- ## 六、协作规范
94
-
95
- ### 6.1 分支管理
96
- - `main` - 主分支,稳定版本
97
- - `develop` - 开发分支
98
- - `feature/*` - 功能分支
99
- - `bugfix/*` - Bug修复分支
100
- - `release/*` - 发布分支
101
-
102
- ### 6.2 代码审查流程
103
- 1. 功能开发完成后提交 PR
104
- 2. 触发 requesting-code-review
105
- 3. 审查通过后触发 receiving-code-review
106
- 4. 合并到 develop 分支
107
-
108
- ### 6.3 沟通规范
109
- - 使用明确的技能触发关键词
110
- - 及时更新状态
111
- - 遇到问题及时反馈
112
-
113
- ## 七、调用机制规范
114
-
115
- ### 7.1 Trae调用格式
116
- ```
117
- trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
118
- ```
119
-
120
- ### 7.2 Claude Code调用格式
121
- ```
122
- 调用 技能名称 参数
123
- ```
124
-
125
- ### 7.3 流程场景参数
126
- | 参数值 | 说明 |
127
- |--------|------|
128
- | 完整3阶段SDD流程 | 大型项目完整流程 |
129
- | 从零开始新项目 | 新项目立项 |
130
- | 小型功能迭代 | 快速迭代 |
131
- | Bug处理 | Bug修复 |
132
- | 代码发布 | 版本发布 |
133
-
134
- ## 八、工具与环境
135
-
136
- ### 8.1 推荐工具
137
- - **Figma** - UI设计
138
- - **GitHub** - 代码托管
139
- - **Trae** - 技能调用
140
- - **Claude Code** - AI协作
141
-
142
- ### 8.2 环境要求
143
- - Node.js ≥ 18.x
144
- - npm ≥ 9.x
145
- - sdd-full ≥ 2.2.0
146
-
147
- ## 九、版本管理
148
-
149
- ### 9.1 版本命名规范
150
- ```
151
- v{主版本}.{次版本}.{修订版本}
152
- 示例:v2.2.0
153
- ```
154
-
155
- ### 9.2 版本发布流程
156
- 1. 完成功能开发与测试
157
- 2. 更新版本号
158
- 3. 通过 quality-gate
159
- 4. 执行 release-flow
160
- 5. 发布到 npm
161
-
162
- ---
163
-
164
- **版本**: v1.0
165
- **更新时间**: 2026-05-06
166
- **适用项目**: sdd-full-npm
167
- **团队**: SDD开发团队
@@ -1,90 +0,0 @@
1
- 【claude code调用标识:sdd-framework】【trae调用标识:sdd-framework+SDD融合框架】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目】
2
-
3
- ---
4
- name: sdd-framework
5
- description: SDD融合框架 - 标准化SDD模板管理,覆盖从全局基线到测试的全流程
6
- ---
7
-
8
- # SDD融合框架
9
-
10
- ## 概述
11
-
12
- 本框架提供标准化SDD模板管理,将头脑风暴、竞品分析、PRD、UI设计、代码实现、API设计、环境配置、测试设计等环节纳入文档化管理,形成纯文档闭环。
13
-
14
- ## SDD模板清单
15
-
16
- 模板统一存放在 `skills/templates/` 目录:
17
-
18
- | 模板名称 | 核心内容 | 适用技能 |
19
- |---------|---------|---------|
20
- | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
21
- | **Brain-SDD** | 头脑风暴文档 | brainstorming |
22
- | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
23
- | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
24
- | **UI-SDD** | UI设计文档 | ui-sdd |
25
- | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
26
- | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
27
- | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
28
- | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
29
-
30
- ## 专项SDD模板
31
-
32
- | 模板名称 | 核心内容 | 适用场景 |
33
- |---------|---------|---------|
34
- | **UI-SDD专用模板** | UI设计稿结构化、交付标准 | UI设计阶段 |
35
- | **功能SDD专用模板** | 业务功能专属模板 | 功能开发 |
36
- | **BDD风格验收标准SDD** | BDD验收句式、准入/准出标准 | 测试验收 |
37
- | **环境预检标准化SDD** | 本机配置、依赖版本、网络预检 | 项目启动 |
38
- | **Flutter地图导航业务SDD** | 高德SDK集成、Marker处理 | 地图开发 |
39
- | **Flutter音视频全栈SDD** | 离线ASR、TTS、OCR接入 | 音视频功能 |
40
- | **Flutter全类型测试策略SDD** | Golden测试、E2E、TDD、冒烟测试 | 测试策略 |
41
- | **Flutter常见异常专项SDD** | SocketException、渲染异常排查 | Bug修复 |
42
- | **企业级全栈工程规范SDD** | 项目目录、版本管理、交付标准 | 工程规范 |
43
- | **Andrej Karpathy AI编码规则SDD** | 编码约束、禁止自由发挥 | 编码规范 |
44
- | **高保真设计转代码SDD** | Rive动画、Figma转Flutter | 设计转代码 |
45
-
46
- ## 强制顺序流水线
47
-
48
- ```
49
- Base-SDD → Brain-SDD → Competitor-SDD → PRD-SDD → Figma设计 → UI-SDD → Code-SDD → API-SDD → Env-SDD → Test-SDD → TDD开发 → 分层测试 → Bug闭环 → quality-gate → sdd-deploy → release-flow → claudeception
50
- ```
51
-
52
- ## 使用指南
53
-
54
- ### 新项目完整流程
55
- 1. 首先创建Base-SDD定义全局基线
56
- 2. Brain-SDD进行头脑风暴
57
- 3. Competitor-SDD进行竞品分析
58
- 4. PRD-SDD编写产品需求
59
- 5. Figma设计UI
60
- 6. 依次创建UI-SDD、Code-SDD、API-SDD、Env-SDD、Test-SDD
61
- 7. TDD开发、测试、发布
62
-
63
- ### Bug修复流程
64
- 1. systematic-debugging分析问题
65
- 2. 更新Test-SDD添加回归用例
66
- 3. sdd-add修复代码
67
- 4. verification-before-completion验证
68
- 5. quality-gate检查
69
- 6. claudeception沉淀经验
70
-
71
- ### 精简流程(小功能)
72
- 满足任意2条可使用精简流程:
73
- - 开发周期≤1天,代码量≤500行
74
- - 不涉及新接口、新UI组件
75
- - 无复杂交互,不影响全局流程
76
-
77
- ## AI协作规范
78
-
79
- | 阶段 | AI职责 | 人工校验要求 |
80
- |------|--------|-------------|
81
- | Brain-SDD | 发散想法、评估风险 | 确认想法合理性 |
82
- | Competitor-SDD | 收集竞品信息、对比差异 | 确认分析准确性 |
83
- | PRD-SDD | 补全需求、梳理用户旅程 | 必须人工二次确认 |
84
- | Code-SDD | 编写测试用例、排查Bug | 确认代码规范 |
85
- | 所有阶段 | 协助整理归档 | 校验完整性 |
86
-
87
- ---
88
-
89
- **模板版本**: v5.0
90
- **适用场景**: 个人+AI开发模式的完整文档化流程
@@ -1,215 +0,0 @@
1
- 【claude code调用标识:receiving-code-review】【trae调用标识:receiving-code-review+代码审查接收】【流程场景:1.完整3阶段SDD流程、3.小型功能迭代、5.代码发布】
2
-
3
- ---
4
- name: receiving-code-review
5
- description: 在收到代码审查反馈时使用,在实施建议之前,特别是如果反馈似乎不清楚或技术上有问题 - 需要技术严谨性和验证,而不是表演性同意或盲目实施
6
- ---
7
-
8
- # 代码审查接收
9
-
10
- ## 概述
11
-
12
- 代码审查需要技术评估,而不是情感表演。
13
-
14
- **核心原则:** 实施前验证。假设前询问。技术正确性优先于社交舒适度。
15
-
16
- ## 响应模式
17
-
18
- ```
19
- 收到代码审查反馈时:
20
-
21
- 1. 阅读:完整阅读反馈,不做出反应
22
- 2. 理解:用自己的话重述要求(或询问)
23
- 3. 验证:对照代码库现实进行检查
24
- 4. 评估:对这个代码库技术上是否合理?
25
- 5. 响应:技术确认或有理由的反驳
26
- 6. 实施:一次一个项目,测试每个项目
27
- ```
28
-
29
- ## 禁止的响应
30
-
31
- **永远不要:**
32
- - "你绝对正确!"(明确违反 CLAUDE.md)
33
- - "好观点!" / "优秀的反馈!"(表演性的)
34
- - "让我现在实施那个"(验证前)
35
-
36
- **相反:**
37
- - 重述技术要求
38
- - 提出澄清问题
39
- - 如果错误,用技术推理反驳
40
- - 直接开始工作(行动 > 言语)
41
-
42
- ## 处理不清楚的反馈
43
-
44
- ```
45
- 如果任何项目不清楚:
46
- 停止 - 暂时不要实施任何内容
47
- 要求澄清不清楚的项目
48
-
49
- 原因:项目可能相关。部分理解 = 错误实施。
50
- ```
51
-
52
- **示例:**
53
- ```
54
- 你的人类伙伴:"修复 1-6"
55
- 你理解 1,2,3,6。对 4,5 不清楚。
56
-
57
- ❌ 错误:现在实施 1,2,3,6,稍后询问 4,5
58
- ✅ 正确:"我理解项目 1,2,3,6。在继续之前需要澄清 4 和 5。"
59
- ```
60
-
61
- ## 特定来源处理
62
-
63
- ### 来自你的人类伙伴
64
- - **可信** - 理解后实施
65
- - **如果范围不清楚,仍要询问**
66
- - **无表演性同意**
67
- - **直接行动**或技术确认
68
-
69
- ### 来自外部审查者
70
- ```
71
- 实施前:
72
- 1. 检查:对这个代码库技术上是否正确?
73
- 2. 检查:是否破坏现有功能?
74
- 3. 检查:当前实现的原因?
75
- 4. 检查:是否在所有平台/版本上工作?
76
- 5. 检查:审查者是否理解完整上下文?
77
-
78
- 如果建议似乎错误:
79
- 用技术推理反驳
80
-
81
- 如果无法轻松验证:
82
- 说明:"没有 [X] 我无法验证这一点。我应该 [调查/询问/继续]?"
83
-
84
- 如果与你的人类伙伴之前的决定冲突:
85
- 先停止并与你的人类伙伴讨论
86
- ```
87
-
88
- **你的人类伙伴的规则:** "外部反馈 - 保持怀疑,但仔细检查"
89
-
90
- ## "专业"功能的 YAGNI 检查
91
-
92
- ```
93
- 如果审查者建议"正确实施":
94
- 在代码库中搜索实际使用
95
-
96
- 如果未使用:"这个端点没有被调用。移除它(YAGNI)?"
97
- 如果使用:则正确实施
98
- ```
99
-
100
- **你的人类伙伴的规则:** "你和审查者都向我报告。如果我们不需要这个功能,就不要添加它。"
101
-
102
- ## 实施顺序
103
-
104
- ```
105
- 对于多项反馈:
106
- 1. 首先澄清任何不清楚的内容
107
- 2. 然后按以下顺序实施:
108
- - 阻塞问题(中断,安全)
109
- - 简单修复(拼写错误,导入)
110
- - 复杂修复(重构,逻辑)
111
- 3. 单独测试每个修复
112
- 4. 验证无回归
113
- ```
114
-
115
- ## 何时反驳
116
-
117
- 当以下情况时反驳:
118
- - 建议破坏现有功能
119
- - 审查者缺乏完整上下文
120
- - 违反 YAGNI(未使用的功能)
121
- - 对这个技术栈技术上不正确
122
- - 存在遗留/兼容性原因
123
- - 与你的人类伙伴的架构决策冲突
124
-
125
- **如何反驳:**
126
- - 使用技术推理,而非防御性
127
- - 提出具体问题
128
- - 引用工作测试/代码
129
- - 如果是架构问题,让你的人类伙伴参与
130
-
131
- **如果不愿意大声反驳的信号:** "Circle K 有奇怪的事情发生"
132
-
133
- ## 确认正确的反馈
134
-
135
- 当反馈正确时:
136
- ```
137
- ✅ "已修复。[对更改的简要描述]"
138
- ✅ "好发现 - [具体问题]。在 [位置] 已修复。"
139
- ✅ [直接修复并在代码中显示]
140
-
141
- ❌ "你绝对正确!"
142
- ❌ "好观点!"
143
- ❌ "感谢发现那个!"
144
- ❌ "感谢 [任何内容]"
145
- ❌ 任何感谢表达
146
- ```
147
-
148
- **为什么不感谢:** 行动说话。直接修复。代码本身表明你听到了反馈。
149
-
150
- **如果你发现自己要写"谢谢":** 删除它。改为说明修复。
151
-
152
- ## 优雅地纠正你的反驳
153
-
154
- 如果你反驳了但错了:
155
- ```
156
- ✅ "你是对的 - 我检查了 [X],它确实 [Y]。现在实施。"
157
- ✅ "验证了这一点,你是正确的。我最初的理解是错误的,因为 [原因]。正在修复。"
158
-
159
- ❌ 冗长的道歉
160
- ❌ 为你反驳的原因辩护
161
- ❌ 过度解释
162
- ```
163
-
164
- 事实陈述纠正并继续。
165
-
166
- ## 常见错误
167
-
168
- | 错误 | 修复 |
169
- |------|------|
170
- | 表演性同意 | 说明要求或直接行动 |
171
- | 盲目实施 | 首先对照代码库验证 |
172
- | 批量实施而不测试 | 一次一个,测试每个 |
173
- | 假设审查者是对的 | 检查是否破坏事物 |
174
- | 避免反驳 | 技术正确性 > 舒适度 |
175
- | 部分实施 | 首先澄清所有项目 |
176
- | 无法验证,仍继续 | 说明限制,请求方向 |
177
-
178
- ## 真实示例
179
-
180
- **表演性同意(错误):**
181
- ```
182
- 审查者:"移除遗留代码"
183
- ❌ "你绝对正确!让我移除那个..."
184
- ```
185
-
186
- **技术验证(正确):**
187
- ```
188
- 审查者:"移除遗留代码"
189
- ✅ "检查中... 构建目标是 10.15+,此 API 需要 13+。需要遗留代码以保持向后兼容。当前实现的 bundle ID 错误 - 修复它还是放弃 13 之前的支持?"
190
- ```
191
-
192
- **YAGNI(正确):**
193
- ```
194
- 审查者:"实施带有数据库、日期过滤器、CSV 导出的适当指标跟踪"
195
- ✅ "搜索代码库 - 没有调用此端点。移除它(YAGNI)?还是我遗漏了使用情况?"
196
- ```
197
-
198
- **不清楚的项目(正确):**
199
- ```
200
- 你的人类伙伴:"修复项目 1-6"
201
- 你理解 1,2,3,6。对 4,5 不清楚。
202
- ✅ "理解 1,2,3,6。在实施之前需要澄清 4 和 5。"
203
- ```
204
-
205
- ## GitHub 线程回复
206
-
207
- 在 GitHub 上回复内联审查评论时,在评论线程中回复(`gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies`),而不是作为顶级 PR 评论。
208
-
209
- ## 底线
210
-
211
- **外部反馈 = 要评估的建议,不是要遵循的命令。**
212
-
213
- 验证。提问。然后实施。
214
-
215
- 无表演性同意。始终保持技术严谨。
@@ -1,107 +0,0 @@
1
- 【claude code调用标识:requesting-code-review】【trae调用标识:requesting-code-review+请求代码审查】【流程场景:1.完整3阶段SDD流程、3.小型功能迭代、5.代码发布】
2
-
3
- ---
4
- name: requesting-code-review
5
- description: 在完成任务、实现主要功能或合并前使用,以验证工作是否满足要求
6
- ---
7
-
8
- # 请求代码审查
9
-
10
- 调度 superpowers:code-reviewer 子代理,在问题扩散前捕获它们。审查者获得精确设计的评估上下文 - 绝不是你的会话历史。这使审查者专注于工作产品,而不是你的思考过程,并保留你自己的上下文以继续工作。
11
-
12
- **核心原则:** 尽早审查,经常审查。
13
-
14
- ## 何时请求审查
15
-
16
- **必须:**
17
- - 子代理驱动开发中的每个任务后
18
- - 完成主要功能后
19
- - 合并到 main 之前
20
-
21
- **可选但有价值:**
22
- - 卡住时(新鲜视角)
23
- - 重构前(基线检查)
24
- - 修复复杂错误后
25
-
26
- ## 如何请求
27
-
28
- **1. 获取 git SHAs:**
29
- ```bash
30
- BASE_SHA=$(git rev-parse HEAD~1) # 或 origin/main
31
- HEAD_SHA=$(git rev-parse HEAD)
32
- ```
33
-
34
- **2. 调度代码审查子代理:**
35
-
36
- 使用 Task 工具与 superpowers:code-reviewer 类型,填写 `code-reviewer.md` 中的模板
37
-
38
- **占位符:**
39
- - `{WHAT_WAS_IMPLEMENTED}` - 你刚刚构建的内容
40
- - `{PLAN_OR_REQUIREMENTS}` - 它应该做什么
41
- - `{BASE_SHA}` - 起始提交
42
- - `{HEAD_SHA}` - 结束提交
43
- - `{DESCRIPTION}` - 简短摘要
44
-
45
- **3. 根据反馈行动:**
46
- - 立即修复关键问题
47
- - 在继续之前修复重要问题
48
- - 记录次要问题以便以后处理
49
- - 如果审查者错误,反驳(带有理由)
50
-
51
- ## 示例
52
-
53
- ```
54
- [刚刚完成任务 2:添加验证函数]
55
-
56
- 你:让我在继续之前请求代码审查。
57
-
58
- BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
59
- HEAD_SHA=$(git rev-parse HEAD)
60
-
61
- [调度 superpowers:code-reviewer 子代理]
62
- WHAT_WAS_IMPLEMENTED: 对话索引的验证和修复函数
63
- PLAN_OR_REQUIREMENTS: docs/superpowers/plans/deployment-plan.md 中的任务 2
64
- BASE_SHA: a7981ec
65
- HEAD_SHA: 3df7661
66
- DESCRIPTION: 添加了 verifyIndex() 和 repairIndex(),具有 4 种问题类型
67
-
68
- [子代理返回]:
69
- 优势:干净的架构,真实测试
70
- 问题:
71
- 重要:缺少进度指示器
72
- 次要:报告间隔的魔法数字 (100)
73
- 评估:可以继续
74
-
75
- 你:[修复进度指示器]
76
- [继续到任务 3]
77
- ```
78
-
79
- ## 与工作流集成
80
-
81
- **子代理驱动开发:**
82
- - 每个任务后审查
83
- - 在问题复合前捕获它们
84
- - 在移至下一个任务前修复
85
-
86
- **执行计划:**
87
- - 每批(3 个任务)后审查
88
- - 获取反馈,应用,继续
89
-
90
- **临时开发:**
91
- - 合并前审查
92
- - 卡住时审查
93
-
94
- ## 红旗
95
-
96
- **永远不要:**
97
- - 因为"简单"而跳过审查
98
- - 忽略关键问题
99
- - 带着未修复的重要问题继续
100
- - 与有效的技术反馈争论
101
-
102
- **如果审查者错误:**
103
- - 用技术推理反驳
104
- - 展示证明它有效的代码/测试
105
- - 请求澄清
106
-
107
- 请参阅模板:requesting-code-review/code-reviewer.md
@@ -1,117 +0,0 @@
1
- 【claude code调用标识:using-superpowers】【trae调用标识:using-superpowers+技能调用管理】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
2
-
3
- ---
4
- name: using-superpowers
5
- description: 当开始任何对话时使用 - 建立如何查找和使用技能的方法,要求在包括澄清问题在内的任何响应之前调用Skill工具
6
- ---
7
-
8
- <SUBAGENT-STOP>
9
- 如果您被派作为子代理执行特定任务,请跳过此技能。
10
- </SUBAGENT-STOP>
11
-
12
- <EXTREMELY-IMPORTANT>
13
- 如果您认为技能可能适用于您正在做的事情的可能性甚至为1%,您绝对必须调用该技能。
14
-
15
- 如果技能适用于您的任务,您没有选择。您必须使用它。
16
-
17
- 这是不可协商的。这不是可选的。您不能通过理性思考来逃避这一点。
18
- </EXTREMELY-IMPORTANT>
19
-
20
- ## 指令优先级
21
-
22
- Superpowers技能会覆盖默认的系统提示行为,但**用户指令始终优先**:
23
-
24
- 1. **用户的明确指令**(CLAUDE.md、GEMINI.md、AGENTS.md、直接请求)— 最高优先级
25
- 2. **Superpowers技能** — 在冲突时覆盖默认系统行为
26
- 3. **默认系统提示** — 最低优先级
27
-
28
- 如果CLAUDE.md、GEMINI.md或AGENTS.md说"不要使用TDD",而技能说"始终使用TDD",请遵循用户的指令。用户是控制者。
29
-
30
- ## 如何访问技能
31
-
32
- **在Claude Code中:** 使用`Skill`工具。当您调用技能时,其内容会加载并呈现给您——直接遵循它。永远不要在技能文件上使用Read工具。
33
-
34
- **在Gemini CLI中:** 技能通过`activate_skill`工具激活。Gemini在会话开始时加载技能元数据,并根据需要激活完整内容。
35
-
36
- **在其他环境中:** 查看您平台的文档,了解如何加载技能。
37
-
38
- ## 平台适应
39
-
40
- 技能使用Claude Code工具名称。非CC平台:请参阅`references/codex-tools.md`(Codex)了解工具等效项。Gemini CLI用户通过GEMINI.md自动加载工具映射。
41
-
42
- # 使用技能
43
-
44
- ## 规则
45
-
46
- **在任何响应或操作之前调用相关或请求的技能。** 即使技能可能适用的可能性为1%,也意味着您应该调用技能进行检查。如果调用的技能结果证明不适合该情况,您不需要使用它。
47
-
48
- ```dot
49
- digraph skill_flow {
50
- "收到用户消息" [shape=doublecircle];
51
- "即将进入计划模式?" [shape=doublecircle];
52
- "已经进行头脑风暴?" [shape=diamond];
53
- "调用头脑风暴技能" [shape=box];
54
- "可能适用任何技能?" [shape=diamond];
55
- "调用Skill工具" [shape=box];
56
- "宣布:'使用[技能]进行[目的]'" [shape=box];
57
- "有清单?" [shape=diamond];
58
- "为每个项目创建TodoWrite待办事项" [shape=box];
59
- "严格遵循技能" [shape=box];
60
- "响应(包括澄清)" [shape=doublecircle];
61
-
62
- "即将进入计划模式?" -> "已经进行头脑风暴?";
63
- "已经进行头脑风暴?" -> "调用头脑风暴技能" [label="否"];
64
- "已经进行头脑风暴?" -> "可能适用任何技能?" [label="是"];
65
- "调用头脑风暴技能" -> "可能适用任何技能?";
66
-
67
- "收到用户消息" -> "可能适用任何技能?";
68
- "可能适用任何技能?" -> "调用Skill工具" [label="是,即使1%"];
69
- "可能适用任何技能?" -> "响应(包括澄清)" [label="绝对不"];
70
- "调用Skill工具" -> "宣布:'使用[技能]进行[目的]'";
71
- "宣布:'使用[技能]进行[目的]'" -> "有清单?";
72
- "有清单?" -> "为每个项目创建TodoWrite待办事项" [label="是"];
73
- "有清单?" -> "严格遵循技能" [label="否"];
74
- "为每个项目创建TodoWrite待办事项" -> "严格遵循技能";
75
- }
76
- ```
77
-
78
- ## 红旗
79
-
80
- 这些想法意味着停止——您在合理化:
81
-
82
- | 想法 | 现实 |
83
- |------|------|
84
- | "这只是一个简单的问题" | 问题是任务。检查技能。 |
85
- | "我需要先了解更多上下文" | 技能检查在澄清问题之前进行。 |
86
- | "让我先探索代码库" | 技能告诉您如何探索。先检查。 |
87
- | "我可以快速检查git/文件" | 文件缺乏对话上下文。检查技能。 |
88
- | "让我先收集信息" | 技能告诉您如何收集信息。 |
89
- | "这不需要正式技能" | 如果技能存在,使用它。 |
90
- | "我记得这个技能" | 技能会演变。阅读当前版本。 |
91
- | "这不算任务" | 行动=任务。检查技能。 |
92
- | "技能过度了" | 简单的事情会变得复杂。使用它。 |
93
- | "我先做这件事" | 在做任何事情之前检查。 |
94
- | "这感觉很有成效" | 无纪律的行动浪费时间。技能可以防止这种情况。 |
95
- | "我知道那是什么意思" | 知道概念≠使用技能。调用它。 |
96
-
97
- ## 技能优先级
98
-
99
- 当多个技能可能适用时,使用此顺序:
100
-
101
- 1. **首先是流程技能**(头脑风暴、调试)- 这些决定如何处理任务
102
- 2. **其次是实现技能**(前端设计、mcp-builder)- 这些指导执行
103
-
104
- "让我们构建X" → 先头脑风暴,然后是实现技能。
105
- "修复这个错误" → 先调试,然后是领域特定技能。
106
-
107
- ## 技能类型
108
-
109
- **严格**(TDD、调试):严格遵循。不要放弃纪律。
110
-
111
- **灵活**(模式):根据上下文调整原则。
112
-
113
- 技能本身会告诉您是哪一种。
114
-
115
- ## 用户指令
116
-
117
- 指令说明做什么,而不是怎么做。"添加X"或"修复Y"并不意味着跳过工作流程。