universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1

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 (721) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/mock-boundary.ai.yaml +138 -2
  5. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  6. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
  7. package/bundled/core/commit-message-guide.md +22 -19
  8. package/bundled/core/mock-boundary.md +70 -2
  9. package/bundled/core/secret-management-standards.md +13 -1
  10. package/bundled/core/turn-completion-integrity.md +8 -2
  11. package/bundled/extensions/locales/zh-tw.md +19 -19
  12. package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
  13. package/bundled/hooks/check-logging-standard.mjs +35 -6
  14. package/bundled/hooks/validate-commit-msg.mjs +317 -28
  15. package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
  16. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  17. package/bundled/locales/zh-CN/README.md +3 -3
  18. package/bundled/locales/zh-CN/SECURITY.md +4 -3
  19. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  20. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  21. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  22. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  23. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  24. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  25. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  26. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  27. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  28. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  29. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  30. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  31. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  32. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  33. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  34. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  35. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  36. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  37. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  38. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  39. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  40. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  41. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  42. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  43. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  45. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  47. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  48. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  49. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  50. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  51. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  52. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  53. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  54. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  55. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  56. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  57. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  58. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  59. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  60. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  61. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  62. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  63. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  64. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  65. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  66. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  67. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  68. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  69. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  70. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  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/mock-boundary.md +74 -6
  80. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  81. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  82. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  83. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  84. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  85. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  86. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  87. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  88. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  89. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  90. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  91. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  92. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  93. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  94. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  95. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  96. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  97. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  98. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  99. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  100. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  101. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  102. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  103. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  104. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  105. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  106. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  107. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  108. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  109. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  110. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  111. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  112. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  113. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  114. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
  115. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  116. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  117. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  118. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  119. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  120. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  121. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  122. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  123. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  124. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  125. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  126. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  127. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  128. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  129. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  130. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  131. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  132. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  133. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  134. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  135. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  136. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  137. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  138. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  139. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  140. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  141. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  142. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  143. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  144. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  145. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  146. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  147. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  148. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  149. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  150. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  151. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  152. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  153. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  154. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  155. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  156. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  157. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  158. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  159. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  160. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  161. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  162. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  163. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  164. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  165. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  166. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  167. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  168. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  169. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  170. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  171. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  172. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  173. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  174. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  175. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  176. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  177. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  178. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  179. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  180. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  181. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  182. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  183. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  184. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  185. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  186. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  187. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  188. package/bundled/locales/zh-CN/skills/README.md +2 -1
  189. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  190. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  191. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  192. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  193. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  194. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  195. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  196. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  197. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  198. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  199. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  200. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  201. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  202. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  203. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  204. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  205. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  206. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  207. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  208. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  209. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  210. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  211. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  212. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  213. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  214. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  215. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  216. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  217. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  218. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  219. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  220. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  221. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  222. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  224. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  225. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  226. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  227. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  228. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  229. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  230. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  231. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  232. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  233. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  234. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  235. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  237. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  238. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  239. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  240. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  241. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  242. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  243. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  244. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  245. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  246. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  247. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  248. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  249. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  250. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  251. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  252. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  253. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  254. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  255. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  256. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  257. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  258. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  259. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  260. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  261. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  262. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  263. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  264. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  265. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  266. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  267. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  268. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  269. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  270. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  271. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  272. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  273. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  274. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  275. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  276. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  277. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  278. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  279. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  280. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  281. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  282. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  283. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  284. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  285. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  286. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  287. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  288. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  289. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  290. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  291. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  292. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  293. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  294. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  295. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  296. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  297. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  298. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  299. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  300. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  301. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  302. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  303. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  304. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  305. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  306. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  307. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  308. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  309. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  310. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  311. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  312. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  313. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  314. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  315. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  316. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  317. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  318. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  319. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  320. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  321. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  322. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  323. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  324. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  325. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  326. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  327. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  328. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  329. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  330. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  331. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  332. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  333. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  334. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  335. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  336. package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
  337. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  338. package/bundled/locales/zh-TW/README.md +3 -3
  339. package/bundled/locales/zh-TW/SECURITY.md +4 -3
  340. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  341. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  342. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  343. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  344. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  345. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  346. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  347. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  348. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  349. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  350. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  351. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  352. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  353. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  354. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  355. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  356. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  357. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  358. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  359. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  360. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  361. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  362. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  363. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  364. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  365. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  366. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  367. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  368. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  369. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  370. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  371. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  372. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  373. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  374. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  375. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  376. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  377. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  378. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  379. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  380. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  381. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  382. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  383. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  384. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  385. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  386. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  387. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  388. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  389. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  390. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  391. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  392. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  393. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  394. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  395. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  396. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  397. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  398. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  399. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  400. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  401. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  402. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  403. package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
  404. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  405. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  406. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  407. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  408. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  409. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  410. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  411. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  412. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  413. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  414. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  415. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  416. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  417. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  418. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  419. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  420. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  421. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  422. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  423. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  424. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  425. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  426. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  427. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  428. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  429. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  430. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  431. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  432. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  433. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  434. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  435. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  436. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  437. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  438. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  439. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
  440. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  441. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  442. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  443. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  444. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  445. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  446. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  447. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  448. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  449. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  450. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  451. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  452. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  453. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  454. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  455. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  456. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  457. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  458. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  459. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  460. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  461. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  462. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  464. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  465. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  467. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  468. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  469. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  470. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  471. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  472. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  473. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  474. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  475. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  476. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  477. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  478. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  479. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  480. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  481. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  482. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  483. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  484. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  485. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  486. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  487. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  488. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  489. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  490. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  491. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  492. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  493. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  494. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  495. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  496. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  497. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  498. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  499. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  500. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  501. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  502. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  503. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  504. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  505. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  506. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  507. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  508. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  509. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  510. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  511. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  512. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  513. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  514. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  515. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  516. package/bundled/locales/zh-TW/skills/README.md +2 -1
  517. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  518. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  519. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  520. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  521. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  522. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  523. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  524. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  525. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  526. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  527. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  528. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  529. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  530. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  531. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  532. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  533. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  534. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  535. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  536. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  537. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  538. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  539. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  540. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  541. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  542. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  543. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  544. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  545. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  546. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  547. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  548. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  549. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  550. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  551. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  552. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  553. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  555. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  556. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  557. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  558. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  559. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  560. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  561. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  562. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  563. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  565. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  566. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  567. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  568. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  569. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  570. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  571. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  572. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  573. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  574. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  575. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  577. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  578. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  579. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  580. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  581. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  582. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  583. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  584. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  585. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  586. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  587. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  588. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  589. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  590. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  591. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  592. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  593. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  594. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  595. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  596. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  597. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  598. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  599. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  600. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  601. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  602. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  603. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  604. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  605. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  606. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  607. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  608. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  609. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  610. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  611. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  612. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  613. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  614. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  615. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  616. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  617. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  618. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  619. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  620. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  621. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  622. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  623. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  624. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  625. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  626. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  627. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  628. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  629. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  630. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  631. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  632. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  633. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  634. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  635. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  636. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  637. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  638. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  639. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  640. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  641. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  642. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  643. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  644. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  645. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  646. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  647. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  648. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  649. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  650. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  651. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  652. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  653. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  654. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  655. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  656. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  657. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  658. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  659. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  660. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  661. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  662. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  663. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  664. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  665. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  666. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  667. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  668. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  669. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  670. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  671. package/bundled/skills/commit-standards/SKILL.md +2 -2
  672. package/bundled/skills/commit-standards/guide.md +3 -2
  673. package/bundled/skills/commit-standards/language-options.md +19 -17
  674. package/package.json +2 -2
  675. package/src/commands/audit.js +28 -1
  676. package/src/commands/check.js +72 -3
  677. package/src/commands/compile.js +37 -4
  678. package/src/commands/config.js +49 -24
  679. package/src/commands/init.js +78 -30
  680. package/src/commands/open-work.js +6 -2
  681. package/src/commands/release-messages.js +228 -0
  682. package/src/commands/release.js +127 -68
  683. package/src/commands/run-intent.js +11 -0
  684. package/src/commands/spec.js +4 -2
  685. package/src/commands/update.js +227 -47
  686. package/src/compilers/claude-code-compiler.js +9 -1
  687. package/src/config/ai-agent-paths.js +14 -1
  688. package/src/core/installed-formats.js +15 -0
  689. package/src/core/open-work-config.js +20 -1
  690. package/src/core/project-config.js +55 -0
  691. package/src/i18n/messages.js +106 -2
  692. package/src/installers/hooks-installer.js +1 -1
  693. package/src/installers/manifest-installer.js +1 -1
  694. package/src/installers/skills-installer.js +1 -1
  695. package/src/installers/standards-installer.js +3 -1
  696. package/src/mcp/server.js +9 -3
  697. package/src/prompts/init.js +26 -22
  698. package/src/reconciler/actual-state-scanner.js +2 -8
  699. package/src/reconciler/backup-locations.js +5 -0
  700. package/src/reconciler/backup-manager.js +19 -11
  701. package/src/reconciler/desired-state-calculator.js +89 -57
  702. package/src/reconciler/plan-executor.js +101 -8
  703. package/src/reconciler/recorded-versions.js +49 -0
  704. package/src/reconciler/relative-path.js +23 -0
  705. package/src/uninstallers/hook-uninstaller.js +9 -1
  706. package/src/uninstallers/skills-uninstaller.js +22 -3
  707. package/src/utils/available-standards-report.js +25 -4
  708. package/src/utils/available-standards.js +13 -3
  709. package/src/utils/build-manifest.js +1 -1
  710. package/src/utils/commit-message-judge.js +60 -13
  711. package/src/utils/friction-detector.js +23 -11
  712. package/src/utils/git-hooks.js +106 -4
  713. package/src/utils/integration-generator.js +95 -67
  714. package/src/utils/legacy-hook-migration.js +121 -2
  715. package/src/utils/open-work-tracking.mjs +105 -16
  716. package/src/utils/sdd-header.js +16 -4
  717. package/src/utils/skills-installer.js +2 -1
  718. package/src/utils/spinner.js +14 -4
  719. package/src/utils/standard-validator.js +3 -2
  720. package/standards-registry.json +10 -8
  721. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/standard-lifecycle-management.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: e7c98175b173
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,21 +11,13 @@ status: current
10
11
 
