universal-dev-standards 6.14.0-beta.8 → 6.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) 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/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/health-check-standards.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: d8020bc66eac
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,135 +11,76 @@ status: current
10
11
 
11
12
  > **语言**: [English](../../../core/health-check-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-17
15
- **状态**: Trial(到期 2026-10-17)
16
- **适用范围**: universal
17
- **来源**: XSPEC-067(DEC-043 Wave 1 可靠性套件)
14
+ > **来源**: XSPEC-067 | **驱动来源**: DEC-043 Wave 1 Reliability Pack | **状态**: Trial(2026-04-17 ~ 2026-10-17)
18
15
 
19
- ---
20
-
21
- ## 目的
16
+ ## 概述
22
17
 
23
- 健康检查标准:liveness / readiness / startup 三种 probe、深度 health check、结构化 JSON 响应。
18
+ 健康检查标准 —— 业界常见错误是把 liveness 和 readiness 混用(健康检查检查外部依赖导致连锁重启)。本标准明确三种 probe 的语义分离、定义深度 health check 的检查范围(仅关键依赖),并规范结构化 JSON 响应以便下游自动化处理。与 observability 整合,作为 RED metric 的 Error 来源之一。
24
19
 
25
- 业界常见错误:把 liveness 和 readiness 混用(健康检查检查外部依赖导致连锁重启)。本标准明确三种 probe 语义分离,定义深度 health check 的检查范围(仅关键依赖),并规范结构化 JSON 响应以便下游自动化处理。
26
-
27
- ---
20
+ ## 关键原则
28
21
 
29
- ## 核心规范
30
-
31
- - Liveness probe 不得检查外部依赖(DB、下游 API),否则会造成连锁重启
32
- - Readiness probe 可检查关键外部依赖,但仅关键(非全部依赖)
33
- - 慢启动服务应使用 startup probe,启动完成后交棒给 liveness
34
- - Health check 端点必须回传结构化 JSON,包含 status / dependencies / timestamp
35
- - Health check 结果应作为 observability 的 Error signal 之一,连续 fail 触发 incident
36
-
37
- ---
22
+ - **Liveness 不碰外部依赖**:liveness 失败会造成 pod 重启;若依赖 DB,DB 故障时会造成所有 pod 连锁重启
23
+ - **Readiness 仅检查关键依赖**:非关键依赖不纳入,避免边缘故障导致服务被下线
24
+ - **慢启动用 startup probe**:启动完成后交棒给 liveness
25
+ - **结构化 JSON 响应**:包含 `status` / `dependencies` / `timestamp` / `version`
26
+ - **作为 observability signal**:连续失败(达到 probe threshold)时依 [alerting-standards](alerting-standards.md) 触发告警——由 alerting 定义触发时机、严重性映射与路由(`HC-001 HEALTH_CHECK_FAILED` 为告警来源之一),health-check 只负责发出 signal,不自行决定通知对象
38
27
 
39
- ## 三种 Probe 类型
28
+ ## Probe 类型
40
29
 
41
- ### Liveness Probe
30
+ | Probe | 端点 | 检查内容 | 失败时 | 阈值 |
31
+ |-------|------|---------|--------|------|
32
+ | **liveness** | `GET /health/live` | process 可响应 HTTP、内部 event loop | 重启 pod | 3 次失败 |
33
+ | **readiness** | `GET /health/ready` | 自身 API、DB ping(若必要)、关键下游 | 移出负载均衡(不重启)| 3 次失败 |
34
+ | **startup** | `GET /health/startup` | 启动过程所需资源就绪 | 重启 pod(启动超时)| 30 次失败 |
42
35
 
43
- - **目的**:服务是否还存活(process 是否卡死)
44
- - **建议端点**:`GET /health/live`
45
- - **允许检查**:process 是否能响应 HTTP、内部 event loop 是否可用
46
- - **禁止检查**:DB 连接、下游 API、消息队列(会造成连锁重启)
47
- - **失败行为**:重启 pod / process
48
- - **参数**:failureThreshold=3,periodSeconds=10
36
+ ### Liveness 禁止的检查
49
37
 
50
- ### Readiness Probe
51
-
52
- - **目的**:是否可接收流量
53
- - **建议端点**:`GET /health/ready`
54
- - **允许检查**:自身 API 可用、DB 连接(若服务必须依赖 DB)、关键下游依赖、必要配置已加载
55
- - **禁止检查**:非关键依赖(避免非关键故障造成服务被移出负载均衡)
56
- - **失败行为**:移出负载均衡,不重启
57
- - **参数**:failureThreshold=3,periodSeconds=5
58
-
59
- ### Startup Probe
60
-
61
- - **目的**:启动期专用,替代慢启动服务的 liveness
62
- - **建议端点**:`GET /health/startup`
63
- - **检查项目**:启动过程所需资源(如缓存预热、index 加载)已完成
64
- - **失败行为**:重启 pod(启动超时)
65
- - **完成后**:停用,改由 liveness 接手
66
- - **参数**:failureThreshold=30,periodSeconds=10
67
-
68
- ---
38
+ - DB 连接(DB 故障时 liveness 失败 → pod 重启 → 启动更多 client → DB 更糟)
39
+ - 下游 API(会造成连锁重启)
40
+ - 消息队列
69
41
 
70
42
  ## 深度规则
71
43
 
72
- | 层级 | 使用时机 | 检查范围 |
73
- |------|---------|---------|
74
- | Shallow | Liveness | process 是否可响应,不碰任何外部依赖 |
75
- | Deep | Readiness | 自身 API 路由、DB ping(若必须)、关键下游 API ping |
76
-
77
- **关键依赖的定义**:没有它服务就完全无法提供核心功能。
78
-
79
- ---
44
+ - **Shallow(liveness)**:process 是否可响应,不碰任何外部依赖
45
+ - **Deep(readiness)**:自身 API 路由、DB ping、关键下游 API ping(关键 = 没有它,服务就完全无法提供核心功能)
80
46
 
81
47
  ## 响应格式
82
48
 
83
- **Content-Type**:`application/json`
84
-
85
- | HTTP 状态码 | 含义 |
86
- |------------|------|
87
- | `200` | healthy — 所有关键依赖正常 |
88
- | `503` | unhealthy — 至少一个关键依赖失败 |
89
-
90
- **JSON Schema**:
91
-
92
49
  ```json
93
50
  {
94
51
  "status": "healthy | degraded | unhealthy",
95
- "timestamp": "<ISO-8601>",
96
- "uptime_seconds": 12345,
97
- "version": "1.0.0",
52
+ "timestamp": "2026-04-17T10:00:00Z",
53
+ "uptime_seconds": 3600,
98
54
  "dependencies": {
99
- "database": {
100
- "status": "healthy | unhealthy",
101
- "latency_ms": 5,
102
- "last_check": "<ISO-8601>"
103
- },
104
- "upstream_api": {
105
- "status": "healthy | unhealthy",
106
- "latency_ms": 20
107
- }
108
- }
55
+ "database": {"status": "healthy", "latency_ms": 5, "last_check": "..."},
56
+ "upstream_api": {"status": "healthy", "latency_ms": 42, "last_check": "..."}
57
+ },
58
+ "version": "1.2.3"
109
59
  }
110
60
  ```
111
61
 
112
- ---
113
-
114
- ## 与 Observability 整合
115
-
116
- - Health check 结果应作为 RED metric 的 Error 来源之一(Rate / Errors / Duration)
117
- - 连续 N 次 health check failed 应触发 incident(对齐 incident-response)
118
- - probe 延迟本身应被监控(异常缓慢可能是 resource_exhaustion 征兆)
62
+ - HTTP 200 → healthy
63
+ - HTTP 503 → unhealthy(至少一个关键依赖失败)
119
64
 
120
- ---
65
+ ## 使用示例
121
66
 
122
- ## 情境示例
67
+ - **场景 1 —— Liveness 不检查 DB**:DB 连接池耗尽,liveness 仍返回 200(liveness 不检查 DB),避免所有 pod 重启
68
+ - **场景 2 —— Readiness 失败**:关键下游 API 不可达,readiness 返回 503,pod 移出 LB;process 不重启
69
+ - **场景 3 —— Startup → Liveness 交棒**:服务需要 60s 预热缓存,startup probe 在前 60s 持续返回 503,预热完成后改由 liveness 接手
123
70
 
124
- **情境 1:liveness 不检查 DB**
125
- - 条件:DB 暂时无法连接
126
- - Liveness 回传 200 healthy(不检查 DB),避免连锁重启
71
+ ## 错误码
127
72
 
128
- **情境 2:readiness 因关键依赖失败**
129
- - 条件:关键下游 API 不可达
130
- - Readiness 回传 503,pod 移出负载均衡但不重启
73
+ - `HC-001` — `HEALTH_CHECK_FAILED`(关键依赖失败)
74
+ - `HC-002` — `HEALTH_CHECK_TIMEOUT`(probe 本身超时)
75
+ - `HC-003` — `INVALID_DEPENDENCY_SET`(readiness 检查了非关键依赖,设计违规)
131
76
 
132
- **情境 3:startup 后交棒 liveness**
133
- - 条件:服务需 60s 预热缓存
134
- - 前 60s startup probe 持续回 503,预热完成后交棒 liveness
77
+ ## 参考资料
135
78
 
136
- ---
79
+ - AI 优化版:[ai/standards/health-check-standards.ai.yaml](../../../ai/standards/health-check-standards.ai.yaml)
80
+ - XSPEC-067:DEC-043 Wave 1 Reliability Pack 跨项目规格
81
+ - DEC-043:UDS 覆盖完整性路线图(驱动来源)
82
+ - 相关:`deployment-standards`, `circuit-breaker`, `alerting-standards`(probe 连续失败 → 告警触发与路由), observability-standards(XSPEC-063 规划中)
83
+ - 业界:Kubernetes probes, Microsoft eShop health checks, Google SRE Book Ch.6
137
84
 
138
- ## 错误码
139
85
 
140
- | 代码 | 说明 |
141
- |------|------|
142
- | `HC-001` | `HEALTH_CHECK_FAILED` — 关键依赖失败 |
143
- | `HC-002` | `HEALTH_CHECK_TIMEOUT` — probe 本身超时 |
144
- | `HC-003` | `INVALID_DEPENDENCY_SET` — readiness 检查了非关键依赖(设计违规)|
86
+ **范围**: universal
@@ -2,95 +2,118 @@
2
2
  source: ../../../core/immutability-first.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: 3678885d6b73
6
7
  status: current
7
8
  ---
8
9
 
9
- # 不可变性优先原则
10
+ # 不可变性优先架构标准
10
11
 
11
12
  > **语言**: [English](../../../core/immutability-first.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-17
15
- **状态**: Trial(到期 2026-10-17)
16
- **适用范围**: universal
17
- **来源**: XSPEC-068(DEC-043 Wave 1 可靠性套件)
14
+ > **来源**: XSPEC-044 | **适用于**: TypeScript、并发系统
18
15
 
19
- ---
16
+ ## 概述
20
17
 
21
- ## 目的
18
+ 不可变性优先(Immutability-First)是一项系统级设计原则,用于防止并发 Agent 环境中的竞态条件。所有数据流接口(DTO / Value Object)都必须以 `readonly` 声明字段,数组字段必须使用 `ReadonlyArray<T>`,对象的修改必须通过 spread 语法创建新对象,而不是原地修改。
22
19
 
23
- 不可变性优先原则:DTO 字段 readonly,防止并发 Agent 竞态条件。
20
+ 缺少这项纪律时,并发的 Agent 编排(例如 `Promise.all` 批量执行)就有意外共享状态的风险:一个 Agent 的修改会悄悄影响另一个 Agent 对同一对象的视图。
24
21
 
25
- 多个 Agent 并发执行时,共享状态的可变对象容易产生竞态条件(race condition)。本标准要求所有跨 Agent 边界传递的数据对象(DTO)默认使用 readonly 字段,并提供安全修改的替代模式(返回新实例而非原地修改)。
22
+ ## 规则
26
23
 
27
- ---
24
+ | 规则 | 严重性 | 说明 |
25
+ |------|--------|------|
26
+ | **IMM-001** | required | DTO/Value Object 字段必须为 `readonly` |
27
+ | **IMM-002** | required | 数组字段必须使用 `ReadonlyArray<T>`,而非 `T[]` |
28
+ | **IMM-003** | required | 修改时使用 spread 语法创建新对象 |
29
+ | **IMM-004** | required | 跨越并发边界的对象必须是深度不可变的 |
30
+ | **IMM-005** | recommended | 嵌套对象字段以 `Readonly<T>` 包装 |
28
31
 
29
- ## 核心规范
32
+ ## 示例
30
33
 
31
- - 所有 DTO(Data Transfer Object)字段默认必须声明为 `readonly`
32
- - 跨 Agent 边界传递的对象必须是不可变的(immutable)
33
- - 需要修改时,必须返回新实例(而非原地修改)
34
- - 深层嵌套对象的所有层级都必须是 readonly
35
- - 集合(数组/Map)使用 `ReadonlyArray` / `ReadonlyMap`
34
+ ### IMM-001:DTO 字段 readonly
36
35
 
37
- ---
36
+ ```typescript
37
+ // ❌ Bad
38
+ interface TaskResult {
39
+ status: TaskStatus
40
+ cost_usd?: number
41
+ }
42
+
43
+ // ✅ Good
44
+ interface TaskResult {
45
+ readonly status: TaskStatus
46
+ readonly cost_usd?: number
47
+ }
48
+ ```
38
49
 
39
- ## IMM 规则
50
+ ### IMM-002:数组字段使用 ReadonlyArray
40
51
 
41
- | 规则 | 说明 |
42
- |------|------|
43
- | `IMM-001` | DTO 所有字段声明为 `readonly` |
44
- | `IMM-002` | 嵌套对象使用 `Readonly<T>` 递归包装 |
45
- | `IMM-003` | 数组使用 `ReadonlyArray<T>` 而非 `T[]` |
46
- | `IMM-004` | 禁止对跨 Agent 边界的对象使用原地修改(`push`、`splice`、直接赋值)|
47
- | `IMM-005` | 需要修改时,使用展开运算符(spread)返回新实例 |
52
+ ```typescript
53
+ // ❌ Bad
54
+ interface MemoryContext {
55
+ recentHistory: IterationRecord[] // push/splice can corrupt shared state
56
+ }
48
57
 
49
- ---
58
+ // ✅ Good
59
+ interface MemoryContext {
60
+ readonly recentHistory: ReadonlyArray<IterationRecord>
61
+ }
62
+ ```
50
63
 
51
- ## TypeScript 示例
64
+ ### IMM-003:以 Spread 语法进行修改
52
65
 
53
66
  ```typescript
54
- // 正确:不可变 DTO
55
- interface TaskResult {
56
- readonly taskId: string;
57
- readonly status: 'succeeded' | 'failed';
58
- readonly outputs: ReadonlyArray<string>;
59
- readonly metadata: Readonly<Record<string, unknown>>;
60
- }
67
+ // ❌ Bad
68
+ options.sessionId = forkId // other holders see the change
69
+
70
+ // ✅ Good
71
+ const taskOptions = { ...options, sessionId: forkId }
72
+ ```
73
+
74
+ ### IMM-004:并发边界上的深度不可变
75
+
76
+ ```typescript
77
+ // ✅ Good — each parallel task holds its own options snapshot
78
+ const batchResults = await Promise.all(
79
+ batch.map(task => {
80
+ const taskOptions = { ...baseOptions, sessionId: forkId }
81
+ return executeOneTask(task, adapter, taskOptions, ...)
82
+ })
83
+ )
84
+ ```
61
85
 
62
- // 正确:通过展开运算符创建新实例
63
- function updateStatus(result: TaskResult, newStatus: TaskResult['status']): TaskResult {
64
- return { ...result, status: newStatus };
86
+ ### IMM-005:嵌套对象使用 Readonly<T>
87
+
88
+ ```typescript
89
+ // ❌ Bad — metadata.score can still be mutated
90
+ interface PipelineMemoryEntry {
91
+ readonly metadata: { score?: number }
65
92
  }
66
93
 
67
- // 错误:原地修改(违反 IMM-004)
68
- // result.status = 'succeeded'; // TypeScript 会报错
94
+ // ✅ Good
95
+ interface PipelineMemoryEntry {
96
+ readonly metadata: Readonly<{ score?: number; severity?: string }>
97
+ }
69
98
  ```
70
99
 
71
- ---
100
+ ## 何时适用
72
101
 
73
- ## 情境示例
102
+ - 设计新的 DTO / Value Object / Config 接口
103
+ - 跨并发边界传递对象
104
+ - 设计 Agent 之间的共享状态
105
+ - 代码审查:检查接口是否遗漏 `readonly`
74
106
 
75
- **情境 1:并发 Agent 读取同一 DTO**
76
- - 条件:两个 Agent 并发读取 `TaskResult` 对象
77
- - 结果:因为字段是 readonly,无需加锁,不存在竞态条件
107
+ ## 例外
78
108
 
79
- **情境 2:需要更新状态**
80
- - 条件:Agent A 需要将 `TaskResult.status` 从 `failed` 改为 `succeeded`
81
- - 结果:通过 `{ ...result, status: 'succeeded' }` 返回新对象,不修改原始对象
109
+ - Builder Pattern 的可变 builder(`build()` 之后返回不可变结果)
110
+ - 测试 fixture 的可变构建步骤(创建完成后视为不可变)
111
+ - 性能关键的热路径(需要明确的 benchmark 证据)
82
112
 
83
- **情境 3:集合操作**
84
- - 条件:需要向 `outputs` 数组添加新元素
85
- - 结果:`{ ...result, outputs: [...result.outputs, newOutput] }`
113
+ ## 参考资料
86
114
 
87
- ---
115
+ - AI 优化版:[ai/standards/immutability-first.ai.yaml](../../../ai/standards/immutability-first.ai.yaml)
116
+ - XSPEC-044:跨项目规格
88
117
 
89
- ## 错误码
90
118
 
91
- | 代码 | 说明 |
92
- |------|------|
93
- | `IMM-001` | `MUTABLE_DTO_FIELD` — DTO 字段缺少 readonly 声明 |
94
- | `IMM-002` | `MUTABLE_NESTED_OBJECT` — 嵌套对象未使用 Readonly 包装 |
95
- | `IMM-003` | `MUTABLE_ARRAY` — 使用可变数组而非 ReadonlyArray |
96
- | `IMM-004` | `IN_PLACE_MUTATION` — 对跨 Agent 边界对象执行原地修改 |
119
+ **范围**: universal
@@ -2,13 +2,22 @@
2
2
  source: ../../../core/knowledge-transfer-standards.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: 7d994f996240
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 知识传承标准
10
11
 
11
- > 版本: 1.0.0 | 最后更新: 2026-04-01
12
+ > **语言**: [English](../../../core/knowledge-transfer-standards.md) | [繁體中文](../../zh-TW/core/knowledge-transfer-standards.md) | 简体中文
13
+
14
+ **版本**: 1.0.0
15
+ **最后更新**: 2026-03-31
16
+ **适用范围**: 所有软件项目
17
+ **范围**: universal
18
+ **参考**: [Atlassian Knowledge Transfer](https://www.atlassian.com/work-management/knowledge-sharing)、[Google re:Work](https://rework.withgoogle.com/)
19
+
20
+ ---
12
21
 
13
22
  ## 概述
14
23
 
@@ -18,82 +27,136 @@ status: current
18
27
 
19
28
  ## Onboarding 路线图
20
29
 
30
+ 结构化的 30 天 Onboarding 流程能帮助新团队成员快速产出。
31
+
21
32
  ### 4 周计划
22
33
 
23
34
  | 周次 | 主题 | 目标 | 交付物 |
24
35
  |------|------|------|--------|
25
- | **第 1 周** | 环境与文化 | 完成开发环境设置;理解团队规范 | 成功构建并运行项目 |
36
+ | **第 1 周** | 环境与文化 | 完成开发环境设置;理解团队规范与惯例 | 成功构建并运行项目 |
26
37
  | **第 2 周** | 架构与代码 | 理解系统架构与关键路径 | 完成 Code Tour |
27
38
  | **第 3 周** | 流程与工具 | 理解 CI/CD、部署与监控流程 | 完成第一个 PR |
28
39
  | **第 4 周** | 独立贡献 | 独立完成一个小型任务 | 通过 Buddy 评估 |
29
40
 
30
41
  ### Onboarding 检查清单
31
42
 
43
+ 每位新团队成员应在第一天及第一周内完成以下检查清单:
44
+
32
45
  | 类别 | 项目 |
33
46
  |------|------|
34
- | **账号访问** | Git 仓库、CI/CD 平台、监控工具、云端控制台、通讯工具 |
35
- | **环境设置** | 开发环境、IDE 配置、VPN、数据库访问、本地构建验证 |
47
+ | **账号访问** | Git 仓库、CI/CD 平台、监控工具、云端控制台、通讯工具(Slack/Teams) |
48
+ | **环境设置** | 开发环境、IDE 配置、VPN 访问、数据库访问、本地构建验证 |
36
49
  | **文档** | README、架构文档、API 文档、CLAUDE.md 或等效 AI 上下文文件 |
37
- | **会议** | 与 Buddy 1:1、团队介绍、架构概览 |
38
- | **首要任务** | Good First Issue、Code Tour、第一个小型 PR |
50
+ | **会议** | 与 Buddy 1:1、团队介绍、架构概览会议 |
51
+ | **首要任务** | 分配 Good First Issue、完成 Code Tour、提交第一个小型 PR |
39
52
 
40
53
  ---
41
54
 
42
55
  ## Handoff 流程
43
56
 
57
+ 当团队成员即将离职或转换角色时,使用此结构化交接流程以防止知识流失。
58
+
59
+ ### 交接检查清单
60
+
44
61
  | 项目 | 说明 | 时程 |
45
62
  |------|------|------|
46
- | **负责清单** | 列出所有负责的模块、服务与流程 | 离职前 4 周 |
47
- | **隐性知识记录** | 记录所有「只有我知道」的操作与陷阱 | 离职前 3 周 |
48
- | **WIP 交接** | 移交进行中的任务、打开的 PR、事件追踪 | 离职前 2 周 |
49
- | **Buddy 配对** | 指定继任者并进行 Pair Programming | 离职前 2 周 |
50
- | **账号与权限** | 移交 owner 权限、轮换 API 密钥 | 离职前 1 周 |
51
- | **Runbook 更新** | 审查并更新所有相关 Runbook | 离职前 1 周 |
63
+ | **负责清单** | 列出此人负责的所有模块、服务与流程 | 离职前 4 周 |
64
+ | **隐性知识记录** | 使用下方的知识记录格式,记录所有「只有我知道」的操作、技巧与陷阱 | 离职前 3 周 |
65
+ | **WIP 交接** | 移交所有进行中的任务、打开的 PR 与事件追踪项目 | 离职前 2 周 |
66
+ | **Buddy 配对** | 指定继任者,并针对复杂领域进行 Pair Programming | 离职前 2 周 |
67
+ | **账号与权限移交** | 移交 owner 权限、轮换 API 密钥、更新访问控制 | 离职前 1 周 |
68
+ | **Runbook 更新** | 审查并更新所有相关 Runbook,确保其为最新且完整 | 离职前 1 周 |
52
69
 
53
70
  ### 知识记录格式
54
71
 
55
- | 字段 | 说明 |
56
- |------|------|
57
- | **主题** | 捕捉什么知识 |
58
- | **情境** | 何时需要此知识 |
59
- | **步骤** | 具体操作程序 |
60
- | **陷阱** | 常见错误与注意事项 |
61
- | **资源** | 代码、文档、Runbook 链接 |
72
+ 记录隐性知识时,每条记录应(SHOULD)包含以下 5 个字段:
73
+
74
+ | 字段 | 说明 | 示例 |
75
+ |------|------|------|
76
+ | **主题** | 捕捉什么知识 | 「支付网关重试逻辑」 |
77
+ | **情境** | 在什么情况下需要此知识 | 「支付因超时错误失败时」 |
78
+ | **步骤** | 应遵循的具体程序 | 「1. 检查网关状态页 2. 审查重试队列 3. ...」 |
79
+ | **陷阱** | 常见错误与注意事项 | 「绝不重试 4xx 错误;只对 5xx 或超时重试」 |
80
+ | **资源** | 代码、文档、Runbook 链接 | 「参见 `src/payment/retry.js`,Runbook:payment-recovery」 |
62
81
 
63
82
  ---
64
83
 
65
84
  ## Bus Factor 评估
66
85
 
86
+ Bus Factor 衡量需要多少团队成员「被公交车撞到」(意外离开)才会导致关键知识流失。Bus Factor 为 1 表示只要一人离开,就可能使某个系统领域瘫痪。
87
+
88
+ ### 评估指标
89
+
90
+ 针对每个关键领域或系统区域,评估以下 3 项指标:
91
+
67
92
  | 指标 | 定义 | 风险等级 |
68
93
  |------|------|---------|
69
- | **知识人数** | 可独立处理该领域的人数 | 1 人 = **高**、2 人 = **中**、3+ 人 = **低** |
70
- | **文档覆盖率** | 有书面文档覆盖的百分比 | < 30% = **高**、30-70% = **中**、> 70% = **低** |
71
- | **最近知识分享** | 最近一次有人学习该领域 | > 6 个月 = **高**、3-6 个月 = **中**、< 3 个月 = **低** |
94
+ | **知识人数** | 可独立处理该领域的人数 | 1 人 = **高**风险、2 人 = **中**、3+ 人 = **低** |
95
+ | **文档覆盖率** | 该领域有书面文档覆盖的百分比 | < 30% = **高**风险、30-70% = **中**、> 70% = **低** |
96
+ | **最近知识分享** | 最近一次有人学习该领域距今多久 | > 6 个月 = **高**风险、3-6 个月 = **中**、< 3 个月 = **低** |
72
97
 
73
98
  ### 知识扩散策略
74
99
 
75
- | 策略 | 适用场景 |
76
- |------|---------|
77
- | **Pair Programming** | 复杂逻辑、特殊技巧 |
78
- | **Tech Talk** | 架构决策、设计理由 |
79
- | **文档化** | 操作程序、部署步骤 |
80
- | **Code Review 轮调** | 代码理解、打破知识孤岛 |
81
- | **On-call 轮调** | 运维知识、事件响应 |
100
+ 识别出 Bus Factor = 1 的领域时,使用以下一种或多种策略扩散知识:
101
+
102
+ | 策略 | 说明 | 适用场景 |
103
+ |------|------|---------|
104
+ | **Pair Programming** | 专家与学习者一起处理实际任务 | 复杂逻辑、特殊技巧 |
105
+ | **Tech Talk** | 专家以结构化会议向团队讲解 | 架构决策、设计理由 |
106
+ | **文档化** | 将隐性知识转为书面文档或 Runbook | 操作程序、部署步骤 |
107
+ | **Code Review 轮调** | 轮换审查者,让不同的人审查不同领域 | 代码理解、发现知识孤岛 |
108
+ | **On-call 轮调** | 在不同服务之间轮换值班 | 运维知识、事件响应 |
82
109
 
83
110
  ---
84
111
 
85
112
  ## Code Tour
86
113
 
114
+ Code Tour 提供贯穿代码库的结构化导览路线,帮助新人无需阅读每个文件即可理解系统。
115
+
87
116
  ### 导览路线
88
117
 
118
+ 每个代码库应(SHOULD)至少定义以下导览路线:
119
+
89
120
  | 路线 | 涵盖内容 | 目标对象 |
90
121
  |------|---------|---------|
91
122
  | **Quick Start** | 入口点、主要配置、启动流程 | 所有新人 |
92
123
  | **Request Flow** | 请求从进入到响应的完整路径 | 后端开发者 |
93
124
  | **Data Flow** | 数据从创建到存储到检索的路径 | 数据相关开发者 |
94
- | **Deploy Flow** | 从 PR 到生产的完整路径 | 需要部署的人 |
125
+ | **Deploy Flow** | 从 PR 到生产环境的完整路径 | 需要部署的人 |
95
126
  | **Key Decisions** | 重要架构决策及其 ADR | 需要理解「为什么」的人 |
96
127
 
128
+ ### Code Tour 维护
129
+
130
+ 发生代码变更时,评估 Code Tour 是否需要更新:
131
+
132
+ | 变更类型 | 动作 | 理由 |
133
+ |---------|------|------|
134
+ | 入口点或路由变更 | **必须(MUST)** 更新导览 | 导览引用会失效或产生误导 |
135
+ | 内部重构(接口不变) | **无需更新** | 导览描述的是流程,而非实现细节 |
136
+ | 新增重大功能 | **应(SHOULD)** 新增导览路线 | 新功能可能值得拥有独立的导览路径 |
137
+
138
+ ---
139
+
140
+ ## 参考资料
141
+
142
+ - [Atlassian Knowledge Transfer Guide](https://www.atlassian.com/work-management/knowledge-sharing) — 知识分享最佳实践
143
+ - [Google re:Work — Onboarding](https://rework.withgoogle.com/guides/hiring-shape-the-candidate-experience/steps/make-onboarding-a-great-experience/) — 以证据为基础的 Onboarding 实践
144
+ - [Bus Factor on Wikipedia](https://en.wikipedia.org/wiki/Bus_factor) — 概念定义与缓解方式
145
+
146
+ ---
147
+
148
+ **相关标准:**
149
+ - [文档生命周期](documentation-lifecycle.md) — 文档维护与审查周期
150
+ - [Runbook 标准](runbook-standards.md) — 运维 Runbook 格式与要求
151
+
152
+ ---
153
+
154
+ ## 版本历史
155
+
156
+ | 版本 | 日期 | 变更 |
157
+ |------|------|------|
158
+ | 1.0.0 | 2026-03-31 | 初始发布:Onboarding 路线图、Handoff 流程、Bus Factor 评估、Code Tour |
159
+
97
160
  ---
98
161
 
99
162
  ## 许可
@@ -1,18 +1,18 @@
1
1
  ---
2
2
  source: ../../../core/mutation-testing.md
3
- source_version: 1.0.0
3
+ source_version: 1.1.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-06-10
6
- source_hash: 6a5286d76274
7
- status: stale
5
+ last_synced: 2026-10-15
6
+ source_hash: 8eeaea8d9cc3
7
+ status: current
8
8
  ---
9
9
 
10
10
  # 变异测试标准
11
11
 
12
12
  > **语言**: [English](../../../core/mutation-testing.md) | [繁體中文](../../zh-TW/core/mutation-testing.md) | 简体中文
13
13
 
14
- **版本**: 1.0.0
15
- **最后更新**: 2026-05-04
14
+ **版本**: 1.1.0
15
+ **最后更新**: 2026-08-14
16
16
  **适用性**: 所有具备单元/集成测试的软件项目
17
17
  **范围**: universal
18
18
  **行业标准**: ISTQB Foundation Syllabus(测试有效性指标)
@@ -39,6 +39,42 @@ Mutation Score = Killed Mutants / (Killed + Survived) × 100%
39
39
 
40
40
  ---
41
41
 
42
+ ## 归因:kill 记给第一个失败的测试
43
+
44
+ `Killed` 表示本次运行中*有某个*测试对该变异体断言失败——大多数工具不会记录是*哪个*测试杀死了它,更不会记录是*哪个测试层级*。因此 7/7 的 kill score 验证的是**对该变异体运行过的整套测试**,而不是任何单个测试,也不是任何单个测试层级(unit vs. integration vs. property)。
45
+
46
+ **后果**:“property suite 验证了 X”并不是一次聚合的 mutation run 所能支持的主张。要支持它,必须*只启用* property suite 重新运行变异测试:
47
+
48
+ ```bash
49
+ npx stryker run --mutate 'src/module/**' -- --project=property
50
+ ```
51
+
52
+ 如果隔离运行杀死的变异体少于聚合运行,这个差距正是 unit/integration 测试原本悄悄覆盖掉的部分。
53
+
54
+ **规则**:高风险模块(与 80% 阈值适用的同一集合——auth/license/payment/security)在宣称“已被 property 验证”之前,必须先单独针对 property suite 重新运行变异体。
55
+
56
+ ---
57
+
58
+ ## 单边不变式抓不到 fail-closed 缺陷
59
+
60
+ 像“输出永不超出上限”这种性质是单边的:它无法检测到使代码 **fail closed**(拒绝一切,包括合法输入)的变异体——因为 fail-closed 的变异体永远不会产生超过上限的输出。Mutation score 看起来未受影响,而整整一类缺陷(拒绝服务、错误拒绝合法请求)对测试套件完全隐形。
61
+
62
+ **修复方法**:将每个单边不变式与其相反边界配对。“永不超出上限”需要一个搭档性质——例如“接受上限及以下的一切输入”——以便过度宽容和过度严格的变异体都有一条被检测到的路径。
63
+
64
+ ---
65
+
66
+ ## Equivalent mutant 不是要追杀的存活者
67
+
68
+ 存活的变异体并不自动等同于测试缺口。有些变异体与原始代码**语义等价**——没有任何输入能区分两者的行为——无论测试怎么写都无法杀死它们。用一个仅仅为了推高分数而存在的断言(例如对一个无关紧要的值加上 `expect(x).toBeDefined()`)硬杀,只会制造一个空心测试,而没有真正填补任何缺口。
69
+
70
+ **每个被审查过的存活者都必须分类**:
71
+ - **真实缺口** → 编写一个能触发该可区分行为的测试。
72
+ - **`equivalent, because <reason>`** → 连同为了得出此结论而检查过的输入一并记录。
73
+
74
+ 未分类的存活者不等于已分类为 equivalent 的存活者。只有已分类为 equivalent 的变异体,才可以从分母中排除。
75
+
76
+ ---
77
+
42
78
  ## 工具
43
79
 
44
80
  | 语言 | 工具 | 命令 |
@@ -96,6 +132,9 @@ npm install --save-dev @stryker-mutator/core @stryker-mutator/vitest-runner
96
132
  - 在每个 PR 的 CI 中都加入变异测试(太慢)
97
133
  - 未经 mutation score 验证就接受 AI 生成的测试
98
134
  - 靠加 `toBeDefined()` 断言来杀死变异
135
+ - 仅凭一次聚合(非隔离)的 mutation run 就宣称“property suite 验证了 X”
136
+ - 对具有 fail-closed 失效模式的性质,只使用单边不变式
137
+ - 对语义等价的变异体强行杀死,而不是分类为 `equivalent, because <reason>`
99
138
 
100
139
  ---
101
140