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,6 +2,8 @@
2
2
  source: core/guides/security-guide.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: efb5c611807a
5
7
  status: current
6
8
  ---
7
9
 
@@ -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**:連續 fail(達 probe threshold)依 [alerting-standards](alerting-standards.md) 觸發告警——由 alerting 定義觸發時機、嚴重性對映與路由(`HC-001 HEALTH_CHECK_FAILED` 為 alert 來源之一),health-check 只負責 emit 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
+ **Scope**: universal
@@ -2,7 +2,8 @@
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
 
@@ -10,99 +11,70 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/immutability-first.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-16
15
- **適用範圍**: TypeScript 介面、資料流設計、並行系統
16
- **Scope**: universal
17
- **來源**: XSPEC-044
14
+ > **來源**: XSPEC-044 | **適用於**: TypeScript、並行系統
18
15
 
19
- ---
16
+ ## 概述
20
17
 
21
- ## 目的
18
+ 不可變性優先(Immutability-First)是一項系統層級的設計原則,用以防止並行 Agent 環境中的競態條件。所有資料流介面(DTO / Value Object)都必須以 `readonly` 宣告欄位,陣列欄位必須使用 `ReadonlyArray<T>`,物件修改必須透過展開語法建立新物件,而非就地修改。
22
19
 
23
- 系統級不可變性設計原則:DTO/Value Object 欄位一律 `readonly`,防止並行 Agent 環境下的競態條件。
20
+ 若缺乏此紀律,並行 Agent 編排(例如 `Promise.all` 批次執行)便有意外共享狀態的風險:某個 Agent 的修改會悄悄影響其他 Agent 所看到的同一個物件。
24
21
 
25
- 資料流介面(DTO / Value Object)的欄位一律宣告為 `readonly`,陣列欄位使用 `ReadonlyArray<T>`,物件修改透過展開語法建立新物件,防止並行 Agent 環境下的意外狀態共享與競態條件。
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 | 修改時使用展開語法建立新物件 |
29
+ | **IMM-004** | required | 跨越並行邊界的物件必須為深層不可變 |
30
+ | **IMM-005** | recommended | 巢狀物件欄位以 `Readonly<T>` 包裝 |
28
31
 
29
- ## 核心規範
32
+ ## 範例
30
33
 
31
- - 資料流介面(DTO / Value Object)的所有欄位必須宣告 `readonly`
32
- - 介面中的陣列型欄位使用 `ReadonlyArray<T>` 而非可變的 `T[]`
33
- - 修改物件時使用物件展開語法建立新物件,不直接賦值給 `readonly` 欄位
34
- - 跨並行邊界(`Promise.all` / Worker Thread)傳遞的物件必須為深層不可變
35
- - 介面中的嵌套物件欄位使用 `Readonly<T>` 包裝(防止淺層保護不足)
36
-
37
- ---
34
+ ### IMM-001:DTO 欄位 readonly
38
35
 
39
- ## 規則詳細說明
40
-
41
- ### IMM-001:DTO 欄位 readonly(必要)
42
-
43
- 資料流介面(Data Transfer Objects、Value Objects)的所有欄位必須宣告 `readonly`,防止並行 Agent 環境下的意外狀態共享與競態條件。
44
-
45
- **錯誤範例**:
46
36
  ```typescript
37
+ // ❌ Bad
47
38
  interface TaskResult {
48
- status: TaskStatus // ← 可被意外修改
39
+ status: TaskStatus
49
40
  cost_usd?: number
50
41
  }
51
- ```
52
42
 
53
- **正確範例**:
54
- ```typescript
43
+ // ✅ Good
55
44
  interface TaskResult {
56
- readonly status: TaskStatus // ← 型別安全保護
45
+ readonly status: TaskStatus
57
46
  readonly cost_usd?: number
58
47
  }
59
48
  ```
60
49
 
61
- ---
62
-
63
- ### IMM-002:陣列欄位 ReadonlyArray(必要)
50
+ ### IMM-002:陣列欄位使用 ReadonlyArray
64
51
 
65
- 介面中的陣列型欄位使用 `ReadonlyArray<T>` 而非可變的 `T[]`,防止 `push`/`splice`/`sort` 等就地修改操作破壞共享陣列。
66
-
67
- **錯誤範例**:
68
52
  ```typescript
53
+ // ❌ Bad
69
54
  interface MemoryContext {
70
- recentHistory: IterationRecord[] // ← 可被 push/splice
55
+ recentHistory: IterationRecord[] // push/splice can corrupt shared state
71
56
  }
72
- ```
73
57
 
74
- **正確範例**:
75
- ```typescript
58
+ // ✅ Good
76
59
  interface MemoryContext {
77
60
  readonly recentHistory: ReadonlyArray<IterationRecord>
78
61
  }
79
62
  ```
80
63
 
