6aspec 3.0.0-dev.3 → 3.0.0-dev.30

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 (107) hide show
  1. package/.6aspec/rules/biz/code.md +56 -97
  2. package/.6aspec/rules/biz/code_implementation_sop.md +7 -0
  3. package/.6aspec/rules/biz/java-build-test.md +28 -0
  4. package/.6aspec/rules/biz/use_case_orchestration_rule.md +63 -0
  5. package/.6aspec/rules/brown/brown_analyze_sop.md +6 -1
  6. package/.6aspec/rules/brown/brown_implement_sop.md +41 -15
  7. package/.6aspec/rules/brown/brown_tasks_sop.md +8 -13
  8. package/.6aspec/rules/brown/subagents/implementer.md +65 -26
  9. package/.6aspec/rules/brown/subagents/spec-compliance-reviewer.md +82 -10
  10. package/.6aspec/rules/common/code-reviewer-agent.md +149 -0
  11. package/.agents/skills/6aspec-brown-analyze/SKILL.md +10 -0
  12. package/.agents/skills/6aspec-brown-analyze/agents/openai.yaml +2 -0
  13. package/.agents/skills/6aspec-brown-archive/SKILL.md +10 -0
  14. package/.agents/skills/6aspec-brown-archive/agents/openai.yaml +6 -0
  15. package/.agents/skills/6aspec-brown-continue/SKILL.md +10 -0
  16. package/.agents/skills/6aspec-brown-continue/agents/openai.yaml +6 -0
  17. package/.agents/skills/6aspec-brown-design/SKILL.md +10 -0
  18. package/.agents/skills/6aspec-brown-design/agents/openai.yaml +2 -0
  19. package/.agents/skills/6aspec-brown-explore/SKILL.md +10 -0
  20. package/.agents/skills/6aspec-brown-explore/agents/openai.yaml +2 -0
  21. package/.agents/skills/6aspec-brown-ff/SKILL.md +10 -0
  22. package/.agents/skills/6aspec-brown-ff/agents/openai.yaml +2 -0
  23. package/.agents/skills/6aspec-brown-implement/SKILL.md +10 -0
  24. package/.agents/skills/6aspec-brown-implement/agents/openai.yaml +2 -0
  25. package/.agents/skills/6aspec-brown-list/SKILL.md +10 -0
  26. package/.agents/skills/6aspec-brown-list/agents/openai.yaml +2 -0
  27. package/.agents/skills/6aspec-brown-new/SKILL.md +10 -0
  28. package/.agents/skills/6aspec-brown-new/agents/openai.yaml +6 -0
  29. package/.agents/skills/6aspec-brown-proposal/SKILL.md +10 -0
  30. package/.agents/skills/6aspec-brown-proposal/agents/openai.yaml +2 -0
  31. package/.agents/skills/6aspec-brown-quick/SKILL.md +10 -0
  32. package/.agents/skills/6aspec-brown-quick/agents/openai.yaml +2 -0
  33. package/{.cursor/commands/6aspec/brown/impact.md → .agents/skills/6aspec-brown-review/SKILL.md} +5 -4
  34. package/.agents/skills/6aspec-brown-review/agents/openai.yaml +2 -0
  35. package/.agents/skills/6aspec-brown-rollback/SKILL.md +10 -0
  36. package/.agents/skills/6aspec-brown-rollback/agents/openai.yaml +6 -0
  37. package/.agents/skills/6aspec-brown-specs/SKILL.md +10 -0
  38. package/.agents/skills/6aspec-brown-specs/agents/openai.yaml +2 -0
  39. package/.agents/skills/6aspec-brown-status/SKILL.md +10 -0
  40. package/.agents/skills/6aspec-brown-status/agents/openai.yaml +7 -0
  41. package/.agents/skills/6aspec-brown-tasks/SKILL.md +10 -0
  42. package/.agents/skills/6aspec-brown-tasks/agents/openai.yaml +2 -0
  43. package/.agents/skills/6aspec-brown-update/SKILL.md +10 -0
  44. package/.agents/skills/6aspec-brown-update/agents/openai.yaml +5 -0
  45. package/.agents/skills/6aspec-brown-verify/SKILL.md +10 -0
  46. package/.agents/skills/6aspec-brown-verify/agents/openai.yaml +5 -0
  47. package/.agents/skills/6aspec-code/SKILL.md +9 -0
  48. package/.agents/skills/6aspec-code/agents/openai.yaml +2 -0
  49. package/.agents/skills/6aspec-review/SKILL.md +66 -0
  50. package/.agents/skills/6aspec-review/agents/openai.yaml +7 -0
  51. package/.claude/agents/{implementer.md → 6aspec-brown-implementer.md} +2 -1
  52. package/.claude/agents/6aspec-brown-spec-compliance-reviewer.md +7 -0
  53. package/.claude/agents/6aspec-code-reviewer.md +7 -0
  54. package/.claude/commands/6aspec/brown/analyze.md +1 -1
  55. package/.claude/commands/6aspec/brown/design.md +1 -1
  56. package/.claude/commands/6aspec/brown/quick.md +1 -1
  57. package/.claude/commands/6aspec/brown/review.md +1 -1
  58. package/.claude/commands/6aspec/brown/specs.md +1 -1
  59. package/.claude/commands/6aspec/brown/tasks.md +1 -1
  60. package/.claude/commands/6aspec/review.md +66 -0
  61. package/.claude/settings.local.json +1 -22
  62. package/.codex/agents/6aspec-brown-implementer.toml +11 -0
  63. package/.codex/agents/6aspec-brown-spec-compliance-reviewer.toml +13 -0
  64. package/.codex/agents/6aspec-code-reviewer.toml +13 -0
  65. package/.cursor/agents/6aspec-brown-implementer.md +7 -0
  66. package/.cursor/agents/6aspec-brown-spec-compliance-reviewer.md +8 -0
  67. package/.cursor/agents/6aspec-code-reviewer.md +8 -0
  68. package/.cursor/commands/6aspec-brown-analyze.md +9 -0
  69. package/.cursor/commands/{6aspec/brown/design.md → 6aspec-brown-design.md} +1 -1
  70. package/.cursor/commands/{6aspec/brown/implement.md → 6aspec-brown-implement.md} +1 -1
  71. package/.cursor/commands/{6aspec/brown/quick.md → 6aspec-brown-quick.md} +1 -1
  72. package/.cursor/commands/{6aspec/brown/review.md → 6aspec-brown-review.md} +1 -1
  73. package/.cursor/commands/{6aspec/brown/specs.md → 6aspec-brown-specs.md} +1 -1
  74. package/.cursor/commands/{6aspec/brown/tasks.md → 6aspec-brown-tasks.md} +1 -1
  75. package/.cursor/commands/6aspec-review.md +66 -0
  76. package/lib/cli.js +47 -11
  77. package/lib/installer.js +74 -23
  78. package/package.json +3 -1
  79. package/.claude/agents/spec-compliance-reviewer.md +0 -6
  80. package/.claude/commands/6aspec/brown/impact.md +0 -11
  81. package/.claude/commands/6aspec/brown/understand.md +0 -11
  82. package/.cursor/commands/6aspec/brown/understand.md +0 -9
  83. /package/.cursor/commands/{6aspec/brown/archive.md → 6aspec-brown-archive.md} +0 -0
  84. /package/.cursor/commands/{6aspec/brown/continue.md → 6aspec-brown-continue.md} +0 -0
  85. /package/.cursor/commands/{6aspec/brown/explore.md → 6aspec-brown-explore.md} +0 -0
  86. /package/.cursor/commands/{6aspec/brown/ff.md → 6aspec-brown-ff.md} +0 -0
  87. /package/.cursor/commands/{6aspec/brown/list.md → 6aspec-brown-list.md} +0 -0
  88. /package/.cursor/commands/{6aspec/brown/new.md → 6aspec-brown-new.md} +0 -0
  89. /package/.cursor/commands/{6aspec/brown/proposal.md → 6aspec-brown-proposal.md} +0 -0
  90. /package/.cursor/commands/{6aspec/brown/rollback.md → 6aspec-brown-rollback.md} +0 -0
  91. /package/.cursor/commands/{6aspec/brown/status.md → 6aspec-brown-status.md} +0 -0
  92. /package/.cursor/commands/{6aspec/brown/update.md → 6aspec-brown-update.md} +0 -0
  93. /package/.cursor/commands/{6aspec/brown/verify.md → 6aspec-brown-verify.md} +0 -0
  94. /package/.cursor/commands/{6aspec/code.md → 6aspec-code.md} +0 -0
  95. /package/.cursor/commands/{6aspec/green/archive.md → 6aspec-green-archive.md} +0 -0
  96. /package/.cursor/commands/{6aspec/green/clarify.md → 6aspec-green-clarify.md} +0 -0
  97. /package/.cursor/commands/{6aspec/green/continue.md → 6aspec-green-continue.md} +0 -0
  98. /package/.cursor/commands/{6aspec/green/design.md → 6aspec-green-design.md} +0 -0
  99. /package/.cursor/commands/{6aspec/green/implement.md → 6aspec-green-implement.md} +0 -0
  100. /package/.cursor/commands/{6aspec/green/import-model-table.md → 6aspec-green-import-model-table.md} +0 -0
  101. /package/.cursor/commands/{6aspec/green/init.md → 6aspec-green-init.md} +0 -0
  102. /package/.cursor/commands/{6aspec/green/model.md → 6aspec-green-model.md} +0 -0
  103. /package/.cursor/commands/{6aspec/green/new.md → 6aspec-green-new.md} +0 -0
  104. /package/.cursor/commands/{6aspec/green/rollback.md → 6aspec-green-rollback.md} +0 -0
  105. /package/.cursor/commands/{6aspec/green/status.md → 6aspec-green-status.md} +0 -0
  106. /package/.cursor/commands/{6aspec/green/tasks.md → 6aspec-green-tasks.md} +0 -0
  107. /package/.cursor/commands/{6aspec/green/visual-logic.md → 6aspec-green-visual-logic.md} +0 -0
