sdd-full 3.1.0 → 4.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 (87) hide show
  1. package/bin.js +63 -31
  2. package/package.json +1 -1
  3. package/skills/README.md +0 -97
  4. package/skills/call-adaptation/SKILL.md +0 -23
  5. package/skills/call-adaptation/call-adaptation-guide.md +0 -136
  6. package/skills/call-adaptation/claude-code-call-spec.md +0 -50
  7. package/skills/call-adaptation/trae-call-spec.md +0 -56
  8. package/skills/checklist.md +0 -154
  9. package/skills/design-planning/ai-coding-rules/SKILL.md +0 -52
  10. package/skills/design-planning/design-to-code/SKILL.md +0 -53
  11. package/skills/design-planning/enterprise-spec/SKILL.md +0 -54
  12. package/skills/design-planning/flutter-av/SKILL.md +0 -54
  13. package/skills/design-planning/flutter-map/SKILL.md +0 -54
  14. package/skills/design-planning/function-sdd/SKILL.md +0 -54
  15. package/skills/design-planning/sdd-code/SKILL.md +0 -347
  16. package/skills/design-planning/sdd-deploy/SKILL.md +0 -501
  17. package/skills/design-planning/sdd-ops/SKILL.md +0 -306
  18. package/skills/design-planning/sdd-test/SKILL.md +0 -383
  19. package/skills/design-planning/ui-sdd/SKILL.md +0 -291
  20. package/skills/design-planning/ui-sdd-specialized/SKILL.md +0 -56
  21. package/skills/design-planning/writing-plans/SKILL.md +0 -144
  22. package/skills/development-execution/flutter-errors/SKILL.md +0 -54
  23. package/skills/development-execution/sdd-add/SKILL.md +0 -540
  24. package/skills/development-execution/systematic-debugging/SKILL.md +0 -298
  25. package/skills/development-execution/test-driven-development/SKILL.md +0 -373
  26. package/skills/development-execution/verification-before-completion/SKILL.md +0 -141
  27. package/skills/knowledge-precipitation/claudeception/SKILL.md +0 -96
  28. package/skills/knowledge-precipitation/mempalace-auto-saver/SKILL.md +0 -302
  29. package/skills/quality-assurance/bdd-acceptance/SKILL.md +0 -56
  30. package/skills/quality-assurance/flutter-test/SKILL.md +0 -56
  31. package/skills/quality-assurance/quality-gate/SKILL.md +0 -350
  32. package/skills/quality-assurance/security-audit/SKILL.md +0 -386
  33. package/skills/release-ops/finishing-a-development-branch/SKILL.md +0 -202
  34. package/skills/release-ops/release-flow/SKILL.md +0 -404
  35. package/skills/requirement-analysis/brainstorming/SKILL.md +0 -166
  36. package/skills/requirement-analysis/competitive-brief/SKILL.md +0 -121
  37. package/skills/requirement-analysis/market-research/SKILL.md +0 -143
  38. package/skills/requirement-analysis/prd-write/SKILL.md +0 -111
  39. package/skills/requirement-analysis/requirement-completion-officer/SKILL.md +0 -124
  40. package/skills/requirement-analysis/sdd/SKILL.md +0 -1044
  41. package/skills/requirement-analysis/sdd-full/SKILL.md +0 -735
  42. package/skills/requirement-analysis/unified-flow/SKILL.md +0 -147
  43. package/skills/rules/project_rules.md +0 -167
  44. package/skills/rules/user_rules.md +0 -223
  45. package/skills/sdd-framework/API-SDD-template.md +0 -26
  46. package/skills/sdd-framework/Base-SDD-template.md +0 -36
  47. package/skills/sdd-framework/Brain-SDD-template.md +0 -29
  48. package/skills/sdd-framework/Code-SDD-template.md +0 -29
  49. package/skills/sdd-framework/Competitor-SDD-template.md +0 -38
  50. package/skills/sdd-framework/Env-SDD-template.md +0 -29
  51. package/skills/sdd-framework/PRD-SDD-template.md +0 -35
  52. package/skills/sdd-framework/SKILL.md +0 -82
  53. package/skills/sdd-framework/Test-SDD-template.md +0 -26
  54. package/skills/sdd-framework/UI-SDD-template.md +0 -31
  55. package/skills/sdd-framework/figma-spec.md +0 -27
  56. package/skills/sdd-framework/flow-charts.md +0 -99
  57. package/skills/sdd-framework/template-version.lock +0 -14
  58. package/skills/special-tools/env-check/SKILL.md +0 -53
  59. package/skills/special-tools/receiving-code-review/SKILL.md +0 -215
  60. package/skills/special-tools/requesting-code-review/SKILL.md +0 -107
  61. package/skills/special-tools/using-superpowers/SKILL.md +0 -117
  62. package/skills/templates/API-SDD.md +0 -31
  63. 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
  64. 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
  65. package/skills/templates/Base-SDD.md +0 -38
  66. package/skills/templates/Brain-SDD.md +0 -36
  67. package/skills/templates/Code-SDD.md +0 -41
  68. package/skills/templates/Competitor-SDD.md +0 -34
  69. package/skills/templates/Env-SDD.md +0 -37
  70. 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
  71. 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
  72. 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
  73. package/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md +0 -121
  74. package/skills/templates/PRD-SDD.md +0 -45
  75. package/skills/templates/SKILL.md +0 -29
  76. package/skills/templates/Test-SDD.md +0 -34
  77. package/skills/templates/UI-SDD.md +0 -38
  78. package/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -141
  79. 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
  80. 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
  81. package/skills/templates//345/212/237/350/203/275SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -132
  82. 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
  83. 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
  84. 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
  85. 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
  86. package/skills//346/212/200/350/203/275/344/275/277/347/224/250/346/214/207/345/215/227.md +0 -265
  87. package/skills//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md +0 -294
