universal-dev-standards 6.7.5 → 6.9.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 (213) hide show
  1. package/bin/uds.js +19 -2
  2. package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +14 -2
  3. package/bundled/ai/standards/adr-standards.ai.yaml +14 -2
  4. package/bundled/ai/standards/ai-instruction-standards.ai.yaml +6 -6
  5. package/bundled/ai/standards/code-review.ai.yaml +13 -3
  6. package/bundled/ai/standards/commit-message.ai.yaml +8 -4
  7. package/bundled/ai/standards/deferred-item-exit.ai.yaml +225 -0
  8. package/bundled/ai/standards/feature-discovery-standards.ai.yaml +14 -2
  9. package/bundled/ai/standards/governance-layer.ai.yaml +128 -2
  10. package/bundled/ai/standards/logging.ai.yaml +2 -2
  11. package/bundled/ai/standards/retrospective-standards.ai.yaml +14 -2
  12. package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +73 -2
  13. package/bundled/ai/standards/security-standards.ai.yaml +2 -2
  14. package/bundled/ai/standards/spec-driven-development.ai.yaml +14 -2
  15. package/bundled/ai/standards/tech-debt-standards.ai.yaml +87 -3
  16. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +131 -0
  17. package/bundled/core/acceptance-criteria-traceability.md +5 -2
  18. package/bundled/core/adr-standards.md +26 -2
  19. package/bundled/core/ai-instruction-standards.md +9 -7
  20. package/bundled/core/code-review-checklist.md +5 -2
  21. package/bundled/core/context-aware-loading.md +1 -1
  22. package/bundled/core/deferred-item-exit.md +254 -0
  23. package/bundled/core/feature-discovery-standards.md +5 -1
  24. package/bundled/core/governance-layer.md +114 -2
  25. package/bundled/core/retrospective-standards.md +4 -2
  26. package/bundled/core/reverse-engineering-standards.md +81 -2
  27. package/bundled/core/spec-driven-development.md +8 -2
  28. package/bundled/core/tech-debt-standards.md +67 -8
  29. package/bundled/core/turn-completion-integrity.md +196 -0
  30. package/bundled/hooks/check-dangerous-cmd.mjs +60 -0
  31. package/bundled/hooks/check-logging-standard.mjs +59 -0
  32. package/bundled/hooks/check-turn-completion.mjs +233 -0
  33. package/bundled/hooks/inject-standards.mjs +183 -0
  34. package/bundled/hooks/telemetry-wrapper.mjs +77 -0
  35. package/bundled/hooks/turn-completion/detect.mjs +99 -0
  36. package/bundled/hooks/turn-completion/locales/en.mjs +159 -0
  37. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +166 -0
  38. package/bundled/hooks/validate-commit-msg.mjs +104 -0
  39. package/bundled/locales/zh-CN/CHANGELOG.md +65 -3
  40. package/bundled/locales/zh-CN/CLAUDE.md +1 -1
  41. package/bundled/locales/zh-CN/README.md +7 -7
  42. package/bundled/locales/zh-CN/SECURITY.md +1 -1
  43. package/bundled/locales/zh-CN/core/adr-standards.md +1 -1
  44. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +10 -8
  45. package/bundled/locales/zh-CN/core/governance-layer.md +118 -6
  46. package/bundled/locales/zh-CN/core/retrospective-standards.md +1 -1
  47. package/bundled/locales/zh-CN/core/tech-debt-standards.md +71 -4
  48. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +190 -0
  49. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +27 -6
  50. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +29 -68
  51. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +172 -24
  52. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +1 -2
  53. package/bundled/locales/zh-CN/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md} +1 -1
  54. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +3 -3
  55. package/bundled/locales/zh-CN/skills/agents/README.md +1 -1
  56. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +2 -0
  57. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +2 -0
  58. package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +22 -12
  59. package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +12 -9
  60. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +1 -0
  61. package/bundled/locales/zh-CN/skills/commands/brainstorm.md +17 -13
  62. package/bundled/locales/zh-CN/skills/commands/config.md +0 -1
  63. package/bundled/locales/zh-CN/skills/commands/init.md +1 -2
  64. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -0
  65. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -0
  66. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +2 -0
  67. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +1 -0
  68. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +1 -0
  69. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +3 -0
  70. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +2 -0
  71. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +3 -0
  72. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +13 -23
  73. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +1 -0
  74. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +1 -0
  75. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +2 -0
  76. package/bundled/locales/zh-CN/skills/workflows/README.md +2 -11
  77. package/bundled/locales/zh-TW/CHANGELOG.md +65 -3
  78. package/bundled/locales/zh-TW/CLAUDE.md +1 -1
  79. package/bundled/locales/zh-TW/README.md +7 -7
  80. package/bundled/locales/zh-TW/SECURITY.md +1 -1
  81. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +2 -0
  82. package/bundled/locales/zh-TW/core/adr-standards.md +26 -5
  83. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +10 -8
  84. package/bundled/locales/zh-TW/core/code-review-checklist.md +2 -0
  85. package/bundled/locales/zh-TW/core/container-image-standards.md +2 -2
  86. package/bundled/locales/zh-TW/core/contract-testing-standards.md +2 -2
  87. package/bundled/locales/zh-TW/core/cross-flow-regression.md +8 -7
  88. package/bundled/locales/zh-TW/core/data-contract.md +2 -2
  89. package/bundled/locales/zh-TW/core/data-migration-testing.md +2 -2
  90. package/bundled/locales/zh-TW/core/data-pipeline.md +2 -2
  91. package/bundled/locales/zh-TW/core/deferred-item-exit.md +251 -0
  92. package/bundled/locales/zh-TW/core/documentation-writing-standards.md +228 -3
  93. package/bundled/locales/zh-TW/core/full-coverage-testing.md +15 -2
  94. package/bundled/locales/zh-TW/core/governance-layer.md +118 -5
  95. package/bundled/locales/zh-TW/core/iac-design-principles.md +2 -2
  96. package/bundled/locales/zh-TW/core/incident-response.md +2 -2
  97. package/bundled/locales/zh-TW/core/model-provenance.md +4 -2
  98. package/bundled/locales/zh-TW/core/pii-classification.md +42 -6
  99. package/bundled/locales/zh-TW/core/prd-standards.md +4 -2
  100. package/bundled/locales/zh-TW/core/product-metrics-standards.md +4 -2
  101. package/bundled/locales/zh-TW/core/release-readiness-gate.md +2 -2
  102. package/bundled/locales/zh-TW/core/resource-cost-boundary.md +2 -2
  103. package/bundled/locales/zh-TW/core/retrospective-standards.md +5 -3
  104. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +83 -5
  105. package/bundled/locales/zh-TW/core/runbook.md +2 -2
  106. package/bundled/locales/zh-TW/core/schema-evolution.md +2 -2
  107. package/bundled/locales/zh-TW/core/secret-management-standards.md +2 -2
  108. package/bundled/locales/zh-TW/core/slo-sli.md +2 -2
  109. package/bundled/locales/zh-TW/core/spec-driven-development.md +2 -0
  110. package/bundled/locales/zh-TW/core/tech-debt-standards.md +71 -4
  111. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +190 -0
  112. package/bundled/locales/zh-TW/core/user-journey-testing.md +2 -2
  113. package/bundled/locales/zh-TW/core/user-story-mapping.md +2 -2
  114. package/bundled/locales/zh-TW/core/verification-oracle.md +2 -2
  115. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +27 -6
  116. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +29 -68
  117. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +172 -24
  118. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +1 -2
  119. package/bundled/locales/zh-TW/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md} +1 -1
  120. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +3 -3
  121. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
  122. package/bundled/locales/zh-TW/skills/agents/README.md +1 -1
  123. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
  124. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
  125. package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +22 -12
  126. package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +12 -9
  127. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +1 -0
  128. package/bundled/locales/zh-TW/skills/commands/brainstorm.md +17 -13
  129. package/bundled/locales/zh-TW/skills/commands/config.md +0 -1
  130. package/bundled/locales/zh-TW/skills/commands/init.md +1 -2
  131. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -0
  132. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -1
  133. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +2 -0
  134. package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +1 -1
  135. package/bundled/locales/zh-TW/skills/knowledge-graph/guide.md +2 -2
  136. package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
  137. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +1 -0
  138. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +1 -0
  139. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +1 -0
  140. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +3 -0
  141. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +2 -0
  142. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +3 -0
  143. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +13 -23
  144. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +1 -0
  145. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +1 -0
  146. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +2 -0
  147. package/bundled/locales/zh-TW/skills/workflows/README.md +2 -11
  148. package/bundled/skills/agents/README.md +1 -1
  149. package/bundled/skills/atdd-assistant/SKILL.md +2 -0
  150. package/bundled/skills/bdd-assistant/SKILL.md +2 -0
  151. package/bundled/skills/brainstorm-assistant/SKILL.md +31 -13
  152. package/bundled/skills/brainstorm-assistant/guide.md +9 -6
  153. package/bundled/skills/code-review-assistant/SKILL.md +1 -0
  154. package/bundled/skills/commands/brainstorm.md +12 -9
  155. package/bundled/skills/commands/config.md +0 -1
  156. package/bundled/skills/commands/init.md +2 -3
  157. package/bundled/skills/commit-standards/SKILL.md +2 -0
  158. package/bundled/skills/contract-test-assistant/SKILL.md +1 -0
  159. package/bundled/skills/dev-methodology/SKILL.md +4 -0
  160. package/bundled/skills/observability-assistant/SKILL.md +1 -0
  161. package/bundled/skills/project-discovery/SKILL.md +1 -0
  162. package/bundled/skills/project-structure-guide/SKILL.md +1 -0
  163. package/bundled/skills/release-standards/SKILL.md +3 -0
  164. package/bundled/skills/requirement-assistant/SKILL.md +2 -0
  165. package/bundled/skills/reverse-engineer/SKILL.md +3 -0
  166. package/bundled/skills/reverse-engineer/tdd-analysis.md +16 -23
  167. package/bundled/skills/runbook-assistant/SKILL.md +1 -0
  168. package/bundled/skills/slo-assistant/SKILL.md +1 -0
  169. package/bundled/skills/tdd-assistant/SKILL.md +2 -0
  170. package/bundled/skills/workflows/README.md +2 -11
  171. package/bundled/templates/.ai-context.yaml.template +194 -0
  172. package/bundled/templates/CLAUDE.md.template +145 -0
  173. package/bundled/templates/DESIGN.md +237 -0
  174. package/bundled/templates/SKILL-BRIEF-TEMPLATE.md +57 -0
  175. package/bundled/templates/SKILL-CANDIDATES.md +39 -0
  176. package/bundled/templates/gates/check-error-exit.mjs +309 -0
  177. package/bundled/templates/mcp-config.json +10 -0
  178. package/bundled/templates/methodology-template.yaml +209 -0
  179. package/bundled/templates/migration-template.md +408 -0
  180. package/bundled/templates/requirement-checklist.md +410 -0
  181. package/bundled/templates/requirement-document-template.md +591 -0
  182. package/bundled/templates/requirement-template.md +881 -0
  183. package/bundled/templates/reverse-spec-template.md +409 -0
  184. package/bundled/templates/test-case-template.md +74 -0
  185. package/bundled/templates/test-plan-template.md +74 -0
  186. package/package.json +9 -5
  187. package/src/commands/audit.js +82 -0
  188. package/src/commands/check.js +66 -10
  189. package/src/commands/init.js +161 -16
  190. package/src/commands/lint.js +96 -0
  191. package/src/commands/quickstart.js +16 -13
  192. package/src/commands/update.js +286 -14
  193. package/src/compilers/claude-code-compiler.js +4 -1
  194. package/src/config/ai-agent-paths.js +62 -17
  195. package/src/core/constants.js +42 -11
  196. package/src/core/manifest.js +201 -3
  197. package/src/core/paths.js +2 -2
  198. package/src/i18n/messages.js +9 -32
  199. package/src/installers/hooks-installer.js +167 -75
  200. package/src/installers/integration-installer.js +9 -5
  201. package/src/prompts/init.js +14 -14
  202. package/src/reconciler/actual-state-scanner.js +14 -3
  203. package/src/utils/detector.js +21 -1
  204. package/src/utils/effect-boundary.js +1093 -0
  205. package/src/utils/hasher.js +229 -9
  206. package/src/utils/hook-stats.js +1 -1
  207. package/src/utils/integration-generator.js +100 -4
  208. package/src/utils/reference-sync.js +4 -1
  209. package/src/utils/skills-installer.js +17 -3
  210. package/src/utils/spec-linter.js +35 -76
  211. package/src/utils/yaml-generator.js +51 -9
  212. package/standards-registry.json +31 -8
  213. package/src/commands/sync.js +0 -133
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: brainstorm-assistant
3
3
  source: ../../../../skills/brainstorm-assistant/SKILL.md