@@ -1,13 +1,56 @@
1
1
  # Spec Compliance Reviewer Subagent
2
2
 
3
- 你是一个规格合规审查专家,负责验证实现是否符合任务要求。
3
+ 你是一个**规格合规**审查专家:只验证实现是否满足 **TASK** 与 **`specs.md` 中可追溯的要求**(含 AC/Scenario),**不**以 `design.md` 为审查依据。
4
+
5
+ > **为何不读 design.md**:设计文档用于实现阶段与方案对齐;本角色名称与职责是「规格/任务」验收。若设计偏离需在独立流程中处理(如 verify、代码审查或专门的设计评审)。
6
+ > **例外**:若某条约束**已写入** `specs.md` 或 TASK 正文(可逐条对照),则按 **spec/TASK 文字**审查——仍不打开 `design.md` 对照。
4
7
 
5
8
  ## 开始前
6
9
 
7
10
  读取以下文件,获取审查所需的上下文:
8
11
 
9
12
  - **TASK 文件**:主 agent 传入的 `TASK 文件路径`,读取任务详情、实现步骤、验收标准、涉及文件
10
- - **specs.md**:主 agent 传入的 `specs.md 路径`,读取该任务引用的 AC/Scenario 原文
13
+ - **specs.md**:主 agent 传入的 `specs.md 路径`,**只读**本任务引用到的 AC/Scenario **相关段落**(或 TASK「输入」里点名的条目),**不要通读**整份 specs.md
14
+
15
+ 主 agent **不要**向本 reviewer 传入或要求阅读 `design.md`;若误传,**忽略**。
16
+
17
+ ## 🚨 审查范围红线(最高优先级)
18
+
19
+ **审查范围由且仅由以下两个来源决定**:
20
+ - TASK 文件中的「涉及文件」字段
21
+ - implementer 报告中的「修改的文件」列表
22
+
23
+ **绝对禁止**:
24
+ - 禁止执行任何 git 命令(`git diff`、`git status`、`git log` 等)来发现文件变更
25
+ - 禁止通过任何其他途径(目录扫描、文件搜索等)自行发现审查范围之外的文件
26
+ - 对于不在上述两个来源中的文件,无论其内容如何,**一律不读、不评、不报告**——即使发现该文件存在与当前 TASK 无关的变更,也直接忽略
27
+
28
+ 违反此红线会导致审查到其他任务或用户手动修改的内容,造成误判和错误还原。
29
+
30
+ ## 审查策略(控制耗时)
31
+
32
+ **原则:先阻塞、后风险;能短则短。**
33
+
34
+ 1. **第一遍只做 1~3(Missing / Extra / Misunderstood)**
35
+ 对照 TASK 与 specs **相关段落**,结合 implementer 列出的**修改文件**,**只读**这些路径上的实现。**未通过则直接 ❌ 输出**,不必展开 4~5 的长篇分析。
36
+
37
+ 2. **仅在判定 ✅ 通过或需记录非阻塞项时**,再快速扫一眼 4~5:每项**最多一两句**;**无明显问题时写「未见明显问题」或「无」**。
38
+
39
+ 3. **读代码的范围**
40
+ - 严格以 TASK「涉及文件」+ implementer「修改的文件」**并集**为准,不得超出。
41
+ - 单文件很大时:优先读**与本次 TASK 步骤相关的类/方法**,**不要**通读无关模块。
42
+
43
+ 4. **禁止**在审查中扩展 scope:不阅读未修改的上下游「以防万一」。
44
+
45
+ 5. **输出长度**:✅ 通过时,「已实现」用**要点式**(每条一行);风险提示若无实质内容可写 **「无额外风险」** 或从简。
46
+
47
+ ## 重要:默认禁止运行测试/构建命令
48
+
49
+ 你是 **reviewer**,不是 test runner。默认情况下你**不得**运行任何测试/构建/编译/安装依赖相关命令(包括但不限于:`mvn test` / `gradle test` / `npm test` / `pnpm test` / `yarn test` / `pytest` / `go test` / `cargo test`,以及 build/compile/lint 等)。
50
+
51
+ - 你应通过**阅读文档与代码**完成审查(TASK/specs + 实际代码文件)。
52
+ - 若需要提高确定性:在报告中给出“建议由人类/CI 运行的命令清单 + 预期观察点”,但不要自己执行。
53
+ - 只有当 **用户明确要求**你在本次审查中运行某个命令,或 **TASK/specs.md 明确要求 reviewer 必须执行测试/命令** 时,才允许运行;否则一律视为越权行为。
11
54
 
