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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -1,22 +1,34 @@
1
1
  ---
2
2
  source: ../../../core/supply-chain-security-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 25ea1d1d96a9
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 供應鏈安全標準
10
11
 
11
- > 版本: 1.1.0 | 最後更新: 2026-08-04
12
+ > **語言**: [English](../../../core/supply-chain-security-standards.md) | 繁體中文
13
+
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-08-04
16
+ **適用性**: 所有具有外部相依性的軟體專案
17
+ **範圍**: universal
18
+ **產業標準**: SLSA, SPDX, CycloneDX, OpenSSF Scorecard
19
+ **參考**: [slsa.dev](https://slsa.dev/), [spdx.dev](https://spdx.dev/), [cyclonedx.org](https://cyclonedx.org/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
25
  本文件定義供應鏈安全標準,涵蓋軟體物料清單(SBOM)、相依性稽核、SLSA 成熟度等級、授權合規與相依性健康評估。
16
26
 
27
+ ---
28
+
17
29
  ## 軟體物料清單(SBOM)
18
30
 
19
- ### 格式比較
31
+ ### SBOM 格式比較
20
32
 
21
33
  | 面向 | SPDX | CycloneDX |
22
34
  |------|------|-----------|
@@ -24,13 +36,22 @@ status: current
24
36
  | **主要焦點** | 授權合規 + 安全 | 安全 + 元件分析 |
25
37
  | **格式** | JSON, RDF, YAML, Tag-Value | JSON, XML, Protobuf |
26
38
  | **ISO 標準** | ISO/IEC 5962:2021 | ECMA-424 |
39
+ | **生態系** | 在開源治理領域較強 | 在 DevSecOps 工具鏈較強 |
40
+
41
+ ### 選擇指引
42
+
43
+ - **選擇 SPDX**:當授權合規是主要考量,或需要 ISO 認證時
44
+ - **選擇 CycloneDX**:當安全分析與 DevSecOps 整合是優先事項時
45
+ - **兩種格式皆可**;組織內保持一致比選哪一種更重要
27
46
 
28
- ### 需求
47
+ ### SBOM 需求
29
48
 
30
49
  - 每次發布必須包含 SBOM,列出所有直接與間接相依性
31
50
  - SBOM 必須包含:元件名稱、版本、供應商、授權、已知漏洞
32
51
  - SBOM 應作為 CI/CD Pipeline 的一部分自動產生
33
52
 
53
+ ---
54
+
34
55
  ## 相依性稽核
35
56
 
36
57
  ### 四大稽核維度
@@ -42,8 +63,21 @@ status: current
42
63
  | **維護狀態** | 最後提交日期、開放 Issue、維護者數量 | 超過 2 年未維護: 警告 |
43
64
  | **版本時效** | 落後最新版本多少個 Major/Minor | 落後 Major > 2: 警告 |
44
65
 
66
+ ### 稽核頻率
67
+
68
+ | 觸發時機 | 動作 |
69
+ |---------|------|
70
+ | 每次 CI 建構 | 漏洞掃描(自動化) |
71
+ | 每週 | 完整稽核報告(自動化) |
72
+ | 發布前 | 人工審查所有警告 |
73
+ | 收到安全公告時 | 立即評估受影響的相依性 |
74
+
75
+ ---
76
+
45
77
  ## SLSA 等級
46
78
 
79
+ Supply-chain Levels for Software Artifacts(軟體產物供應鏈等級)定義建構完整性的成熟度等級:
80
+
47
81
  | 等級 | 需求 | 適用情境 |
48
82
  |------|------|---------|
49
83
  | **L1 — Provenance** | 建構流程文件化;產生 SBOM | 所有專案(最低基準) |
@@ -51,27 +85,54 @@ status: current
51
85
  | **L3 — Hardened Builds** | 隔離、短暫的建構環境;不可偽造的 Provenance | 安全關鍵應用 |
52
86
  | **L4 — Two-Party Review** | 所有變更需兩人審查;密封式建構 | 基礎設施、金融系統 |
53
87
 
88
+ ### 進階路徑
89
+
90
+ 從 L1 開始,依風險概況逐步採用更高等級:
91
+
92
+ ```
93
+ L1 (All projects) → L2 (CI/CD projects) → L3 (Security-critical) → L4 (High-assurance)
94
+ ```
95
+
96
+ ---
97
+
54
98
  ## 授權合規
55
99
 
56
100
  ### 授權類別矩陣
57
101
 
58
102
  | 類別 | 範例 | 相容性 | 風險 |
59
103
  |------|------|--------|------|
60
- | **寬鬆式** | MIT, Apache-2.0, BSD | 幾乎與所有授權相容 | 低 |
61
- | **弱 Copyleft** | LGPL-2.1, MPL-2.0 | 作為函式庫使用時相容 | 中 |
104
+ | **寬鬆式** | MIT, Apache-2.0, BSD-2/3 | 幾乎與所有授權相容 | 低 |
105
+ | **弱 Copyleft** | LGPL-2.1, MPL-2.0 | 作為函式庫使用(未修改)時相容 | 中 |
62
106
  | **強 Copyleft** | GPL-2.0, GPL-3.0 | 衍生作品須使用相同授權 | 高 |
63
107
  | **網路 Copyleft** | AGPL-3.0 | Copyleft 延伸至網路互動 | 極高 |
64
108
  | **專有** | 自訂、無授權 | 未經明確許可不得使用 | 阻擋 |
65
109
 
110
+ ### 合規規則
111
+
112
+ - **寬鬆式 + 寬鬆式**:一律相容
113
+ - **寬鬆式 + Copyleft**:遵守 Copyleft 條款即相容
114
+ - **Copyleft + 不同的 Copyleft**:經常不相容——需法務審查
115
+ - **SaaS 中的 AGPL**:會對整個服務觸發 Copyleft——需審慎評估
116
+ - **無授權**:視為專有——未經明確許可不得使用
117
+
118
+ ---
119
+
66
120
  ## 相依性更新策略
67
121
 
68
122
  | 更新類型 | 策略 | 自動化 |
69
123
  |---------|------|--------|
70
- | **Patch** (x.y.Z) | CI 通過後自動合併 | 全自動 |
124
+ | **Patch** (x.y.Z) | CI 通過後自動合併 | 全自動(Dependabot/Renovate) |
71
125
  | **Minor** (x.Y.0) | 自動建立 PR,人工審查 | 半自動 |
72
- | **Major** (X.0.0) | 人工評估,遷移計畫 | 手動 |
126
+ | **Major** (X.0.0) | 人工評估,遷移計畫 | 手動,並審閱變更日誌 |
73
127
  | **鎖定策略** | 提交 lock 檔——**若你發布套件,另須驗證消費端會解析到什麼**(見下) | lock 檔進版控;發版時檢查消費端解析 |
74
128
 
129
+ ### 更新規則
130
+
131
+ - lock 檔必須提交至版本控制
132
+ - Patch 更新應在 7 天內套用
133
+ - 安全修補必須在 48 小時(Critical)或 7 天(High)內套用
134
+ - Major 版本升級應每季評估
135
+
75
136
  ### lock 檔約束不了你的使用者
76
137
 
77
138
  提交 lock 檔讓**你自己的**建置可重現。它到不了任何安裝你套件的人:發布出去的 npm
@@ -105,6 +166,54 @@ tarball、PyPI wheel、Ruby gem 都不帶 lock 檔。消費端是**在他們安
105
166
  > **適用於發布出去的產物,不適用於應用程式。** 一個部署出去的服務會連同 lock 檔一起
106
167
  > 出貨,因此它的建置與執行看到的是同一組版本。本節談的是**別人會安裝的套件**。
107
168
 
169
+ ---
170
+
171
+ ## CI/CD 整合
172
+
173
+ ### Pipeline 安全關卡
174
+
175
+ 相依性掃描必須整合進 CI/CD:
176
+
177
+ ```
178
+ PR Created → Dependency Scan → Results
179
+ │
180
+ ┌──────────────┼──────────────┐
181
+ ▼ ▼ ▼
182
+ Critical High Medium/Low
183
+ → Block PR → Warn + → Log only
184
+ Create Ticket
185
+ ```
186
+
187
+ ### 必要的 Pipeline 步驟
188
+
189
+ 1. **SBOM 產生** — 每次建構都產出 SBOM
190
+ 2. **漏洞掃描** — 比對 CVE 資料庫
191
+ 3. **授權掃描** — 驗證授權相容性
192
+ 4. **相依性新鮮度** — 回報過時的相依性
193
+
194
+ ---
195
+
196
+ ## 相依性健康評估
197
+
198
+ ### 健康指標
199
+
200
+ | 指標 | 健康 | 警告 | 不健康 |
201
+ |------|------|------|--------|
202
+ | **最後更新日期** | < 6 個月 | 6-24 個月 | > 24 個月 |
203
+ | **已知 CVE** | 0 個 Critical/High | 1-2 個 High | 任何未修補的 Critical |
204
+ | **維護者數量** | ≥ 3 | 2 | 1(巴士因子風險) |
205
+ | **社群活躍度** | Issue/PR 活躍 | 回應緩慢 | 已棄置 |
206
+ | **下載趨勢** | 穩定或成長 | 下降 | 接近零 |
207
+
208
+ ### 健康分數
209
+
210
+ 將各指標合併為整體健康分數:
211
+ - **綠燈**(健康):所有指標皆無警告
212
+ - **黃燈**(注意):1-2 項警告等級指標
213
+ - **紅燈**(需採取行動):任何不健康指標或 Critical CVE
214
+
215
+ ---
216
+
108
217
  ## 快速參考卡
109
218
 
110
219
  ```
@@ -116,9 +225,27 @@ Critical CVE? → 48 小時內修補
116
225
 
117
226
  ---
118
227
 
228
+ ## 參考資料
229
+
230
+ - [SLSA Framework](https://slsa.dev/) — Supply-chain Levels for Software Artifacts
231
+ - [SPDX Specification](https://spdx.dev/) — Software Package Data Exchange
232
+ - [CycloneDX](https://cyclonedx.org/) — OWASP 軟體物料清單標準
233
+ - [OpenSSF Scorecard](https://securityscorecards.dev/) — 自動化安全健康檢查
234
+
235
+ ---
236
+
119
237
  **相關標準:**
120
238
  - [安全標準](security-standards.md) - 應用程式安全
121
239
  - [容器化標準](containerization-standards.md) - 映像檔漏洞掃描
240
+ - [棄用標準](deprecation-standards.md) - 相依性停用通知
241
+
242
+ ---
243
+
244
+ ## 版本歷史
245
+
246
+ | 版本 | 日期 | 變更內容 |
247
+ |------|------|----------|
248
+ | 1.0.0 | 2026-04-01 | 初始發布 |
122
249
 
123
250
  ---
124
251
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/systematic-debugging.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: 7f591022723b
6
7
  status: current
7
8
  ---
8
9
 
@@ -39,57 +40,112 @@ status: current
39
40
 
40
41
  > **禁止跳過根因分析直接修復。**
41
42
 
42
- 如果你發現自己在說「快速修復」、「試試看」或「應該可以了」— **停下來**,回到第一階段。
43
+ 如果你發現自己在說「快速修復」、「試試看」或「應該可以了」— **停下來**,回到階段 1。
43
44
 
44
45
  ---
45
46
 
46
- ## 四階段除錯工作流
47
+ ## 四個階段
47
48
 
48
- ### 階段 1:觀察與重現
49
+ ### 階段 1:根因調查(Root Cause Investigation)
49
50
 
50
- | 步驟 | 說明 |
51
- |------|------|
52
- | 收集錯誤資訊 | 錯誤訊息、堆疊追蹤、日誌 |
53
- | 確定重現步驟 | 建立可靠的重現路徑 |
54
- | 記錄環境條件 | 作業系統、版本、設定 |
51
+ 分析錯誤訊息並追蹤最近變更,形成初步假設。
55
52
 
56
- ### 階段 2:根因分析
53
+ 1. **仔細閱讀錯誤訊息** — 確認失敗的確切位置與類型
54
+ 2. **追蹤最近變更** — 使用 `git log`、`git diff`、`git blame` 找出變更內容
55
+ 3. **在元件邊界加入診斷** — 在模組之間的介面插入日誌/中斷點
56
+ 4. **記錄觀察** — 記下所見,並形成初步假設
57
57
 
58
- | 技術 | 適用場景 |
59
- |------|----------|
60
- | 反向追蹤 | 從錯誤點向後追溯資料流 |
61
- | 二分法 | 快速縮小問題範圍 |
62
- | 元件隔離 | 逐一排除元件 |
63
- | 日誌分析 | 檢查事件順序和狀態變化 |
58
+ ### 階段 2:模式分析(Pattern Analysis)
64
59
 
65
- ### 階段 3:修復
60
+ 比對失敗程式碼與類似的成功實作。
66
61
 
67
- | 規則 | 說明 |
68
- |------|------|
69
- | 先寫測試 | 寫一個重現 bug 的失敗測試 |
70
- | 最小化修改 | 只修改必要的程式碼 |
71
- | 驗證修復 | 確認測試從紅轉綠 |
72
- | 無副作用 | 確認沒有引入新的 bug |
62
+ 1. **在程式碼庫中搜尋類似的成功實作**
63
+ 2. **找出差異** — 比較失敗與正常運作的程式碼
64
+ 3. **檢查缺少的前置條件** — 初始化、設定、執行順序
73
65
 
74
- ### 階段 4:驗證與預防
66
+ ### 階段 3:假設測試(Hypothesis Testing)
75
67
 
76
- | 步驟 | 說明 |
77
- |------|------|
78
- | 執行完整測試套件 | 確保沒有回歸 |
79
- | 更新文件 | 記錄根因和修復方案 |
80
- | 回顧 | 是否需要加強預防措施 |
68
+ 以最小、隔離的修改驗證假設。
69
+
70
+ 1. **做最小可能的修改** 來測試假設
71
+ 2. **每次只改一個變數** — 絕不同時進行多項修改
72
+ 3. **記錄每次嘗試** — 記下假設、修改內容與結果
73
+
74
+ ### 階段 4:修復實作(Fix Implementation)
75
+
76
+ 確認根因後才實作修復。
77
+
78
+ 1. **確認根因** 已經由假設測試驗證
79
+ 2. **實作修復**,並做好適當的錯誤處理
80
+ 3. **執行完整測試套件** — 確保沒有回歸
81
+ 4. **驗證修復未引入新問題**
82
+
83
+ ---
81
84
 
82
85
  ## 3-Strike Rule
83
86
 
84
- 連續 3 次修復嘗試失敗時:
87
+ > 連續 **3 次修復嘗試失敗** 後,停止猜測並質疑架構設計。
88
+
89
+ 3-Strike Rule 觸發時:
90
+
91
+ 1. 從具體的 bug 中抽身
92
+ 2. 檢視整體模組/元件設計
93
+ 3. 思考架構是否支援預期行為
94
+ 4. 找出讓這類 bug 得以發生的設計缺陷
95
+ 5. 在嘗試下一次修復前先考慮重構
96
+
97
+ ---
98
+
99
+ ## 規則
100
+
101
+ | ID | 觸發條件 | 動作 | 優先級 |
102
+ |----|---------|------|--------|
103
+ | SD-001 | 連續 3 次修復失敗 | 停止猜測,質疑架構設計 | Critical |
104
+ | SD-002 | 出現「快速修復」、「試試看」、「應該可以了」等措辭 | 回到階段 1 根因分析 | High |
105
+ | SD-003 | 多元件互動錯誤 | 在每個元件邊界加入診斷觀察 | Medium |
85
106
 
86
- 1. **停止修復** — 不要再嘗試第 4 次
87
- 2. **升級** — 通知架構師或資深開發人員
88
- 3. **重新分析** — 從更高層次重新分析問題
89
- 4. **考慮重構** — 問題可能在架構層面
107
+ ---
108
+
109
+ ## 應避免的反模式
110
+
111
+ | 反模式 | 為何有害 |
112
+ |-------|---------|
113
+ | 散彈式除錯(Shotgun debugging) | 隨機修改浪費時間,且可能引入新 bug |
114
+ | 從 Stack Overflow 複製貼上修復 | 未經理解,修復可能沒有處理到真正的根因 |
115
+ | 壓制錯誤 | 隱藏表徵並不能解決問題 |
116
+ | 「在我的機器上可以跑」 | 環境差異是線索,不是推託的理由 |
117
+
118
+ ---
119
+
120
+ ## 範例
121
+
122
+ ### 好的做法:結構化除錯
123
+
124
+ ```
125
+ Phase 1: TypeError at line 42 in parser.ts — reading property of undefined
126
+ git log shows parser.ts was modified 2 commits ago
127
+ Added console.log at module boundary → input is null when empty array passed
128
+
129
+ Phase 2: Similar parser in legacy/ handles empty arrays with early return
130
+
131
+ Phase 3: Added early return for empty array → test passes
132
+ Changed only one thing, recorded result
133
+
134
+ Phase 4: Implemented fix, ran full test suite (47/47 pass), no regressions
135
+ ```
136
+
137
+ ### 不好的做法:猜測修復
138
+
139
+ ```
140
+ "Hmm, let me try adding a null check... nope.
141
+ Maybe wrapping in try-catch... still broken.
142
+ Let me just change the type to any... 🤦"
143
+ ```
144
+
145
+ ---
90
146
 
91
- ## 相關標準
147
+ ## 參考資料
92
148
 
93
- - [驗證證據](verification-evidence.md)
94
- - [測試標準](testing-standards.md)
95
- - [AI 模型選擇策略](model-selection.md)
149
+ - **Superpowers**:[systematic-debugging](https://github.com/obra/superpowers) (MIT)
150
+ - **The Pragmatic Programmer**:除錯相關章節
151
+ - **Debugging by Thinking**:A Multidisciplinary Approach(Robert Charles Metzger)
@@ -2,61 +2,85 @@
2
2
  source: ../../../core/tech-debt-standards.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-08-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 85337eebbcf4
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 技術債管理標準
10
11
 
11
- > 版本: 1.1.0 | 最後更新: 2026-08-20
12
+ > **語言**: [English](../../../core/tech-debt-standards.md) | 繁體中文
13
+
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-08-20
16
+ **適用性**: 所有軟體專案
17
+ **範圍**: universal
18
+ **產業標準**: Martin Fowler's Technical Debt Quadrant, Ward Cunningham's Debt Metaphor
19
+ **參考**: [martinfowler.com/bliki/TechnicalDebt](https://martinfowler.com/bliki/TechnicalDebt.html)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
- 技術債代表因選擇權宜之計而非更佳方案所產生的未來重工隱含成本。本標準定義如何分類、登記、排序、預算、衡量及追蹤技術債。
25
+ 技術債代表因現在選擇權宜之計、而非耗時較長的更佳方案,所產生的未來重工隱含成本。本標準定義如何在整個軟體開發生命週期中分類、登記、排序、編列預算、衡量及追蹤技術債。
26
+
27
+ ---
16
28
 
17
29
  ## 1. 技術債類型
18
30
 
31
+ 所有技術債都歸屬於下列六種類別之一:
32
+
19
33
  | 類型 | 說明 | 範例 |
20
34
  |------|------|------|
21
- | **Design Debt** | 架構捷徑或次優設計決策 | 缺少抽象層、緊耦合 |
22
- | **Code Debt** | 增加維護負擔的程式碼品質問題 | 重複程式碼、過長方法、Magic Number |
23
- | **Test Debt** | 不足或低品質的測試覆蓋 | 缺少單元測試、不穩定測試 |
24
- | **Documentation Debt** | 缺失、過時或不正確的文件 | 未文件化的 API、過時 README |
25
- | **Dependency Debt** | 過時、有漏洞或不必要的依賴 | 未修補的函式庫、已棄用框架 |
26
- | **Infrastructure Debt** | 次優的建置、部署或維運工具 | 手動部署、缺少監控 |
35
+ | **Design Debt** | 架構捷徑或次優設計決策 | 缺少抽象層、緊耦合、分層被破壞 |
36
+ | **Code Debt** | 增加維護負擔的程式碼品質問題 | 重複程式碼、過長方法、Magic Number、死碼 |
37
+ | **Test Debt** | 不足或低品質的測試覆蓋 | 缺少單元測試、不穩定測試、沒有整合測試 |
38
+ | **Documentation Debt** | 缺失、過時或不正確的文件 | 未文件化的 API、過時 README、缺少架構文件 |
39
+ | **Dependency Debt** | 過時、有漏洞或不必要的依賴 | 未修補的函式庫、已棄用框架、未使用的套件 |
40
+ | **Infrastructure Debt** | 次優的建置、部署或維運工具 | 手動部署、缺少監控、過時的 CI/CD |
27
41
 
28
42
  ### 蓄意 vs 非蓄意
29
43
 
30
- - **蓄意(Deliberate)**:有意識地選擇捷徑,應立即登記
31
- - **非蓄意(Inadvertent)**:因知識不足而產生,發現後應立即登記
44
+ 技術債可能經由兩種不同模式產生:
45
+
46
+ | 模式 | 說明 | 範例 |
47
+ |------|------|------|
48
+ | **蓄意(Deliberate)** | 在了解後果的情況下,有意識地選擇捷徑 | 「我們知道這不是正確的抽象,但我們週五前必須上線」 |
49
+ | **非蓄意(Inadvertent)** | 因知識不足或疏忽而無意間產生的債務 | 「我們沒料到這個模式會造成擴充性問題」 |
50
+
51
+ 蓄意債務一律應立即登記。非蓄意債務應在發現後立即登記。
52
+
53
+ ---
32
54
 
33
55
  ## 2. 技術債登記表
34
56
 
35
- 每個技術債項目必須記錄以下 11 個欄位:
36
-
37
- | # | 欄位 | 說明 |
38
- |---|------|------|
39
- | 1 | **ID** | 唯一識別碼,格式 `TD-NNN` |
40
- | 2 | **Title** | 簡短描述性標題 |
41
- | 3 | **Type** | 上述 6 種類型之一 |
42
- | 4 | **Source** | 引入方式(蓄意/非蓄意) |
43
- | 5 | **Impact** | 業務與技術影響描述 |
44
- | 6 | **Estimated Cost** | 解決所需工作量 |
45
- | 7 | **Interest** | 不解決的持續成本 |
46
- | 8 | **Priority** | 優先等級(P0-P3) |
47
- | 9 | **Owner** | 負責團隊或個人 |
48
- | 10 | **Created Date** | 登記日期 |
49
- | 11 | **Target Resolution Date** | 計劃解決日期 |
57
+ ### 登記表範本
58
+
59
+ 每個技術債項目都必須以下列 11 個欄位記錄在登記表中:
60
+
61
+ | # | 欄位 | 說明 | 範例 |
62
+ |---|------|------|------|
63
+ | 1 | **ID** | 唯一識別碼,格式 `TD-NNN` | TD-001 |
64
+ | 2 | **Title** | 簡短描述性標題 | 「單體式 auth 模組需要拆解」 |
65
+ | 3 | **Type** | 上述 6 種類型之一 | Design |
66
+ | 4 | **Source** | 引入方式(蓄意/非蓄意/事故事後檢討——見 [postmortem-standards](postmortem-standards.md) 的行動項目交接) | 蓄意(或 `postmortem PM-042`) |
67
+ | 5 | **Impact** | 業務與技術影響描述 | 「每個 Sprint 拖慢功能開發約 2 天」 |
68
+ | 6 | **Estimated Cost** | 解決所需工作量(故事點或人天) | 8 故事點 |
69
+ | 7 | **Interest** | 不解決的持續成本(見利息類型) | 每個 Sprint 額外 1 天除錯 |
70
+ | 8 | **Priority** | 依影響矩陣得出的優先等級(P0-P3) | P1 |
71
+ | 9 | **Owner** | 負責解決的團隊或個人 | @backend-team |
72
+ | 10 | **Created Date** | 登記日期 | 2026-01-15 |
73
+ | 11 | **Target Resolution Date** | 計劃解決日期 | 2026-Q2 |
50
74
 
51
75
  ### 登記表儲存選項
52
76
 
53
- 登記表可存放於下列任一位置,但每個選項**只有在同時滿足右欄的到期檢查條件時才合法**:
77
+ 登記表可存放於下列任一位置。每個選項**只有在同時滿足右欄條件時才合法**——見下方[到期處置](#到期處置)。
54
78
 
55
- | 選項 | 適用對象 | 到期檢查條件 |
56
- |------|---------|-------------|
57
- | `docs/tech-debt-registry.md` | 小型團隊 | 有一支 repo 檢查會解析該表格,並在有列超過 Target Resolution Date 時失敗——**或**該檔帶有「無人看管宣告」 |
58
- | Issue tracker(GitHub Issues、Jira) | 較大團隊 | 有一個排程查詢實際會**執行**並發出告警;沒有人打開的儲存查詢不算檢查——**或**帶有「無人看管宣告」 |
59
- | 專用試算表 | 非技術利害關係人 | 僅當該表以明訂頻率匯出到某個會被檢查讀取的位置時才合法——**或**帶有「無人看管宣告」 |
79
+ | 選項 | 適用對象 | 格式 | 到期檢查條件 |
80
+ |------|---------|------|-------------|
81
+ | `docs/tech-debt-registry.md` | 小型團隊、簡易追蹤 | Markdown 表格 | 有一支 repo 檢查會解析該表格,並在有列超過 Target Resolution Date 時失敗——**或**該檔帶有「無人看管宣告」 |
82
+ | Issue tracker(GitHub Issues、Jira) | 較大團隊、工作流程整合 | 帶 `tech-debt` 標籤的 Issue | 對到期日欄位的排程查詢實際會**執行**並發出告警;沒有人打開的儲存查詢不算檢查——**或**帶有「無人看管宣告」 |
83
+ | 專用試算表 | 非技術利害關係人 | 含 11 個欄位的 CSV/Excel | 僅當該表以明訂頻率匯出到某個會被檢查讀取的位置時才合法——**或**帶有「無人看管宣告」 |
60
84
 
61
85
  > **這一欄為什麼必須加。** 一份沒有任何程式讀得到的登記表,滿足本節其餘每一條要求:11 個欄位齊全、有 Owner、有 Target Resolution Date。它沒有任何地方是錯的——直到日期過了,然後什麼都沒發生。試算表選項**刻意不移除**(試算表常是出錢的人唯一會打開的格式);不再合法的是「任何一種儲存方式成為日期無聲過期的地方」。
62
86
 
@@ -70,7 +94,7 @@ status: current
70
94
 
71
95
  | 處置 | 意義 | 必留痕跡 |
72
96
  |------|------|---------|
73
- | **做掉(Resolve)** | 把事情做完 | 關閉登記項 + `Tech-Debt: TD-NNN resolved` commit footer |
97
+ | **做掉(Resolve)** | 把事情做完 | 關閉登記項 + `Tech-Debt: TD-NNN resolved` commit footer(見 [Commit 標記](#6-commit-標記)) |
74
98
  | **撤銷(Withdraw)** | 決定不做,並刪掉這筆記載 | 標記為撤銷,附理由與日期。它不再被計為技術債,因為它已經不是了 |
75
99
  | **延期(Extend)** | 設定新的 Target Resolution Date | 新日期**與**書面理由必須一起記下;先前的日期保持可見(用附加,不要覆蓋) |
76
100
 
@@ -115,51 +139,143 @@ status: current
115
139
  >
116
140
  > 所以這裡的最低標準**不是**「去建一支檢查器」,而是**「絕不讓一份登記表在無聲中變成無人看管」**。宣告 `無人看管` 只要一段文字,而且完全合規。無人看管**卻不宣告**才是本標準真正禁止的唯一結果,因為只有它會讓讀者對「有沒有東西在看」產生誤解。
117
141
 
142
+ ---
143
+
118
144
  ## 3. 預算分配
119
145
 
146
+ ### 依團隊狀態的預算比例
147
+
148
+ 團隊應依目前狀態,將每個 Sprint 產能的一定百分比分配給技術債償還:
149
+
120
150
  | 團隊狀態 | 預算 | 說明 |
121
151
  |---------|------|------|
122
- | 新專案(< 6 個月) | **10%** | 預防性維護 |
123
- | 成熟專案(6+ 個月) | **15%** | 持續維護 |
124
- | 高債務專案 | **20-30%** | 積極償還 |
152
+ | **新專案**(< 6 個月) | **10%** | 預防性維護;及早建立良好模式 |
153
+ | **成熟專案**(6+ 個月,穩定) | **15%** | 持續維護;防止債務累積 |
154
+ | **高債務專案**(有關鍵債務積壓) | **20-30%** | 積極償還;恢復開發速度 |
155
+
156
+ ### 預算使用追蹤
157
+
158
+ 團隊必須追蹤技術債預算的使用情況以落實當責:
159
+
160
+ 1. **Sprint 規劃**:為債務工作保留適當百分比的產能
161
+ 2. **Sprint 審查**:回報實際花在償債上的時間與預算的對比
162
+ 3. **Sprint 回顧**:評估預算分配是否恰當,必要時調整
163
+ 4. **季度報告**:彙整債務趨勢、預算使用率與對開發速度的影響
164
+
165
+ ---
125
166
 
126
167
  ## 4. 優先排序矩陣
127
168
 
128
- | | 低工作量 | 中工作量 | 高工作量 |
169
+ ### 3x3 影響 x 工作量矩陣
170
+
171
+ 使用此矩陣,依影響(業務/技術嚴重度)與工作量(解決成本)決定優先等級:
172
+
173
+ | | **低工作量** | **中工作量** | **高工作量** |
129
174
  |--|---------|---------|---------|
130
175
  | **高影響** | P0 — 立即 | P1 — 下個 Sprint | P1 — 下個 Sprint |
131
176
  | **中影響** | P1 — 下個 Sprint | P2 — 本季 | P2 — 本季 |
132
177
  | **低影響** | P2 — 本季 | P3 — Backlog | P3 — Backlog |
133
178
 
179
+ ### 優先等級定義
180
+
181
+ | 等級 | 緊急程度 | SLA |
182
+ |------|---------|-----|
183
+ | **P0** | 關鍵——阻礙開發或構成安全風險 | 於當前 Sprint 內解決 |
184
+ | **P1** | 高——顯著影響開發速度或品質 | 於下個 Sprint 內解決 |
185
+ | **P2** | 中——影響明顯但可控 | 於本季內解決 |
186
+ | **P3** | 低——目前影響極小,可能隨時間擴大 | 放入 Backlog,每季檢視 |
187
+
134
188
  ### 利息類型
135
189
 
136
- | 利息類型 | 說明 |
137
- |---------|------|
138
- | **時間利息** | 繞過債務所需的額外開發時間 |
139
- | **風險利息** | Bug、當機或安全事件的機率增加 |
140
- | **人才利息** | 對開發者體驗與留才的負面影響 |
190
+ 技術債會累積「利息」——不解決所帶來的持續成本。請追蹤下列三種利息類別:
191
+
192
+ | 利息類型 | 說明 | 範例 |
193
+ |---------|------|------|
194
+ | **時間利息** | 為繞過債務而額外花費的開發時間 | 因資料層過於複雜,每個功能多花 2 小時 |
195
+ | **風險利息** | Bug、當機或安全事件的機率增加 | 有已知 CVE 卻未修補的依賴 |
196
+ | **人才利息** | 對開發者體驗、新人上手與留才的負面影響 | 因架構未文件化,新進人員需要 2 倍時間才能上手 |
197
+
198
+ ---
141
199
 
142
200
  ## 5. 量化指標
143
201
 
144
- | 指標 | 公式 | 目標 |
145
- |------|------|------|
146
- | 總債務量 | 所有未關閉債務項目數 | 下降趨勢 |
147
- | 債務比率 | 債務項目 / 總 Backlog × 100% | < 15% |
148
- | 平均存活天數 | 總天數 / 債務項目數 | < 90 天 |
149
- | 類型分布 | 各類型佔比 | 單一類型不超過 40% |
150
- | 高優先比率 | (P0+P1) / 總數 × 100% | < 20% |
202
+ 追蹤下列五項關鍵指標以監控技術債健康度:
203
+
204
+ | # | 指標 | 公式 | 目標 |
205
+ |---|------|------|------|
206
+ | 1 | **總債務量** | 所有未關閉債務項目數 | 下降趨勢 |
207
+ | 2 | **債務比率** | 未關閉債務項目 / 總 Backlog 項目 × 100% | < 15% |
208
+ | 3 | **平均存活天數** | 所有債務項目存活天數總和 / 債務項目數 | < 90 天 |
209
+ | 4 | **類型分布** | 各類型數量 / 總債務項目 × 100% | 單一類型不超過 40% |
210
+ | 5 | **高優先比率** | (P0 + P1 項目) / 總債務項目 × 100% | < 20% |
211
+
212
+ ### 報告頻率
213
+
214
+ | 頻率 | 報告內容 |
215
+ |------|---------|
216
+ | 每週 | 新增債務項目、已解決項目、P0/P1 狀態 |
217
+ | 每月 | 全部 5 項指標及趨勢分析 |
218
+ | 每季 | 完整債務審查、預算調整建議 |
219
+
220
+ ---
151
221
 
152
222
  ## 6. Commit 標記
153
223
 
154
- 引入債務時:`Tech-Debt: TD-042 introduced`
155
- 解決債務時:`Tech-Debt: TD-042 resolved`
224
+ ### Commit Footer 格式
225
+
226
+ 當 commit 引入或解決技術債時,在 commit message 加上一行 footer:
227
+
228
+ **引入債務:**
229
+ ```
230
+ feat(auth): add temporary session cache bypass
231
+
232
+ Skipping cache validation for admin sessions to meet launch deadline.
233
+
234
+ Tech-Debt: TD-042 introduced
235
+ ```
236
+
237
+ **解決債務:**
238
+ ```
239
+ refactor(auth): implement proper session cache validation
240
+
241
+ Replace temporary bypass with full cache validation pipeline.
242
+
243
+ Tech-Debt: TD-042 resolved
244
+ ```
245
+
246
+ ### 標記規則
247
+
248
+ 1. commit 明知會引入技術債時,使用 `Tech-Debt: TD-NNN introduced` 格式
249
+ 2. commit 完整解決一筆已登記的債務項目時,使用 `Tech-Debt: TD-NNN resolved` 格式
250
+ 3. TD-NNN 識別碼必須對應技術債登記表中的條目
251
+ 4. 單一 commit 可引用多筆債務項目(每行一筆)
252
+ 5. 部分解決時應在 commit body 描述進度,但不標記為 resolved
253
+
254
+ ---
255
+
256
+ ## 參考資料
257
+
258
+ - [Martin Fowler — Technical Debt](https://martinfowler.com/bliki/TechnicalDebt.html) — 債務隱喻的原始說明
259
+ - [Martin Fowler — Technical Debt Quadrant](https://martinfowler.com/bliki/TechnicalDebtQuadrant.html) — 蓄意 vs 非蓄意分類
260
+ - [Ward Cunningham — Debt Metaphor](http://wiki.c2.com/?WardExplainsDebtMetaphor) — Ward Cunningham 提出的原始概念
156
261
 
157
262
  ---
158
263
 
159
264
  **相關標準:**
160
- - [程式碼審查清單](code-review-checklist.md)
161
- - [重構標準](refactoring-standards.md)
162
- - [測試標準](testing-standards.md)
265
+ - [程式碼審查清單](code-review-checklist.md) — 用於攔截新債務的審查流程
266
+ - [重構標準](refactoring-standards.md) — 解決程式碼債務的技巧
267
+ - [測試標準](testing-standards.md) — 處理測試債務
268
+ - [Commit 訊息指南](commit-message-guide.md) — 包含債務標記的 commit 格式
269
+ - [治理層](governance-layer.md) — 標準 #0;對待決事項與已接受風險套用同一套時鐘,並定義彙總報告與新鮮度指標規則
270
+
271
+ ---
272
+
273
+ ## 版本歷史
274
+
275
+ | 版本 | 日期 | 變更內容 |
276
+ |------|------|----------|
277
+ | 1.1.0 | 2026-08-20 | 新增:到期處置——到期時的三種合法處置(做掉/撤銷/附理由延期)、TD-EXP-001..006、禁止自動延期與自動關閉、以「無人看管宣告」作為檢查器的合規替代方案;登記表儲存選項為每個選項加上到期檢查條件(沒有程式讀得到的登記表,僅在宣告無人看管時合法) |
278
+ | 1.0.0 | 2026-03-31 | 初始發布:6 種債務類型、登記表範本、預算分配、優先排序矩陣、量化指標、commit 標記 |
163
279
 
164
280
  ---
165
281