4
- source_version: 4.1.0
5
- source_hash: 711404f2c4af
6
- translation_version: 4.2.0
7
- last_synced: 2026-08-17
4
+ source_version: 4.2.0
5
+ source_hash: 02e63146c84e
6
+ translation_version: 4.3.0
7
+ last_synced: 2026-08-24
8
8
  status: current
9
9
  description: |
10
10
  [UDS] 在规格出现之前执行的结构化多角色头脑风暴,并附带评分质量关卡。
@@ -26,6 +26,10 @@ description: |
26
26
 
27
27
  **v4 的核心改动:** v3 提供了强健的*机制*,却没有可判定 pass/fail 的质量闸。v4 在其上叠加一道**时序化质量契约**——**头脑风暴质量标准(BQS v1)**——且不移除任何 v3 行为。BQS 是**四层 × 时间轴**结构:第 0 层宣告 explore/exploit 配比;第 1 层(过程、leading、发散期全程可见)跑维度 **D1–D4**;第 2 层(产物、leading、收敛后仅施于推荐集,即 Agg. Score ≥ 3.5、不限笔数的想法)跑 **D5–D8** 加 Seeds 栏与争议区;第 3 层是不受治理的 **Judgment Override**。第一原理:**决策用 leading 信号、校准用 lagging 信号——两者是时间前后,而非对错取舍。** 硬序列闸禁止 D5–D8 在发散期被揭示或评分。详见下方「BQS v1 — 质量契约」。