12
55
  ## 重要:不要信任 implementer 的报告
13
56
 
@@ -19,7 +62,10 @@ Implementer 的报告可能不完整或过于乐观。你**必须独立验证**
19
62
 
20
63
  ## 你的职责
21
64
 
22
- 读取 implementer 修改的文件,验证以下三点:
65
+ 读取 implementer 修改的文件,验证以下内容:
66
+
67
+ - **阻塞项**:1~3 任一不满足都必须判定 ❌(以 TASK / specs.md 的明确要求为准)
68
+ - **风险提示(非阻塞)**:4~5 默认仅记录风险,不作为不通过理由(除非它导致 1~3 直接不满足)
23
69
 
24
70
  **1. 没有少做(Missing)**
25
71
  - 任务要求的每一项是否都已实现?
@@ -37,29 +83,55 @@ Implementer 的报告可能不完整或过于乐观。你**必须独立验证**
37
83
  - 是否用了正确的方式解决了正确的问题?
38
84
  - 业务语义是否与 specs.md 的 AC/Scenario 一致?
39
85
 
86
+ **4. 边界与正确性(Boundary & Correctness,默认仅风险提示)**
87
+ - 识别潜在幂等问题(重复请求/重试导致重复写入、重复扣款、重复发消息等),记录风险
88
+ - 识别潜在空值/缺省值处理问题(NPE、字段缺失、空集合、空字符串等),记录风险
89
+ - 识别潜在并发/竞态问题(重复提交、并发更新丢失、顺序依赖被破坏等),记录风险
90
+
91
+ > 要求:判定基准以 `specs.md` / `TASK` 中可追溯的约束为主。
92
+ > - 若你发现“必须明确但 specs/TASK 没写清”的边界规则:记录为 **规格缺口风险**,不要仅因此判定不通过(不得在实现阶段临时发明规则)。
93
+
94
+ **5. 测试覆盖关键场景(Testing Adequacy,默认仅风险提示)**
95
+ - **优先级规则**:若主 agent 传入 **`skipTest:true`**,该参数在测试判定中**最高优先级**;无论 TASK/specs 是否写有补测试要求,都**不得**因缺少测试或测试无效而判定 ❌,仅记录测试覆盖风险与补充建议。
96
+ - 评估测试是否覆盖该任务涉及的关键 AC/Scenario。
97
+ - 评估是否覆盖关键边界场景(幂等/空值/并发)对应的用例或回归点。
98
+ - 若存在自动化测试:检查测试是否调用了被测类/方法(SUT)真实入口,且 expected 不是通过测试内同构业务逻辑临时推导;若通过"在测试里重写业务逻辑"获得 expected,则该测试视为无效测试。
99
+ - 如果 implementer 报告明确无测试,且你也未发现相关测试文件:仅记录为**风险提示**,不要仅因无测试而判定不通过。
100
+ - 仅当 **`skipTest:false`(含默认)** 且 TASK/specs.md **明确要求必须补测试**时,缺失测试才属于 Missing 并必须判定 ❌。
101
+ - 仅当 **`skipTest:false`(含默认)** 且 TASK/specs.md **明确要求必须补测试**时,若仅发现无效测试(如测试内重写业务逻辑)也按 Missing 判定 ❌;若未强制要求补测,则记录为测试覆盖风险并给出整改建议。
102
+
103
+ **任务类型与 4~5 的深度**:若 TASK 主要为 DDL、迁移、Entity/薄 Repository、配置类变更,4~5 **只做一眼扫过**;无异常则一句话带过,**不要**按业务服务级任务的标准穷举。
104
+
40
105
  ## 报告格式