@@ -1,29 +0,0 @@
1
- # Env-SDD:[项目名称]环境配置
2
-
3
- ## 一、环境列表
4
- | 环境 | URL | 用途 |
5
- |------|-----|------|
6
- | [ ] | | |
7
-
8
- ## 二、权限配置
9
- - [ ]
10
-
11
- ## 三、SDK配置
12
- - [ ]
13
-
14
- ## 四、APIKey管理
15
- - [ ]
16
-
17
- ## 五、原生工程配置
18
- - [ ]
19
-
20
- ## 六、隐私配置
21
- - [ ]
22
-
23
- ## 七、敏感信息管理(不提交代码库)
24
- - [ ]
25
-
26
- ---
27
-
28
- **模板版本**: v4.1
29
- **适用技能**: sdd-deploy, sdd-ops
@@ -1,35 +0,0 @@
1
- # PRD-SDD:[项目名称]产品需求文档
2
-
3
- ## 一、需求背景
4
- - [ ] 来源:
5
- - [ ] 目的:
6
- - [ ] 优先级:
7
-
8
- ## 二、用户角色定义
9
- | 角色 | 描述 | 需求关注点 |
10
- |------|------|-----------|
11
- | [ ] | | |
12
-
13
- ## 三、用户旅程梳理
14
- - [ ]
15
-
16
- ## 四、功能范围界定
17
- - [ ] 包含:
18
- - [ ] 不包含:
19
-
20
- ## 五、需求补全清单
21
- - [ ]
22
-
23
- ## 六、主干流程
24
- - [ ]
25
-
26
- ## 七、架构&模块拆分(附录)
27
- - [ ]
28
-
29
- ## 八、验收标准
30
- - [ ]
31
-
32
- ---
33
-
34
- **模板版本**: v4.1
35
- **适用技能**: prd-write, requirement-completion-officer
@@ -1,82 +0,0 @@
1
- 【claude code调用标识:sdd-framework】【trae调用标识:sdd-framework+SDD融合框架】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目】
2
-
3
- ---
4
- name: sdd-framework
5
- description: SDD融合框架 - 9份标准化SDD模板,覆盖从全局基线到测试的全流程
6
- ---
7
-
8
- # SDD融合框架
9
-
10
- ## 概述
11
-
12
- 本框架提供9份标准化SDD模板,将头脑风暴、竞品分析、PRD、UI设计、代码实现、API设计、环境配置、测试设计等环节纳入文档化管理,形成纯文档闭环。
13
-
14
- ## 9份SDD模板
15
-
16
- | 模板名称 | 核心内容 | 适用技能 |
17
- |---------|---------|---------|
18
- | **Base-SDD** | 全局通用基线规范 | sdd, sdd-full |
19
- | **Brain-SDD** | 头脑风暴文档 | brainstorming |
20
- | **Competitor-SDD** | 竞品分析文档 | competitive-brief, market-research |
21
- | **PRD-SDD** | 产品需求文档 | prd-write, requirement-completion-officer |
22
- | **UI-SDD** | UI设计文档 | ui-sdd |
23
- | **Code-SDD** | 代码实现文档 | sdd-code, test-driven-development |
24
- | **API-SDD** | 接口设计文档 | sdd(接口拆分) |
25
- | **Env-SDD** | 环境配置文档 | sdd-deploy, sdd-ops |
26
- | **Test-SDD** | 测试设计文档 | sdd-test, test-driven-development |
27
-
28
- ## 强制顺序流水线
29
-
30
- ```
31
- 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
32
- ```
33
-
34
- ## 使用指南
35
-
36
- ### 新项目完整流程
37
- 1. 首先创建Base-SDD定义全局基线
38
- 2. Brain-SDD进行头脑风暴
39
- 3. Competitor-SDD进行竞品分析
40
- 4. PRD-SDD编写产品需求
41
- 5. Figma设计UI
42
- 6. 依次创建UI-SDD、Code-SDD、API-SDD、Env-SDD、Test-SDD
43
- 7. TDD开发、测试、发布
44
-
45
- ### Bug修复流程
46
- 1. systematic-debugging分析问题
47
- 2. 更新Test-SDD添加回归用例
48
- 3. sdd-add修复代码
49
- 4. verification-before-completion验证
50
- 5. quality-gate检查
51
- 6. claudeception沉淀经验
52
-
53
- ### 精简流程(小功能)
54
- 满足任意2条可使用精简流程:
55
- - 开发周期≤1天,代码量≤500行
56
- - 不涉及新接口、新UI组件
57
- - 无复杂交互,不影响全局流程
58
-
59
- ## 模板版本管理
60
-
61
- 所有模板采用版本化管理,通过`template-version.lock`文件记录版本信息,每个项目绑定固定版本,避免版本混乱。
62
-
63
- ## Figma接入规范
64
-
65
- - Figma链接失效时启用PDF/PNG备用文件
66
- - 关键截图需标注核心尺寸
67
- - UI-SDD中必须同时包含链接和备用文件
68
-
69
- ## AI协作规范
70
-
71
- | 阶段 | AI职责 | 人工校验要求 |
72
- |------|--------|-------------|
73
- | Brain-SDD | 发散想法、评估风险 | 确认想法合理性 |
74
- | Competitor-SDD | 收集竞品信息、对比差异 | 确认分析准确性 |
75
- | PRD-SDD | 补全需求、梳理用户旅程 | 必须人工二次确认 |
76
- | Code-SDD | 编写测试用例、排查Bug | 确认代码规范 |
77
- | 所有阶段 | 协助整理归档 | 校验完整性 |
78
-
79
- ---
80
-
81
- **模板版本**: v4.1
82
- **适用场景**: 个人+AI开发模式的完整文档化流程
@@ -1,26 +0,0 @@
1
- # Test-SDD:[测试模块名称]
2
-
3
- ## 一、测试策略
4
- - [ ]
5
-
6
- ## 二、测试用例
7
- | 用例ID | 测试场景 | 预期结果 |
8
- |--------|---------|---------|
9
- | [ ] | | |
10
-
11
- ## 三、测试数据
12
- - [ ]
13
-
14
- ## 四、测试覆盖率目标
15
- - [ ]
16
-
17
- ## 五、性能测试指标
18
- - [ ]
19
-
20
- ## 六、安全测试要点
21
- - [ ]
22
-
23
- ---
24
-
25
- **模板版本**: v4.1
26
- **适用技能**: sdd-test, test-driven-development
@@ -1,31 +0,0 @@
1
- # UI-SDD:[页面/组件名称]
2
-
3
- ## 一、页面/组件概述
4
- - [ ]
5
-
6
- ## 二、Figma链接
7
- - [ ] 设计稿:
8
- - [ ] 备用方案(PDF/PNG):
9
- - [ ] 关键截图:
10
-
11
- ## 三、页面结构
12
- - [ ]
13
-
14
- ## 四、组件清单
15
- | 组件名称 | 功能描述 | 状态 |
16
- |---------|---------|------|
17
- | [ ] | | |
18
-
19
- ## 五、交互流程
20
- - [ ]
21
-
22
- ## 六、状态设计
23
- - [ ]
24
-
25
- ## 七、设计规范(对齐Base-SDD)
26
- - [ ]
27
-
28
- ---
29
-
30
- **模板版本**: v4.1
31
- **适用技能**: ui-sdd
@@ -1,27 +0,0 @@
1
- # Figma接入规范
2
-
3
- ## 一、Figma源文件管理
4
- - 云端托管:统一存储到团队Figma空间
5
- - 文件命名:[项目名]-[模块名].fig
6
- - 版本管理:使用Figma版本历史功能
7
-
8
- ## 二、UI-SDD嵌入要求
9
- - 必须包含Figma设计稿链接
10
- - 关键页面/组件需附截图,标注核心尺寸(按钮大小、间距)
11
- - UI-SDD中必须同时包含链接和备用文件(PDF/PNG)
12
-
13
- ## 三、设计规范同步
14
- - Figma组件库版本与Base-SDD保持一致
15
- - 颜色/字体/间距规范从Base-SDD导入
16
- - 设计变更需同步更新UI-SDD
17
-
18
- ## 四、协作流程
19
- - 设计完成 → 评审 → 导出标注 → 更新UI-SDD → 开发
20
-
21
- ## 五、备用方案
22
- - Figma链接失效时启用PDF/PNG备用文件
23
- - 截图需保持清晰,标注必要的尺寸信息
24
-
25
- ---
26
-
27
- **适用技能**: ui-sdd
@@ -1,99 +0,0 @@
1
- # SDD融合流程图汇总
2
-
3
- ## 一、新项目完整流程
4
-
5
- ```
6
- ┌─────────────────────────────────────────────────────────────────┐
7
- │ 阶段0:全局基线 │
8
- ├─────────────────────────────────────────────────────────────────┤
9
- │ Base-SDD → 全局UI交互基线、弹窗/浮层规范、通用编码规范 │
10
- └─────────────────────────────────────────────────────────────────┘
11
-
12
- ┌─────────────────────────────────────────────────────────────────┐
13
- │ 阶段1:需求发散 │
14
- ├─────────────────────────────────────────────────────────────────┤
15
- │ Brain-SDD → 想法、点子、灵感、初步脑洞、废弃方案 │
16
- │ ↓ │
17
- │ Competitor-SDD → 竞品功能、交互、优缺点、可借鉴点、避坑点 │
18
- └─────────────────────────────────────────────────────────────────┘
19
-
20
- ┌─────────────────────────────────────────────────────────────────┐
21
- │ 阶段2:需求定义 │
22
- ├─────────────────────────────────────────────────────────────────┤
23
- │ PRD-SDD → 原始需求、用户场景、功能边界、需求补全 │
24
- │ ├─ 用户角色定义 │
25
- │ ├─ 用户旅程梳理 │
26
- │ ├─ 产品方案设计 │
27
- │ └─ 架构&模块拆分(附录) │
28
- └─────────────────────────────────────────────────────────────────┘
29
-
30
- ┌─────────────────────────────────────────────────────────────────┐
31
- │ 阶段3:技术设计 │
32
- ├─────────────────────────────────────────────────────────────────┤
33
- │ Figma设计 → 设计稿、组件库(对齐Base-SDD) │
34
- │ ↓ │
35
- │ UI-SDD → 页面结构、组件清单、交互流程、内嵌Figma链接 │
36
- │ ↓ │
37
- │ Code-SDD → 代码结构、函数定义、数据模型、代码规范 │
38
- │ ↓ │
39
- │ API-SDD → 接口定义、参数、返回值、错误码、契约版本 │
40
- │ ↓ │
41
- │ Env-SDD → 环境配置、权限、SDK、APIKey、原生工程配置 │
42
- │ ↓ │
43
- │ Test-SDD → 测试用例、测试策略、测试数据 │
44
- └─────────────────────────────────────────────────────────────────┘
45
-
46
- ┌─────────────────────────────────────────────────────────────────┐
47
- │ 阶段4:开发执行 │
48
- ├─────────────────────────────────────────────────────────────────┤
49
- │ TDD开发 → 按Test-SDD实施,测试先行 │
50
- │ ↓ │
51
- │ 分层测试 → 单元/UI/真机/E2E │
52
- │ ↓ │
53
- │ Bug闭环 → systematic-debugging → sdd-add │
54
- └─────────────────────────────────────────────────────────────────┘
55
-
56
- ┌─────────────────────────────────────────────────────────────────┐
57
- │ 阶段5:发布归档 │
58
- ├─────────────────────────────────────────────────────────────────┤
59
- │ quality-gate → 质量门禁检查 │
60
- │ ↓ │
61
- │ sdd-deploy → 打包、发布、部署流程 │
62
- │ ↓ │
63
- │ release-flow → 版本发布 │
64
- │ ↓ │
65
- │ claudeception → 经验沉淀 │
66
- └─────────────────────────────────────────────────────────────────┘
67
- ```
68
-
69
- ## 二、功能新增流程
70
-
71
- ```
72
- PRD-SDD补充 → Figma更新 → UI-SDD补充 → Code-SDD补充 → API-SDD补充 → Env-SDD补充 → Test-SDD补充 → sdd-add → verification-before-completion → quality-gate → release-flow
73
- ```
74
-
75
- ## 三、Bug修复流程
76
-
77
- ```
78
- systematic-debugging → Test-SDD补充回归用例 → sdd-add修复 → verification-before-completion → quality-gate → claudeception
79
- ```
80
-
81
- ## 四、快速迭代流程
82
-
83
- ```
84
- requirement-completion-officer(可选) → writing-plans(可选) → sdd-add → verification-before-completion → quality-gate → finishing-a-development-branch(可选) → 简单发布
85
- ```
86
-
87
- ## 五、技能映射关系
88
-
89
- | SDD模板 | 对应技能 |
90
- |---------|---------|
91
- | Base-SDD | sdd, sdd-full |
92
- | Brain-SDD | brainstorming |
93
- | Competitor-SDD | competitive-brief, market-research |
94
- | PRD-SDD | prd-write, requirement-completion-officer |
95
- | UI-SDD | ui-sdd |
96
- | Code-SDD | sdd-code, test-driven-development |
97
- | API-SDD | sdd(接口拆分) |
98
- | Env-SDD | sdd-deploy, sdd-ops |
99
- | Test-SDD | sdd-test, test-driven-development |
@@ -1,14 +0,0 @@
1
- {
2
- "templateVersion": "v4.1",
3
- "projectBind": {
4
- "个人备忘录APP": "v4.1",
5
- "简易记账工具": "v3.0"
6
- },
7
- "updateLog": [
8
- {
9
- "version": "v4.1",
10
- "updateTime": "2026-05-06",
11
- "updateContent": "skill选项式设计、全流程融合、AI协作规范、技能映射优化"
12
- }
13
- ]
14
- }
@@ -1,53 +0,0 @@
1
- name: 环境预检标准化SDD
2
- description: 本机配置、依赖版本、网络连接预检固定话术与流程规范
3
- author:
4
- version: 1.0.0
5
- trigger:
6
- - 环境预检
7
- - 环境检查
8
- - 依赖检查
9
- tags:
10
- - 环境配置
11
- - 预检流程
12
- - 开发环境
13
-
14
- 【claude code调用标识:环境预检标准化SDD】【trae调用标识:环境预检标准化SDD+环境检查】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
15
-
16
- ## 功能描述
17
-
18
- 本技能提供环境预检标准化流程,包含本机配置、依赖版本、网络连接的检查清单和流程规范,帮助团队快速验证开发环境。
19
-
20
- ## 调用方式
21
-
22
- ### Claude Code调用
23
- ```
24
- 调用 环境预检标准化SDD 项目名称=个人备忘录APP
25
- ```
26
-
27
- ### Trae调用
28
- ```
29
- trae调用 环境预检标准化SDD 项目名称=个人备忘录APP 环境类型=development 流程场景=从零开始新项目
30
- ```
31
-
32
- ## 参数说明
33
-
34
- | 参数名 | 类型 | 必填 | 说明 |
35
- |--------|------|------|------|
36
- | 项目名称 | string | 是 | 项目名称 |
37
- | 环境类型 | string | 否 | development/test/production |
38
-
39
- ## 输出内容
40
-
41
- 1. 本机配置检查(OS版本、IDE版本、依赖工具)
42
- 2. 依赖版本检查(语言环境、第三方SDK)
43
- 3. 网络连接检查(网络可用性、API连通性)
44
- 4. 工程配置检查(pubspec、密钥、环境变量)
45
- 5. 预检流程(自动脚本、手动清单、修复指南)
46
- 6. 预检报告(结果汇总、问题清单、修复建议)
47
-
48
- ## 适用场景
49
-
50
- - 项目启动前环境检查
51
- - Bug排查时环境验证
52
- - 团队协作环境统一
53
- - CI/CD流程集成
@@ -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
- 无表演性同意。始终保持技术严谨。