28
28
 
29
+ **v4.2 的核心改动(XSPEC-388):** D4 原本只钉住判官坐在哪里,一个字都没说它得想得动。一个独立 context 跑字面遵循型模型会逐字满足旧条文,然后照 D5–D8 逐条打勾放行——与一场真的有人反对过的评审在报告上无从分辨。v4.2 给 D4 加上**第二个轴**:评审还必须宣告其**模型层级**要求(见下方术语说明)。CONVERGE 的提示改为**目标+约束**形状——D5–D8 是判断必须满足的判准,不是按顺序执行的步骤;既有固定句型与逐准则分数指南保留为参考格式。发散侧引用 [core/model-selection.md](../../../../core/model-selection.md)(Standard 或更高)而不另立规则。不移除任何 v3 机制。
30
+
31
+ > **术语——「模型层级」,不用「tier」:** 在本 skill 内,`tier` 已被占用两次——BQS 分级表(套用哪些维度)与 Enhanced Tier。[core/model-selection.md](../../../../core/model-selection.md) 定义的模型能力轴(该标准称 *model tier*)在本 skill 一律写作**模型层级(model level)**。模型层级是该标准的**厂商中立标签**;本 skill 绝不指名具体厂商模型(见 D4)。
32
+
29
33
  ## 使用前先选模式
30
34
 
31
35
  使用前套用以下**客观触发条件**。默认为完整 v3,路由规则是跳过阶段的快捷方式,而非额外障碍。
@@ -68,7 +72,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
68
72
  | **D1 框架纯度** | 问题内嵌特定方案或「像 X 给 Y」→fail;须 5-Whys 到根因 |
69
73
  | **D2 发散覆盖** | 存活想法跨 <3 独立 persona/透镜→fail(受第 0 层权重调节);连一轮零新增才算饱和 |
70
74
  | **D3 跨会话多样性** | 种子是竞品类比→fail;Top 全来自单一 lens→fail |
71
- | **D4 评估去偏** | 须 ≥3 评审 + 硬角色 Devil's Advocate + Steelman;**pass 须在独立 context 执行**,否则标 `[degraded]` 不得标 pass |
75
+ | **D4 评估去偏** | 须 ≥3 评审 + 硬角色 Devil's Advocate + Steelman;**pass 须同时满足两轴**:(1) 独立 context,**且** (2) 以 [model-selection](../../../../core/model-selection.md) 的厂商中立标签宣告**模型层级**要求——指名具体厂商模型即违规。缺任一轴→标 `[degraded]` 不得标 pass |
72
76
 
73
77
  > **硬序列闸:** D5–D8 禁止在发散期揭示或评分;CONVERGE 的 critic 不得在**最后一个 persona** 产完前被调用。
74
78
 
@@ -92,7 +96,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
92
96
  ### 结构规则
93
97
 
94
98
  1. **Meta 停止规则:** 该层维度全绿 **且** 再跑一轮后 **推荐集成员不变**(看集合成员、不看内部排序)→停。**硬上限 2 轮**。取代模糊的「不翻决策」。
95
- 2. **判官≠产生者:** D2/D4/D5/D7 判定须独立视角;单 context 自评只能 `[degraded]`,不得 pass。
99
+ 2. **判官≠产生者:** D2/D4/D5/D7 判定须独立视角;单 context 自评只能 `[degraded]`,不得 pass。D4 另需宣告模型层级——独立性只是它两轴之一(见 D4)。
96
100
  3. **校准回路(吃 lagging):** v3 的三个工作阶段自评指标收编为此回路 **lagging** 端——**Adoption Rate=D6 滞后验证、Diversity=D2/D3 滞后观测、Cognitive Load=成本约束**;**禁两套平行评估**。
97
101
  4. **BQS 自我演化(轻量):** 版本化 + 证据清单 last-reviewed 逾期 flag;「定期对 BQS 自身 brainstorm」列可选。
98
102
  5. **最小充分原则:** 套用该 tier 所需的最少维度 + 把第 2 层限缩在推荐集(Agg. Score ≥ 3.5),而非全部发散想法——认知经济性的守门,不另设成本维度。
@@ -149,6 +153,8 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
149
153
 
150
154
  > **v3 核心机制:** **persona 集成**——每个 persona 以**思维链**在**隔离**状态下推理——再乘上**多样性透镜**。Meincke、Mollick、Terwiesch(2024)发现「思维链 + persona」的想法多样性高于所有受测的提示策略,接近人类团体。光冲数量是弱代理;结构性逼出不同视角才是真正的杠杆。
151
155
 