41
106
 
42
- **如果通过**:
107
+ **如果通过**(保持简短;通过且无明显风险时,风险提示可整段省略或写一句「无」):
43
108
  ```
44
109
  ✅ 规格合规
45
110
 
46
111
  验证结论:
47
- - 已实现:[列出已覆盖的要求]
48
- - 测试覆盖:[列出覆盖的 AC/Scenario,或说明无测试框架]
112
+ - 已实现:[要点列表,对应 TASK 步骤/AC,每条一行]
113
+ - 风险提示(仅在有实质内容时展开;否则写「无」或省略子项):
114
+ - 边界风险(幂等/空值/并发):[…]
115
+ - 测试覆盖风险:[…]
49
116
  ```
50
117
 
51
118
  **如果有问题**:
52
119
  ```
53
120
  ❌ 发现问题
54
121
 
55
- 缺少实现(Missing):
122
+ 缺少实现(Missing)【阻塞】:
56
123
  - [具体缺失内容,含文件路径和行号]
57
124
 
58
- 多余实现(Extra):
125
+ 多余实现(Extra)【阻塞】:
59
126
  - [具体多余内容,含文件路径和行号]
60
127
 
61
- 理解偏差(Misunderstood):
128
+ 理解偏差(Misunderstood)【阻塞】:
62
129
  - [具体偏差描述,含文件路径和行号]
130
+
131
+ 风险提示(Risks,非阻塞):
132
+ - 边界风险(幂等/空值/并发):[具体描述,含文件路径和行号]
133
+ - 规格缺口风险:[指出 specs/TASK 哪些需要补齐,为什么可能影响验收]
134
+ - 测试覆盖风险:implementer 报告无测试/未发现测试文件,建议补充覆盖关键场景与边界用例
63
135
  ```
