universal-dev-standards 6.8.0 → 6.10.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 (225) hide show
  1. package/bin/uds.js +12 -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/code-review.ai.yaml +13 -3
  5. package/bundled/ai/standards/commit-message.ai.yaml +8 -4
  6. package/bundled/ai/standards/deferred-item-exit.ai.yaml +225 -0
  7. package/bundled/ai/standards/feature-discovery-standards.ai.yaml +14 -2
  8. package/bundled/ai/standards/governance-layer.ai.yaml +128 -2
  9. package/bundled/ai/standards/logging.ai.yaml +2 -2
  10. package/bundled/ai/standards/retrospective-standards.ai.yaml +14 -2
  11. package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +73 -2
  12. package/bundled/ai/standards/security-standards.ai.yaml +2 -2
  13. package/bundled/ai/standards/spec-driven-development.ai.yaml +14 -2
  14. package/bundled/ai/standards/tech-debt-standards.ai.yaml +87 -3
  15. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +131 -0
  16. package/bundled/core/acceptance-criteria-traceability.md +5 -2
  17. package/bundled/core/adr-standards.md +26 -2
  18. package/bundled/core/agent-communication-protocol.md +8 -0
  19. package/bundled/core/branch-completion.md +8 -0
  20. package/bundled/core/change-batching-standards.md +8 -0
  21. package/bundled/core/code-review-checklist.md +5 -2
  22. package/bundled/core/context-aware-loading.md +1 -1
  23. package/bundled/core/deferred-item-exit.md +254 -0
  24. package/bundled/core/execution-history.md +8 -0
  25. package/bundled/core/feature-discovery-standards.md +5 -1
  26. package/bundled/core/governance-layer.md +114 -2
  27. package/bundled/core/pipeline-integration-standards.md +8 -0
  28. package/bundled/core/retrospective-standards.md +4 -2
  29. package/bundled/core/reverse-engineering-standards.md +81 -2
  30. package/bundled/core/spec-driven-development.md +8 -2
  31. package/bundled/core/tech-debt-standards.md +67 -8
  32. package/bundled/core/turn-completion-integrity.md +196 -0
  33. package/bundled/core/workflow-enforcement.md +8 -0
  34. package/bundled/core/workflow-state-protocol.md +8 -0
  35. package/bundled/hooks/check-dangerous-cmd.mjs +60 -0
  36. package/bundled/hooks/check-logging-standard.mjs +59 -0
  37. package/bundled/hooks/check-turn-completion.mjs +233 -0
  38. package/bundled/hooks/inject-standards.mjs +183 -0
  39. package/bundled/hooks/telemetry-wrapper.mjs +77 -0
  40. package/bundled/hooks/turn-completion/detect.mjs +99 -0
  41. package/bundled/hooks/turn-completion/locales/en.mjs +159 -0
  42. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +166 -0
  43. package/bundled/hooks/validate-commit-msg.mjs +104 -0
  44. package/bundled/locales/zh-CN/CHANGELOG.md +73 -3
  45. package/bundled/locales/zh-CN/CLAUDE.md +1 -1
  46. package/bundled/locales/zh-CN/README.md +2 -2
  47. package/bundled/locales/zh-CN/SECURITY.md +1 -1
  48. package/bundled/locales/zh-CN/core/adr-standards.md +1 -1
  49. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +7 -0
  50. package/bundled/locales/zh-CN/core/branch-completion.md +7 -0
  51. package/bundled/locales/zh-CN/core/change-batching-standards.md +7 -0
  52. package/bundled/locales/zh-CN/core/execution-history.md +7 -0
  53. package/bundled/locales/zh-CN/core/governance-layer.md +118 -6
  54. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +7 -0
  55. package/bundled/locales/zh-CN/core/retrospective-standards.md +1 -1
  56. package/bundled/locales/zh-CN/core/tech-debt-standards.md +71 -4
  57. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +190 -0
  58. package/bundled/locales/zh-CN/core/workflow-enforcement.md +7 -0
  59. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +7 -0
  60. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +8 -1
  61. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +29 -68
  62. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +25 -15
  63. package/bundled/locales/zh-CN/docs/MIGRATION-v6.md +8 -4
  64. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +1 -2
  65. package/bundled/locales/zh-CN/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md} +1 -1
  66. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +3 -3
  67. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +2 -0
  68. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +2 -0
  69. package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +22 -12
  70. package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +12 -9
  71. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +1 -0
  72. package/bundled/locales/zh-CN/skills/commands/brainstorm.md +17 -13
  73. package/bundled/locales/zh-CN/skills/commands/config.md +0 -1
  74. package/bundled/locales/zh-CN/skills/commands/init.md +1 -2
  75. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -0
  76. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -0
  77. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +2 -0
  78. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +1 -0
  79. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +1 -0
  80. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +3 -0
  81. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +2 -0
  82. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +3 -0
  83. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +1 -0
  84. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +1 -0
  85. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +2 -0
  86. package/bundled/locales/zh-TW/CHANGELOG.md +74 -3
  87. package/bundled/locales/zh-TW/CLAUDE.md +1 -1
  88. package/bundled/locales/zh-TW/README.md +2 -2
  89. package/bundled/locales/zh-TW/SECURITY.md +1 -1
  90. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +2 -0
  91. package/bundled/locales/zh-TW/core/adr-standards.md +26 -5
  92. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +7 -0
  93. package/bundled/locales/zh-TW/core/branch-completion.md +7 -0
  94. package/bundled/locales/zh-TW/core/change-batching-standards.md +7 -0
  95. package/bundled/locales/zh-TW/core/code-review-checklist.md +2 -0
  96. package/bundled/locales/zh-TW/core/container-image-standards.md +2 -2
  97. package/bundled/locales/zh-TW/core/contract-testing-standards.md +2 -2
  98. package/bundled/locales/zh-TW/core/cross-flow-regression.md +8 -7
  99. package/bundled/locales/zh-TW/core/data-contract.md +2 -2
  100. package/bundled/locales/zh-TW/core/data-migration-testing.md +2 -2
  101. package/bundled/locales/zh-TW/core/data-pipeline.md +2 -2
  102. package/bundled/locales/zh-TW/core/deferred-item-exit.md +251 -0
  103. package/bundled/locales/zh-TW/core/documentation-writing-standards.md +228 -3
  104. package/bundled/locales/zh-TW/core/execution-history.md +7 -0
  105. package/bundled/locales/zh-TW/core/full-coverage-testing.md +15 -2
  106. package/bundled/locales/zh-TW/core/governance-layer.md +118 -5
  107. package/bundled/locales/zh-TW/core/iac-design-principles.md +2 -2
  108. package/bundled/locales/zh-TW/core/incident-response.md +2 -2
  109. package/bundled/locales/zh-TW/core/model-provenance.md +4 -2
  110. package/bundled/locales/zh-TW/core/pii-classification.md +42 -6
  111. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +7 -0
  112. package/bundled/locales/zh-TW/core/prd-standards.md +4 -2
  113. package/bundled/locales/zh-TW/core/product-metrics-standards.md +4 -2
  114. package/bundled/locales/zh-TW/core/release-readiness-gate.md +2 -2
  115. package/bundled/locales/zh-TW/core/resource-cost-boundary.md +2 -2
  116. package/bundled/locales/zh-TW/core/retrospective-standards.md +5 -3
  117. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +83 -5
  118. package/bundled/locales/zh-TW/core/runbook.md +2 -2
  119. package/bundled/locales/zh-TW/core/schema-evolution.md +2 -2
  120. package/bundled/locales/zh-TW/core/secret-management-standards.md +2 -2
  121. package/bundled/locales/zh-TW/core/slo-sli.md +2 -2
  122. package/bundled/locales/zh-TW/core/spec-driven-development.md +2 -0
  123. package/bundled/locales/zh-TW/core/tech-debt-standards.md +71 -4
  124. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +190 -0
  125. package/bundled/locales/zh-TW/core/user-journey-testing.md +2 -2
  126. package/bundled/locales/zh-TW/core/user-story-mapping.md +2 -2
  127. package/bundled/locales/zh-TW/core/verification-oracle.md +2 -2
  128. package/bundled/locales/zh-TW/core/workflow-enforcement.md +7 -0
  129. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +7 -0
  130. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +8 -1
  131. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +29 -68
  132. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +25 -15
  133. package/bundled/locales/zh-TW/docs/MIGRATION-v6.md +8 -4
  134. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +1 -2
  135. package/bundled/locales/zh-TW/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md} +1 -1
  136. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +3 -3
  137. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
  138. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
  139. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
  140. package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +22 -12
  141. package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +12 -9
  142. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +1 -0
  143. package/bundled/locales/zh-TW/skills/commands/brainstorm.md +17 -13
  144. package/bundled/locales/zh-TW/skills/commands/config.md +0 -1
  145. package/bundled/locales/zh-TW/skills/commands/init.md +1 -2
  146. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -0
  147. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -1
  148. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +2 -0
  149. package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +1 -1
  150. package/bundled/locales/zh-TW/skills/knowledge-graph/guide.md +2 -2
  151. package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
  152. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +1 -0
  153. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +1 -0
  154. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +1 -0
  155. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +3 -0
  156. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +2 -0
  157. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +3 -0
  158. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +1 -0
  159. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +1 -0
  160. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +2 -0
  161. package/bundled/skills/atdd-assistant/SKILL.md +2 -0
  162. package/bundled/skills/bdd-assistant/SKILL.md +2 -0
  163. package/bundled/skills/brainstorm-assistant/SKILL.md +31 -13
  164. package/bundled/skills/brainstorm-assistant/guide.md +9 -6
  165. package/bundled/skills/code-review-assistant/SKILL.md +1 -0
  166. package/bundled/skills/commands/brainstorm.md +12 -9
  167. package/bundled/skills/commands/config.md +0 -1
  168. package/bundled/skills/commands/init.md +2 -3
  169. package/bundled/skills/commit-standards/SKILL.md +2 -0
  170. package/bundled/skills/contract-test-assistant/SKILL.md +1 -0
  171. package/bundled/skills/dev-methodology/SKILL.md +4 -0
  172. package/bundled/skills/observability-assistant/SKILL.md +1 -0
  173. package/bundled/skills/project-discovery/SKILL.md +1 -0
  174. package/bundled/skills/project-structure-guide/SKILL.md +1 -0
  175. package/bundled/skills/release-standards/SKILL.md +3 -0
  176. package/bundled/skills/requirement-assistant/SKILL.md +2 -0
  177. package/bundled/skills/reverse-engineer/SKILL.md +3 -0
  178. package/bundled/skills/runbook-assistant/SKILL.md +1 -0
  179. package/bundled/skills/slo-assistant/SKILL.md +1 -0
  180. package/bundled/skills/tdd-assistant/SKILL.md +2 -0
  181. package/bundled/templates/.ai-context.yaml.template +194 -0
  182. package/bundled/templates/CLAUDE.md.template +145 -0
  183. package/bundled/templates/DESIGN.md +237 -0
  184. package/bundled/templates/SKILL-BRIEF-TEMPLATE.md +57 -0
  185. package/bundled/templates/SKILL-CANDIDATES.md +39 -0
  186. package/bundled/templates/gates/check-error-exit.mjs +309 -0
  187. package/bundled/templates/mcp-config.json +10 -0
  188. package/bundled/templates/methodology-template.yaml +209 -0
  189. package/bundled/templates/migration-template.md +408 -0
  190. package/bundled/templates/requirement-checklist.md +410 -0
  191. package/bundled/templates/requirement-document-template.md +591 -0
  192. package/bundled/templates/requirement-template.md +881 -0
  193. package/bundled/templates/reverse-spec-template.md +409 -0
  194. package/bundled/templates/test-case-template.md +74 -0
  195. package/bundled/templates/test-plan-template.md +74 -0
  196. package/package.json +12 -9
  197. package/src/commands/audit.js +82 -0
  198. package/src/commands/check.js +227 -34
  199. package/src/commands/config.js +19 -19
  200. package/src/commands/init.js +174 -20
  201. package/src/commands/spec.js +2 -2
  202. package/src/commands/update.js +537 -43
  203. package/src/compilers/claude-code-compiler.js +4 -1
  204. package/src/config/ai-agent-paths.js +62 -17
  205. package/src/core/constants.js +42 -11
  206. package/src/core/manifest.js +201 -3
  207. package/src/core/paths.js +2 -2
  208. package/src/i18n/messages.js +42 -29
  209. package/src/installers/hooks-installer.js +167 -75
  210. package/src/installers/integration-installer.js +13 -9
  211. package/src/installers/skills-installer.js +4 -4
  212. package/src/installers/standards-installer.js +3 -3
  213. package/src/prompts/init.js +47 -18
  214. package/src/reconciler/diff-engine.js +57 -2
  215. package/src/reconciler/plan-executor.js +31 -11
  216. package/src/utils/detector.js +21 -1
  217. package/src/utils/effect-boundary.js +1093 -0
  218. package/src/utils/hasher.js +166 -1
  219. package/src/utils/hook-stats.js +1 -1
  220. package/src/utils/integration-generator.js +288 -82
  221. package/src/utils/reference-sync.js +107 -8
  222. package/src/utils/registry.js +57 -0
  223. package/src/utils/spinner.js +31 -0
  224. package/src/utils/yaml-generator.js +51 -9
  225. package/standards-registry.json +32 -9
