universal-dev-standards 6.13.1 → 6.14.0-beta.10

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 (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -1,17 +1,20 @@
1
1
  ---
2
2
  source: ../../../core/acceptance-criteria-traceability.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-23
6
- status: stale
3
+ source_version: 1.2.0
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 06ca6a77af24
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 验收标准可追溯性规范
10
11
 
11
- > **语言**: [English](../../../core/acceptance-criteria-traceability.md) | 简体中文
12
+ > **语言**: [English](../../../core/acceptance-criteria-traceability.md) | [繁體中文](../../zh-TW/core/acceptance-criteria-traceability.md) | 简体中文
12
13
 
14
+ **版本**: 1.2.0
15
+ **最后更新**: 2026-08-24
13
16
  **适用范围**: 所有使用规格驱动或测试驱动工作流程的软件项目
14
- **Scope**: universal
17
+ **范围**: universal
15
18
 
16
19
  ---
17
20
 
@@ -78,6 +81,12 @@ class TestAC1_UserLogin:
78
81
  Scenario: User login with valid credentials
79
82
  ```
80
83
 
84
+ > **键名拼法(刻意设计,不是冲突)。** `acceptance-criteria`(kebab-case)
85
+ > 是给人看的/识别字拼法——文档标题、标准 id、AI 格式的键。
86
+ > `acceptance_criteria`(snake_case)是 YAML **序列化**字段(例如
87
+ > `structured-task-definition`)。`acceptanceCriteria`(camelCase)不使用。
88
+ > 这些是各层适用的拼法(见词汇表的字段命名表),**不予统一**。
89
+
81
90
  ---
82
91
 
83
92
  ## 覆盖状态定义
@@ -89,28 +98,60 @@ Scenario: User login with valid credentials
89
98
  | **已覆盖** | ✅ | AC 已完整测试 | AC 中所有条件都有对应的测试断言 |
90
99
  | **部分覆盖** | ⚠️ | AC 已部分测试 | 部分条件已测试,但缺少边界情况或执行路径 |
91
100
  | **未覆盖** | ❌ | AC 没有测试 | 没有任何测试用例引用此 AC |
101
+ | **未实现** | 🚫 | AC 没有对应的实现 | 功能代码不存在(不是测试缺口,而是代码缺口) |
102
+
103
+ ### `not_implemented` 与 `uncovered` 判定树
104
+
105
+ ```
106
+ Q1: Does the corresponding code exist in src/?
107
+ No → 🚫 not_implemented
108
+ Yes → Q2: Does any test reference this AC?
109
+ No → ❌ uncovered
110
+ Yes → Q3: Are all conditions in the AC tested?
111
+ Yes → ✅ covered
112
+ No → ⚠️ partial
113
+ ```
114
+
115
+ `not_implemented` 的典型信号:`throw new NotImplementedException()`、空的 stub 函数体、`// FEATURE_STUB:` 标记。
92
116
 
93
117
  ### 覆盖率计算
94
118
 
95
119
  ```
96
- AC Coverage % = (covered_count / total_ac_count) × 100
120
+ AC Coverage % = (covered_count + partial_count × 0.5) / (total_ac_count - not_implemented_count) × 100
97
121
 
98
122
  Where:
99
123
  covered_count = count of AC with status "covered"
100
124
  total_ac_count = total number of AC in specification
125
+ not_implemented_count = count of AC with status "not_implemented" (excluded from denominator)
101
126
  partial counts as 0.5 for coverage calculation
102
127
  ```
103
128
 
104
129
  ### 计算范例
105
130
 
106
131
  ```
107
- SPEC-001: 8 AC total
108
- - 5 covered (✅)
109
- - 2 partial (⚠️)
110
- - 1 uncovered (❌)
132
+ SPEC-001: 20 AC total
133
+ - 15 covered (✅)
134
+ - 0 partial (⚠️)
135
+ - 2 uncovered (❌)
136
+ - 3 not_implemented (🚫)
137
+
138
+ Coverage = (15 + 0) / (20 - 3) × 100 = 88.2%
139
+ Status: BLOCKED by 3 not_implemented AC(s)
140
+ ```
141
+
142
+ ### `not_implemented` 的 CI 闸门
143
+
144
+ `not_implemented` 的 AC 会触发一道**阻断式** CI 闸门,与覆盖率百分比闸门各自独立:
111
145
 
112
- Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
113
146
  ```
147
+ [AC-NOT-IMPL] 3 AC(s) marked not_implemented:
148
+ 🚫 AC-007 OrderCancellation
149
+ 🚫 AC-012 RefundCalculation
150
+ 🚫 AC-019 ExportToPDF
151
+ All not_implemented ACs must be resolved before UAT.
152
+ ```
153
+
154
+ 只有当所有 `not_implemented` 的 AC 都更新为 `uncovered`、`partial` 或 `covered` 时,闸门才会解除。
114
155
 
115
156
  ---
116
157
 
@@ -195,6 +236,8 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
195
236
  | 基础设施限制 | 测试环境限制 | 解决方案计划 |
196
237
  | 延后至下一迭代 | 已与利害关系人确认 | Ticket 引用 |
197
238
 
239
+ > 本标准产出的**延后项目**(`Gaps` 的 Uncovered AC/Partial AC、上表的例外、报告的 `Action Items`)适用 [deferred-item-exit](../../../core/deferred-item-exit.md)。
240
+
198
241
  ---
199
242
 
200
243
  ## AC 覆盖率报告格式
@@ -205,7 +248,7 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
205
248
  # AC Coverage Report
206
249
 
207
250
  **Specification**: SPEC-001 — User Authentication
208
- **Generated**: 2026-03-23
251
+ **Generated**: 2026-03-18
209
252
  **Coverage**: 75% (6/8 AC)
210
253
 
211
254
  ## Summary
@@ -246,7 +289,7 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
246
289
  {
247
290
  "specId": "SPEC-001",
248
291
  "specName": "User Authentication",
249
- "generatedAt": "2026-03-23T10:00:00Z",
292
+ "generatedAt": "2026-03-18T10:00:00Z",
250
293
  "coverage": {
251
294
  "percentage": 75,
252
295
  "covered": 5,
@@ -325,6 +368,8 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
325
368
  | 忽略未覆盖的 AC | 验证存在缺口 | 追踪并规划所有 AC 的覆盖工作 |
326
369
  | AC 缺乏可测试性 | 无法验证 | 确保所有 AC 都可测试 |
327
370
  | 覆盖但缺乏断言 | 测试执行但不验证任何内容 | 确认测试含有有意义的断言 |
371
+ | 代码不存在却标为 `uncovered` | 掩盖功能完整性的缺口 | 代码不存在时使用 `not_implemented` |
372
+ | 把 `not_implemented` 计入分母 | 灌水覆盖率指标 | 将 `not_implemented` 排除于分母之外 |
328
373
 
329
374
  ---
330
375
 
@@ -343,3 +388,5 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
343
388
  | 版本 | 日期 | 变更内容 |
344
389
  |------|------|---------|
345
390
  | 1.0.0 | 2026-03-18 | 初始版本 — 可追溯性矩阵、覆盖率计算、规格生成规则 |
391
+ | 1.1.0 | 2026-05-12 | 新增第 4 种状态 `not_implemented`;更新 CI 闸门公式;新增判定树(XSPEC-199) |
392
+ | 1.2.0 | 2026-08-24 | 为覆盖缺口、门槛例外与报告行动项目加上指向 `deferred-item-exit` 的指标(XSPEC-391 R5) |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/acceptance-test-driven-development.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: c3209a2e8e02
6
7
  status: current
7
8
  ---
8
9
 
@@ -1,17 +1,18 @@
1
1
  ---
2
2
  source: ../../../core/adr-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-26
6
- status: stale
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 929da01fb617
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 架构决策记录(ADR)
10
11
 
11
- > **语言**: [English](../../../core/adr-standards.md) | 简体中文
12
+ > **语言**: [English](../../../core/adr-standards.md) | [繁體中文](../../zh-TW/core/adr-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-03-26
14
+ **版本**: 1.1.0
15
+ **最后更新**: 2026-08-24
15
16
  **适用范围**: 所有进行架构决策的软件项目
16
17
  **范畴**: universal
17
18
  **行业标准**: ISO/IEC/IEEE 42010(架构描述)、TOGAF ADR
@@ -50,38 +51,68 @@ status: stale
50
51
  - **Deciders**: [参与决策者]
51
52
  - **Technical Story**: [相关 SPEC-ID、Issue 或 PR]
52
53
 
53
- ## Context(背景)
54
+ ## Context
54
55
 
55
- [描述引发此决策的技术或业务背景。]
56
+ [描述引发此决策的技术或业务背景。
57
+ 问题或机会是什么?存在哪些限制?]
56
58
 
57
- ## Decision Drivers(决策驱动因素)
59
+ ## Decision Drivers
58
60
 
59
- - [驱动因素 1]
60
- - [驱动因素 2]
61
+ - [驱动因素 1:例如性能要求]
62
+ - [驱动因素 2:例如团队专长]
63
+ - [驱动因素 3:例如预算限制]
61
64
 
62
- ## Considered Options(考虑的选项)
65
+ ## Considered Options
63
66
 
64
67
  1. [选项 1]
65
68
  2. [选项 2]
66
69
  3. [选项 3]
67
70
 
68
- ## Decision Outcome(决策结果)
71
+ ## Decision Outcome
69
72
 
70
73
  选择 **[选项 N]**,因为 [理由]。
71
74
 
72
- ### Consequences(后果)
75
+ ### Consequences
73
76
 
74
77
  **Good:**
75
- - [正面结果]
78
+ - [正面结果 1]
79
+ - [正面结果 2]
76
80
 
77
81
  **Bad:**
78
- - [负面结果或取舍]
82
+ - [负面结果或取舍 1]
83
+ - [接受的风险 1]
79
84
 
80
- ## Links(相关链接)
85
+ **Neutral:**
86
+ - [既非正面也非负面的副作用]
81
87
 
82
- - [相关 ADR、SPEC、PR]
88
+ ## Links
89
+
90
+ - [相关 ADR、SPEC、PR 或外部参考]
83
91
  ```
84
92
 
93
+ > 此模板中记下的**延后项目**(`Consequences` 下的既受风险与负面后果、被考虑而未采用的选项)适用 [deferred-item-exit](../../../core/deferred-item-exit.md)。
94
+
95
+ ---
96
+
97
+ ## 验收标准放在 SPEC 里
98
+
99
+ 一份 ADR 记录的是**决策**,它不带自己的一份验收标准。当一个决策有验收标准时,
100
+ 它们**只在一处维护——SPEC**,而 ADR 以链接(`Technical Story` 或 `Links`)指向它。
101
+
102
+ 一份被复制的 AC 清单有两个拥有者,而只有其中一个会被更新。实测后果是:
103
+ 实现完成、SPEC 的勾选框打勾,ADR 那一份**整份留在未勾选状态**——
104
+ 读 ADR 的人于是认为什么都没做,而读 SPEC 的 AC 覆盖率工具**根本看不到 ADR 里那一份**。
105
+
106
+ > 本条是关于 **AC 在哪里维护**的边界规则,不涉及 AC 的写法或标注惯例。AC 本身的格式见 [spec-driven-development](spec-driven-development.md);AC 到验证的可追溯性见 [acceptance-criteria-traceability](acceptance-criteria-traceability.md)。
107
+
108
+ ---
109
+
110
+ ## ADR 编号
111
+
112
+ - 使用连续编号:`ADR-001`、`ADR-002` 等。
113
+ - 编号永不重复使用,即使 ADR 已被 deprecated。
114
+ - 多项目组织可加上项目识别前缀:`[PROJECT]-ADR-001`。
115
+
85
116
  ---
86
117
 
87
118
  ## 状态生命周期
@@ -96,13 +127,15 @@ Proposed ──► Accepted ──► Deprecated
96
127
  |------|------|
97
128
  | **Proposed** | 讨论中,尚未决定 |
98
129
  | **Accepted** | 决策生效,应遵循 |
99
- | **Deprecated** | 不再适用 |
100
- | **Superseded** | 已被更新的 ADR 取代 |
130
+ | **Deprecated** | 决策不再适用(例如功能已移除) |
131
+ | **Superseded** | 已被更新的 ADR 取代(附上链接) |
101
132
 
102
133
  ### 规则
103
134
 
104
- 1. 永远不要将 **Accepted** 的 ADR 改回 **Proposed**。改为建立新 ADR 取代它。
105
- 2. **Deprecated** 和 **Superseded** 是终态。
135
+ 1. **Proposed** 的 ADR 可以变成 **Accepted**,或被删除(若遭否决)。
136
+ 2. **Accepted** 的 ADR 可以变成 **Deprecated** 或 **Superseded**。
137
+ 3. **Deprecated** 和 **Superseded** 是终态。
138
+ 4. 永远不要将 **Accepted** 的 ADR 改回 **Proposed**。改为建立新 ADR 取代它。
106
139
 
107
140
  ---
108
141
 
@@ -112,18 +145,88 @@ Proposed ──► Accepted ──► Deprecated
112
145
  docs/adr/
113
146
  ├── ADR-001-use-postgresql.md
114
147
  ├── ADR-002-adopt-event-sourcing.md
115
- └── README.md # ADR 索引(可选)
148
+ ├── ADR-003-migrate-to-kubernetes.md
149
+ └── README.md # ADR index (optional)
116
150
  ```
117
151
 
152
+ ### 文件命名
153
+
118
154
  - 格式:`ADR-NNN-short-description.md`
119
155
  - 描述部分使用 kebab-case。
156
+ - 描述保持在 5 个单词以内。
157
+
158
+ ### 索引文件(可选)
159
+
160
+ 在 `docs/adr/` 中维护一份列出所有 ADR 的 `README.md`:
161
+
162
+ ```markdown
163
+ # Architecture Decision Records
164
+
165
+ | ADR | Title | Status | Date |
166
+ |-----|-------|--------|------|
167
+ | [ADR-001](ADR-001-use-postgresql.md) | Use PostgreSQL | Accepted | 2026-01-15 |
168
+ | [ADR-002](ADR-002-adopt-event-sourcing.md) | Adopt Event Sourcing | Superseded by ADR-005 | 2026-02-01 |
169
+ ```
170
+
171
+ ---
172
+
173
+ ## 取代一份 ADR
174
+
175
+ 当一个决策被取代时:
176
+
177
+ 1. 以更新后的决策建立新的 ADR。
178
+ 2. 在新 ADR 中加上:`Supersedes [ADR-NNN](ADR-NNN-old-title.md)`。
179
+ 3. 将旧 ADR 的状态更新为:`Superseded by [ADR-NNN](ADR-NNN-new-title.md)`。
180
+ 4. 保留旧 ADR 的内容不动,作为历史背景。
181
+
182
+ ---
183
+
184
+ ## 与其他产物的整合
185
+
186
+ | 产物 | 整合方式 |
187
+ |------|---------|
188
+ | **SDD 规格** | 在 Technical Design 区段引用 ADR |
189
+ | **代码注释** | 实现不明显的模式时链接 ADR:`// See ADR-003` |
190
+ | **PR 描述** | 架构变更时引用相关 ADR |
191
+ | **Commit 消息** | 在 footer 加上 `ADR-NNN` 以便追溯 |
192
+
193
+ ---
194
+
195
+ ## 质量检查清单
196
+
197
+ 接受一份 ADR 前,确认:
198
+
199
+ - [ ] **Context** 清楚说明问题或机会
200
+ - [ ] 至少考虑过 **2 个选项**
201
+ - [ ] 明确列出 **决策驱动因素**
202
+ - [ ] **Consequences** 同时包含正面与负面结果
203
+ - [ ] **Status** 设置正确
204
+ - [ ] 附上相关产物的 **Links**
205
+ - [ ] 文件存放在 `docs/adr/` 且命名正确
206
+ - [ ] **没有把验收标准复制进 ADR**——改为链接到维护它们的 SPEC
207
+ - [ ] 每个**延后项目**都带有其出口的识别码([deferred-item-exit](../../../core/deferred-item-exit.md))
208
+
209
+ ---
210
+
211
+ ## 反模式
212
+
213
+ | 反模式 | 问题 | 修正 |
214
+ |-------|------|------|
215
+ | 事后才写 ADR | 缺少真实背景与替代方案 | 在决策之前或当下撰写 ADR |
216
+ | ADR 太多 | 决策疲劳、噪音 | 只记录重大决策 |
217
+ | ADR 太少 | 知识流失、重复争论 | 遵循上方的「6 个月法则」 |
218
+ | 没有后果 | 分析不完整 | 一律列出正面与负面结果 |
219
+ | 背景模糊 | 对未来读者毫无用处 | 写出具体的限制与驱动因素 |
220
+ | 编辑已接受的 ADR | 历史流失 | 改为取代,而非编辑 |
221
+ | 把 SPEC 的验收标准复制进 ADR | 两个拥有者、只有一个被更新;ADR 那份永远未勾选,覆盖率工具也看不到 | SPEC 只保留一份,以链接指向它 |
222
+ | 接受的风险没有出口 | ADR 是唯一的载体,而它现在已被批准 | 给它一个出口,并在此写明该出口 |
120
223
 
121
224
  ---
122
225
 
123
226
  ## 最佳实践
124
227
 
125
228
  1. **在决策当下撰写 ADR** — 不要等到几周后背景已遗忘。
126
- 2. **保持简短** — 最多 1-2 页。
229
+ 2. **保持简短** — 最多 1-2 页。简短才会有人写、有人读。
127
230
  3. **包含被排除的选项** — 知道什么没有被选择与知道什么被选择一样有价值。
128
231
  4. **双向链接** — ADR 引用代码;代码引用 ADR。
129
232
  5. **定期审查** — 在架构审查时标记过时的 ADR 为 deprecated。
@@ -180,9 +283,9 @@ docs/adr/
180
283
 
181
284
  | 状态 | 含义 | 行动 |
182
285
  |------|------|------|
183
- | **Adopt** | 已验证有效,全面采用 | 列为标准实践,记录最佳实践文档 |
184
- | **Trial** | 正在评估中,有限范围试行 | 持续测量,维护假设书(必填下次评估日期) |
185
- | **Assess** | 有限条件下有效,需谨慎 | 记录适用边界,不扩大采用 |
286
+ | **Adopt** | 已验证有效,全面采用 | 列为标准实践,记录证据 |
287
+ | **Trial** | 正在评估中,有限范围试行 | 持续测量,维护假设书 |
288
+ | **Assess** | 有限条件下有效 | 记录适用边界,不扩大采用 |
186
289
  | **Hold** | 评估无效或有害 | 停止新增采用,规划移除 |
187
290
 
188
291
  **默认值**:所有新建借鉴型 DEC 从 `Trial` 开始。
@@ -217,9 +320,14 @@ Step 3: 判定方法本身无效
217
320
  > **移除原因**: 方法本身无效 | 场景不符 | 有反效果
218
321
  > **紧急程度**: 正常流程 | 紧急(反效果,立即停用)
219
322
 
323
+ ---
324
+
220
325
  ## 移除原因
221
326
 
222
- [详述为何判定此方法无效]
327
+ [详述为何判定此方法无效。说明已确认:
328
+ 1. 实作正确性(已对照原始论文/Repo 确认)
329
+ 2. 应用场景符合性(已确认场景符合论文假设)
330
+ 3. 方法在我们环境中的实际表现]
223
331
 
224
332
  ## 诊断过程
225
333
 
@@ -229,9 +337,18 @@ Step 3: 判定方法本身无效
229
337
  | Step 2 | 应用场景是否符合论文假设 | ✅ 符合 |
230
338
  | Step 3 | 方法本身有效性 | ❌ 无效 |
231
339
 
340
+ ## 观察到的指标
341
+
342
+ | 指标 | 借鉴前 | 借鉴后 | 预期目标 | 判定 |
343
+ |------|-------|-------|---------|------|
344
+ | [指标名称] | [基准值] | [实际值] | [目标值] | ❌ 未达成 |
345
+
232
346
  ## 反模式记录
233
347
 
348
+ > 记录此方法在我们环境中的反模式,供未来避免相同错误。
349
+
234
350
  - [反模式 1: 具体描述]
351
+ - [反模式 2: 具体描述]
235
352
 
236
353
  ## 移除步骤
237
354
 
@@ -239,16 +356,22 @@ Step 3: 判定方法本身无效
239
356
  - [ ] 移除实作代码
240
357
  - [ ] 更新 TECH-RADAR.md:状态改为 Hold
241
358
  - [ ] 更新原始 DEC 状态为 `Superseded by DEC-NNN-reversal`
242
- - [ ] 在下次 Retrospective 分享学习
359
+ - [ ] 在下次 Retrospective 分享学习(紧急情况除外)
243
360
 
244
361
  ## 学习点
245
362
 
246
- [从此次失败借鉴中学到什么?]
363
+ [从此次失败借鉴中学到什么?对未来借鉴决策的启示?]
364
+
365
+ ## Links
366
+
367
+ - 原始 DEC: [DEC-NNN](DEC-NNN-original-title.md)
368
+ - 相关 Retrospective: [链接]
369
+ - TECH-RADAR: [cross-project/decisions/TECH-RADAR.md](../decisions/TECH-RADAR.md)
247
370
  ```
248
371
 
249
372
  ### Reversal DEC 规则
250
373
 
251
- 1. **必须建立** Reversal DEC:当方法本身被确认无效(非实作错误)。
374
+ 1. **必须建立** Reversal DEC:当方法本身被确认无效(不只是实作错误)。
252
375
  2. **不建立** Reversal DEC:若是实作错误,修正后重启假设书计时即可。
253
376
  3. 原始 DEC 状态应更新为 `Superseded by DEC-NNN-reversal`。
254
377
  4. Reversal DEC 是终态,不会再被撤销。
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/agent-communication-protocol.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-11
6
+ source_hash: fa627ef7668a
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/agent-dispatch.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: d18ca22786b3
6
7
  status: current
7
8
  ---
8
9
 
@@ -59,55 +60,89 @@ Prompt 包含执行所需的完整上下文,代理不需要额外提问或搜
59
60
 
60
61
  ---
61
62
 
62
- ## 独立性验证
63
+ ## 状态协议
63
64
 
64
- 在并行派遣前,必须检查以下条件:
65
+ 每个子代理完成时必须回报以下四种状态之一:
65
66
 
66
- | 检查项 | 条件 | 失败时处理 |
67
- |--------|------|-----------|
68
- | 文件集合不相交 | 两个任务不修改相同文件 | 串行执行 |
69
- | 无共享可变状态 | 任务间不依赖共享变量 | 合并为单一任务 |
70
- | 无执行顺序依赖 | 任务 B 不需要任务 A 的输出 | 串行执行 |
67
+ | 状态 | 说明 | 编排器动作 |
68
+ |------|------|-----------|
69
+ | `DONE` | 任务成功完成 | 继续下一个任务 |
70
+ | `DONE_WITH_CONCERNS` | 已完成,但有需要记录的疑虑 | 记录疑虑,继续 |
71
+ | `NEEDS_CONTEXT` | 需要更多上下文才能完成 | 注入上下文,重新派遣(不是重试) |
72
+ | `BLOCKED` | 无法完成,需要升级处理 | 升级模型等级或拆分任务 |
71
73
 
72
- ## 状态协议
74
+ ### 状态判定流程
73
75
 
74
- 每个子代理必须返回标准化状态:
76
+ ```
77
+ Agent completes work
78
+ ├── All acceptance criteria met? → DONE
79
+ ├── Criteria met but concerns exist? → DONE_WITH_CONCERNS
80
+ ├── Missing information to proceed? → NEEDS_CONTEXT
81
+ └── Fundamentally unable to complete? → BLOCKED
82
+ ```
75
83
 
76
- | 状态 | 含义 | 后续动作 |
77
- |------|------|---------|
78
- | `SUCCESS` | 任务完成,所有验证通过 | 整合结果 |
79
- | `FAILED` | 任务失败,附带错误详情 | 分析失败原因 |
80
- | `BLOCKED` | 任务被外部依赖阻塞 | 解除阻塞后重试 |
81
- | `PARTIAL` | 部分完成,附带进度说明 | 评估是否继续 |
84
+ ---
82
85
 
83
- ## 冲突预防
86
+ ## 冲突检测
84
87
 
85
- ### 文件级隔离
88
+ 并行代理返回时,编排器必须:
89
+
90
+ 1. **检查文件冲突** — 是否有多个代理修改了同一文件?
91
+ 2. **运行完整测试套件** — 合并所有变更后验证集成
92
+ 3. **解决冲突** — 自动解决,或标记交由人工审查
86
93
 
87
94
  ```
88
- 代理 A: src/auth/** ← 独立域
89
- 代理 B: src/payments/** ← 独立域
90
- 代理 C: src/shared/** ← ⚠️ 不可并行(共享域)
95
+ Agent A (modifies: src/auth.ts, src/auth.test.ts) ─┐
96
+ ├─→ Conflict check → Integration test
97
+ Agent B (modifies: src/api.ts, src/api.test.ts) ─┘
91
98
  ```
92
99
 
93
- ### 合并策略
100
+ ---
101
+
102
+ ## 规则
94
103
 
95
- | 情况 | 策略 |
96
- |------|------|
97
- | 无冲突 | 自动合并 |
98
- | 格式冲突(仅空白/排序) | 自动解决 |
99
- | 语义冲突 | 人工审查 |
104
+ | ID | 触发条件 | 动作 | 优先级 |
105
+ |----|---------|------|--------|
106
+ | AD-001 | 多个代理编辑同一文件 | 标记冲突,要求合并解决 | Critical |
107
+ | AD-002 | 代理回报 BLOCKED | 升级模型等级并重试一次 | High |
108
+ | AD-003 | 所有并行代理完成 | 运行完整测试套件验证集成 | High |
100
109
 
101
110
  ---
102
111
 
103
- ## 相关标准
112
+ ## 示例
104
113
 
105
- - [Git Worktree 隔离](git-worktree.md)
106
- - [分支完成工作流程](branch-completion.md)
107
- - [AI 模型选择策略](model-selection.md)
114
+ ### 正确:并行的独立任务
115
+
116
+ ```yaml
117
+ # Two agents working on independent modules
118
+ Agent 1:
119
+ task: "Add rate limiting to /api/users endpoint"
120
+ files: [src/api/users.ts, src/api/users.test.ts]
121
+
122
+ Agent 2:
123
+ task: "Add caching to /api/products endpoint"
124
+ files: [src/api/products.ts, src/api/products.test.ts]
125
+
126
+ # No shared files → safe to parallelize
127
+ ```
128
+
129
+ ### 错误:并行的相依任务
130
+
131
+ ```yaml
132
+ # Two agents modifying shared state
133
+ Agent 1:
134
+ task: "Refactor database connection pool"
135
+ files: [src/db.ts] # ⚠️ shared file
136
+
137
+ Agent 2:
138
+ task: "Add connection retry logic"
139
+ files: [src/db.ts] # ⚠️ conflict!
140
+ ```
108
141
 
109
142
  ---
110
143
 
111
- ## 许可证
144
+ ## 参考资料
112
145
 
113
- 本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
146
+ - **Superpowers**: [dispatching-parallel-agents](https://github.com/obra/superpowers), [subagent-driven-development](https://github.com/obra/superpowers) (MIT)
147
+ - **MapReduce**: 概念性的并行执行模型
148
+ - **Actor Model**: 独立代理的通信模式
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/ai-agreement-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: 9238a5b53f4e
6
7
  status: current
7
8
  ---
8
9
 
@@ -22,7 +23,7 @@ status: current
22
23
 
23
24
  ## 目的
24
25
 
25
- 本标准将人类(获取方)与 AI(供应方)之间的交互形式化为可验证的协议。在 "Vibe Coding" 中,prompt 上下文作为管理 AI 行为和交付物的合约。
26
+ 本标准将人类(获取方)与 AI(供应方)之间的交互形式化为可验证的协议。在 "Vibe Coding" 中,prompt 上下文即为约束 AI 行为和交付物的法律合约。
26
27
 
27
28
  ---
28
29
 
@@ -66,38 +67,38 @@ status: current
66
67
  # 交付要求
67
68
  1. [要求 A]
68
69
  2. [要求 B]
70
+
71
+ # 验证计划
72
+ - [ ] [测试用例 1]
73
+ - [ ] [测试用例 2]
69
74
  ```
70
75
 
71
76
  ---
72
77
 
73
- ## 3. 变更管理
74
-
75
- ### 3.1 范围变更协议
76
-
77
- | 变更类型 | 处理方式 |
78
- |---------|---------|
79
- | **范围内** | 直接实现 |
80
- | **小范围外** | 提出建议,等待确认 |
81
- | **大范围外** | 暂停,要求新的 RFP |
82
-
83
- ### 3.2 冲突解决
78
+ ## 3. 交付验收
84
79
 
85
- 当 AI 检测到指令冲突时:
80
+ ### 3.1 AI 自我验证
81
+ 在输出代码前,AI(供应方)必须依据上下文合约验证自己的输出:
82
+ - 这段代码是否违反任何约束法则?
83
+ - 是否满足所有验收条件?
86
84
 
87
- 1. 明确指出冲突
88
- 2. 列出冲突的指令
89
- 3. 提出推荐解决方案
90
- 4. 等待人类决策
85
+ ### 3.2 人类签核
86
+ 用户(获取方)在应用"交付物"(AI 输出)之前,必须严格审查:
87
+ - **审查**:阅读代码(不要直接信任)。
88
+ - **验证**:执行验证计划。
89
+ - **接受**:仅在验证通过后才提交变更。
91
90
 
92
91
  ---
93
92
 
94
93
  ## 相关标准
95
94
 
96
- - [虚拟组织标准](virtual-organization-standards.md)
97
- - [AI 指令标准](../../../core/ai-instruction-standards.md)
95
+ - [防幻觉协议](anti-hallucination.md)
96
+ - [需求工程](requirement-engineering.md)
98
97
 
99
98
  ---
100
99
 
101
- ## 许可证
100
+ ## 版本历史
102
101
 
103
- 本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
102
+ | 版本 | 日期 | 变更内容 |
103
+ |------|------|---------|
104
+ | 1.0.0 | 2026-01-29 | 初始发布,对应 ISO 12207 协议过程 |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/ai-command-behavior.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: d110d30416fc
6
7
  status: current
7
8
  ---
8
9