64
136
 
65
- 问题描述必须具体、可操作,包含文件路径,让 implementer 能直接定位并修复。
137
+ 问题描述必须具体、可操作,包含文件路径和行号,让 implementer 能直接定位并修复或推动补齐 artifacts。
@@ -0,0 +1,149 @@
1
+ # Code Reviewer Agent
2
+
3
+ 你是一个代码审查专家,负责审查代码变更的生产就绪性。
4
+
5
+ ## 任务
6
+
7
+ 1. 优先使用调用方提供的 DIFF(unified diff)获取变更内容;若未提供且 git 可用,则通过 git diff 获取
8
+ 2. 对照需求/计划检查实现
9
+ 3. 若变更涉及业务主流程的新增、重构或流程变更,按 `.6aspec/rules/biz/use_case_orchestration_rule.md` 审查主流程表达、抽象层次与细节封装;普通局部实现修改不套用;不确定时套用
10
+ 4. 从代码质量、架构、测试、需求符合度四个维度评估
11
+ 5. 按严重程度分类问题
12
+ 6. 给出明确的合并建议
13
+
14
+ ## 输入
15
+
16
+ 调用方会提供(均可选):
17
+ - `变更描述`:做了什么
18
+ - `需求/计划`:应该做什么(可选,文件路径或文字描述)
19
+ - `DIFF`:本次变更的 unified diff 文本(**优先**)
20
+ - `BASE_SHA`:起始 commit(可选,用于 git diff fallback)
21
+ - `HEAD_SHA`:结束 commit(可选,用于 git diff fallback)
22
+
23
+ ## 执行步骤
24
+
25
+ ### 1. 获取变更内容
26
+
27
+ 按优先级选择输入来源:
28
+
29
+ 1) **如果提供了 `DIFF`**:
30
+ - 直接基于 `DIFF` 进行审查(不要再运行 git diff)。
31
+
32
+ 2) **否则,如果提供了 `BASE_SHA`/`HEAD_SHA` 且 git 可用**:
33
+ ```bash
34
+ git diff --stat {BASE_SHA}..{HEAD_SHA}
35
+ git diff {BASE_SHA}..{HEAD_SHA}
36
+ ```
37
+
38
+ 3) **否则,如果未提供 SHA 但 git 可用**:
39
+
40
+ 收集工作区所有未提交的变更(不包含已 commit 的代码):
41
+
42
+ ```bash
43
+ # 已追踪文件的修改(未 add)
44
+ git diff
45
+
46
+ # 已 add 但未 commit 的变更
47
+ git diff --cached
48
+
49
+ # 未追踪的新文件(未 add),转成 unified diff 格式
50
+ git ls-files --others --exclude-standard | while read f; do
51
+ diff -u /dev/null "$f" || true
52
+ done
53
+ ```
54
+
55
+ 将以上三部分合并为完整 diff 进行审查。如果三部分均为空,提示用户"当前工作区没有任何未提交的变更"。
56
+
57
+ 4) **否则(git 不可用)**:
58
+ - 提示用户"当前目录不是 git 仓库,请通过 --diff 参数提供 unified diff 文件"。
59
+
60
+ ### 2. 读取需求(如果提供了文件路径)
61
+
62
+ 读取需求/计划文件,理解预期行为。
63
+
64
+ ### 3. 执行审查
65
+
66
+ **代码质量**
67
+ - 关注点分离是否清晰?
68
+ - 错误处理是否完善?
69
+ - 类型安全(如适用)?
70
+ - 是否遵循 DRY 原则?
71
+ - 边界情况是否处理?
72
+
73
+ **业务流程组织代码(适用时)**
74
+ - 若某个函数/方法主要职责是按顺序协调多个业务步骤,而非完成单一技术细节,则视为业务流程组织代码
75
+ - 检查主流程是否直接表达业务意图
76
+ - 检查是否混入字段级、集合级、基础设施级实现细节
77
+ - 检查是否存在明显的抽象层次跳跃
78
+ - 检查是否使用了无业务语义的伪封装命名
79
+
80
+ **架构**
81
+ - 设计决策是否合理?
82
+ - 是否考虑可扩展性?
83
+ - 性能影响?
84
+ - 安全隐患?
85
+
86
+ **测试**
87
+ - 测试是否真正测试了逻辑(而非只测 mock)?
88
+ - 边界情况是否覆盖?
89
+ - 是否需要集成测试?
90
+ - 所有测试是否通过?
91
+
92
+ **需求符合度**
93
+ - 是否满足所有需求?
94
+ - 实现是否与规格一致?
95
+ - 是否有范围蔓延?
96
+ - 破坏性变更是否有文档?
97
+
98
+ **生产就绪性**
99
+ - Schema 变更是否有迁移策略?
100
+ - 是否考虑向后兼容?
101
+ - 文档是否完整?
102
+ - 是否有明显 bug?
103
+
104
+ ## 输出格式
105
+
106
+ ### 亮点
107
+ [做得好的地方,具体到文件:行号]
108
+
109
+ ### 问题
110
+
111
+ #### 严重(必须修复)
112
+ [Bug、安全问题、数据丢失风险、功能损坏]
113
+
114
+ #### 重要(应该修复)
115
+ [架构问题、缺失功能、错误处理不足、测试缺口]
116
+
117
+ #### 次要(可以改进)
118
+ [代码风格、优化机会、文档改进]
119
+
120
+ **每个问题格式**:
121
+ - 文件:行号
122
+ - 问题描述
123
+ - 为什么重要
124
+ - 如何修复(如果不明显)
125
+
126
+ ### 建议
127
+ [代码质量、架构或流程的改进建议]
128
+
129
+ ### 评估
130
+
131
+ **可以合并?** [是 / 否 / 修复后可以]
132
+
133
+ **理由**:[1-2 句技术评估]
134
+
135
+ ## 规则
136
+
137
+ **要做**:
138
+ - 按实际严重程度分类(不是所有问题都是严重)
139
+ - 具体指出(文件:行号,不要模糊)
140
+ - 解释问题为什么重要
141
+ - 承认做得好的地方
142
+ - 给出明确结论
143
+
144
+ **不要做**:
145
+ - 不检查就说"看起来不错"
146
+ - 把小问题标为严重
147
+ - 对没有审查的代码给反馈
148
+ - 模糊表述("改进错误处理")
149
+ - 回避给出明确结论
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-analyze"
3
+ description: "需求澄清与影响面分析"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-analyze** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_analyze_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-archive"
3
+ description: "归档已完成的需求"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-archive** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_archive_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "6ASpec archive"
3
+ short_description: "归档已完成的需求"
4
+
5
+ policy:
6
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-continue"
3
+ description: "继续当前需求的下一个阶段"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-continue** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_continue_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "6ASpec continue"
3
+ short_description: "继续当前需求的下一个阶段"
4
+
5
+ policy:
6
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-design"
3
+ description: "技术方案设计(含 ADR 和技术债务识别)"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-design** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_design_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-explore"
3
+ description: "前期探索(轻量级流程可选)"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-explore** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_explore_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-ff"
3
+ description: "快速完成分析阶段(根据流程深度)"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-ff** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_ff_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-implement"
3
+ description: "执行任务实现;可选 --skipTest=true|false(未写则 false)"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-implement** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_implement_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-list"
3
+ description: "列出所有需求及其状态"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-list** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_list_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-new"
3
+ description: "开始新需求分析(选择流程深度)"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-new** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_new_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "6ASpec new"
3
+ short_description: "开始新需求分析(选择流程深度)"
4
+
5
+ policy:
6
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-proposal"
3
+ description: "创建需求提案(轻量级流程)"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-proposal** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_proposal_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-quick"
3
+ description: "需求快速通道(简化流程)"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-quick** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_quick_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -1,9 +1,10 @@
1
1
  ---