156
+ > **模型层级(发散侧):** 发散提示只给目标与约束——正是 core/model-selection.md 的 [MS-004](../../../../core/model-selection.md#rules)/[Criterion 2](../../../../core/model-selection.md#criterion-2--specification-definiteness規格明確度) 的触发条件:发散以 **Standard 或更高**层级执行。不是「最高层级」——那会同时超出 MS-004 所说的与我们的证据。lagging 登记:此选择由校准回路既有的 **Diversity(D2/D3 滞后观测)** 栏验证,不另开第二套登记。
157
+
152
158
  #### 步骤 2a —— persona 集成
153
159
 
154
160
  通过默认 persona 组生成想法。每个 persona **逐步推理(思维链)**,**只从自己的视角**产出 2–4 个想法。用户可用 `--personas` 增减或改名。
@@ -195,9 +201,11 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
195
201
 
196
202
  > **v3 核心机制:** **多评审面板**取代单一加权评分者。单一 LLM 是弱且有偏的评估者(Li 等,2025:LLM 强于生成 / 精炼、弱于评估——人类保留最终裁决权)。三个独立评审透镜各自对每个想法评分后聚合。
197
203
 
204
+ > **评审提示形状——目标+约束(v4.2):** 对面板、Devil's Advocate、Steelman 派工时——尤其派入独立 context(`--enhanced`)——提示**必须**以**目标+其判断必须满足的约束**表达,不得写成按顺序执行的步骤清单。D5–D8 与下方的具体性要求是**判准**(「你的判断必须满足这些」),不是**步骤**(「照这个顺序做这些事」)。既有固定句型、逐准则 1–5 指南与评审权重公式**保留为参考格式**,皆非必经步骤。理由:core/model-selection.md 的 [MS-009](../../../../core/model-selection.md#rules)。
205
+
198
206
  #### 步骤 3a:多评审面板
199
207
 
200
- 运行**三个独立评审**,各自以自己的透镜对每个想法打 1–5 分。取平均聚合以降低单评审偏误。每位评审皆套用下方的加权公式。
208
+ 运行**三个独立评审**,各自以自己的透镜对每个想法打 1–5 分。取平均聚合以降低单评审偏误。下方加权准则定义默认透镜——是参考格式,不是评审必须逐步照走的脚本。
201
209
 
202
210
  | 评审透镜 | 它负责的加权标准 |
203
211
  |----------|------------------|
@@ -205,7 +213,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
205
213
  | **用户影响** | 影响 70% · 一致性 30% |
206
214
  | **战略一致性** | 一致性 60% · 影响 40% |
207
215
 
208
- 各标准指引(1–5):可行性(5=轻而易举 … 1=几乎不可能);影响(5=变革性 … 1=可忽略);工作量(5=数小时 … 1=数个季度,反向计分,工作量越低分数越高);一致性(5=核心使命 … 1=偏离使命)。
216
+ 各标准指引(1–5,参考格式):可行性(5=轻而易举 … 1=几乎不可能);影响(5=变革性 … 1=可忽略);工作量(5=数小时 … 1=数个季度,反向计分,工作量越低分数越高);一致性(5=核心使命 … 1=偏离使命)。
209
217
 
210
218
  > **可选——RICE / ICE(产品功能):** 排序可发布功能时用 `RICE =(Reach × Impact × Confidence)/ Effort` 或较轻的 `ICE = Impact × Confidence × Ease`。Effort 交由工程师估、不要让 LLM 估(它没有代码库知识)。RICE 偏好渐进式胜利,别单独用于战略性押注。
211
219
 
@@ -213,7 +221,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
213
221
 
214
222
  软性的「请批评一下」指令只会得到附和(谄媚)。v3 指派**硬角色**:对**推荐集**(Agg. Score ≥ 3.5,不限笔数)中的每一个想法各跑一个 **Devil's Advocate**(「你的任务是论证此案会失败」)与一个 **Steelman**(「说出反方最强而善意的版本」)。两者一起对韧性做压力测试,而非只是戳一下。
215
223
 
216
- 每个反对理由必须采用以下形式:「在 [具体情境] 下,此想法会失败,因为 [具体原因]。」模糊顾虑(「这可能有点难」)不接受。
224
+ 约束:每个反对理由须指出**具体情境**与**具体原因**——模糊顾虑(「这可能有点难」)不接受。句型「在 [具体情境] 下,此想法会失败,因为 [具体原因]」是参考格式,不是必用句式。
217
225
 
218
226
  用户**必须**对每个反对理由给出回应才能继续:
219
227
 
@@ -225,16 +233,17 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
225
233
 
226
234
  **旗标:** `--no-rebuttal` 跳过此步骤;报告区段标注「Rebuttal: skipped」。
227
235
 
228
- > **BQS D4 — 判官≠产生者:** D4 唯有**评审/Devil's Advocate 在独立 context 执行**(`--enhanced` 隔离 agent 宿主)才可 pass。baseline 单 context 下,面板是同 context 自评,标 `[degraded]`、**不得标 pass**——诚实但非独立。不得把 baseline 跑当成 D4 pass 静默通过。
236
+ > **BQS D4 — 判官≠产生者,两轴:** D4 唯有**两轴同时成立**才可 pass。**(1) 座位——独立性**:评审/Devil's Advocate 在独立 context 执行(`--enhanced` 隔离 agent 宿主)。**(2) 心智——宣告模型层级**:评审宣告其**模型层级**要求,以 [core/model-selection.md](../../../../core/model-selection.md) 的厂商中立标签表达;选层依据为该标准的判准(引用,不复述)。指名具体厂商模型即违规——层级标签是唯一合法的表达方式。缺任一轴→面板标 `[degraded]`、**不得标 pass**:独立 context 跑字面遵循型模型会逐字满足座位轴,成为一枚完全合规的橡皮图章——认出「不同名字下的同一件事」是打勾做不到的判断工作。baseline 单 context 下,面板是同 context 自评,标 `[degraded]`、不得 pass——诚实但非独立。不得把 baseline 跑当成 D4 pass 静默通过。
229
237
 
230
238
  #### 步骤 3c:BQS 第 2 层——对推荐集的产物闸
231
239
 
232
- 收敛后,**仅对推荐集**(Agg. Score ≥ 3.5 的想法,不限笔数)套用 **D5–D8**(绝不对全部发散想法)。若无想法达 3.5,仍保留分数最高的 1 个,标记 `[未达门槛——仅供参考]`,避免报告空白。对推荐集中每个想法:
240
+ 收敛后,**仅对推荐集**(Agg. Score ≥ 3.5 的想法,不限笔数)套用 **D5–D8**(绝不对全部发散想法)。若无想法达 3.5,仍保留分数最高的 1 个,标记 `[未达门槛——仅供参考]`,避免报告空白。D5–D8 是**判断必须满足的判准**——不限顺序,不是程序。对推荐集中每个想法,判断必须满足:
233
241
 
234
242
  - **D5 接地:** 将每个主张分流为 `[现状/外部事实]`(需 file:line 或来源,否则 fail)vs `[未来/假说]`(免接地、标 `[假说]`)。**外部事实宣称为跨级地板**——creative 级也须接地。
235
243
  - **D6 净值:** 推荐集中每个想法须答「解谁问题/我们真有吗/不做的代价」;至少一个淘汰为「不值得做」;挂 **lagging 登记栏**(事后哪个信号验证)。
236
244
  - **D7 可证伪(二态):** 标 `[现可陈述证伪]` **或** `[需先做 X 才能定义证伪]`。后者**转 next-step 喂 D8——不算 fail**。
237
245
  - **D8 可行动:** 每个存活想法需 next-step 裁决(含明确「暂不做」);无 → fail。
246
+ - 裁决为「暂不做」者,以及 **Seeds(来自被淘汰的想法)** 中每个被搁置的想法,皆为 [deferred-item-exit](../../../../core/deferred-item-exit.md) 所指的延后项目。
238
247
 
239
248
  > **Meta 停止规则(BQS 结构规则 1):** 当套用的维度全绿 **且** 再跑一轮后 **推荐集成员不变**(看集合成员、非内部排序)→停。**硬上限 2 轮。**
240
249
 
@@ -289,7 +298,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
289
298
  - [ ] Proceed to `/sdd` if requirements are clear
290
299
  ```
291
300
 
292
- > **BQS 输出新增(v4):** **Seeds** 区(规则:被杀 ≥1 则非空)、**争议区**(高方差想法不按 mean 淘汰)、**Judgment Override** 通道(人类裁决凌驾聚合分)为 BQS 第 2/3 层所要求。Recommendations 区块为推荐集(不限笔数)中每个想法逐项记录 D5–D8 状态。
301
+ > **BQS 输出新增(v4):** **Seeds** 区(规则:被杀 ≥1 则非空)、**争议区**(高方差想法不按 mean 淘汰)、**Judgment Override** 通道(人类裁决凌驾聚合分)为 BQS 第 2/3 层所要求。Recommendations 区块为推荐集(不限笔数)中每个想法逐项记录 D5–D8 状态。自 v4.2 起,报告表头并记录评审宣告的**模型层级**(厂商中立标签)——没有它,D4 为 `[degraded]`,且宣告无处可验。
293
302
 
294
303
  ## 多样性崩塌防护
295
304
 
@@ -366,6 +375,7 @@ BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3
366
375
  ## 参考
367
376
 
368
377
  - 详细指南:[guide.md](./guide.md)
378
+ - 模型层级依据:[core/model-selection.md](../../../../core/model-selection.md)——D4 心智轴与发散侧层级皆以该标准的判准为准。**引用、不复述**——摘要会随来源被更正而腐坏,指针不会。
369
379
 
370
380
  ## AI 代理行为
371
381
 
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  scope: universal
3
3
  source: ../../../../skills/brainstorm-assistant/guide.md
4
- source_version: 4.1.0
5
- source_hash: c5cd260548c2
6
- translation_version: 4.1.0
7
- last_synced: 2026-07-09
4
+ source_version: 4.2.0
5
+ source_hash: f789b3bbc31a
6
+ translation_version: 4.2.0
7
+ last_synced: 2026-08-21
8
8
  status: current
9
9
  description: |
10
10
  指导在编写规格前进行结构化 AI 辅助头脑风暴。
@@ -16,8 +16,8 @@ description: |
16
16
 
17
17
  > **语言**: [English](../../../../skills/brainstorm-assistant/guide.md) | 简体中文
18
18
 
19
- **版本**: 4.1.0
20
- **最后更新**: 2026-07-09
19
+ **版本**: 4.2.0
20
+ **最后更新**: 2026-08-21
21
21
  **适用范围**: 所有软件项目
22
22
  **Scope**: universal
23
23
  **类型**: 工具型 Skill(无对应核心标准)
@@ -292,7 +292,7 @@ HMW(默认起点)、SCAMPER(改善既有功能:Substitute、Combine、Ad
292
292
  | **用户影响** | 影响 70% · 对齐 30% |
293
293
  | **战略对齐** | 对齐 60% · 影响 40% |
294
294
 
295
- **逐准则指引(1–5):**
295
+ **逐准则指引(1–5,参考格式——不是评审必须逐步照走的脚本):**
296
296
 
297
297
  | 准则 | 5 | 3 | 1 |
298
298
  |------|---|---|---|
@@ -318,7 +318,7 @@ HMW(默认起点)、SCAMPER(改善既有功能:Substitute、Combine、Ad
318
318
  - **Devil's Advocate**:「你的任务是论证这个想法*会*失败。给出 2 个具体的失败条件。」
319
319
  - **Steelman**:「陈述反方论点最强、最善意的版本——一个有思想的对手实际会提出的那种。」
320
320
 
321
- 每个反方论点必须采取以下形式:**「这个想法会在 [特定上下文] 失败,因为 [特定理由]。」**
321
+ 约束:每个反方论点必须指出**特定上下文**与**特定理由**。句型**「这个想法会在 [特定上下文] 失败,因为 [特定理由]」**是参考格式,不是必用句式(v4.2——评审提示为目标+约束,见 SKILL.md「评审提示形状」)。
322
322
 
323
323
  **不可接受**(太空泛):「这可能很难。」/「可能会有 edge case。」
324
324
 
@@ -354,6 +354,7 @@ HMW(默认起点)、SCAMPER(改善既有功能:Substitute、Combine、Ad
354
354
  **Personas Used**: [domain expert, skeptic, analogist, ...]
355
355
  **Lenses Used**: [analogical, reversal, ...]
356
356
  **Pre-flight**: [Completed / Skipped] **Rebuttal**: [Completed / Skipped] **Tier**: [Baseline / Enhanced]
357
+ **评审模型层级(D4 心智轴)**: [core/model-selection.md 的厂商中立层级标签——指名厂商模型即违规;未宣告 → D4 [degraded]]
357
358
 
358
359
  ## Problem Statement
359
360
  [Refined problem + root cause from 5 Whys]
@@ -566,7 +567,7 @@ BQS v1 是**叠加的质量契约**,不是推倒重来。v3 的一切都保留
566
567
 
567
568
  - **所有旗标**:`--personas`、`--lens`、`--enhanced`、`--skip-preflight`、`--no-rebuttal`、`--quick`、`--technique` 行为与 v3 完全相同。v4 仅新增一个可选旗标 `--intent`,供第 0 层宣告。
568
569
  - **所有机制**:PRE-FLIGHT 防锚定、FRAME 5-Whys/HMW、persona 集成、多样性透镜、多评审面板、硬角色反驳(Devil's Advocate + Steelman)、多样性坍缩护栏、Enhanced 层,皆不变。
569
- - **`--enhanced` 隔离 agent 宿主**正是让 BQS **D4 pass**(判官≠产生者)的条件;baseline 单 context 标 `[degraded]`、不静默通过。
570
+ - **`--enhanced` 隔离 agent 宿主**满足的是 BQS **D4 的座位轴**(判官≠产生者);自 v4.2(XSPEC-388)起,D4 pass 另需评审宣告**模型层级**(心智轴——依 core/model-selection.md 的厂商中立标签)。baseline 单 context 标 `[degraded]`、不静默通过。
570
571
 
571
572
  ---
572
573
 
@@ -601,6 +602,7 @@ BQS v1 是**叠加的质量契约**,不是推倒重来。v3 的一切都保留
601
602
  | [Requirement Engineering](../../core/requirement-engineering.md) | 头脑风暴输出馈入需求编写 |
602
603
  | [Spec-Driven Development](../../core/spec-driven-development.md) | 头脑风暴输出馈入 SDD 提案 |
603
604
  | [Anti-Hallucination](../../core/anti-hallucination.md) | 评审的可行性主张必须基于证据,而非断言 |
605
+ | [Model Selection](../../core/model-selection.md) | D4 心智轴(宣告模型层级)与发散侧层级(Standard 或更高)皆以此标准的判准为准——引用、绝不复述 |
604
606
 
605
607
  ---
606
608
 
@@ -608,6 +610,7 @@ BQS v1 是**叠加的质量契约**,不是推倒重来。v3 的一切都保留
608
610
 
609
611
  | 版本 | 日期 | 变更 |
610
612
  |------|------|------|
613
+ | 4.2.0 | 2026-08-21 | XSPEC-388:D4 的 pass 条件加上第二个轴——座位(独立 context,不变)加上心智(评审必须宣告其**模型层级**要求,且只能以 core/model-selection.md 的厂商中立标签表达;指名具体厂商模型即违规;未宣告 → `[degraded]`、不得 pass)。CONVERGE 评审提示依 MS-009 改为目标+约束形状:D5–D8 以「判断必须满足的判准」呈现、不得以按顺序执行的程序呈现;固定反驳句型、逐准则 1–5 指引与评审权重公式保留为参考格式、非必经步骤。发散侧引用 MS-004/Criterion 2(Standard 或更高——刻意不是「最高」),由校准回路既有的 Diversity(D2/D3)lagging 栏验证。术语:模型能力轴全文写作「模型层级」,因为「tier」已被 BQS 分级与 Enhanced Tier 占用。所有 v3 旗标与机制保留。 |
611
614
  | 4.1.0 | 2026-07-09 | XSPEC-325:把固定 Top-3 推荐上限改为分数门槛**推荐集**(Agg. Score ≥ 3.5,不限笔数),贯穿 BQS 第 2 层——产物闸(D5–D8)、硬角色反驳轮(Devil's Advocate + Steelman)、Meta 停止规则(集合成员稳定性)、多样性坍缩护栏、OUTPUT 推荐区块,全部改以推荐集为对象,不再是固定 3 个。若无想法达 3.5,仍显示分数最高的 1 个并标示「未达门槛,仅供参考」,避免报告空白。 |
612
615
  | 4.0.0 | 2026-06-22 | XSPEC-296:头脑风暴质量标准(BQS v1)——叠加于 v3 的四层 × 时间轴质量契约。第 0 层 explore/exploit 意图(调节 D2 权重);第 1 层过程 leading 维度 D1–D4 + 硬序列闸(发散期禁 D5–D8);第 2 层产物 leading 维度 D5–D8 仅施于 Top 3,加 Seeds 栏与高方差争议区;第 3 层 Judgment Override(凌驾聚合分)。D4 判官≠产生者(须独立 context,否则 `[degraded]`);D5 主张分流(外部事实跨级地板);D7 二态证伪(「需先做 X」→next-step、不算 fail);Meta 停止规则(Top-3 集合稳定 + 硬上限 2 轮)。工作阶段自评重新定位为校准回路 lagging 端(Adoption→D6、Diversity→D2/D3、Cognitive Load→成本;禁两套平行评估)。第一原理修正为「决策用 leading、校准用 lagging」。分级绑客观模式选择触发。新增旗标 `--intent`。所有 v3 旗标/机制保留。 |
613
616
  | 3.0.0 | 2026-06-01 | XSPEC-247:DIVERGE 重新聚焦于 persona 集成 + 多样性透镜(类比 / 反转 / 形态学);CONVERGE 重新聚焦于多评审面板 + 硬角色反驳(Devil's Advocate + Steelman);多样性坍缩护栏;Enhanced 层级(并行 persona/评审智能体,优雅回退);Research Foundations 基于 6 项已验证的 2024–2026 出处重建;效度说明重新评级(飞行前为低、Nijstad/Nemeth 降级);新旗标 `--personas`/`--lens`/`--enhanced`;反种子护栏 |
@@ -63,5 +63,6 @@ description: |
63
63
 
64
64
  ## 参考
65
65
 
66
+ - [Pre-Commit Checklist(提交前检查清单)](./checkin-checklist.md) — 提交之前当作最后一道检查时读它。
66
67
  - 详细指南:[guide.md](./guide.md)
67
68
  - 核心规范:[code-review-checklist.md](../../../../core/code-review-checklist.md)
@@ -1,9 +1,10 @@
1
1
  ---
2
2
  source: ../../../../skills/commands/brainstorm.md
3
- source_version: 4.0.0
4
- source_hash: b4d32a8b638e
5
- translation_version: 4.0.0
6
- last_synced: 2026-07-09
3
+ source_version: 4.2.0
4
+ source_hash: 319f8ad4f02f
5
+ translation_version: 4.2.0
6
+ last_synced: 2026-08-21
7
+ status: current
7
8
  ---
8
9
 
9
10
  ---
@@ -34,7 +35,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
34
35
  | **PRE-FLIGHT** | 防止 AI 锚定 | 用户先写 3 个想法;不用类比种子;**BQS 第 0 层意图(explore/exploit)** |
35
36
  | **FRAME** | 清楚定义问题 | 5 Whys, HMW, Stakeholder Map;**D1 框架纯度** |
36
37
  | **DIVERGE** | 逼出视角多样性 | persona 集成 + 多样性透镜;**BQS 第 1 层 D1–D4,硬闸隐藏 D5–D8** |
37
- | **CONVERGE** | 经偏误检查的选择 | 多评审面板 + Devil's Advocate/Steelman;**BQS 第 2 层 D5–D8 施于 Top 3,D4 判官≠产生者** |
38
+ | **CONVERGE** | 经偏误检查的选择 | 多评审面板 + Devil's Advocate/Steelman;**BQS 第 2 层 D5–D8 施于推荐集(Agg. ≥ 3.5),D4 判官≠产生者(两轴:独立 context+宣告模型层级)** |
38
39
  | **OUTPUT** | 可执行的报告 | Brainstorm Report + Seeds + 争议区 + **第 3 层 Judgment Override** |
39
40
 
40
41
  > **BQS v1(XSPEC-296):** v4 在 v3 上叠加四层 × 时间轴质量契约。完整 oracle 与结构规则见 skill:[Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md#bqs-v1--质量契约)。
@@ -68,7 +69,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
68
69
  ## Problem Statement
69
70
  [Refined problem from FRAME phase]
70
71
 
71
- ## Top 3 Recommendations
72
+ ## Recommendations (Agg. Score ≥ 3.5 — uncapped)
72
73
  1. **[Idea]** — Agg. X.X ✓ Passed rebuttal — Persona: [..] — [Why recommended]
73
74
 
74
75
  ## Diversity Note
@@ -100,7 +101,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
100
101
  | `/brainstorm "topic"` | 以指定主题启动 PRE-FLIGHT,再进入 FRAME |
101
102
  | `/brainstorm --personas "a,b,c"` | 以自定义 persona 组进入 DIVERGE |
102
103
  | `/brainstorm --lens <name>` | 以指定多样性透镜为主进入 DIVERGE |
103
- | `/brainstorm --enhanced` | 若宿主支持子代理则并行跑 persona/评审,否则静默退回 baseline;此模式下 BQS D4 方可 pass |
104
+ | `/brainstorm --enhanced` | 若宿主支持子代理则并行跑 persona/评审,否则静默退回 baseline;此模式满足 BQS D4 的座位轴(独立 context),pass 另需宣告模型层级(心智轴,见 skill D4) |
104
105
  | `/brainstorm --intent exploit` | 以 exploit 意图启动(BQS 第 0 层),D2 低覆盖不扣分 |
105
106
 
106
107
  ### 交互脚本
@@ -125,12 +126,13 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
125
126
  3. 至少套用一个多样性透镜(类比/假设反转/形态矩阵)
126
127
  4. 以多样性(覆盖的 persona/透镜数,D2/D3)而非数量为继续门槛
127
128
  5. **硬序列闸**:D5–D8 在最后一个 persona 产完前**不得揭示或评分**;CONVERGE critic 不得提前调用
129
+ 6. **模型层级(发散侧)**:以 **Standard 或更高**层级执行——依 core/model-selection.md 的 MS-004/Criterion 2(引用,不复述;不是「最高层级」)
128
130
 
129
- #### CONVERGE 阶段(BQS 第 2 层 — D5–D8 仅施于 Top 3)
130
- 1. 以 3 个独立评审(工程可行性/用户影响/战略一致)各自评分后聚合
131
- 2. 对前 3 名跑硬角色 Devil's Advocate(论证会失败)+ Steelman;用户以 (a)修改/(b)反驳/(c)移除 回应。**D4 判官≠产生者**:评审须在独立 context(`--enhanced`)方可 pass,否则标 `[degraded]` 不得 pass
132
- 3. **仅对 Top 3** 套用 D5 接地(外部事实需 file:line/来源、跨级地板;假说免接地)、D6 净值(解谁问题/真有吗/不做代价+挂 lagging 栏)、D7 二态证伪(「需先做 X」转 next-step、不算 fail)、D8 next-step 裁决
133
- 4. **Meta 停止规则**:维度全绿且再跑一轮 Top 3 集合成员不变→停;硬上限 2 轮
131
+ #### CONVERGE 阶段(BQS 第 2 层 — D5–D8 仅施于推荐集)
132
+ 1. 以 3 个独立评审(工程可行性/用户影响/战略一致)各自评分后聚合;**评审提示以「目标+约束」表达**(判准,不是步骤清单——理由见 skill 引用的 core/model-selection.md MS-009),加权公式与逐准则指引为参考格式
133
+ 2. 对**推荐集**(Agg. Score ≥ 3.5,不限笔数)跑硬角色 Devil's Advocate(论证会失败)+ Steelman;用户以 (a)修改/(b)反驳/(c)移除 回应。**D4 判官≠产生者,两轴**:(1) 评审在独立 context(`--enhanced`)执行,且 (2) 宣告模型层级(core/model-selection.md 的厂商中立标签;指名具体厂商模型即违规)——缺任一轴标 `[degraded]` 不得 pass
134
+ 3. **仅对推荐集**套用 D5 接地(外部事实需 file:line/来源、跨级地板;假说免接地)、D6 净值(解谁问题/真有吗/不做代价+挂 lagging 栏)、D7 二态证伪(「需先做 X」转 next-step、不算 fail)、D8 next-step 裁决——四者为判准、不限顺序
135
+ 4. **Meta 停止规则**:维度全绿且再跑一轮推荐集集合成员不变→停;硬上限 2 轮
134
136
 
135
137
  🛑 **STOP**: 展示 Brainstorm Report(含 Seeds/争议区/Judgment Override)后等待用户决定下一步
136
138
 
@@ -151,13 +153,15 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
151
153
  | 使用「像 X 但给 Y」种子 | 改写为底层问题再继续(反种子 guardrail) |
152
154
  | 指定的 persona/透镜不存在 | 列出可用选项供选择 |
153
155
  | `--enhanced` 但宿主不支持子代理 | 静默退回 baseline,照常进行 |
154
- | 前 3 名全来自同一 persona/透镜 | 标示并在输出前再跑一个透镜 |
156
+ | 推荐集全来自同一 persona/透镜 | 标示并在输出前再跑一个透镜 |
155
157
  | baseline 单 context 跑评审(无独立 context) | BQS D4 标 `[degraded]`,不得标 pass |
158
+ | 评审未宣告模型层级(或以具体厂商模型名宣告) | BQS D4 标 `[degraded]` 不得 pass;模型名改为 core/model-selection.md 的层级标签 |
156
159
  | 外部事实宣称无 file:line/来源 | D5 接地 fail,要求补来源或改标 `[假说]` |
157
160
 
158
161
  ## 参考
159
162
 
160
163
  * [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)
161
164
  * [Brainstorm Assistant Guide](../brainstorm-assistant/guide.md)
165
+ * [Model Selection](../../core/model-selection.md) — BQS D4 与发散侧的模型层级标签(引用,不复述)
162
166
  * [Requirement Assistant](../requirement-assistant/SKILL.md)
163
167
  * [Spec-Driven Development](../spec-driven-dev/SKILL.md)
@@ -167,7 +167,6 @@ Current Skills status:
167
167
  | 模式 | 说明 |
168
168
  |------|------|
169
169
  | `standard` | 摘要 + 任务映射,AI 知道何时读取哪个标准(推荐) |
170
- | `full` | 在集成文件中完整嵌入所有标准 |
171
170
  | `minimal` | 仅嵌入核心规则 |
172
171
 
173
172
  ## 配置变更的影响
@@ -41,7 +41,7 @@ argument-hint: "[--level N | --yes]"
41
41
  | **OpenCode** | `AGENTS.md` | ✅ | ✅ |
42
42
  | **Gemini CLI** | `GEMINI.md` | ✅ | ✅ |
43
43
  | **Codex** | `AGENTS.md` | ✅ | ❌ |
44
- | **Antigravity** | `INSTRUCTIONS.md` | ✅ | ❌ |
44
+ | **Antigravity** | `.agents/AGENTS.md` | ✅ | ❌ |
45
45
 
46
46
  预选环境中检测到的工具。注意:Codex 和 OpenCode 共用 `AGENTS.md`。
47
47
 
@@ -210,7 +210,6 @@ Options:
210
210
  | 选项 | 说明 |
211
211
  |------|------|
212
212
  | **标准(建议)** | 摘要 + 任务映射,AI 知道何时读取哪个标准 |
213
- | **完整嵌入** | 嵌入所有规则,AI 可立即使用但文件较大 |
214
213
  | **最简** | 仅文件引用,搭配 Skills 使用最佳 |
215
214
 
216
215
  ### 步骤 13:确认并执行
@@ -125,6 +125,8 @@ Closes #123
125
125
 
126
126
  ## 参考
127
127
 
128
+ - [Conventional Commits 指南](./conventional-commits.md) — 需要确切的 type、scope 与格式规则时读它。
129
+ - [Commit Message 语言选项](./language-options.md) — 要决定 commit message 用哪一种语言时读它。
128
130
  - 详细指南:[guide.md](./guide.md)
129
131
  - 核心规范:[commit-message-guide.md](../../../../core/commit-message-guide.md)
130
132
 
@@ -102,6 +102,7 @@ ASSESS ──► CHOOSE ──► DEFINE ──► IMPLEMENT ──► VERIFY
102
102
 
103
103
  ## 参考
104
104
 
105
+ - 详细指南:[guide.md](./guide.md) — 契约测试的策略与实现。要配置 Pact/OpenAPI,或把契约测试接入 CI 时读它。
105
106
  - 详细指南:[contract-testing.md](../../options/testing/contract-testing.md)
106
107
  - 相关:[api-design-assistant](../api-design-assistant/SKILL.md)
107
108
 
@@ -104,6 +104,8 @@ argument-hint: "[动作] [参数]"
104
104
 
105
105
  ## 参考
106
106
 
107
+ - [创建自定义 Methodology 指南](./create-methodology.md) — 要自建方法论而不是用现成的那几套时读它。
108
+ - [Methodology Runtime 指南](./runtime.md) — 需要知道方法论在执行当下如何运作时读它。
107
109
  - 详细指南:[guide.md](./guide.md)
108
110
 
109
111
  ## AI 代理行为
@@ -46,6 +46,7 @@ description: |
46
46
 
47
47
  ## 参考
48
48
 
49
+ - 详细指南:[guide.md](./guide.md) — 日志、指标、追踪三大支柱的完整说明。要搭建监控、选择指标类型、引入追踪或评估成熟度时读它。
49
50
  - 核心规范:[observability-standards.md](../../../../core/observability-standards.md)
50
51
  - 核心规范:[alerting-standards.md](../../../../core/alerting-standards.md)
51
52
  - 核心规范:[slo-standards.md](../../../../core/slo-standards.md)
@@ -150,6 +150,7 @@ project/
150
150
 
151
151
  ## 相关标准
152
152
 
153
+ - [各语言的项目结构](./language-patterns.md) — 按语言列出的实际目录布局(Node.js/TypeScript、Python、Go 等)。要为某个特定语言安排项目结构时读它。
153
154
  - [核心:项目结构](../../core/project-structure.md)
154
155
  - [核心:文档结构](../../core/documentation-structure.md)
155
156
  - [指南:文件归档决策指南](../../core/guides/file-placement-guide.md)
@@ -70,5 +70,8 @@ description: |
70
70
 
71
71
  ## 参考
72
72
 
73
+ - [变更日誌格式指南](./changelog-format.md) — 要撰写或审查变更日志时读它。
74
+ - [發布流程指南](./release-workflow.md) — 真的要发一版、需要逐步流程时读它。
75
+ - [語意化版本指南](./semantic-versioning.md) — 要判断一个变更算 major、minor 还是 patch 时读它。
73
76
  - 详细指南:[guide.md](./guide.md)
74
77
  - 核心规范:[versioning.md](../../../../core/versioning.md)
@@ -73,5 +73,7 @@ So that [benefit].
73
73
 
74
74
  ## 参考
75
75
 
76
+ - [需求完整性检查清单](./requirement-checklist.md) — 要在需求被接受之前检查它完不完整时读它。
77
+ - [需求撰写指南](./requirement-writing.md) — 要从零开始写一份需求时读它。
76
78
  - 详细指南:[guide.md](./guide.md)
77
79
  - 核心规范:[requirement-engineering.md](../../../../core/requirement-engineering.md)
@@ -125,6 +125,9 @@ description: |
125
125
 
126
126
  ## 参考
127
127
 
128
+ - [BDD 提取工作流程指南](./bdd-extraction.md) — 要从既有规格里萃取 BDD 场景时读它。
129
+ - [TDD 分析工作流程指南](./tdd-analysis.md) — 要对照场景分析测试覆盖率、找出缺口时读它。
130
+ - 分步流程:[workflow.md](./workflow.md) — 逆向工程的各阶段与顺序(代码扫描、数据模型、配置、测试分析、覆盖率)。真的要跑一次逆向时读它。
128
131
  - 详细指南:[guide.md](./guide.md)
129
132
  - 核心规范:[reverse-engineering-standards.md](../../../../core/reverse-engineering-standards.md)
130
133
 
@@ -605,9 +605,19 @@ test.each([
605
605
 
606
606
  ## CI/CD 整合
607
607
 
608
- ### GitHub Actions 范例
608
+ ### GitHub Actions —— 目前无法脚本化
609
+
610
+ `uds reverse-tdd` 这个 CLI 指令不存在。覆盖率缺口分析是以 **`reverse-tdd`
611
+ AI agent**(`uds agent install reverse-tdd`)提供——由你的 AI 工具交互式执行,
612
+ 不是会吐出 `coverage.json` 的确定性脚本。本文件先前版本示范了一个调用不存在
613
+ CLI 指令的 GitHub Actions 步骤(XSPEC-383 R4,2026-08-19)。
614
+
615
+ 下方仅为**示意**——展示若未来真的做出可脚本化的分析器,CI 整合可能长什么样,
616
+ 不是现在就能贴进 workflow 使用的东西:
609
617
 
610
618
  ```yaml
619
+ # 示意用途——目前没有可脚本化的等价物。
620
+ # 现况:改用 reverse-tdd agent 从你的 AI 工具交互式执行。
611
621
  name: BDD Coverage Check
612
622
 
613
623
  on: [pull_request]
@@ -618,29 +628,9 @@ jobs:
618
628
  steps:
619
629
  - uses: actions/checkout@v4
620
630
 
621
- - name: Run BDD Coverage Analysis
622
- run: |
623
- uds reverse-tdd features/ --output coverage.json
624
-
625
- - name: Check Coverage Threshold
631
+ - name: Run BDD Coverage Analysis (尚未实现)
626
632
  run: |
627
- COVERAGE=$(jq '.summary.effectiveCoverage' coverage.json)
628
- if (( $(echo "$COVERAGE < 0.80" | bc -l) )); then
629
- echo "Coverage $COVERAGE below 80% threshold"
630
- exit 1
631
- fi
632
-
633
- - name: Comment on PR
634
- uses: actions/github-script@v6
635
- with:
636
- script: |
637
- const coverage = require('./coverage.json');
638
- github.rest.issues.createComment({
639
- issue_number: context.issue.number,
640
- owner: context.repo.owner,
641
- repo: context.repo.repo,
642
- body: `## BDD 覆盖率报告\n\n覆盖率: ${(coverage.summary.effectiveCoverage * 100).toFixed(1)}%`
643
- });
633
+ echo "目前没有 CLI 等价物——交互式用法请见 reverse-tdd agent"
644
634
  ```
645
635
 
646
636
  ---
@@ -45,6 +45,7 @@ description: |
45
45
 
46
46
  ## 参考
47
47
 
48
+ - 详细指南:[guide.md](./guide.md) — 运维手册的编写、组织与验证。要写手册、审查运维流程、规划演练或评估覆盖范围时读它。
48
49
  - 核心规范:[runbook-standards.md](../../../../core/runbook-standards.md)
49
50
  - 相关:[alerting-standards.md](../../../../core/alerting-standards.md)
50
51
  - 相关:[postmortem-standards.md](../../../../core/postmortem-standards.md)
@@ -45,6 +45,7 @@ description: |
45
45
 
46
46
  ## 参考
47
47
 
48
+ - 详细指南:[guide.md](./guide.md) — SLI/SLO/错误预算的定义与管理。要定义 SLO、选择 SLI、计算错误预算或设定可靠性目标时读它。
48
49
  - 核心规范:[slo-standards.md](../../../../core/slo-standards.md)
49
50
  - 相关:[observability-standards.md](../../../../core/observability-standards.md)
50
51
  - 相关:[alerting-standards.md](../../../../core/alerting-standards.md)
@@ -72,5 +72,7 @@ description: |
72
72
 
73
73
  ## 参考
74
74
 
75
+ - [TDD 语言範例](./language-examples.md) — 需要某个特定语言的实际范例时读它。
76
+ - [TDD 工作流程指南](./tdd-workflow.md) — 要完整跑一轮红-绿-重构时读它。
75
77
  - 详细指南:[guide.md](./guide.md)
76
78
  - 核心规范:[test-driven-development.md](../../../../core/test-driven-development.md)
@@ -164,18 +164,9 @@ steps:
164
164
 
165
165
  ## 用法
166
166
 
167
- ### CLI 安装
167
+ ### 获取 Workflows
168
168
 
169
- ```bash
170
- # List available workflows
171
- uds workflow list
172
-
173
- # Install specific workflow
174
- uds workflow install integrated-flow
175
-
176
- # Install all workflows
177
- uds workflow install --all
178
- ```
169
+ `uds workflow` 已于 v6.0.0 移除(流程编排职责移至采用层——DEC-049;见 [MIGRATION-v6.md §3](../../../../docs/MIGRATION-v6.md#3-removed-4-deprecated-cli-commands))。没有 CLI 安装步骤:workflow 定义直接存放在本 repo 的 `skills/workflows/*.workflow.yaml`(见上方表格),请直接引用路径或复制到项目的 `.claude/workflows/`。
179
170
 
180
171
  ### 执行
181
172