81
- ---
82
-
83
- ### IMM-003:展開語法替代就地修改(必要)
84
-
85
- 修改物件時使用物件展開語法建立新物件,不直接賦值給 `readonly` 欄位,保留原始物件不變,同時建立可追蹤的修改歷程。
64
+ ### IMM-003:以展開語法進行修改
86
65
 
87
- **錯誤範例**:
88
66
  ```typescript
89
- options.sessionId = forkId // ← 直接修改,其他持有者看到改變
90
- ```
67
+ // ❌ Bad
68
+ options.sessionId = forkId // other holders see the change
91
69
 
92
- **正確範例**:
93
- ```typescript
94
- const taskOptions = { ...options, sessionId: forkId } // ← 新物件
70
+ // ✅ Good
71
+ const taskOptions = { ...options, sessionId: forkId }
95
72
  ```
96
73
 
97
- ---
98
-
99
- ### IMM-004:並行邊界深層不可變(必要)
100
-
101
- 跨並行邊界(`Promise.all` / Worker Thread)傳遞的物件必須為深層不可變,並行執行中無法預測存取順序,可變共享物件必然產生競態條件。
74
+ ### IMM-004:並行邊界的深層不可變
102
75
 
103
- **正確範例**:
104
76
  ```typescript
105
- // 每個並行任務持有自己的 options 快照
77
+ // ✅ Good — each parallel task holds its own options snapshot
106
78
  const batchResults = await Promise.all(
107
79
  batch.map(task => {
108
80
  const taskOptions = { ...baseOptions, sessionId: forkId }
@@ -111,49 +83,37 @@ const batchResults = await Promise.all(
111
83
  )
112
84
  ```
113
85
 
114
- ---
115
-
116
- ### IMM-005:嵌套物件 Readonly 包裝(建議)
86
+ ### IMM-005:巢狀物件使用 Readonly<T>
117
87
 
118
- 介面中的嵌套物件欄位使用 `Readonly<T>` 包裝,頂層 `readonly` 不防止嵌套物件欄位被修改(淺層保護不足)。
119
-
120
- **錯誤範例**:
121
88
  ```typescript
89
+ // ❌ Bad — metadata.score can still be mutated
122
90
  interface PipelineMemoryEntry {
123
- readonly metadata: { score?: number } // ← metadata.score 仍可被修改
91
+ readonly metadata: { score?: number }
124
92
  }
125
- ```
126
93
 
127
- **正確範例**:
128
- ```typescript
94
+ // ✅ Good
129
95
  interface PipelineMemoryEntry {
130
96
  readonly metadata: Readonly<{ score?: number; severity?: string }>
131
97
  }
132
98
  ```
133
99
 
134
- ---
135
-
136
100
  ## 適用時機
137
101
 
138
102
  - 設計新的 DTO / Value Object / Config 介面時
139
103
  - 跨並行邊界傳遞物件時
140
- - Agent 間共享狀態設計時
141
- - Code Review 時檢查介面是否遺漏 `readonly`
142
-
143
- ---
104
+ - 設計 Agent 間的共享狀態時
105
+ - Code Review:檢查介面是否遺漏 `readonly`
144
106
 
145
107
  ## 豁免情況
146
108
 
147
- - Builder Pattern 的 mutable builder 物件(在 `build()` 後回傳不可變結果)
148
- - 測試 fixture 的 mutable 建立步驟(建立後視為不可變)
149
- - 效能關鍵的熱路徑(需有明確的 benchmark 依據才可豁免)
109
+ - Builder Pattern 的可變 builder(在 `build()` 後回傳不可變結果)
110
+ - 測試 fixture 的可變建立步驟(建立後視為不可變)
111
+ - 效能關鍵的熱路徑(需有明確的 benchmark 依據)
150
112
 
151
- ---
113
+ ## 參考資料
152
114
 
153
- ## 錯誤碼
115
+ - AI 最佳化版:[ai/standards/immutability-first.ai.yaml](../../../ai/standards/immutability-first.ai.yaml)
116
+ - XSPEC-044:跨專案規格
154
117
 
155
- | 代碼 | 說明 |
156
- |------|------|
157
- | `IMM-E001` | `READONLY_VIOLATION` — 嘗試修改 readonly 欄位(TypeScript 編譯期捕獲) |
158
- | `IMM-E002` | `SHARED_MUTATION` — 跨並行邊界的就地修改導致競態條件 |
159
- | `IMM-E003` | `SHALLOW_READONLY` — 嵌套物件遺漏 `Readonly<T>` 包裝,淺層保護不足 |
118
+
119
+ **Scope**: universal
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/knowledge-graph-memory.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-05-30
5
+ last_synced: 2026-10-11
6
+ source_hash: 6a5372029069
6
7
  status: current
7
8
  ---
8
9
 
@@ -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) | 繁體中文
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,84 +27,138 @@ status: current
18
27
 
19
28
  ## Onboarding 路線圖
20
29
 