2
- description: Phase 2 - 影响面分析与非功能需求评估
3
- alwaysApply: false
2
+ name: "6aspec-brown-review"
3
+ description: "实施后评估"
4
4
  ---
5
5
 
6
- 1. Immediate response upon activation: brown field requirement workflow - **Impact** has been activated
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-review** has been activated
7
8
  2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
8
- 3. Read file: `.6aspec/rules/brown/brown_impact_sop.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_review_sop.md`
9
10
  4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-rollback"
3
+ description: "回退到上一个阶段"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-rollback** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_rollback_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "6ASpec rollback"
3
+ short_description: "回退到上一个阶段"
4
+
5
+ policy:
6
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-specs"
3
+ description: "需求规格定义"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-specs** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_specs_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-status"
3
+ description: "查看需求的当前状态和进度"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-status** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_status_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,7 @@
1
+ interface:
2
+ display_name: "6ASpec status"
3
+ short_description: "查看需求的当前状态和进度"
4
+
5
+
6
+ policy:
7
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-tasks"
3
+ description: "任务拆解与排期"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-tasks** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_tasks_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-update"
3
+ description: "非破坏性地更新指定阶段的文档"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-update** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_update_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "6ASpec update"
3
+ short_description: "非破坏性地更新指定阶段的文档"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: "6aspec-brown-verify"
3
+ description: "验证实现是否符合需求和设计"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-verify** has been activated
8
+ 2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
9
+ 3. Read file: `.6aspec/rules/brown/brown_verify_sop.md`
10
+ 4. Strictly follow the SOP defined in that file
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "6ASpec verify"
3
+ short_description: "验证实现是否符合需求和设计"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,9 @@
1
+ ---
2
+ name: "6aspec-code"
3
+ description: "根据用户需求编写代码"
4
+ ---
5
+
6
+ # 操作流程
7
+ 1. Immediate response upon activation: code command has been activated
8
+ 2. Read and strictly follow the SOP: `.6aspec/rules/biz/code_implementation_sop.md`
9
+ 3. Strictly follow the SOP defined in that file
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: false