@@ -1,7 +1,7 @@
1
1
  # UDS 功能參考手冊
2
2
 
3
3
  > Universal Development Standards - 完整功能文件
4
- > Auto-generated | Last updated: 2026-08-19
4
+ > Auto-generated | Last updated: 2026-09-14
5
5
 
6
6
  **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
7
7
 
@@ -14,10 +14,10 @@
14
14
  3. [技能](#skills) (55)
15
15
  4. [代理](#agents) (5)
16
16
  5. [工作流程](#workflows) (5)
17
- 6. [核心規範](#core-standards) (150)
18
- 7. [腳本](#scripts) (54)
17
+ 6. [核心規範](#core-standards) (152)
18
+ 7. [腳本](#scripts) (59)
19
19
 
20
- **Total Features: 343**
20
+ **Total Features: 350**
21
21
 
22
22
  ---
23
23
 
@@ -49,10 +49,10 @@
49
49
  | `--framework` | Framework extension (fat-free) |
50
50
  | `--locale` | Locale extension (zh-tw) |
51
51
  | `--skills-location` | Skills location (marketplace, user, project, none) [default: marketplace] |
52
- | `--content-mode` | Content mode for integration files (minimal, index, full) [default: index] |
52
+ | `--content-mode` | Content mode for integration files (minimal, index) [default: index]; full is retired and resolves to index |
53
53
  | `--agents-md` | Generate AGENTS.md universal summary |
54
54
  | `--no-agents-md` | Skip AGENTS.md generation |
55
- | `--with-hooks` | Install enforcement hooks (commit-msg, security, logging) |
55
+ | `--with-hooks` | Install enforcement hooks declared by the installed standards |
56
56
  | `--content-layout` | Content layout (flat, layered) [default: flat] |
57
57
  | `-y, --yes` | Use defaults, skip interactive prompts |
58
58
  | `-E, --experimental` | Enable experimental features (methodology) |
@@ -153,6 +153,7 @@
153
153
  | `--plan` | Show reconciliation plan without executing (like terraform plan); combines with --skills/--commands to plan just that scope, still writing nothing |
154
154
  | `--apply` | Apply exactly the plan --plan prints (plain `uds update` does not); with --skills/--commands it does the reconciliation AND that scope, not only the scope |
155
155
  | `--force` | Force update all files, ignoring hash comparison |
156
+ | `--prune` | Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write) |
156
157
  | `--rollback` | Rollback to the most recent backup |
157
158
  | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
158
159
 
@@ -182,6 +183,8 @@
182
183
  | `--trend` | Show historical score trend (use with --score) |
183
184
  | `--ci` | CI mode: output score only, exit 1 if below threshold (use with --score) |
184
185
  | `--threshold` | Score threshold for CI mode (default: 75) |
186
+ | `--effects` | Static effect boundary gate: do the implementations of each declared effect interface reach anything outside this process |
187
+ | `--effects-config` | Path to the effect-family config (default: .uds/effect-boundary.json) |
185
188
 
186
189
  ### `uds deps`
187
190
 
@@ -425,10 +428,10 @@
425
428
 
426
429
  | Standard | 版本 | 說明 |
427
430
  |----------|---------|-------------|
428
- | `acceptance-criteria-traceability` | 1.1.0 | |
431
+ | `acceptance-criteria-traceability` | 1.2.0 | |
429
432
  | `acceptance-test-driven-development` | 1.1.0 | |
430
433
  | `accessibility-standards` | 1.1.0 | This standard defines comprehensive guidelines for creating accessible software |
431
- | `adr-standards` | 1.0.0 | Architecture Decision Records capture the context, options, and rationale behind |
434
+ | `adr-standards` | 1.1.0 | Architecture Decision Records capture the context, options, and rationale behind |
432
435
  | `adversarial-test` | - | |
433
436
  | `agent-behavior-discipline` | 1.0.0 | This standard defines four behavioral disciplines for AI agents that elevate per |
434
437
  | `agent-communication-protocol` | 1.0.0 | Define a unified communication protocol for AI agents across the AsiaOstrich pro |
@@ -456,7 +459,7 @@
456
459
  | `checkin-standards` | 1.8.0 | This standard defines quality gates that MUST be passed before committing code t |
457
460
  | `circuit-breaker` | - | |
458
461
  | `class-level-fix` | 1.1.0 | A defect is almost never alone. It is one member of a set — one flag in a dispat |
459
- | `code-review-checklist` | 1.4.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
462
+ | `code-review-checklist` | 1.5.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
460
463
  | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
461
464
  | `container-image-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
462
465
  | `container-security` | - | |
@@ -469,6 +472,7 @@
469
472
  | `data-migration-testing` | - | |
470
473
  | `data-pipeline` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
471
474
  | `database-standards` | 1.0.0 | This standard defines guidelines for database design, querying, migration, and o |
475
+ | `deferred-item-exit` | 1.0.0 | Several standards require documents that **produce deferred items** — an ADR's a |
472
476
  | `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
473
477
  | `deprecation-standards` | 1.1.0 | |
474
478
  | `design-document-standards` | 1.0.0 | |
@@ -483,7 +487,7 @@
483
487
  | `estimation-standards` | 1.0.0 | |
484
488
  | `execution-history` | 1.0.0 | |
485
489
  | `failure-source-taxonomy` | - | |
486
- | `feature-discovery-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-05-13 | |
490
+ | `feature-discovery-standards` | 1.1.0 | **Status**: Active | **Updated**: 2026-08-24 | |
487
491
  | `feature-flag-standards` | 1.0.0 | |
488
492
  | `feature-manifest-standard` | - | |
489
493
  | `flaky-test-management` | - | |
@@ -493,7 +497,7 @@
493
497
  | `full-coverage-testing` | - | |
494
498
  | `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
495
499
  | `git-worktree` | 1.1.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
496
- | `governance-layer` | 1.0.0 | A governance layer provides a shared anchor for all agents and roles in a projec |
500
+ | `governance-layer` | 1.1.0 | A governance layer provides a shared anchor for all agents and roles in a projec |
497
501
  | `health-check-standards` | - | |
498
502
  | `iac-design-principles` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
499
503
  | `immutability-first` | - | |
@@ -532,9 +536,9 @@
532
536
  | `replay-test` | - | |
533
537
  | `requirement-engineering` | 1.1.0 | |
534
538
  | `resource-cost-boundary` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
535
- | `retrospective-standards` | 1.0.0 | Retrospectives are structured team reflections that identify what worked well, w |
539
+ | `retrospective-standards` | 1.1.0 | Retrospectives are structured team reflections that identify what worked well, w |
536
540
  | `retry-standards` | - | |
537
- | `reverse-engineering-standards` | 1.2.0 | This standard defines the principles, workflows, and best practices for reverse |
541
+ | `reverse-engineering-standards` | 1.3.0 | This standard defines the principles, workflows, and best practices for reverse |
538
542
  | `rollback-standards` | - | |
539
543
  | `runbook-standards` | 1.0.0 | |
540
544
  | `runbook` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
@@ -551,14 +555,14 @@
551
555
  | `slo-sli` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
552
556
  | `slo-standards` | 1.0.0 | |
553
557
  | `smoke-test` | - | |
554
- | `spec-driven-development` | 2.4.0 | |
558
+ | `spec-driven-development` | 2.5.0 | |
555
559
  | `standard-admission-criteria` | - | |
556
560
  | `standard-lifecycle-management` | - | |
557
561
  | `structured-task-definition` | 1.0.0 | |
558
562
  | `supply-chain-attestation` | - | |
559
563
  | `supply-chain-security-standards` | 1.1.0 | |
560
564
  | `systematic-debugging` | 1.0.0 | Define a structured, four-phase debugging workflow that prevents the common anti |
561
- | `tech-debt-standards` | 1.0.0 | |
565
+ | `tech-debt-standards` | 1.1.0 | |
562
566
  | `test-completeness-dimensions` | 1.1.0 | This document defines a systematic framework for evaluating test completeness. I |
563
567
  | `test-data-standards` | 1.0.0 | |
564
568
  | `test-driven-development` | 1.2.0 | |
@@ -567,6 +571,7 @@
567
571
  | `timeout-standards` | - | |
568
572
  | `token-budget` | - | |
569
573
  | `translation-lifecycle-standards` | 1.0.1 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
574
+ | `turn-completion-integrity` | 1.3.0 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
570
575
  | `user-journey-testing` | - | |
571
576
  | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
572
577
  | `verification-evidence` | 1.3.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
@@ -590,6 +595,7 @@
590
595
  | `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
591
596
  | `check-ai-agent-sync.sh` | AI Agent Sync Checker |
592
597
  | `check-ai-yaml-parses.mjs` | Every shipped .ai.yaml must parse, and must parse into what it says. |
598
+ | `check-bump-sync-roundtrip.mjs` | check-bump-sync-roundtrip — 測「跑完 bump 之後 check 必須通過」這個不變量。 |
593
599
  | `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
594
600
  | `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
595
601
  | `check-commands-sync.ps1` | Check Commands Sync |
@@ -599,6 +605,7 @@
599
605
  | `check-docs-integrity.sh` | Documentation Integrity Checker |
600
606
  | `check-docs-sync.ps1` | Check Docs Sync |
601
607
  | `check-docs-sync.sh` | Documentation Sync Checker |
608
+ | `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
602
609
  | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
603
610
  | `check-orphan-specs.ps1` | Check Orphan Specs |
604
611
  | `check-orphan-specs.sh` | Orphan Spec Detection Script |
@@ -612,6 +619,7 @@
612
619
  | `check-standards-reference-sync.sh` | check-standards-reference-sync.sh |
613
620
  | `check-standards-sync.ps1` | Check Standards Sync |
614
621
  | `check-standards-sync.sh` | Standards Consistency Checker |
622
+ | `check-translation-hash-ratchet.sh` | XSPEC-392 R6 棘輪:新的翻譯必須帶 source_hash,既有的欠債冷凍為基線。 |
615
623
  | `check-translation-sync.ps1` | Check Translation Sync |
616
624
  | `check-translation-sync.sh` | Translation Sync Checker |
617
625
  | `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerated |
@@ -623,7 +631,9 @@
623
631
  | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
624
632
  | `fix-manifest-paths.ps1` | Fix Manifest Paths |
625
633
  | `fix-manifest-paths.sh` | Manifest Path Fixer |
634
+ | `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate — XSPEC-385 |
626
635
  | `generate-docs.mjs` | Look up the release date for `version` from CHANGELOG.md's own |
636
+ | `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
627
637
  | `generate-locale-coverage.mjs` | Locale Coverage Generator |
628
638
  | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
629
639
  | `install-hooks.mjs` | Install Hooks |
@@ -32,14 +32,13 @@ UDS 6.0.0 是 **major** 版本:包含一項 breaking 更名、移除 8 個已
32
32
 
33
33
  **不受影響**:指涉外部工具內建 review 命令(如 Codex)的 `/review` 字樣與 UDS 無關,刻意保留原樣。
34
34
 
35
- ## 2. 移除:8 個已棄用的機器可讀標準(`.ai.yaml`)
35
+ ## 2. 移除:7 個已棄用的機器可讀標準(`.ai.yaml`)
36
36
 
37
- 這 8 個標準的 runtime 已於 5.4.0 移交採用層(XSPEC-086/095;UDS 定義活動、採用層編排流程——DEC-049),其 `.ai.yaml` stub 如期移除:
37
+ 這些標準的 runtime 已於 5.4.0 移交採用層(XSPEC-086/095;UDS 定義活動、採用層編排流程——DEC-049),其 `.ai.yaml` stub 如期移除:
38
38
 
39
39
  | 移除的 `.ai.yaml` | 保留的人類可讀文件 |
40
40
  |---|---|
41
41
  | `agent-communication-protocol` | `core/agent-communication-protocol.md` |
42
- | `agent-dispatch` | `core/agent-dispatch.md` |
43
42
  | `branch-completion` | `core/branch-completion.md` |
44
43
  | `change-batching-standards` | `core/change-batching-standards.md` |
45
44
  | `execution-history` | `core/execution-history.md` |
@@ -51,7 +50,12 @@ UDS 6.0.0 是 **major** 版本:包含一項 breaking 更名、移除 8 個已
51
50
 
52
51
  - 若從未直接載入這些 `.ai.yaml`:不需動作——人類可讀概念仍留在 `core/` 作為參考文件。
53
52
  - 若採用層(agent runtime、orchestrator、CI)曾載入這些 stub:在自家工具鏈實作等效機制。這些 stub 自 5.4.0 起本身就是指向此方向的棄用告示。
54
- - 這些標準不再由 `uds init` / `uds update` 發佈。專案 `.standards/` 中既有副本不會被自動刪除——想要乾淨樹的話請手動移除。
53
+ - 這些標準不再由 `uds init` / `uds update` 發佈。每一份保留下來的 `core/*.md` 都在自己的開頭寫明這件事,而 `scripts/reference-only-standards.json` 是那份清單的機器可讀版本。
54
+ - **`agent-dispatch` 曾在這張表上,現在不在了。** 它的 `.ai.yaml` 已於 XSPEC-362 R5a 恢復、正常出貨,而本指南在那之後仍把它列為已移除,跨了兩個大版本。**你的 manifest 裡若還有它,那是對的。**
55
+ - 專案 `.standards/` 中既有副本不會被自動刪除。請用 **`uds update --prune`**,不要手動刪:
56
+ - `--prune` 會連同 `fileHashes` 裡的紀錄一起移除。手動刪只刪掉檔案,紀錄還在,`uds check` 會把每一個報成「遺失」並建議 `uds check --restore`——**而那個還原不可能成功**,因為上游已經沒有來源了。
57
+ - **從 6.8.x 以前升上來之後的第一次 `uds update` 什麼都不會刪**,不論你加什麼旗標:此時還沒有檔案歸屬紀錄,而 UDS 不會憑一筆不存在的紀錄刪東西。先跑一次 `uds update`,再跑 `uds update --prune`。
58
+ - `--prune` 不會清 `integrationConfigs[<檔名>].installedStandards`。那份快照正是 `uds update --sync-refs` 重新產生時所依據的東西,所以殘留在那裡的項目仍可能把錯的標準數寫進你的 CLAUDE.md。`uds update --integrations-only` 則是從 manifest 重算。
55
59
 
56
60
  ## 3. 移除:4 個已棄用的 CLI 命令
57
61
 
@@ -58,7 +58,6 @@ status: current
58
58
 
59
59
  **配置方式**:
60
60
  - 安裝時選擇 `standardsScope: full` + Skills 安裝
61
- - 或透過 `contentMode: full` 獲得完整規範
62
61
 
63
62
  **包含內容**:
64
63
  - 16 個 Claude Code Skills
@@ -212,7 +211,7 @@ uds init -y --skills-location marketplace --content-mode index
212
211
 
213
212
  **配置方式**:
214
213
  ```bash
215
- uds init -y --skills-location none --content-mode full
214
+ uds init -y --skills-location none --content-mode index
216
215
  ```
217
216
 
218
217
  ### 場景 4:學習 UDS 標準體系
@@ -1,5 +1,5 @@
1
1
  ---
2
- source: ../../../../integrations/google-antigravity/INSTRUCTIONS.md
2
+ source: ../../../../integrations/google-antigravity/AGENTS.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
5
  last_synced: 2026-01-13
@@ -19,7 +19,7 @@ Google Antigravity 是一個先進的代理程式碼開發助理。此整合協
19
19
  - **[.antigravity/rules.md](../../../../integrations/google-antigravity/.antigravity/rules.md)**(推薦):
20
20
  專案級規則檔,Antigravity 會自動載入。
21
21
 
22
- - **[INSTRUCTIONS.md](./INSTRUCTIONS.md)**:
22
+ - **[AGENTS.md](./AGENTS.md)**:
23
23
  用於手動配置的系統提示詞片段。
24
24
 
25
25
  ## 規則配置
@@ -53,7 +53,7 @@ curl -o .antigravity/rules.md https://raw.githubusercontent.com/AsiaOstrich/univ
53
53
  確保 `core/` 規範已複製到您的專案(例如 `.standards/`)。
54
54
 
55
55
  2. **配置代理**:
56
- 將 `INSTRUCTIONS.md` 的內容複製到您的 Antigravity「使用者規則」或特定任務指令中。
56
+ 將 `AGENTS.md` 的內容複製到您的 Antigravity「使用者規則」或特定任務指令中。
57
57
 
58
58
  ### 驗證合規性
59
59
 
@@ -65,7 +65,7 @@ curl -o .antigravity/rules.md https://raw.githubusercontent.com/AsiaOstrich/univ
65
65
 
66
66
  - [防幻覺標準](../../core/anti-hallucination.md)
67
67
  - [Commit 訊息指南](../../core/commit-message-guide.md)
68
- - [INSTRUCTIONS.md](./INSTRUCTIONS.md)
68
+ - [AGENTS.md](./AGENTS.md)
69
69
 
70
70
  ---
71
71
 
@@ -2,7 +2,7 @@
2
2
  name: adr-assistant
3
3
  source: ../../../../skills/adr-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- source_hash: 7d8bf5944cf4
5
+ source_hash: a5c79c6a04fe
6
6
  translation_version: 1.1.0
7
7
  last_synced: 2026-08-17
8
8
  status: current
@@ -80,5 +80,7 @@ So that [benefit].
80
80
 
81
81
  ## 參考
82
82
 
83
+ - [驗收標準撰寫指南](./acceptance-criteria-guide.md) — 要撰寫或審查驗收標準時讀它。
84
+ - [ATDD 工作流程指南](./atdd-workflow.md) — 要完整跑一輪 ATDD 循環時讀它。
83
85
  - 詳細指南:[guide.md](./guide.md)
84
86
  - 核心規範:[acceptance-test-driven-development.md](../../../../core/acceptance-test-driven-development.md)
@@ -77,5 +77,7 @@ Feature: User Login
77
77
 
78
78
  ## 參考
79
79
 
80
+ - [BDD 工作流程指南](./bdd-workflow.md) — 要把探索、制定、自動化當一個循環跑時讀它。
81
+ - [Gherkin 快速參考指南](./gherkin-guide.md) — 要寫 Given/When/Then 而需要確切語法時讀它。
80
82
  - 詳細指南:[guide.md](./guide.md)
81
83
  - 核心規範:[behavior-driven-development.md](../../../../core/behavior-driven-development.md)
@@ -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
  #### Step 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
  #### Step 3a: 多評審面板
199
207
 
200
- 跑**三個獨立評審**,各自以自己的透鏡對每個想法打 1–5 分;取平均聚合以降低單評審偏誤。每位評審皆套用下方加權公式。
208
+ 跑**三個獨立評審**,各自以自己的透鏡對每個想法打 1–5 分;取平均聚合以降低單評審偏誤。下方加權準則定義預設透鏡——是參考格式,不是評審必須逐步照走的腳本。
201
209
 
202
210
  | 評審透鏡 | 它所負責的加權準則 |
203
211
  |---------|-------------------|
@@ -205,7 +213,7 @@ BQS 是**四層 × 時間軸**契約。它是 v3 的**疊加**——所有 v3
205
213
  | **User impact(使用者影響)** | Impact 70% · Alignment 30% |
206
214
  | **Strategic alignment(策略一致性)** | Alignment 60% · Impact 40% |
207
215
 
208
- 各準則評分指南(1–5):Feasibility(5=輕而易舉 … 1=幾乎不可能);Impact(5=變革性 … 1=可忽略);Effort(5=數小時 … 1=數季,反向計分,工作量越低分越高);Alignment(5=核心使命 … 1=偏離使命)。
216
+ 各準則評分指南(1–5,參考格式):Feasibility(5=輕而易舉 … 1=幾乎不可能);Impact(5=變革性 … 1=可忽略);Effort(5=數小時 … 1=數季,反向計分,工作量越低分越高);Alignment(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
  #### Step 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
 
@@ -5,10 +5,10 @@ description: |
5
5
  使用時機:模糊想法、功能探索、問題再框架、創意發想。
6
6
  關鍵字:brainstorm, ideation, persona ensemble, multi-critic, HMW, SCAMPER, 腦力激盪, 發想, 創意。
7
7
  source: ../../../../skills/brainstorm-assistant/guide.md
8
- source_version: 4.1.0
9
- source_hash: c5cd260548c2
10
- translation_version: 4.1.0
11
- last_synced: 2026-07-09
8
+ source_version: 4.2.0
9
+ source_hash: f789b3bbc31a
10
+ translation_version: 4.2.0
11
+ last_synced: 2026-08-21
12
12
  status: current
13
13
  ---
14
14
 
@@ -16,8 +16,8 @@ status: current
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(無對應核心標準)
@@ -280,7 +280,7 @@ HMW(預設起點)、SCAMPER(改善既有功能:Substitute 取代、Combi
280
280
  | **使用者衝擊** | 衝擊 70% · 對齊 30% |
281
281
  | **策略對齊** | 對齊 60% · 衝擊 40% |
282
282
 
283
- **各準則指引(1–5):**
283
+ **各準則指引(1–5,參考格式——不是評審必須逐步照走的腳本):**
284
284
 
285
285
  | 準則 | 5 | 3 | 1 |
286
286
  |------|---|---|---|
@@ -306,7 +306,7 @@ HMW(預設起點)、SCAMPER(改善既有功能:Substitute 取代、Combi
306
306
  - **Devil's Advocate(魔鬼代言人)**:「你的任務是論證這個想法*會*失敗。提出 2 個具體的失敗條件。」
307
307
  - **Steelman(強論立場)**:「陳述最強、最善意版本的反論點——一個有思考力的對手真的會提出的那種。」
308
308
 
309
- 每個反論點都必須採取以下形式:**「這個想法會在 [特定脈絡] 失敗,因為 [特定理由]。」**
309
+ 約束:每個反論點都必須指出**特定脈絡**與**特定理由**。句型**「這個想法會在 [特定脈絡] 失敗,因為 [特定理由]」**是參考格式,不是必用句式(v4.2——評審提示為目標+約束,見 SKILL.md「評審提示形狀」)。
310
310
 
311
311
  **不可接受**(太空泛):「這可能很難。」/「可能會有 edge case。」
312
312
 
@@ -342,6 +342,7 @@ HMW(預設起點)、SCAMPER(改善既有功能:Substitute 取代、Combi
342
342
  **Personas Used**: [領域專家, 懷疑者, 類比者, ...]
343
343
  **Lenses Used**: [類比, 反轉, ...]
344
344
  **Pre-flight**: [Completed / Skipped] **Rebuttal**: [Completed / Skipped] **Tier**: [Baseline / Enhanced]
345
+ **評審模型層級(D4 心智軸)**: [core/model-selection.md 的廠商中立層級標籤——指名廠商模型即違規;未宣告 → D4 [degraded]]
345
346
 
346
347
  ## Problem Statement
347
348
  [精煉後的問題 + 5 Whys 的根本原因]
@@ -549,7 +550,7 @@ BQS v1 是**疊加的品質契約**,不是打掉重練。v3 的一切都保留
549
550
 
550
551
  - **所有旗標**:`--personas`、`--lens`、`--enhanced`、`--skip-preflight`、`--no-rebuttal`、`--quick`、`--technique` 行為與 v3 完全相同。v4 僅新增一個可選旗標 `--intent`,供第 0 層宣告。
551
552
  - **所有機制**:PRE-FLIGHT 防錨定、FRAME 5-Whys/HMW、persona 集成、多樣性透鏡、多評審面板、硬角色反駁(Devil's Advocate + Steelman)、多樣性崩塌護欄、Enhanced 層,皆不變。
552
- - **`--enhanced` 隔離 agent 宿主**正是讓 BQS **D4 pass**(判官≠產生者)的條件;baseline 單 context 標 `[degraded]`、不靜默通過。
553
+ - **`--enhanced` 隔離 agent 宿主**滿足的是 BQS **D4 的座位軸**(判官≠產生者);自 v4.2(XSPEC-388)起,D4 pass 另需評審宣告**模型層級**(心智軸——依 core/model-selection.md 的廠商中立標籤)。baseline 單 context 標 `[degraded]`、不靜默通過。
553
554
 
554
555
  ---
555
556
 
@@ -584,6 +585,7 @@ BQS v1 是**疊加的品質契約**,不是打掉重練。v3 的一切都保留
584
585
  | [Requirement Engineering](../../core/requirement-engineering.md) | 腦力激盪輸出餵入需求撰寫 |
585
586
  | [Spec-Driven Development](../../core/spec-driven-development.md) | 腦力激盪輸出餵入 SDD 提案 |
586
587
  | [Anti-Hallucination](../../core/anti-hallucination.md) | 評審的可行性宣稱必須以證據為基礎,不可空口斷言 |
588
+ | [Model Selection](../../core/model-selection.md) | D4 心智軸(宣告模型層級)與發散側層級(Standard 或更高)皆以此標準的判準為準——引用、絕不複述 |
587
589
 
588
590
  ---
589
591
 
@@ -591,6 +593,7 @@ BQS v1 是**疊加的品質契約**,不是打掉重練。v3 的一切都保留
591
593
 
592
594
  | 版本 | 日期 | 變更 |
593
595
  |------|------|------|
596
+ | 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 旗標與機制保留。 |
594
597
  | 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 個並標示「未達門檻,僅供參考」,避免報告空白。 |
595
598
  | 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 旗標/機制保留。 |
596
599
  | 3.0.0 | 2026-06-01 | XSPEC-247:DIVERGE 重新對齊到 persona 集成 + 多樣性透鏡(類比/反轉/形態學);CONVERGE 重新對齊到多評審面板 + 硬角色反駁(Devil's Advocate + Steelman);多樣性崩塌護欄;Enhanced 層級(平行 persona/評審代理、優雅退回);認知科學依據以 6 項已驗證的 2024–2026 出處重建;效度說明重新評等(pre-flight 為低、Nijstad/Nemeth 降級);新增旗標 `--personas`/`--lens`/`--enhanced`;反種子護欄 |
@@ -66,5 +66,6 @@ description: |
66
66
 
67
67
  ## 參考
68
68
 
69
+ - [Pre-Commit Checklist(提交前檢查清單)](./checkin-checklist.md) — 提交之前當作最後一道檢查時讀它。
69
70
  - 詳細指南:[guide.md](./guide.md)
70
71
  - 核心規範:[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: 3212203924de
5
- translation_version: 4.0.0
6
- last_synced: 2026-06-22
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
  ---
@@ -36,7 +37,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
36
37
  | **PRE-FLIGHT** | 防止 AI 錨定 | 使用者先寫 3 個想法;無類比種子;**BQS 第 0 層意圖(explore/exploit)** |
37
38
  | **FRAME** | 清楚定義問題 | 5 Whys、HMW、Stakeholder Map;**D1 框架純度** |
38
39
  | **DIVERGE** | 逼出視角多樣性 | persona 集成 + 多樣性透鏡;**BQS 第 1 層 D1–D4,硬閘隱藏 D5–D8** |
39
- | **CONVERGE** | 降偏誤選擇 | 多評審面板 + Devil's Advocate/Steelman;**BQS 第 2 層 D5–D8 施於 Top 3,D4 判官≠產生者** |
40
+ | **CONVERGE** | 降偏誤選擇 | 多評審面板 + Devil's Advocate/Steelman;**BQS 第 2 層 D5–D8 施於推薦集(Agg. ≥ 3.5),D4 判官≠產生者(兩軸:獨立 context+宣告模型層級)** |
40
41
  | **OUTPUT** | 可執行的報告 | Brainstorm Report + Seeds + 爭議區 + **第 3 層 Judgment Override** |
41
42
 
42
43
  > **BQS v1(XSPEC-296):** v4 在 v3 上疊加四層 × 時間軸品質契約。完整 oracle 與結構規則見 skill:[Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md#bqs-v1--品質契約)。
@@ -70,7 +71,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
70
71
  ## Problem Statement
71
72
  [Refined problem from FRAME phase]
72
73
 
73
- ## Top 3 Recommendations
74
+ ## Recommendations (Agg. Score ≥ 3.5 — uncapped)
74
75
  1. **[Idea]** — Agg. X.X ✓ Passed rebuttal — Persona: [..] — [Why recommended]
75
76
 
76
77
  ## Diversity Note
@@ -102,7 +103,7 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
102
103
  | `/brainstorm "topic"` | 以指定主題啟動 PRE-FLIGHT,再進入 FRAME |
103
104
  | `/brainstorm --personas "a,b,c"` | 以自訂 persona 組進入 DIVERGE |
104
105
  | `/brainstorm --lens <name>` | 以指定多樣性透鏡為主進入 DIVERGE |
105
- | `/brainstorm --enhanced` | 若宿主支援子代理則平行跑 persona/評審,否則靜默退回 baseline;此模式下 BQS D4 方可 pass |
106
+ | `/brainstorm --enhanced` | 若宿主支援子代理則平行跑 persona/評審,否則靜默退回 baseline;此模式滿足 BQS D4 的座位軸(獨立 context),pass 另需宣告模型層級(心智軸,見 skill D4) |
106
107
  | `/brainstorm --intent exploit` | 以 exploit 意圖啟動(BQS 第 0 層),D2 低覆蓋不扣分 |
107
108
 
108
109
  ### 互動腳本
@@ -127,12 +128,13 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
127
128
  3. 至少套用一個多樣性透鏡(類比/假設反轉/形態矩陣)
128
129
  4. 以多樣性(覆蓋的 persona/透鏡數,D2/D3)而非數量為繼續門檻
129
130
  5. **硬序列閘**:D5–D8 在最後一個 persona 產完前**不得揭示或評分**;CONVERGE critic 不得提前呼叫
131
+ 6. **模型層級(發散側)**:以 **Standard 或更高**層級執行——依 core/model-selection.md 的 MS-004/Criterion 2(引用,不複述;不是「最高層級」)
130
132
 
131
- #### CONVERGE Phase(BQS 第 2 層 — D5–D8 僅施於 Top 3)
132
- 1. 以 3 個獨立評審(工程可行性/使用者影響/策略一致)各自評分後聚合
133
- 2. 對前 3 名跑硬角色 Devil's Advocate(論證會失敗)+ Steelman;使用者以 (a)修改/(b)反駁/(c)移除 回應。**D4 判官≠產生者**:評審須在獨立 context(`--enhanced`)方可 pass,否則標 `[degraded]` 不得 pass
134
- 3. **僅對 Top 3** 套用 D5 接地(外部事實需 file:line/來源、跨級地板;假說免接地)、D6 淨值(解誰問題/真有嗎/不做代價+掛 lagging 欄)、D7 二態證偽(「需先做 X」轉 next-step、不算 fail)、D8 next-step 裁決
135
- 4. **Meta 停止規則**:維度全綠且再跑一輪 Top 3 集合成員不變→停;硬上限 2 輪
133
+ #### CONVERGE Phase(BQS 第 2 層 — D5–D8 僅施於推薦集)
134
+ 1. 以 3 個獨立評審(工程可行性/使用者影響/策略一致)各自評分後聚合;**評審提示以「目標+約束」表達**(判準,不是步驟清單——理由見 skill 引用的 core/model-selection.md MS-009),加權公式與逐準則指南為參考格式
135
+ 2. 對**推薦集**(Agg. Score ≥ 3.5,不限筆數)跑硬角色 Devil's Advocate(論證會失敗)+ Steelman;使用者以 (a)修改/(b)反駁/(c)移除 回應。**D4 判官≠產生者,兩軸**:(1) 評審在獨立 context(`--enhanced`)執行,且 (2) 宣告模型層級(core/model-selection.md 的廠商中立標籤;指名具體廠商模型即違規)——缺任一軸標 `[degraded]` 不得 pass
136
+ 3. **僅對推薦集**套用 D5 接地(外部事實需 file:line/來源、跨級地板;假說免接地)、D6 淨值(解誰問題/真有嗎/不做代價+掛 lagging 欄)、D7 二態證偽(「需先做 X」轉 next-step、不算 fail)、D8 next-step 裁決——四者為判準、不限順序
137
+ 4. **Meta 停止規則**:維度全綠且再跑一輪推薦集集合成員不變→停;硬上限 2 輪
136
138
 
137
139
  🛑 **STOP**: 展示 Brainstorm Report(含 Seeds/爭議區/Judgment Override)後等待使用者決定下一步
138
140
 
@@ -153,13 +155,15 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
153
155
  | 使用「像 X 但給 Y」種子 | 改寫為底層問題再繼續(反種子 guardrail) |
154
156
  | 指定的 persona/透鏡不存在 | 列出可用選項供選擇 |
155
157
  | `--enhanced` 但宿主不支援子代理 | 靜默退回 baseline,照常進行 |
156
- | 前 3 名全來自同一 persona/透鏡 | 標示並在輸出前再跑一個透鏡 |
158
+ | 推薦集全來自同一 persona/透鏡 | 標示並在輸出前再跑一個透鏡 |
157
159
  | baseline 單 context 跑評審(無獨立 context) | BQS D4 標 `[degraded]`,不得標 pass |
160
+ | 評審未宣告模型層級(或以具體廠商模型名宣告) | BQS D4 標 `[degraded]` 不得 pass;模型名改為 core/model-selection.md 的層級標籤 |
158
161
  | 外部事實宣稱無 file:line/來源 | D5 接地 fail,要求補來源或改標 `[假說]` |
159
162
 
160
163
  ## 參考
161
164
 
162
165
  * [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)
163
166
  * [Brainstorm Assistant Guide](../brainstorm-assistant/guide.md)
167
+ * [Model Selection](../../core/model-selection.md) — BQS D4 與發散側的模型層級標籤(引用,不複述)
164
168
  * [Requirement Assistant](../requirement-assistant/SKILL.md)
165
169
  * [Spec-Driven Development](../spec-driven-dev/SKILL.md)
@@ -171,7 +171,6 @@ Current Skills status:
171
171
  | 模式 | 說明 |
172
172
  |------|------|
173
173
  | `standard` | 摘要 + 任務映射,AI 知道何時讀取哪個標準(推薦)|
174
- | `full` | 將所有標準完整內嵌於整合檔案 |
175
174
  | `minimal` | 僅內嵌核心規則 |
176
175
 
177
176
  ## 設定變更的影響
@@ -42,7 +42,7 @@ argument-hint: "[--level N | --yes]"
42
42
  | **OpenCode** | `AGENTS.md` | ✅ | ✅ |
43
43
  | **Gemini CLI** | `GEMINI.md` | ✅ | ✅ |
44
44
  | **Codex** | `AGENTS.md` | ✅ | ❌ |
45
- | **Antigravity** | `INSTRUCTIONS.md` | ✅ | ❌ |
45
+ | **Antigravity** | `.agents/AGENTS.md` | ✅ | ❌ |
46
46
 
47
47
  預選環境中偵測到的工具。注意:Codex 和 OpenCode 共用 `AGENTS.md`。
48
48
 
@@ -211,7 +211,6 @@ Options:
211
211
  | 選項 | 說明 |
212
212
  |------|------|
213
213
  | **Standard(建議)** | 摘要 + 任務對應,AI 知道何時讀取哪項標準 |
214
- | **Full Embed** | 嵌入所有規則,AI 可立即使用但檔案較大 |
215
214
  | **Minimal** | 僅檔案參考,適合搭配 Skills 使用 |
216
215
 
217
216
  ### 步驟 13:確認並執行
@@ -126,6 +126,8 @@ Closes #123
126
126
 
127
127
  ## 參考
128
128
 
129
+ - [Conventional Commits 指南](./conventional-commits.md) — 需要確切的 type、scope 與格式規則時讀它。
130
+ - [Commit Message 語言選項](./language-options.md) — 要決定 commit message 用哪一種語言時讀它。
129
131
  - 詳細指南:[guide.md](./guide.md)
130
132
  - 核心規範:[commit-message-guide.md](../../../../core/commit-message-guide.md)
131
133