21
- ### 4 週計畫
30
+ 結構化的 30 天 Onboarding 流程,幫助新成員快速發揮生產力。
31
+
32
+ ### 4 週路線圖
22
33
 
23
34
  | 週次 | 主題 | 目標 | 交付物 |
24
- |------|------|------|--------|
25
- | **第 1 週** | 環境與文化 | 完成開發環境設定;理解團隊規範 | 成功建置並執行專案 |
35
+ |------|-------|------|-------------|
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
- |------|------|
34
- | **帳號存取** | Git 儲存庫、CI/CD 平台、監控工具、雲端控制台、通訊工具 |
35
- | **環境設定** | 開發環境、IDE 配置、VPN、資料庫存取、本地建置驗證 |
36
- | **文件** | README、架構文件、API 文件、CLAUDE.md 或等效 AI 脈絡檔案 |
37
- | **會議** | 與 Buddy 1:1、團隊介紹、架構概覽 |
38
- | **首要任務** | Good First Issue、Code Tour、第一個小型 PR |
46
+ |----------|-------|
47
+ | **帳號存取** | Git 儲存庫、CI/CD 平台、監控工具、雲端控制台、通訊工具(Slack/Teams) |
48
+ | **環境設定** | 開發環境、IDE 設定、VPN 存取、資料庫存取、本地建置驗證 |
49
+ | **文件** | README、架構文件、API 文件、CLAUDE.md 或等效的 AI 脈絡檔案 |
50
+ | **會議** | 與 Buddy 1:1、團隊介紹、架構概覽說明會 |
51
+ | **首要任務** | 指派 Good First Issue、完成 Code Tour、提交第一個小型 PR |
39
52
 
40
53
  ---
41
54
 
42
55
  ## Handoff 流程
43
56
 
57
+ 當團隊成員即將離職或轉換角色時,使用此結構化 Handoff 流程以防止知識流失。
58
+
59
+ ### Handoff 檢查清單
60
+
44
61
  | 項目 | 說明 | 時程 |
45
- |------|------|------|
46
- | **負責清單** | 列出所有負責的模組、服務與流程 | 離職前 4 週 |
47
- | **隱性知識記錄** | 記錄所有「只有我知道」的操作與陷阱 | 離職前 3 週 |
48
- | **WIP 交接** | 移交進行中的任務、開啟的 PR、事件追蹤 | 離職前 2 週 |
49
- | **Buddy 配對** | 指定繼任者並進行 Pair Programming | 離職前 2 週 |
50
- | **帳號與權限** | 移交 owner 權限、輪換 API 金鑰 | 離職前 1 週 |
51
- | **Runbook 更新** | 審查並更新所有相關 Runbook | 離職前 1 週 |
62
+ |------|-------------|----------|
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
+ 記錄隱性知識時,每筆記錄**應該**包含以下 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
- |------|------|---------|
69
- | **知識人數** | 可獨立處理該領域的人數 | 1 人 = **高**、2 人 = **中**、3+ 人 = **低** |
70
- | **文件覆蓋率** | 有書面文件覆蓋的百分比 | < 30% = **高**、30-70% = **中**、> 70% = **低** |
71
- | **最近知識分享** | 最近一次有人學習該領域 | > 6 個月 = **高**、3-6 個月 = **中**、< 3 個月 = **低** |
93
+ |--------|-----------|------------|
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
+ 每個程式碼庫**應該**至少定義以下導覽路線:
119
+
89
120
  | 路線 | 涵蓋內容 | 目標對象 |
90
- |------|---------|---------|
121
+ |-------|--------|-----------------|
91
122
  | **Quick Start** | 進入點、主要設定、啟動流程 | 所有新人 |
92
123
  | **Request Flow** | 請求從進入到回應的完整路徑 | 後端開發者 |
93
- | **Data Flow** | 資料從建立到儲存到擷取的路徑 | 資料相關開發者 |
94
- | **Deploy Flow** | 從 PR 到生產的完整路徑 | 需要部署的人 |
124
+ | **Data Flow** | 資料從建立、儲存到擷取的路徑 | 資料相關開發者 |
125
+ | **Deploy Flow** | 從 PR 到正式環境的完整路徑 | 需要部署的人 |
95
126
  | **Key Decisions** | 重要架構決策及其 ADR | 需要理解「為什麼」的人 |
96
127
 
128
+ ### Code Tour 維護
129
+
130
+ 程式碼變更時,評估 Code Tour 是否需要更新:
131
+
132
+ | 變更類型 | 動作 | 理由 |
133
+ |-------------|--------|-----------|
134
+ | 進入點或路由變更 | **必須**更新導覽 | 導覽中的參照會失效或產生誤導 |
135
+ | 內部重構(介面不變) | **不需更新** | 導覽描述的是流程,而非實作細節 |
136
+ | 新增重大功能 | **應該**新增導覽路線 | 新功能可能值得擁有專屬的導覽路徑 |
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
  ## 授權
100
163
 
101
- 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
164
+ 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。