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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/performance-standards.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-06-17
5
+ last_synced: 2026-10-16
6
+ source_hash: b678e96a3ff1
6
7
  status: current
7
8
  ---
8
9
 
@@ -17,7 +18,7 @@ status: current
17
18
  **業界標準**: ISO/IEC 25010 效能效率
18
19
  **參考**: [sre.google](https://sre.google/books/)
19
20
 
20
- > **詳細說明與最佳化技術,請參閱 [效能指南](../../../core/guides/performance-guide.md)**
21
+ > **詳細說明與最佳化技術,請參閱 [效能指南](guides/performance-guide.md)**
21
22
 
22
23
  ---
23
24
 
@@ -25,7 +26,7 @@ status: current
25
26
 
26
27
  本標準定義軟體效能工程的完整指南,涵蓋效能需求、測試方法論和監控實踐。
27
28
 
28
- **參考標準**:
29
+ **參考標準**:
29
30
  - [ISO/IEC 25010:2011](https://www.iso.org/standard/35733.html) - 效能效率
30
31
  - [Google SRE Book](https://sre.google/books/) - 網站可靠性工程
31
32
 
@@ -36,179 +37,479 @@ status: current
36
37
  ### NFR 格式
37
38
 
38
39
  ```markdown
39
- ### NFR-PERF-XXX: [標題]
40
+ ### NFR-PERF-XXX: [Title]
40
41
 
41
- **分類**: 效能效率 > [時間行為/資源利用/容量]
42
- **優先級**: P1/P2/P3
42
+ **Category**: Performance Efficiency > [Time Behavior/Resource Utilization/Capacity]
43
+ **Priority**: P1/P2/P3
43
44
 
44
- **需求**:
45
- | 百分位 | 目標 | 最大值 |
46
- |--------|------|--------|
45
+ **Requirement**:
46
+ | Percentile | Target | Maximum |
47
+ |------------|--------|---------|
47
48
  | p50 | Xms | Yms |
48
49
  | p95 | Xms | Yms |
49
50
  | p99 | Xms | Yms |
51
+
52
+ **Conditions**: [Load, data volume, etc.]
53
+ **Measurement**: [Tool, sampling, reporting]
50
54
  ```
51
55
 
52
- ## 效能預算
56
+ ---
53
57
 
54
- | 類別 | 預算 | 測量方式 |
55
- |------|------|----------|
56
- | 頁面載入時間 | < 3 秒 | Lighthouse |
57
- | API 回應時間 (p95) | < 500ms | APM 工具 |
58
- | 記憶體使用 | < 512MB | 執行時監控 |
59
- | CPU 使用率 | < 70% 平均 | 系統監控 |
60
- | 套件大小 | < 200KB (gzip) | 建置分析 |
58
+ ## 常見效能目標
61
59
 
62
- ## 效能測試類型
60
+ | 系統類型 | 回應時間 (p95) | 吞吐量 | 可用性 |
61
+ |----------|----------------|--------|--------|
62
+ | **電子商務** | < 200ms | 1000+ rps | 99.9% |
63
+ | **內部工具** | < 500ms | 100+ rps | 99.5% |
64
+ | **批次處理** | N/A | 10K+ 筆記錄/分鐘 | 99% |
65
+ | **即時系統** | < 50ms (p99) | 10K+ rps | 99.99% |
66
+ | **API 閘道** | < 100ms | 5K+ rps | 99.95% |
63
67
 
64
- | 類型 | 目的 | 工具 |
68
+ ---
69
+
70
+ ## Core Web Vitals 目標
71
+
72
+ | 指標 | 目標 | 說明 |
65
73
  |------|------|------|
66
- | **負載測試** | 驗證正常負載下的效能 | k6、JMeter、Locust |
67
- | **壓力測試** | 找出系統極限 | k6、Gatling |
68
- | **浸泡測試** | 偵測記憶體洩漏 | k6(長時間執行) |
69
- | **尖峰測試** | 驗證突發流量處理 | k6、Artillery |
74
+ | **LCP** (Largest Contentful Paint) | < 2.5s | 感知載入速度 |
75
+ | **INP** (Interaction to Next Paint) | < 200ms | 互動回應性 |
76
+ | **CLS** (Cumulative Layout Shift) | < 0.1 | 視覺穩定性 |
77
+
78
+ ---
79
+
80
+ ## 效能預算
81
+
82
+ ```yaml
83
+ # Example Performance Budget
84
+ resources:
85
+ total_size: 500KB
86
+ javascript: 200KB
87
+ css: 50KB
88
+ images: 200KB
89
+ fonts: 50KB
90
+
91
+ metrics:
92
+ time_to_interactive: 3s
93
+ first_contentful_paint: 1.5s
94
+ speed_index: 3s
95
+
96
+ lighthouse_scores:
97
+ performance: 90
98
+ accessibility: 100
99
+ best_practices: 100
100
+ seo: 100
101
+ ```
102
+
103
+ ---
104
+
105
+ ## 效能指標
106
+
107
+ ### 百分位數指引
108
+
109
+ | 百分位數 | 意義 | 用途 |
110
+ |----------|------|------|
111
+ | **p50** | 中位數 | 典型使用者體驗 |
112
+ | **p90** | 90% 較快 | 大多數使用者體驗 |
113
+ | **p95** | 95% 較快 | SLA 閾值(常見) |
114
+ | **p99** | 99% 較快 | 對多數使用者而言的最差情況 |
115
+ | **p99.9** | 99.9% 較快 | 高流量系統 |
70
116
 
71
- ## 監控與告警
117
+ ### 四個黃金訊號 (SRE)
118
+
119
+ | 訊號 | 測量項目 | 目標 |
120
+ |------|----------|------|
121
+ | **延遲 (Latency)** | 回應時間 (p50, p95, p99) | < SLA |
122
+ | **流量 (Traffic)** | 每秒請求數 | 取決於容量 |
123
+ | **錯誤 (Errors)** | 錯誤率 % | < 0.1% |
124
+ | **飽和度 (Saturation)** | 資源利用率 | 持續 < 70% |
125
+
126
+ ---
72
127
 
73
- | 指標類型 | 範例 | 告警閾值 |
74
- |----------|------|----------|
75
- | 延遲 (Latency) | p95 回應時間 | > 目標的 2 倍 |
76
- | 流量 (Traffic) | 每秒請求數 | 異常波動 > 50% |
77
- | 錯誤率 (Errors) | HTTP 5xx 比例 | > 1% |
78
- | 飽和度 (Saturation) | CPU/記憶體使用 | > 80% |
128
+ ## 告警閾值
129
+
130
+ | 指標 | 警告 | 嚴重 | 處置動作 |
131
+ |------|------|------|----------|
132
+ | **p95 回應時間** | > 200ms | > 500ms | 調查、擴展 |
133
+ | **錯誤率** | > 0.1% | > 1% | Call 值班人員 (Page on-call) |
134
+ | **CPU 使用率** | > 70% | > 90% | 擴展、最佳化 |
135
+ | **記憶體使用率** | > 80% | > 95% | 擴展、調查洩漏 |
136
+ | **磁碟使用率** | > 80% | > 95% | 清理、擴充 |
137
+
138
+ ---
139
+
140
+ ## 容量規劃閾值
141
+
142
+ | 資源 | 規劃水位 | 嚴重 |
143
+ |------|----------|------|
144
+ | **運算 (CPU)** | 持續 70% | 90% |
145
+ | **記憶體** | 80% | 95% |
146
+ | **儲存空間** | 70% | 90% |
147
+ | **網路** | 60% | 80% |
148
+ | **資料庫連線** | 80% | 95% |
149
+
150
+ ---
151
+
152
+ ## 連線池配置
153
+
154
+ | 參數 | 建議值 | 備註 |
155
+ |------|--------|------|
156
+ | **最小連線數** | 5-10 | 維持熱連線 (warm connections) |
157
+ | **最大連線數** | 20-100 | 取決於資料庫與應用程式伺服器 |
158
+ | **閒置逾時** | 10-30 分鐘 | 釋放未使用的連線 |
159
+ | **連線逾時** | 5-10 秒 | 發生問題時快速失敗 (Fail fast) |
160
+
161
+ ---
162
+
163
+ ## 速率限制 (Rate Limiting) 配置
164
+
165
+ | 端點類型 | 限制 | 突發 (Burst) |
166
+ |----------|------|--------------|
167
+ | **公開 API** | 100/分鐘 | 10 |
168
+ | **已驗證** | 1000/分鐘 | 50 |
169
+ | **進階層級 (Premium tier)** | 10000/分鐘 | 200 |
170
+ | **內部** | 無限制 | N/A |
171
+
172
+ ---
173
+
174
+ ## 效能測試頻率
175
+
176
+ | 測試類型 | 開發階段 | 預備環境 (Staging) | 正式環境 (Production) |
177
+ |----------|----------|-------------------|----------------------|
178
+ | **單元效能** | 每次提交 | - | - |
179
+ | **負載測試** | 每週 | 每次發布 | 每月 |
180
+ | **壓力測試** | 每月 | 每次發布 | 每季 |
181
+ | **浸泡測試** | 每月 | 重大發布 | 每季 |
182
+ | **尖峰測試** | - | 重大發布 | 大型活動前 |
183
+
184
+ ---
185
+
186
+ ## 效能檢查清單
187
+
188
+ ### 開發階段
189
+
190
+ - [ ] 已定義並記錄效能需求
191
+ - [ ] 已建立效能預算
192
+ - [ ] 資料庫查詢已最佳化(索引、EXPLAIN)
193
+ - [ ] 已實作快取策略
194
+ - [ ] 列表端點已加上分頁機制
195
+ - [ ] 長時間操作已採用非同步處理
196
+ - [ ] 已配置連線池
197
+
198
+ ### 發布前
199
+
200
+ - [ ] 已使用類生產資料完成負載測試
201
+ - [ ] 已完成壓力測試(找出崩潰極限點)
202
+ - [ ] CI/CD 中已納入效能回歸測試
203
+ - [ ] 已達成 Core Web Vitals 目標(若是前端)
204
+ - [ ] 已完成資料庫查詢分析
205
+ - [ ] 快取命中率在可接受範圍
206
+ - [ ] 錯誤率低於閾值
207
+
208
+ ### 正式環境
209
+
210
+ - [ ] 已配置 APM 監控
211
+ - [ ] 已建立效能儀表板
212
+ - [ ] 已定義告警閾值
213
+ - [ ] 已記錄容量規劃
214
+ - [ ] 具備效能問題的維運手冊 (Runbook)
215
+ - [ ] 已安排定期的效能審查
216
+
217
+ ---
79
218
 
80
219
  ## 效能測試執行
81
220
 
82
221
  ### 測試類型定義
83
222
 
84
223
  | 測試類型 | 目的 | 適用場景 |
85
- |----------|------|----------|
224
+ |-----------|---------|---------------------|
86
225
  | **Load Test** | 驗證系統在預期負載下的行為 | 發布前驗證、容量規劃 |
87
- | **Stress Test** | 找出系統極限與崩潰行為 | 架構變更、擴展驗證 |
88
- | **Soak Test** | 偵測記憶體洩漏或資源耗盡 | 重大發布、資源密集服務 |
89
- | **Spike Test** | 驗證突發流量下的回應與恢復 | 行銷活動前、促銷事件 |
226
+ | **Stress Test** | 找出系統極限與崩潰點行為 | 架構變更、擴展驗證 |
227
+ | **Soak Test** | 偵測長時間執行下的記憶體洩漏或資源耗盡 | 重大發布、資源密集服務 |
228
+ | **Spike Test** | 驗證突發流量下的系統回應與復原 | 行銷活動前、促銷事件 |
90
229
 
91
230
  ### Baseline 管理
92
231
 
93
- **首次建立 Baseline:**
232
+ #### 首次建立 Baseline
233
+
94
234
  1. 在穩定版本上執行至少 3 次完整 Load Test
95
235
  2. 取 p50、p95、p99 的中位數作為 baseline
96
236
  3. 記錄測試環境配置(硬體、資料量、並發數)
97
- 4. 將 baseline 與測試腳本一同存入版本控制
237
+ 4. 將 baseline 與測試指令稿一同存入版本控制
98
238
 
99
- **漂移偵測閾值:**
239
+ #### 漂移偵測閾值
100
240
 
101
241
  | 指標 | 可接受漂移 | 需調查 | 阻擋 |
102
- |------|-----------|--------|------|
242
+ |--------|-----------------|-------------|----------|
103
243
  | p50 Latency | < 5% | 5-15% | > 15% |
104
244
  | p95 Latency | < 10% | 10-20% | > 20% |
105
245
  | p99 Latency | < 10% | 10-25% | > 25% |
106
246
  | Throughput | < 5% 下降 | 5-15% 下降 | > 15% 下降 |
107
247
  | Error Rate | 無增加 | < 0.1% 增加 | > 0.1% 增加 |
108
248
 
249
+ #### Baseline 更新策略
250
+
251
+ - 架構重構後:必須(MUST)重新建立 baseline
252
+ - 硬體升級後:應該(SHOULD)更新 baseline
253
+ - 效能最佳化成功後:應該(SHOULD)將新數值設為 baseline
254
+ - 所有 baseline 更新都必須(MUST)記錄變更原因與日期
255
+
109
256
  ### CI 觸發條件
110
257
 
258
+ 並非每次 commit 都需要執行效能測試。請使用以下觸發條件矩陣:
259
+
111
260
  | 觸發條件 | Load Test | Stress Test | Soak Test | Spike Test |
112
- |----------|-----------|-------------|-----------|------------|
261
+ |-------------------|-----------|-------------|-----------|------------|
113
262
  | 每次 commit | 否 | 否 | 否 | 否 |
114
263
  | PR 合併至 main | 是(精簡) | 否 | 否 | 否 |
115
264
  | Release tag | 是(完整) | 是 | 否 | 否 |
116
265
  | 排程(每週) | 是 | 否 | 是 | 否 |
266
+ | 手動觸發 | 是 | 是 | 是 | 是 |
267
+ | 效能相關檔案變更 | 是(精簡) | 否 | 否 | 否 |
117
268
 
118
269
  ### Performance Budget
119
270
 
271
+ 類似於 SRE Error Budget 的概念,Performance Budget 定義了可容忍的劣化餘裕。
272
+
120
273
  | 概念 | 定義 | 範例 |
121
- |------|------|------|
274
+ |---------|------------|---------|
122
275
  | **效能目標** | 目標效能水準 | p99 < 200ms |
123
276
  | **效能預算** | 允許的劣化餘裕 | p99 可劣化至 220ms(10%) |
124
277
  | **預算消耗** | 累積劣化百分比 | 本季已消耗 6% |
125
278
  | **預算耗盡** | 觸發凍結非必要變更 | 剩餘 < 2% 時凍結 |
126
279
 
280
+ #### 劣化容差
281
+
282
+ - p99 延遲不得(SHALL NOT)劣化超過 10%
283
+ - 吞吐量不得(SHALL NOT)下降超過 5%
284
+ - 錯誤率不得(SHALL NOT)增加超過 0.05%
285
+ - 預算依每季週期重設
286
+
287
+ ### 測試報告格式
288
+
289
+ #### 報告範本
290
+
291
+ ```markdown
292
+ ## Performance Test Report
293
+
294
+ ### Test Metadata
295
+ - **Date**: YYYY-MM-DD
296
+ - **Duration**: X minutes
297
+ - **Test Type**: Load / Stress / Soak / Spike
298
+ - **Environment**: staging / production-mirror
299
+
300
+ ### Results Summary
301
+ | Metric | Baseline | Current | Change | Status |
302
+ |--------|----------|---------|--------|--------|
303
+ | p50 Latency | Xms | Yms | +Z% | PASS/FAIL |
304
+ | p95 Latency | Xms | Yms | +Z% | PASS/FAIL |
305
+ | p99 Latency | Xms | Yms | +Z% | PASS/FAIL |
306
+ | Throughput | X rps | Y rps | -Z% | PASS/FAIL |
307
+ | Error Rate | X% | Y% | +Z% | PASS/FAIL |
308
+
309
+ ### Pass/Fail Determination
310
+ - **Overall**: PASS / FAIL
311
+ - **Failed Criteria**: [list of exceeded thresholds]
312
+
313
+ ### Trend Analysis
314
+ - Chart of last 10 runs with baseline markers
315
+ - Anomaly points highlighted
316
+
317
+ ### Recommendations
318
+ - Action items based on results
319
+ ```
320
+
321
+ #### 通過/失敗判定規則
322
+
323
+ - 所有阻擋級別(blocking-level)閾值皆在限制內 → **PASS**
324
+ - 超過任何阻擋級別閾值 → **FAIL**
325
+ - 超過調查級別(investigation-level)閾值 → 記錄為警告,不阻擋
326
+
327
+ #### 趨勢圖需求
328
+
329
+ - 納入至少最近 10 次執行紀錄以進行趨勢比較
330
+ - 在圖表上顯示 baseline 標記
331
+ - 突顯超出閾值的異常資料點
332
+
127
333
  ---
128
334
 
129
335
  ## 遷移非功能性對等(XSPEC-286)
130
336
 
131
- > 屬於 [XSPEC-284](https://github.com/AsiaOstrich/universal-dev-standards) 9 軸遷移完整性矩陣的**軸⑥(非功能)**。涵蓋舊系統重構/重寫時「功能對了、資料對了,但**跑起來不一樣**」這一類遺漏。本節在上述通用基線/漂移機制之上**新增遷移專屬**的 before/after 語義,**不取代**通用效能框架。
337
+ > 屬於 [XSPEC-284](https://github.com/AsiaOstrich/universal-dev-standards) 9 軸遷移完整性矩陣的**軸 ⑥ — 非功能**。涵蓋舊系統重構/重寫時「功能正確、資料正確,但**跑起來不一樣**」這一類遺漏。本節在上述通用基線/漂移機制之上新增**遷移專屬**的 before/after 語意;本節**不取代**通用效能框架。
338
+
339
+ ### 為何這是真正的缺口
132
340
 
133
- ### 為何是真缺口
341
+ 上述通用 Baseline 管理回答的是「*這個版本*相較*它自己*先前的 baseline 是否回歸」。它**無法**回答「**新**系統是否與它所取代的 **legacy** 系統對等」。在重寫時(例如 PHP 單請求 → .NET 共享狀態執行緒),legacy 的延遲/吞吐/隔離特性往往是**隱性且未經記錄的**,導致每請求功能對等(per-request functional parity)與行為快照對等(behavior-snapshot parity)皆通過,但系統卻悄悄跑得更慢、耗盡更小的連線池,或是遺失了某個鎖語意。
134
342
 
135
- 上述通用基線管理回答的是「**這個版本**相較**它自己**先前的基線是否回歸」,**不**回答「**新**系統是否與它取代的**legacy**對等」。重寫時(如 PHP 單請求 → .NET 共享狀態多執行緒),legacy 的延遲/吞吐/隔離特性多為**隱性、未文件化**,使 per-request 功能對等與 behavior-snapshot 對等都通過,系統卻悄悄跑得更慢、耗盡更小的連線池、或丟失某個鎖語義。
343
+ ### 差分 oracle,而非絕對門檻
136
344
 
137
- ### 差分神諭,非絕對門檻
345
+ 遷移對等使用 **legacy 作為 baseline** 並採用**宣告的容差**,而非上表中的絕對目標。legacy 系統量測到的行為即為 oracle;「回歸未超過宣告的容差」即為通過準則。這能讓分歧自我回報,而非依賴某人記得列舉每條熱路徑。
138
346
 
139
- 遷移對等以 **legacy 為基線** + **宣告容差**,而非上述表格的絕對目標。legacy 量測到的行為就是 oracle,「回歸不超過宣告容差」即 pass。讓分歧自報,而非靠人記得列舉每條熱路徑。
347
+ ### 步驟 1 — 機械化擷取非功能 baseline(R3)
140
348
 
141
- ### 步驟 1 — 機械化擷取非功能基線(R3)
349
+ legacy 的非功能特性大多為隱性的。應從 legacy 產物**機械化地**(而非靠記憶)推導 baseline:
142
350
 
143
- legacy 非功能特性多為隱性。從 legacy artifact **機械化**推導基線(不靠人腦回憶):
351
+ | 來源 | 推導出的 baseline 項目 |
352
+ |--------|----------------------|
353
+ | 關鍵路由/控制器 | 各關鍵路徑的 p50 / p95 / p99 延遲 |
354
+ | 熱點查詢/慢查詢日誌 | 每查詢延遲、掃描列數 |
355
+ | 背景作業/cron | 作業時長、吞吐量(筆數/分鐘) |
356
+ | 連線池設定 | 最小/最大連線數、閒置/連線逾時 |
357
+ | 逾時/速率限制(rate-limit)設定 | 每端點逾時、請求數/分鐘、突發量 |
358
+ | 交易設定 | 隔離等級(READ COMMITTED / REPEATABLE READ / SERIALIZABLE) |
144
359
 
145
- | 來源 | 推導出的基線項 |
146
- |------|---------------|
147
- | 關鍵路由 / controller | 各關鍵路徑 p50 / p95 / p99 延遲 |
148
- | 熱點查詢 / 慢查詢 log | 每查詢延遲、掃描列數 |
149
- | 背景作業 / cron | 作業時長、吞吐(records/min) |
150
- | 連線池設定 | min/max 連線數、idle/connection timeout |
151
- | 逾時 / rate-limit 設定 | 每端點逾時、requests/min、burst |
152
- | 交易設定 | 隔離級別(READ COMMITTED / REPEATABLE READ / SERIALIZABLE) |
360
+ 所擷取的集合**同時**是回歸關卡(regression gate)的比對 baseline,**也是**資源/限制對等(步驟 4)的待驗證檢查清單。
153
361
 
154
- 擷取的集合**同時**是回歸 gate 的比較基線**與**資源/限制 parity(步驟 4)的待驗清單。
362
+ ### 步驟 2 — 效能回歸差分關卡(R1)
155
363
 
156
- ### 步驟 2 — 效能回歸差分 gate(R1)
364
+ 針對每條 baseline 路徑,量測新系統中對應的路徑,並在宣告的容差範圍內與 **legacy baseline** 進行比較。
157
365
 
158
- 對每條基線路徑,量測新系統對應路徑,與 **legacy 基線**在宣告容差內比較。
366
+ | 指標 | 預設遷移容差 | 阻擋條件 |
367
+ |--------|----------------------------|-----------|
368
+ | p50 延遲 | ≤ +10% 相較於 legacy | > +10% |
369
+ | p95 延遲 | ≤ +15% 相較於 legacy | > +15% |
370
+ | p99 延遲 | ≤ +20% 相較於 legacy | > +20% |
371
+ | 吞吐量 | ≤ -10% 相較於 legacy | > -10% 下降 |
159
372
 
160
- | 指標 | 預設遷移容差 | block 條件 |
161
- |------|-------------|-----------|
162
- | p50 延遲 | ≤ +10%(vs legacy) | > +10% |
163
- | p95 延遲 | ≤ +15%(vs legacy) | > +15% |
164
- | p99 延遲 | ≤ +20%(vs legacy) | > +20% |
165
- | 吞吐 | ≤ -10%(vs legacy) | > -10% 下降 |
373
+ 容差為**可按路徑設定**(批次作業與互動式端點有所不同)。以 **shadow** 模式起步(僅量測,不阻擋)以收集樣本並校準各路徑容差,隨後再晉級為 blocking。
166
374
 
167
- 容差**每路徑可配**(批次作業與互動端點不同)。**shadow** 起手(只量測不 block)以收樣校準每路徑容差,再升為 blocking。
375
+ **關卡時機**:pre-UAT(在簽核前抓出回歸)**以及** post-cutover(抓出僅在真實生產負載下才會顯現的回歸)。
376
+
377
+ ```markdown
378
+ ## Migration Performance Parity Report — <path>
168
379
 
169
- **Gate 時機**:pre-UAT(簽核前抓回歸)**與** post-cutover(抓只在真實生產負載下浮現的回歸)。
380
+ | Metric | Legacy baseline | New system | Δ | Tolerance | Status |
381
+ |--------|-----------------|------------|---|-----------|--------|
382
+ | p50 | [X]ms | [Y]ms | +[Z]% | +10% | PASS/FAIL |
383
+ | p95 | [X]ms | [Y]ms | +[Z]% | +15% | PASS/FAIL |
384
+ | p99 | [X]ms | [Y]ms | +[Z]% | +20% | PASS/FAIL |
385
+ | Throughput | [X] rps | [Y] rps | -[Z]% | -10% | PASS/FAIL |
386
+
387
+ **Mode**: shadow (measure-only) / blocking
388
+ **Overall**: PASS / FAIL
389
+ ```
170
390
 
171
391
  ### 步驟 3 — 並發隔離驗證(R2)
172
392
 
173
- 同一資源(同筆記錄 / 同帳戶餘額 / 同序號)可能被多並發操作存取。legacy 的鎖 / 交易隔離 / 順序保證屬**隱性行為**,重寫常被改變——而**功能測試與 behavior-snapshot 對等都抓不到**(per-request 對等 ≠ 並發對等,與「per-request ≠ data-at-rest」同源盲區)。
393
+ 同一資源(同一筆記錄/同一個帳戶餘額/同一個序號)可能會被多個並發操作存取。legacy 的鎖定/交易隔離/順序保證皆為**隱性行為**,且經常在重寫中被改變——而**功能測試與行為快照對等兩者皆無法捕捉到這點**(每請求對等 ≠ 並發對等,此為與「每請求 ≠ 靜態資料」相同類型的盲點)。
174
394
 
175
- **方法**:以併發壓力觸發 race,斷言**領域不變量**而非逐一檢查輸出。
395
+ **方法**:透過並發壓力觸發競態,接著斷言**領域不變量**,而非逐一檢查輸出。
176
396
 
177
397
  | 不變量類別 | 範例斷言 |
178
- |-----------|---------|
179
- | 守恆 | N 次並發轉帳後 `SUM(balance)` 不變 |
180
- | 唯一性 | 並發配號下無重複序號 |
181
- | 無遺失更新 | 已 commit 的寫入不被靜默覆寫 |
182
- | 順序 | 並發下事件依保證順序套用 |
398
+ |-----------------|-------------------|
399
+ | 守恆 | 在 N 次並發轉帳後 `SUM(balance)` 保持不變 |
400
+ | 唯一性 | 在並發配置下不會產生重複序號 |
401
+ | 無遺失更新 | 最後寫入者勝出(last-writer-wins)不會靜默覆寫已提交的寫入 |
402
+ | 順序 | 在並發情況下事件依照保證的順序套用 |
183
403
 
184
- 偵測到**隔離降級**(如 legacy SERIALIZABLE → 新 READ COMMITTED、或移除列鎖)即 block。不變量由領域定義;並發案例與狀態轉移/時序不變量重疊時,**狀態機/時序由 XSPEC-287(軸⑧)負責**,並發競態由本節(軸⑥)負責——見 XSPEC-287 §邊界。
404
+ 偵測到**隔離等級調降**(例如 legacy SERIALIZABLE → 新系統 READ COMMITTED,或移除了資料列鎖)將予以阻擋。不變量本身由領域定義;當並發案例與狀態轉移或時間不變量重疊時,**狀態機/時間考量由 XSPEC-287**(軸 ⑧)負責,而並發競態則由本節(軸 ⑥)負責——請參閱 XSPEC-287 §邊界。
185
405
 
186
- **Gate 時機**:pre-UAT。
406
+ **關卡時機**:pre-UAT。
187
407
 
188
- ### 步驟 4 — 資源 / 限制 parity(R4)
408
+ ### 步驟 4 — 資源/限制對等(R4)
189
409
 
190
- 驗證 legacy 資源限制不被重寫**無意**改變(逾時從 30s 悄悄降到 5s 會讓長作業失敗;更小的連線池會串行化流量)。納入非功能對帳清單:
410
+ 驗證 legacy 資源限制未被重寫**無意間**變更(逾時時間悄悄從 30 秒降至 5 秒會導致長時間作業失敗;較小的連線池會將流量序列化)。將以下項目加入非功能核對清單:
191
411
 
192
- - [ ] 請求 / 操作**逾時**與 legacy 一致(或變更已宣告)
193
- - [ ] **Rate limit**(requests/min、burst)與 legacy 一致
194
- - [ ] **連線池** min/max 與 idle/connection timeout 與 legacy 一致
412
+ - [ ] 請求/操作**逾時**與 legacy 一致(或變更已明確宣告)
413
+ - [ ] **速率限制**(請求數/分鐘、突發量)與 legacy 一致
414
+ - [ ] **連線池**最小/最大連線數及閒置/連線逾時與 legacy 一致
195
415
  - [ ] **批次大小**與 legacy 一致
196
- - [ ] **交易隔離級別**與 legacy 一致(與步驟 3 交叉檢查)
416
+ - [ ] **交易隔離等級**與 legacy 一致(與步驟 3 交叉比對)
197
417
 
198
- 每項要嘛匹配、要嘛有**宣告且具理由**的差異。未宣告的差異即已知回歸風險,block cutover。
418
+ 每個項目若非完全一致,就必須有**已宣告且具正當理由的**差異。未宣告的差異屬於已知回歸風險,將阻擋切換(cutover)。
199
419
 
200
420
  ### 完整性宣告(矩陣對齊)
201
421
 
202
- 當本節宣告三件事——**清單來源**(步驟 1 機械化基線)、**oracle**(步驟 2 回歸差分 + 步驟 3 不變量斷言)、**gate 時機**(pre-UAT + post-cutover)——即滿足遷移完整性矩陣軸⑥。複用通用基線/漂移與 `observability-assistant` 量測機制——本節只新增遷移 before/after 與並發隔離語義,不重造通用效能框架。
422
+ 當本節同時宣告以下三項時,即滿足遷移完整性矩陣的軸 ⑥:**推導**(步驟 1 機械化 baseline)、**oracle**(步驟 2 回歸差分 + 步驟 3 不變量斷言)以及**關卡時機**(pre-UAT + post-cutover)。複用通用 baseline/漂移機制與 `observability-assistant` 量測機制——本節僅新增遷移 before/after 與並發隔離語意,並不重新建構通用的效能框架。
423
+
424
+ ---
425
+
426
+ ## 每次發布容量簽核
427
+
428
+ 本節定義在正式發布前必須滿足的**容量關卡**(`release-readiness-gate.md` 中的維度 10,Tier-3)。
429
+
430
+ ### 容量預測
431
+
432
+ 在每個發布候選版本(release candidate)之前,根據以下項目產出容量預測:
433
+
434
+ 1. **基線(Baseline)**:尖峰 TPS 與資源利用率(CPU、記憶體、DB 連線數、儲存空間成長率)的 90 天滾動平均值
435
+ 2. **發布影響評估**:新功能預期的流量變動(例如:新通知流程帶來 +15% TPS)
436
+ 3. **季節性調整**:未來 30 天內任何已知的流量尖峰(行銷活動、季節性尖峰)
437
+
438
+ ### 餘裕閾值
439
+
440
+ | 指標 | 目標 (PASS) | 警告區間 | 失敗閾值 |
441
+ |------|--------------|-----------|----------------|
442
+ | 預估尖峰時的 CPU 餘裕 | ≥ 30% | 20–30% | < 20% |
443
+ | 記憶體餘裕 | ≥ 25% | 15–25% | < 15% |
444
+ | DB 連線池餘裕 | ≥ 40% | 25–40% | < 25% |
445
+ | p99 延遲 vs 基線 | ≤ +5% | +5% 至 +10% | > +10% 回歸 |
446
+ | 尖峰負載下的錯誤率 | < 0.1% | 0.1–0.5% | > 0.5% |
447
+
448
+ ### 負載測試要求
449
+
450
+ 在完成容量簽核前,執行上方「效能測試」章節所定義的負載測試場景(至少包含 Soak + Spike 測試):
451
+
452
+ ```bash
453
+ # Example: k6 capacity verification run
454
+ k6 run --vus 500 --duration 20m scripts/perf/soak-test.js
455
+ # Pass criterion: headroom metrics above, p99 within budget
456
+ ```
457
+
458
+ ### 簽核佐證
459
+
460
+ 容量關卡需要**兩位具名簽核**——工程負責人(Engineering Lead)與 SRE 負責人(SRE Lead):
461
+
462
+ ```markdown
463
+ ## Capacity Sign-off — <version>
464
+
465
+ **Projection date**: YYYY-MM-DD
466
+ **Baseline period**: last 90 days
467
+
468
+ | Metric | Baseline peak | Projected peak | Headroom | Status |
469
+ |--------|-------------|---------------|----------|--------|
470
+ | CPU | [X]% | [Y]% | [Z]% | PASS/WARN/FAIL |
471
+ | Memory | [X]% | [Y]% | [Z]% | PASS/WARN/FAIL |
472
+ | DB pool | [X]% | [Y]% | [Z]% | PASS/WARN/FAIL |
473
+ | p99 latency | [X]ms | [Y]ms | [±Z]% | PASS/WARN/FAIL |
474
+
475
+ **Load test artifact**: [link to load test report]
476
+
477
+ **Eng Lead sign-off**: _______________ Date: __________
478
+ **SRE Lead sign-off**: _______________ Date: __________
479
+ ```
480
+
481
+ ### Tier-3 適用為 N/A 的時機
482
+
483
+ 在下列情況下,容量簽核為 `N/A`(需附上書面理由):
484
+ - 專案 DAU < 100 且預期無顯著流量增長
485
+ - 使用者人數固定的內部工具
486
+ - 靜態內容/文件網站
203
487
 
204
488
  ---
205
489
 
206
490
  ## 相關標準
207
491
 
208
- - [部署標準](deployment-standards.md)
209
- - [安全標準](security-standards.md)
210
- - [測試標準](testing-standards.md)
492
+ - [測試標準](testing-standards.md) - 效能測試整合
211
493
  - [需求工程](requirement-engineering.md) - NFR 文件
212
494
  - [日誌標準](logging-standards.md) - 效能日誌
495
+ - [程式碼審查清單](code-review-checklist.md) - 效能審查
496
+ - [部署標準](deployment-standards.md) - 部署前效能驗證
497
+ - [發布就緒關卡](release-readiness-gate.md) - 維度 1(負載)與維度 10(容量)
213
498
  - [行為快照](behavior-snapshot.md) - 功能對等 oracle(與遷移非功能對等互補)
214
499
  - [完整覆蓋測試](full-coverage-testing.md) - 並發維度交叉引用
500
+
501
+ ---
502
+
503
+ ## 版本歷史
504
+
505
+ | 版本 | 日期 | 變更 |
506
+ |---------|------|---------|
507
+ | 1.2.0 | 2026-06-17 | 新增遷移非功能性對等(XSPEC-286,軸⑥):before/after 差分回歸關卡、並發隔離驗證、資源/限制對等、機械化基線擷取 |
508
+ | 1.1.0 | 2026-01-29 | 重構:拆分為規則 + 指南,將說明移至指南 |
509
+ | 1.0.0 | 2026-01-29 | 初次發布 |
510
+
511
+ ---
512
+
513
+ ## 授權條款
514
+
515
+ 本標準採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/pipeline-integration-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-18
5
+ last_synced: 2026-10-11
6
+ source_hash: 425af5c3b0f3
6
7
  status: current
7
8
  ---
8
9