11
12
  > **语言**: [English](../../../core/standard-lifecycle-management.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-17
15
- **状态**: Trial(到期 2026-10-17)
16
- **适用范围**: universal
17
- **来源**: XSPEC-070(DEC-043 Wave 1 治理 Meta 套件)
14
+ > **来源**: XSPEC-070 | **驱动来源**: DEC-043 Wave 1 Governance Meta Pack | **状态**: Trial(2026-04-17 ~ 2026-10-17)
18
15
 
19
- ---
20
-
21
- ## 目的
16
+ ## 概述
22
17
 
23
18
  UDS 标准生命周期状态机。既有 66 个标准无明确状态管理:新增标准没有试验期、过时标准无弃用路径、废弃标准仍被引用。本标准建立五状态机(Proposed / Trial / Active / Deprecated / Archived)与合法转移规则,并规范所有 `.ai.yaml` 标准必须在 frontmatter 标示 `status` / `since` / `expires` / `supersedes`。
24
19
 
25
- ---
26
-
27
- ## 核心规范
20
+ ## 关键原则
28
21
 
29
22
  - **所有标准必有状态**:frontmatter 必须包含 `status` 和 `since`
30
23
  - **Trial 必有期限**:`expires` 默认 since + 6 months
@@ -32,28 +25,24 @@ UDS 标准生命周期状态机。既有 66 个标准无明确状态管理:新
32
25
  - **禁止反向转移**:Active → Proposed、Archived → Active 均无意义
33
26
  - **逾期自动 Archived**:Trial 到期未决则自动归档
34
27
 
35
- ---
36
-
37
- ## 状态说明
28
+ ## 状态
38
29
 
39
30
  | 状态 | 描述 | Skill 可引用? |
40
- |------|------|--------------|
41
- | **Proposed** | 草案阶段,未通过 admission | 不可 |
42
- | **Trial** | 批准但试验中(默认 6 个月) | 可(标注 trial)|
43
- | **Active** | 全面采用,standard-of-truth | 可 |
44
- | **Deprecated** | 标记弃用,必须提供 `supersedes` | 可(Skill 应警示)|
45
- | **Archived** | 已移除,仅保留历史 | 不可 |
46
-
47
- ---
31
+ |-------|-------------|----------------------|
32
+ | **Proposed** | 草案阶段,未通过 admission | 否 |
33
+ | **Trial** | 批准但试验中(默认 6 个月)| 是(标注 trial)|
34
+ | **Active** | 全面采用,standard-of-truth | 是 |
35
+ | **Deprecated** | 标记弃用,必须提供 `supersedes` | 是(Skill 应警示)|
36
+ | **Archived** | 已移除,仅保留历史 | 否 |
48
37
 
49
- ## 合法转移路径
38
+ ## 合法转移
50
39
 
51
40
  ```
52
- Proposed ──(通过 admission)──→ Trial
53
- Trial ──(验证通过)─────────→ Active
54
- Trial ──(到期/拒绝)─────────→ Archived
55
- Active ──(被取代)───────────→ Deprecated
56
- Deprecated ──(迁移完成)────────→ Archived
41
+ Proposed ──(admission passed)──→ Trial
42
+ Trial ──(validated)──────────→ Active
43
+ Trial ──(expired/rejected)───→ Archived
44
+ Active ──(superseded)─────────→ Deprecated
45
+ Deprecated ──(migration done)───→ Archived
57
46
  ```
58
47
 
59
48
  **禁止的转移**:
@@ -63,11 +52,9 @@ Deprecated ──(迁移完成)────────→ Archived
63
52
  - Deprecated → Active(应重新 Trial)
64
53
  - Proposed → Active(须先 Trial)
65
54
 
66
- ---
67
-
68
55
  ## Frontmatter 必填字段
69
56
 
70
- ### 必填(所有状态)
57
+ ### 始终必填
71
58
 
72
59
  - `status`: proposed | trial | active | deprecated | archived
73
60
  - `since`: ISO-8601(进入当前状态的日期)
@@ -76,41 +63,46 @@ Deprecated ──(迁移完成)────────→ Archived
76
63
  ### 条件必填
77
64
 
78
65
  | 字段 | 适用时机 |
79
- |------|---------|
66
+ |-------|------|
80
67
  | `expires` | `status = trial`(默认 since + 6 months)|
81
68
  | `supersedes` | `status = deprecated`(替代标准 id 或迁移文档路径)|
82
69
  | `migration_guide` | `status = deprecated`(相对路径,选填但强烈建议)|
83
70
 
84
- ---
71
+ ## 使用示例
85
72
 
86
- ## 情境示例
73
+ - **场景 1 —— Trial → Active**:`retry-standards` 处于 trial。2026-08-01 审视发现 Fix Loop(采用层)和 Builder Agent(采用层)均采用且无重大缺陷 → 转 Active,`since=2026-08-01`,移除 `expires`
74
+ - **场景 2 —— Trial 逾期自动 Archived**:某标准 trial 期限 2026-10-17 到期未通过验证 → 状态转 Archived,记录原因
75
+ - **场景 3 —— Deprecated 带迁移**:`legacy-retry-logic` 被 `retry-standards` 取代 → `status=deprecated, supersedes=retry-standards, migration_guide=docs/migrations/retry-v1-to-v2.md`;Skill 使用时显示警告
87
76
 
88
- - **情境 1 — Trial → Active**:`retry-standards` 处于 trial。2026-08-01 审视发现多个采用层(Fix Loop / Builder Agent 等)均采用且无重大缺陷 → 转 Active,`since=2026-08-01`,移除 `expires`
89
- - **情境 2 — Trial 逾期自动 Archived**:某标准 trial 期限 2026-10-17 到期未通过验证 → 状态转 Archived,记录原因
90
- - **情境 3 — Deprecated 带迁移**:`legacy-retry-logic` 被 `retry-standards` 取代 → `status=deprecated, supersedes=retry-standards, migration_guide=docs/migrations/retry-v1-to-v2.md`;Skill 使用时显示警告
77
+ ## 遥测事件
91
78
 
92
- ---
79
+ `standard_state_change`:
93
80
 
94
- ## 遥测事件
81
+ ```
82
+ {
83
+ standard_id: string,
84
+ from_state: proposed|trial|active|deprecated|archived,
85
+ to_state: proposed|trial|active|deprecated|archived,
86
+ reason: string,
87
+ timestamp: ISO-8601
88
+ }
89
+ ```
95
90
 
96
- **`standard_state_change`**
91
+ ## 错误码
97
92
 
98
- | 字段 | 类型 |
99
- |------|------|
100
- | `standard_id` | `string` |
101
- | `from_state` | `proposed\|trial\|active\|deprecated\|archived` |
102
- | `to_state` | `proposed\|trial\|active\|deprecated\|archived` |
103
- | `reason` | `string` |
104
- | `timestamp` | `ISO-8601` |
93
+ - `LIFECYCLE-001` — `MISSING_STATUS`
94
+ - `LIFECYCLE-002` — `MISSING_EXPIRES`(trial 状态)
95
+ - `LIFECYCLE-003` — `MISSING_SUPERSEDES`(deprecated 状态)
96
+ - `LIFECYCLE-004` — `FORBIDDEN_TRANSITION`
97
+ - `LIFECYCLE-005` — `TRIAL_EXPIRED`(期限已过但未决策)
105
98
 
106
- ---
99
+ ## 参考资料
100
+
101
+ - AI 优化版:[ai/standards/standard-lifecycle-management.ai.yaml](../../../ai/standards/standard-lifecycle-management.ai.yaml)
102
+ - XSPEC-070:DEC-043 Wave 1 Governance Meta Pack 跨项目规格
103
+ - DEC-043:UDS 覆盖完整性路线图(驱动来源)
104
+ - 相关:`standard-admission-criteria`, `skill-standard-alignment-check`, `adr-standards`
105
+ - 业界:IETF RFC lifecycle (Proposed → Draft → Internet Standard), Python PEP states, W3C Recommendation Track
107
106
 
108
- ## 错误码
109
107
 
110
- | 代码 | 说明 |
111
- |------|------|
112
- | `LIFECYCLE-001` | `MISSING_STATUS` — frontmatter 缺 status 字段 |
113
- | `LIFECYCLE-002` | `MISSING_EXPIRES` — trial 状态缺 expires 字段 |
114
- | `LIFECYCLE-003` | `MISSING_SUPERSEDES` — deprecated 状态缺 supersedes 字段 |
115
- | `LIFECYCLE-004` | `FORBIDDEN_TRANSITION` — 尝试执行禁止的状态转移 |
116
- | `LIFECYCLE-005` | `TRIAL_EXPIRED` — trial 到期未决策 |
108
+ **范围**: universal
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/structured-task-definition.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-17
5
+ last_synced: 2026-10-11
6
+ source_hash: 8dae927b8e17
6
7
  status: current
7
8
  ---
8
9
 
@@ -1,88 +1,149 @@
1
1
  ---
2
2
  source: ../../../core/supply-chain-security-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-16
6
+ source_hash: 25ea1d1d96a9
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 供应链安全标准
10
11
 
11
- > 版本: 1.1.0 | 最后更新: 2026-08-04
12
+ > **语言**: [English](../../../core/supply-chain-security-standards.md) | [繁體中文](../../zh-TW/core/supply-chain-security-standards.md) | 简体中文
13
+
14
+ **版本**: 1.1.0
15
+ **最后更新**: 2026-08-04
16
+ **适用范围**: 所有包含外部依赖的软件项目
17
+ **范围**: universal
18
+ **行业标准**: SLSA, SPDX, CycloneDX, OpenSSF Scorecard
19
+ **参考链接**: [slsa.dev](https://slsa.dev/), [spdx.dev](https://spdx.dev/), [cyclonedx.org](https://cyclonedx.org/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
25
  本文件定义供应链安全标准,涵盖软件物料清单(SBOM)、依赖审计、SLSA 成熟度等级、许可证合规与依赖健康评估。
16
26
 
27
+ ---
28
+
17
29
  ## 软件物料清单(SBOM)
18
30
 
19
- ### 格式比较
31
+ ### SBOM 格式比较
20
32
 
21
33
  | 方面 | SPDX | CycloneDX |
22
- |------|------|-----------|
34
+ |--------|------|-----------|
23
35
  | **维护者** | Linux Foundation | OWASP |
24
36
  | **主要焦点** | 许可证合规 + 安全 | 安全 + 组件分析 |
25
37
  | **格式** | JSON, RDF, YAML, Tag-Value | JSON, XML, Protobuf |
26
38
  | **ISO 标准** | ISO/IEC 5962:2021 | ECMA-424 |
39
+ | **生态系统** | 在开源治理中表现强劲 | 在 DevSecOps 工具链中表现强劲 |
40
+
41
+ ### 选型指南
42
+
43
+ - 当许可证合规是首要考量或需要 ISO 认证时,**选择 SPDX**
44
+ - 当安全分析与 DevSecOps 集成为优先事项时,**选择 CycloneDX**
45
+ - **任一格式**均可接受;组织内部的一致性比具体选择更重要
27
46
 
28
- ### 需求
47
+ ### SBOM 需求
29
48
 
30
49
  - 每次发布必须包含 SBOM,列出所有直接与间接依赖
31
- - SBOM 必须包含:组件名称、版本、供应商、许可证、已知漏洞
32
- - SBOM 应作为 CI/CD Pipeline 的一部分自动生成
50
+ - SBOM 必须包含:组件名称、版本、供应商、许可证以及已知漏洞
51
+ - SBOM 应作为 CI/CD 流水线的一部分自动生成
52
+
53
+ ---
33
54
 
34
55
  ## 依赖审计
35
56
 
36
57
  ### 四大审计维度
37
58
 
38
- | 维度 | 检查项目 | 严重性 |
39
- |------|---------|--------|
59
+ | 维度 | 检查内容 | 严重性 |
60
+ |-----------|--------------|----------|
40
61
  | **已知漏洞** | CVE 数据库(NVD, OSV, GitHub Advisory) | Critical: 阻断, High: 警告 |
41
62
  | **许可证合规** | 许可证与项目许可证的兼容性 | 不兼容: 阻断 |
42
63
  | **维护状态** | 最后提交日期、开放 Issue、维护者数量 | 超过 2 年未维护: 警告 |
43
64
  | **版本时效** | 落后最新版本多少个 Major/Minor | 落后 Major > 2: 警告 |
44
65
 
66
+ ### 审计频率
67
+
68
+ | 触发条件 | 操作 |
69
+ |---------|--------|
70
+ | 每次 CI 构建 | 漏洞扫描(自动) |
71
+ | 每周 | 完整审计报告(自动) |
72
+ | 发布前 | 人工审查所有警告 |
73
+ | 收到安全通报时 | 立即评估受影响的依赖 |
74
+
75
+ ---
76
+
45
77
  ## SLSA 等级
46
78
 
79
+ 软件产物供应链等级(Supply-chain Levels for Software Artifacts)定义了构建完整性的成熟度等级:
80
+
47
81
  | 等级 | 需求 | 适用场景 |
48
- |------|------|---------|
82
+ |-------|-------------|-------------------|
49
83
  | **L1 — Provenance** | 构建流程文档化;生成 SBOM | 所有项目(最低基准) |
50
- | **L2 — Build Service** | 在托管服务上构建;签署 Provenance | 有 CI/CD Pipeline 的项目 |
84
+ | **L2 — Build Service** | 在托管服务上构建;签署 Provenance | 拥有 CI/CD 流水线的项目 |
51
85
  | **L3 — Hardened Builds** | 隔离、短暂的构建环境;不可伪造的 Provenance | 安全关键应用 |
52
86
  | **L4 — Two-Party Review** | 所有变更需两人审查;密封式构建 | 基础设施、金融系统 |
53
87
 
88
+ ### 演进路径
89
+
90
+ 从 L1 开始,根据风险状况逐步采用更高等级:
91
+
92
+ ```
93
+ L1 (All projects) → L2 (CI/CD projects) → L3 (Security-critical) → L4 (High-assurance)
94
+ ```
95
+
96
+ ---
97
+
54
98
  ## 许可证合规
55
99
 
56
100
  ### 许可证类别矩阵
57
101
 
58
102
  | 类别 | 示例 | 兼容性 | 风险 |
59
- |------|------|--------|------|
60
- | **宽松式** | MIT, Apache-2.0, BSD | 几乎与所有许可证兼容 | 低 |
61
- | **弱 Copyleft** | LGPL-2.1, MPL-2.0 | 作为库使用时兼容 | 中 |
62
- | **强 Copyleft** | GPL-2.0, GPL-3.0 | 衍生作品须使用相同许可证 | 高 |
63
- | **网络 Copyleft** | AGPL-3.0 | Copyleft 延伸至网络交互 | 极高 |
103
+ |----------|---------|--------------|------|
104
+ | **宽松式** | MIT, Apache-2.0, BSD-2/3 | 几乎与所有许可证兼容 | 低 |
105
+ | **弱 Copyleft** | LGPL-2.1, MPL-2.0 | 作为库使用(未修改)时兼容 | 中 |
106
+ | **强 Copyleft** | GPL-2.0, GPL-3.0 | 要求衍生作品使用相同许可证 | 高 |
107
+ | **网络 Copyleft** | AGPL-3.0 | 将 Copyleft 延伸至网络交互 | 极高 |
64
108
  | **专有** | 自定义、无许可证 | 未经明确许可不得使用 | 阻断 |
65
109
 
110
+ ### 合规规则
111
+
112
+ - **宽松式 + 宽松式**:始终兼容
113
+ - **宽松式 + Copyleft**:若遵循 Copyleft 条款则兼容
114
+ - **Copyleft + 不同 Copyleft**:通常不兼容——需要法务审查
115
+ - **SaaS 中的 AGPL**:会触发整个服务的 Copyleft——需要审慎评估
116
+ - **无许可证**:视为专有——未经明确许可不得使用
117
+
118
+ ---
119
+
66
120
  ## 依赖更新策略
67
121
 
68
122
  | 更新类型 | 策略 | 自动化 |
69
- |---------|------|--------|
70
- | **Patch** (x.y.Z) | CI 通过后自动合并 | 全自动 |
123
+ |-------------|----------|-----------|
124
+ | **Patch** (x.y.Z) | CI 通过后自动合并 | 全自动(Dependabot/Renovate) |
71
125
  | **Minor** (x.Y.0) | 自动创建 PR,人工审查 | 半自动 |
72
- | **Major** (X.0.0) | 人工评估,迁移计划 | 手动 |
73
- | **锁定策略** | 提交 lock 文件——**若你发布软件包,另须验证消费端会解析到什么**(见下) | lock 文件进版本控制;发版时检查消费端解析 |
126
+ | **Major** (X.0.0) | 人工评估,制定迁移计划 | 手动审查变更日志 |
127
+ | **锁定策略** | 提交 lock 文件——**若你发布软件包,另须验证消费端会解析到什么**(见下) | lock 文件提交进版本控制;发布时检查消费端解析 |
128
+
129
+ ### 更新规则
130
+
131
+ - lock 文件必须提交到版本控制中
132
+ - Patch 更新应在 7 天内应用
133
+ - 安全补丁必须在 48 小时(Critical)或 7 天(High)内应用
134
+ - Major 版本升级应每季度评估一次
74
135
 
75
136
  ### lock 文件约束不了你的用户
76
137
 
77
- 提交 lock 文件让**你自己的**构建可重现。它到不了任何安装你软件包的人:发布出去的 npm
138
+ 提交 lock 文件让**你自己的**构建可重现。它触达不到任何安装你软件包的人:发布出去的 npm
78
139
  tarball、PyPI wheel、Ruby gem 都不带 lock 文件。消费端是**在他们安装的当下、自行解析你
79
140
  声明的范围**,拿到当时满足该范围的任何版本。
80
141
 
81
142
  **两者不同时,你的测试套件会对着一个没有人会安装的组合亮绿灯——而那个绿灯与真绿灯
82
143
  无从分辨。**
83
144
 
84
- 这是观察到的失效,不是假设的:某项目声明 `"tree-sitter-c-sharp": "^0.23.1"`,该区间有
85
- 三个已发布版本而它们的 API 不同。npm 把 caret 解析到最新匹配版本,于是每一次全新安装
145
+ 这是观察到的失效,不是假设的:某项目声明 `"tree-sitter-c-sharp": "^0.23.1"`。该区间有
146
+ 三个已发布版本而它们并不共享同一套 API。npm 把 caret 解析到最新匹配版本,于是每一次全新安装
86
147
  都拿到不兼容的那个,**任何从 registry 安装的人的 C# 文件从未解析成功过**——而 lock 文件
87
148
  锁着能用的版本、每个测试都通过,横跨该功能的整个生命周期。该项目的源码注释甚至早就记录了
88
149
  那个不兼容版本;caret 悄悄把它又放了回来。
@@ -93,18 +154,66 @@ tarball、PyPI wheel、Ruby gem 都不带 lock 文件。消费端是**在他们
93
154
  该范围今天会解析到的版本。**只报告差异**——一份大多一致的表格会被略过,而其中真正
94
155
  有问题的那几行也跟着被略过。
95
156
  - **原生依赖一律声明为精确版本。** 带原生绑定的软件包(有 install 家族脚本,或依赖
96
- node-gyp/prebuild/node-addon-api/cmake-js 及同类者)**不得**以范围声明。semver 对
97
- 原生 ABI 兼容性没有任何承诺,而这在实践中已被在 minor 范围内打破过。**不论它今天是否
157
+ node-gyp / prebuild / node-addon-api / cmake-js 及同类者)**不得**以范围声明。semver 对
158
+ 原生 ABI 兼容性没有任何承诺,而这在实践中已被在 minor 范围内打破过。**不论它们当前是否
98
159
  正在漂移都要标出**:一个只对应到单一已发布版本的范围,安全是因为上游还没再发布,
99
160
  不是因为有任何保障。
100
161
  - **发版前以消费端解析跑一次测试套件。** 在没有 lock 文件的情况下安装,再对结果跑真正的
101
162
  测试。这是本节唯一**不需要事先知道哪个依赖会坏**的检查。
102
- - **查不到的东西记为未知,绝不记为一致。** 一个「没问题」与「我查不到」长得一样的检查,
163
+ - **查不到的东西记为未知,绝不记为一致。** 一个“没问题”与“我查不到”长得一样的检查,
103
164
  会把未知转成安心。
104
165
 
105
166
  > **适用于发布出去的产物,不适用于应用程序。** 一个部署出去的服务会连同 lock 文件一起
106
167
  > 发布,因此它的构建与运行看到的是同一组版本。本节谈的是**别人会安装的软件包**。
107
168
 
169
+ ---
170
+
171
+ ## CI/CD 集成
172
+
173
+ ### 流水线安全关卡
174
+
175
+ 依赖扫描必须集成到 CI/CD 中:
176
+
177
+ ```
178
+ PR Created → Dependency Scan → Results
179
+ │
180
+ ┌──────────────┼──────────────┐
181
+ ▼ ▼ ▼
182
+ Critical High Medium/Low
183
+ → Block PR → Warn + → Log only
184
+ Create Ticket
185
+ ```
186
+
187
+ ### 必需的流水线步骤
188
+
189
+ 1. **SBOM 生成** — 每次构建均生成 SBOM
190
+ 2. **漏洞扫描** — 对照 CVE 数据库进行检查
191
+ 3. **许可证扫描** — 验证许可证兼容性
192
+ 4. **依赖时效性** — 报告过期的依赖项
193
+
194
+ ---
195
+
196
+ ## 依赖健康评估
197
+
198
+ ### 健康指标
199
+
200
+ | 指标 | 健康 | 警告 | 不健康 |
201
+ |--------|---------|---------|-----------|
202
+ | **最后更新日期** | < 6 个月 | 6-24 个月 | > 24 个月 |
203
+ | **已知 CVE** | 0 个 Critical/High | 1-2 个 High | 任何未修补的 Critical |
204
+ | **维护者数量** | ≥ 3 | 2 | 1(巴士系数风险) |
205
+ | **社区活跃度** | 活跃的 Issue/PR | 响应缓慢 | 已废弃 |
206
+ | **下载趋势** | 稳定或增长 | 下降 | 接近零 |
207
+
208
+ ### 健康评分
209
+
210
+ 将各项指标综合为整体健康评分:
211
+ - **绿色**(健康):所有指标均无警告
212
+ - **黄色**(注意):存在 1-2 项警告级别的指标
213
+ - **红色**(需采取行动):存在任何不健康指标或 Critical CVE
214
+
215
+ ---
216
+
108
217
  ## 快速参考卡
109
218
 
110
219
  ```
@@ -116,12 +225,30 @@ Critical CVE? → 48 小时内修补
116
225
 
117
226
  ---
118
227
 
228
+ ## 参考链接
229
+
230
+ - [SLSA Framework](https://slsa.dev/) — 软件产物供应链等级(Supply-chain Levels for Software Artifacts)
231
+ - [SPDX Specification](https://spdx.dev/) — 软件包数据交换(Software Package Data Exchange)
232
+ - [CycloneDX](https://cyclonedx.org/) — OWASP 软件物料清单标准
233
+ - [OpenSSF Scorecard](https://securityscorecards.dev/) — 自动化安全健康检查
234
+
235
+ ---
236
+
119
237
  **相关标准:**
120
- - [安全标准](security-standards.md) - 应用程序安全
121
- - [容器化标准](containerization-standards.md) - 镜像漏洞扫描
238
+ - [安全标准](security-standards.md) — 应用程序安全
239
+ - [容器化标准](containerization-standards.md) — 镜像漏洞扫描
240
+ - [废弃标准](deprecation-standards.md) — 依赖弃用通知
241
+
242
+ ---
243
+
244
+ ## 版本历史
245
+
246
+ | 版本 | 日期 | 变更内容 |
247
+ |---------|------|---------|
248
+ | 1.0.0 | 2026-04-01 | 初始发布 |
122
249
 
123
250
  ---
124
251
 
125
- ## 许可
252
+ ## 许可证
126
253
 
127
- 本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
254
+ 本标准基于 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
@@ -2,14 +2,15 @@
2
2
  source: ../../../core/systematic-debugging.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: 7f591022723b
6
7
  status: current
7
8
  ---
8
9
 
9
- > **语言**: [English](../../../core/systematic-debugging.md) | 简体中文
10
-
11
10
  # 系统化调试工作流
12
11
 
12
+ > **语言**: [English](../../../core/systematic-debugging.md) | 简体中文
13
+
13
14
  **版本**: 1.0.0
14
15
  **最后更新**: 2026-03-20
15
16
  **适用范围**: 所有使用 AI 辅助开发的软件项目
@@ -20,7 +21,7 @@ status: current
20
21
 
21
22
  ## 目的
22
23
 
23
- 定义结构化的四阶段调试工作流,防止常见的"猜测修复"反模式。强制要求在尝试修复前先进行根因分析,并包含 **3-Strike Rule** 以提早发现架构问题。
24
+ 定义结构化的四阶段调试工作流,防止常见的"猜测修复"循环反模式。本标准强制要求在任何修复尝试之前先进行根因分析,并包含 **3-Strike Rule** 以尽早发现架构问题。
24
25
 
25
26
  ---
26
27
 
@@ -28,16 +29,16 @@ status: current
28
29
 
29
30
  | 术语 | 定义 |
30
31
  |------|------|
31
- | 根因 | 缺陷存在的根本原因,而非仅仅是症状 |
32
- | 3-Strike Rule | 连续 3 次修复尝试失败后,怀疑架构问题 |
33
- | 反向追踪 | 从错误症状追溯到产生源头 |
34
- | 组件边界 | 两个模块或子系统之间的接口 |
32
+ | 根因(Root Cause) | 缺陷存在的根本原因,而不仅仅是症状 |
33
+ | 3-Strike Rule | 连续 3 次修复尝试失败后,怀疑存在架构问题 |
34
+ | 反向追踪(Backward Tracing) | 从错误症状追溯到产生问题的源头 |
35
+ | 组件边界(Component Boundary) | 两个模块或子系统之间的接口 |
35
36
 
36
37
  ---
37
38
 
38
39
  ## 核心原则 — 铁律
39
40
 
40
- > **禁止跳过根因分析直接修复。**
41
+ > **绝不跳过根因分析直接进行修复。**
41
42
 
42
43
  如果你发现自己在说"快速修复"、"试试看"或"现在应该可以了" — **停下来**,回到阶段 1。
43
44
 
@@ -45,62 +46,106 @@ status: current
45
46
 
46
47
  ## 四个阶段
47
48
 
48
- ### 阶段 1:根因调查
49
+ ### 阶段 1:根因调查(Root Cause Investigation)
49
50
 
50
- 分析错误消息并追踪最近变更,形成初步假设。
51
+ 分析错误信息并追踪最近的变更,形成初步假设。
51
52
 
52
53
  1. **仔细阅读错误** — 识别失败的确切位置和类型
53
- 2. **追踪最近变更** — 使用 `git log`、`git diff`、`git blame` 查找变更内容
54
- 3. **在组件边界添加诊断** — 在模块接口处插入日志/断点
55
- 4. **记录观察** — 记录所见并形成初步假设
54
+ 2. **追踪最近的变更** — 使用 `git log`、`git diff`、`git blame` 找出变更内容
55
+ 3. **在组件边界添加诊断** — 在模块之间的接口处插入日志/断点
56
+ 4. **记录观察结果** — 记录所见内容并形成初步假设
56
57
 
57
- ### 阶段 2:模式分析
58
+ ### 阶段 2:模式分析(Pattern Analysis)
58
59
 
59
- 将失败代码与类似的成功实现进行比较。
60
+ 将失败的代码与类似的正常运行实现进行比对。
60
61
 
61
- 1. **搜索类似的成功实现** — 在代码库中查找
62
- 2. **识别差异** — 比较失败和成功代码之间的不同
63
- 3. **检查最近的变更** — 确认是否有回归引入
64
- 4. **验证假设** — 通过额外的日志/测试确认
62
+ 1. **在代码库中搜索类似的成功实现**
63
+ 2. **识别失败代码与正常代码之间的差异**
64
+ 3. **检查缺失的前置条件** — 初始化、配置、执行顺序
65
65
 
66
- ### 阶段 3:修复实施
66
+ ### 阶段 3:假设测试(Hypothesis Testing)
67
67
 
68
- 基于确认的根因实施修复。
68
+ 以最小、隔离的修改验证你的假设。
69
69
 
70
- 1. **先写测试** — 创建复现问题的失败测试
71
- 2. **实施最小修复** — 只修改必需的内容
72
- 3. **验证修复** — 测试现在应通过
73
- 4. **检查副作用** — 运行完整测试套件
70
+ 1. **做出尽可能小的修改**来测试假设
71
+ 2. **每次只改变一个变量** — 绝不同时进行多处修改
72
+ 3. **记录每次尝试** — 记录假设、修改内容和结果
74
73
 
75
- ### 阶段 4:回顾
74
+ ### 阶段 4:修复实施(Fix Implementation)
76
75
 
77
- 防止类似问题再次发生。
76
+ 只有在确认根因之后才实施修复。
78
77
 
79
- 1. **记录根因** — 在提交消息中说明
80
- 2. **评估是否需要额外测试** — 防止回归
81
- 3. **检查是否有类似模式** — 其他地方是否有同样的问题
78
+ 1. **确认根因**已通过假设测试得到验证
79
+ 2. **实施修复**,并进行适当的错误处理
80
+ 3. **运行完整测试套件** — 确保没有回归
81
+ 4. **验证修复不会引入新问题**
82
82
 
83
83
  ---
84
84
 
85
85
  ## 3-Strike Rule
86
86
 
87
- | 尝试 | 动作 |
88
- |------|------|
89
- | 第 1 次失败 | 重新审视假设,添加更多诊断 |
90
- | 第 2 次失败 | 扩大调查范围,考虑上游原因 |
91
- | 第 3 次失败 | **停止** — 怀疑架构问题,寻求审查 |
87
+ > 在**连续 3 次修复尝试失败**后,停止猜测,并质疑架构设计。
88
+
89
+ 当 3-Strike Rule 触发时:
90
+
91
+ 1. 从具体的缺陷中退后一步
92
+ 2. 审视整体模块/组件设计
93
+ 3. 考虑架构是否支持预期行为
94
+ 4. 寻找使这一类缺陷得以出现的设计缺陷
95
+ 5. 在再次尝试修复之前考虑重构
96
+
97
+ ---
98
+
99
+ ## 规则
92
100
 
93
- 连续 3 次修复失败后,问题很可能不在你认为的地方。需要退后一步,重新审视整体架构。
101
+ | ID | 触发条件 | 动作 | 优先级 |
102
+ |----|---------|------|--------|
103
+ | SD-001 | 连续 3 次修复失败 | 停止猜测,质疑架构设计 | Critical |
104
+ | SD-002 | 出现"快速修复"、"试试看"、"现在应该可以了"等说法 | 回到阶段 1 根因分析 | High |
105
+ | SD-003 | 多组件交互错误 | 在每个组件边界添加诊断观察 | Medium |
94
106
 
95
107
  ---
96
108
 
97
- ## 相关标准
109
+ ## 应避免的反模式
110
+
111
+ | 反模式 | 为何有害 |
112
+ |--------|---------|
113
+ | 霰弹枪式调试(Shotgun debugging) | 随机修改浪费时间,且可能引入新缺陷 |
114
+ | 从 Stack Overflow 复制粘贴修复 | 缺乏理解时,修复可能并未解决真正的根因 |
115
+ | 压制错误 | 隐藏症状并不能修复问题 |
116
+ | "在我的机器上可以运行" | 环境差异是线索,而不是推托的理由 |
117
+
118
+ ---
119
+
120
+ ## 示例
121
+
122
+ ### 正确:结构化调试
123
+
124
+ ```
125
+ Phase 1: TypeError at line 42 in parser.ts — reading property of undefined
126
+ git log shows parser.ts was modified 2 commits ago
127
+ Added console.log at module boundary → input is null when empty array passed
128
+
129
+ Phase 2: Similar parser in legacy/ handles empty arrays with early return
130
+
131
+ Phase 3: Added early return for empty array → test passes
132
+ Changed only one thing, recorded result
133
+
134
+ Phase 4: Implemented fix, ran full test suite (47/47 pass), no regressions
135
+ ```
136
+
137
+ ### 错误:猜测后修复
98
138
 
99
- - [验证证据](verification-evidence.md)
100
- - [测试标准](testing-standards.md)
139
+ ```
140
+ "Hmm, let me try adding a null check... nope.
141
+ Maybe wrapping in try-catch... still broken.
142
+ Let me just change the type to any... 🤦"
143
+ ```
101
144
 
102
145
  ---
103
146
 
104
- ## 许可证
147
+ ## 参考资料
105
148
 
106
- 本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
149
+ - **Superpowers**: [systematic-debugging](https://github.com/obra/superpowers) (MIT)
150
+ - **The Pragmatic Programmer**: Chapter on Debugging
151
+ - **Debugging by Thinking**: A Multidisciplinary Approach (Robert Charles Metzger)