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,102 +2,69 @@
2
2
  source: ../../../core/dual-phase-output.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 6a2398bdff72
6
7
  status: current
7
8
  ---
8
9
 
9
- # 双阶段输出标准
10
+ # 双阶段 LLM 输出标准
10
11
 
11
12
  > **语言**: [English](../../../core/dual-phase-output.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-17
15
- **状态**: Trial(到期 2026-10-17)
16
- **适用范围**: universal
17
- **来源**: XSPEC-068(DEC-043 Wave 1 可靠性套件)
18
-
19
- ---
14
+ > **来源**: XSPEC-035 | **借鉴自**: claude-code-book Ch.7 AutoCompact
20
15
 
21
- ## 目的
16
+ ## 概述
22
17
 
23
- 双阶段 LLM 输出标准:`<analysis>` 丢弃 + `<summary>` 保留,统一 Agent 的输出过滤行为。
18
+ 双阶段 LLM 输出模式要求 LLM 审查 Agent 在单次响应中产生两个 XML 区块:`<analysis>` 思考草稿(处理后丢弃)与 `<summary>` 结构化结论(保留)。这让模型能充分推理,同时避免思考过程在对话上下文中累积。
24
19
 
25
- Agent 的推理过程(chain-of-thought)不应直接暴露给下游消费者:它消耗 token、包含中间假设、对机器不友好。本标准要求所有 Agent 输出分为两个阶段,`<analysis>` 标签内容在传递给下游前丢弃,只保留 `<summary>` 内容。
26
-
27
- ---
20
+ ## 问题
28
21
 
29
- ## 核心规范
22
+ 审查 Agent(Judge、Evaluator、Guardian)通常产生 2000–5000 token 的响应,其中 50–70% 是会在对话历史中累积的推理内容。在重复审查的场景(Fix Loop 重试 3 次)中,每个任务因此浪费 3000–10500 token。
30
23
 
31
- - 所有 Agent 必须在输出中明确区分 `<analysis>` 与 `<summary>` 两个阶段
32
- - `<analysis>` 内容为推理过程,不得传递给下游消费者(丢弃)
33
- - `<summary>` 内容为最终结论,必须保留并传递
34
- - 若 Agent 输出缺少 `<summary>` 标签,视为格式错误(DUAL-001)
35
- - 下游模块在消费 Agent 输出前必须执行过滤步骤
36
-
37
- ---
38
-
39
- ## 输出格式
24
+ ## 格式
40
25
 
41
26
  ```xml
42
27
  <analysis>
43
- [Agent 的推理过程、假设检验、中间步骤]
44
- [此区段会被丢弃,不传递给下游]
28
+ [Reasoning scratchpad — DISCARDED after processing]
29
+ - Step-by-step evaluation
30
+ - Edge case considerations
31
+ - Alternative comparisons
45
32
  </analysis>
46
33
 
47
34
  <summary>
48
- [最终结论、可执行的建议、结构化数据]
49
- [此区段会被保留并传递给下游消费者]
35
+ decision: approved | rejected | needs_revision
36
+ confidence: high | medium | low
37
+ findings:
38
+ - [type] description
39
+ next_action: [recommended follow-up action]
50
40
  </summary>
51
41
  ```
52
42
 
53
- ---
54
-
55
- ## 过滤规则
56
-
57
- | 规则 | 说明 |
58
- |------|------|
59
- | 规则 1 | 解析输出时,提取 `<summary>...</summary>` 内容 |
60
- | 规则 2 | 丢弃 `<analysis>...</analysis>` 及其内容 |
61
- | 规则 3 | 若两个标签都缺失,回传错误 `DUAL-001` |
62
- | 规则 4 | 若只有 `<analysis>` 无 `<summary>`,回传错误 `DUAL-001` |
63
- | 规则 5 | 允许 `<summary>` 内嵌套结构化数据(JSON、YAML、代码块)|
43
+ ## 后处理规则
64
44
 
65
- ---
45
+ 1. 提取 `<summary>` 内容 → 持久化到上下文
46
+ 2. 丢弃 `<analysis>` 内容 → 绝不写入对话历史
47
+ 3. 若缺少 `<summary>` 标签 → 回退:把整段响应当作 summary,并记录 `[WARN] dual-phase format missing`
66
48
 
67
- ## 遥测事件
49
+ ## 扩展字段
68
50
 
69
- **`dual_phase_filter_applied`**(每次执行过滤时上报)
51
+ 应用可以在 `<summary>` 内新增字段,但不得移除核心字段:
52
+ - **安全(Guardian)**:`severity: critical | high | medium | low`、`cwe_ids: [CWE-NNN]`
53
+ - **质量(Evaluator)**:`test_coverage: number`、`tech_debt_score: number`
70
54
 
71
- | 字段 | 类型 |
72
- |------|------|
73
- | `agentId` | `string` |
74
- | `analysisTokens` | `number` |
75
- | `summaryTokens` | `number` |
76
- | `filterSuccess` | `boolean` |
77
- | `timestamp` | `string` |
78
-
79
- ---
55
+ ## Token 影响
80
56
 
81
- ## 情境示例
57
+ | 场景 | 节省量 |
58
+ |------|--------|
59
+ | 单次审查 | 1000–3500 token |
60
+ | Fix Loop(重试 3 次) | 3000–10500 token |
61
+ | 多 Agent 管线(evaluator + guardian;采用层) | 每次运行 2000–7000 token |
82
62
 
83
- **情境 1:正常双阶段输出**
84
- - Agent 输出包含 `<analysis>` 和 `<summary>` 标签
85
- - 过滤后只保留 `<summary>` 内容传递给下游
63
+ ## 参考资料
86
64
 
87
- **情境 2:缺少 `<summary>` 标签**
88
- - Agent 输出只有 `<analysis>` 内容
89
- - 回传 `DUAL-001` 错误,不传递任何内容给下游
65
+ - AI 优化版:[ai/standards/dual-phase-output.ai.yaml](../../../ai/standards/dual-phase-output.ai.yaml)
66
+ - XSPEC-035:跨项目规格
67
+ - 借鉴自:[claude-code-book](https://github.com/lintsinghua/claude-code-book) Ch.7 `formatCompactSummary`
90
68
 
91
- **情境 3:`<summary>` 内嵌套 JSON**
92
- - `<summary>` 内包含结构化 JSON 数据
93
- - 过滤后完整保留 JSON,可被下游直接解析
94
69
 
95
- ---
96
-
97
- ## 错误码
98
-
99
- | 代码 | 说明 |
100
- |------|------|
101
- | `DUAL-001` | `MISSING_SUMMARY_TAG` — 输出缺少 `<summary>` 标签 |
102
- | `DUAL-002` | `EMPTY_SUMMARY` — `<summary>` 标签内容为空 |
103
- | `DUAL-003` | `MALFORMED_OUTPUT` — 输出格式无法解析 |
70
+ **适用范围**: universal
@@ -2,146 +2,324 @@
2
2
  source: ../../../core/environment-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-16
6
+ source_hash: d96f447e1080
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 环境管理标准
10
11
 
11
- > 版本: 1.0.0 | 最后更新: 2026-04-01
12
+ > **语言**: [English](../../../core/environment-standards.md) | [繁體中文](../../zh-TW/core/environment-standards.md) | 简体中文
13
+
14
+ **版本**: 1.0.0
15
+ **最后更新**: 2026-03-31
16
+ **适用范围**: 所有软件项目
17
+ **范畴**: universal
18
+ **行业标准**: The Twelve-Factor App, NIST SP 800-123, CIS Benchmarks
19
+ **参考资料**: [12factor.net](https://12factor.net/), [NIST](https://csrc.nist.gov/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
25
  本文档定义应用程序环境在整个生命周期中的管理标准——从本地开发到生产部署。涵盖环境层级、配置管理、环境一致性、密钥处理及验证程序。
16
26
 
27
+ ---
28
+
17
29
  ## 1. 环境层级
18
30
 
19
- ### 标准层级(必要)
31
+ ### 1.1 标准层级 (MUST)
20
32
 
21
- | 层级 | 用途 | 对象 | 数据 |
33
+ 每个项目必须 (MUST) 定义至少四个标准环境层级:
34
+
35
+ | 层级 | 用途 | 受众 | 数据 |
22
36
  |------|------|------|------|
23
- | **Local** | 个人开发工作站 | 单一开发者 | 合成/种子数据 |
37
+ | **Local** | 个人开发工作站 | 单一开发者 | 合成 / 种子数据 |
24
38
  | **Dev** | 共享开发与集成 | 开发团队 | 合成测试数据 |
25
39
  | **Staging** | 上线前验证与 QA | QA 团队、利益相关者 | 匿名化的类生产数据 |
26
40
  | **Production** | 服务终端用户的正式系统 | 终端用户 | 真实用户数据 |
27
41
 
28
- ### 可选层级
42
+ ### 1.2 可选层级 (MAY)
43
+
44
+ 项目可以 (MAY) 根据特殊需求定义额外层级:
29
45
 
30
- | 层级 | 用途 |
31
- |------|------|
32
- | **Preview** | 每个 PR 的临时环境,PR 合并后自动清理 |
33
- | **Sandbox** | 隔离的实验环境 |
34
- | **DR** | 灾难恢复环境 |
46
+ | 层级 | 用途 | 生命周期 |
47
+ |------|------|-----------|
48
+ | **Preview** | 每个 PR 用于审查的临时环境 | PR 打开时创建,PR 合并时自动清理 |
49
+ | **Sandbox** | 隔离的实验环境 | 按需创建,手动或定时清理 |
50
+ | **DR** (Disaster Recovery) | 业务连续性故障转移环境 | 热备或冷备,发生事故时激活 |
51
+
52
+ ---
35
53
 
36
54
  ## 2. 配置优先层级
37
55
 
38
- 配置值依以下优先顺序解析(由高到低):
56
+ ### 2.1 五层优先级 (MUST)
57
+
58
+ 配置值必须 (MUST) 按照以下优先级顺序解析(由高到低):
39
59
 
40
- | 优先顺序 | 来源 | 示例 |
41
- |---------|------|------|
42
- | 1(最高) | 环境变量 | `DATABASE_URL=postgres://...` |
43
- | 2 | 命令行参数 | `--port 3000` |
44
- | 3 | 环境配置文件 | `.env.staging`, `config/staging.yaml` |
45
- | 4 | 应用配置文件 | `config/default.yaml` |
46
- | 5(最低) | 硬编码默认值 | `const PORT = config.port ?? 3000` |
60
+ | 优先级 | 来源 | 说明 | 示例 |
61
+ |----------|--------|-------------|---------|
62
+ | 1 (最高) | **环境变量 (Environment Variables)** | 运行时环境变量 | `DATABASE_URL=postgres://...` |
63
+ | 2 | **命令行参数 (Command-line Arguments)** | CLI 标志与参数 | `--port 3000` |
64
+ | 3 | **环境配置文件 (Environment Config Files)** | 每个环境的配置文件 | `.env.staging`, `config/staging.yaml` |
65
+ | 4 | **应用配置文件 (Application Config Files)** | 共享的应用默认值 | `config/default.yaml`, `application.yml` |
66
+ | 5 (最低) | **硬编码默认值 (Hardcoded Defaults)** | 代码内置的回退值 | `const PORT = config.port ?? 3000` |
67
+
68
+ ### 2.2 解析规则
69
+
70
+ - 较高优先级的来源必须 (MUST) 覆盖较低优先级的来源
71
+ - 较高层级缺失的值必须 (MUST) 向下穿透至下一层级
72
+ - 应用程序在启动时应该 (SHOULD) 记录使用了哪个配置源(无需记录密钥值)
73
+
74
+ ---
47
75
 
48
76
  ## 3. 环境一致性
49
77
 
50
- | 方面 | 要求 |
51
- |------|------|
52
- | 技术栈 | **必须**相同 |
53
- | 架构拓扑 | **应该**相同 |
54
- | 配置结构 | **必须**相同(值可不同) |
55
- | 数据结构 | **必须**相同 |
56
- | 规模 | **可以**不同 |
57
- | 数据内容 | **必须**不同(非生产环境使用匿名化数据) |
78
+ ### 3.1 六大一致性维度
79
+
80
+ 为最大限度减少“在我的机器上能跑”的问题,环境必须 (MUST) 在以下维度保持一致性:
81
+
82
+ | 维度 | 要求 | 理由 |
83
+ |--------|-------------|-----------|
84
+ | **技术栈 (Tech Stack)** | **必须 (MUST)** 相同 | 所有层级使用相同的语言版本、框架和运行时 |
85
+ | **架构拓扑 (Architecture Topology)** | **应该 (SHOULD)** 相同 | 相同的服务拓扑;偏差必须 (MUST) 记录成文 |
86
+ | **配置结构 (Configuration Structure)** | **必须 (MUST)** 相同 | 相同的配置键与模式(schema);各环境的值不同 |
87
+ | **数据结构 (Data Structure)** | **必须 (MUST)** 相同 | 相同的数据库模式(schema),所有层级均应用迁移 |
88
+ | **规模 (Scale)** | **可以 (MAY)** 不同 | 生产环境可以有更多副本、更大的实例规格 |
89
+ | **数据内容 (Data Content)** | **必须 (MUST)** 不同 | 非生产环境必须 (MUST) 使用匿名化或合成数据;切勿复制原始生产数据 |
90
+
91
+ ### 3.2 一致性验证
92
+
93
+ 团队应该 (SHOULD) 在 CI/CD 中自动化一致性检查:
94
+
95
+ - Staging 与 Production 之间的 Schema 比对
96
+ - 基础设施即代码(Infrastructure-as-Code)diff 报告
97
+ - 跨层级的依赖版本审计
98
+
99
+ ---
58
100
 
59
101
  ## 4. 密钥管理
60
102
 
61
- ### 五大核心原则
103
+ ### 4.1 核心原则
104
+
105
+ 所有项目必须 (MUST) 遵循以下五大密钥管理原则:
106
+
107
+ #### 原则 1: 不入版控 (No Version Control)
108
+
109
+ 密钥绝不能 (MUST never) 提交到版本控制。这包括 API 密钥、密码、令牌、证书和连接字符串。
110
+
111
+ #### 原则 2: 模板化 (Template-Based)
112
+
113
+ 项目必须 (MUST) 提供一个 `.env.example` 模板文件,记录所有必需的环境变量,且不包含实际密钥值:
114
+
115
+ ```bash
116
+ # .env.example — commit this file
117
+ DATABASE_URL=postgres://user:password@localhost:5432/mydb
118
+ API_KEY=your-api-key-here
119
+ SECRET_KEY=generate-with-openssl-rand-hex-32
120
+ ```
121
+
122
+ #### 原则 3: 集中管理 (Centralized Management)
123
+
124
+ 生产环境密钥应该 (SHOULD) 存储在集中式密钥管理器中:
125
+
126
+ - AWS Secrets Manager / SSM Parameter Store
127
+ - HashiCorp Vault
128
+ - Azure Key Vault
129
+ - Google Cloud Secret Manager
130
+ - 1Password / Doppler(适用于较小团队)
131
+
132
+ #### 原则 4: 最小权限 (Least Privilege)
133
+
134
+ 密钥访问必须 (MUST) 遵循最小权限原则:
62
135
 
63
- 1. **不入版控**:密钥绝不提交到版本控制
64
- 2. **模板化**:提供 `.env.example` 模板文件
65
- 3. **集中管理**:使用集中式密钥管理器(Vault、AWS Secrets Manager 等)
66
- 4. **最小权限**:每个服务只获取所需的密钥
67
- 5. **定期轮替**:API Key 每 90 天、TLS 证书到期前自动更新
136
+ - 每个服务仅获取其所需的密钥
137
+ - 每个环境使用独立的凭据
138
+ - 避免共享服务账户
68
139
 
69
- ### 轮替频率
140
+ #### 原则 5: 定期轮替 (Regular Rotation)
141
+
142
+ 密钥必须 (MUST) 按照定期计划进行轮替:
70
143
 
71
144
  | 密钥类型 | 轮替频率 |
72
- |---------|---------|
73
- | API Keys | 每 90 天 |
145
+ |-------------|-------------------|
146
+ | API 密钥 | 每 90 天 |
74
147
  | 数据库密码 | 每 90 天 |
75
- | TLS 证书 | 到期前(以 ACME 自动化) |
148
+ | TLS 证书 | 到期前(使用 ACME 自动化) |
76
149
  | 服务账户密钥 | 每 180 天 |
77
150
 
78
- ## 5. .gitignore 规则
151
+ ---
152
+
153
+ ## 5. 密钥相关的 .gitignore 规则
154
+
155
+ ### 5.1 最低要求规则 (MUST)
156
+
157
+ 每个项目必须 (MUST) 在 `.gitignore` 中至少包含以下模式,以防止意外泄露密钥:
79
158
 
80
- 必要规则:
81
159
  ```gitignore
160
+ # Environment files
82
161
  .env
83
162
  .env.local
84
163
  .env.*.local
164
+
165
+ # Certificates and keys
85
166
  *.pem
86
167
  *.key
168
+
169
+ # Cloud credentials
87
170
  credentials.json
88
171
  service-account.json
89
172
  ```
90
173
 
91
- ## 6. 环境验证检查表
174
+ ### 5.2 额外推荐规则 (SHOULD)
175
+
176
+ ```gitignore
177
+ # Additional secret patterns
178
+ *.p12
179
+ *.pfx
180
+ *.jks
181
+ .env.production
182
+ .env.staging
183
+ *-secret.yaml
184
+ *-secret.json
185
+ ```
186
+
187
+ ---
188
+
189
+ ## 6. 环境验证检查清单
190
+
191
+ ### 6.1 八大验证检查类别
192
+
193
+ 在将部署晋级至新环境之前,团队必须 (MUST) 验证以下八个类别:
92
194
 
93
195
  | # | 类别 | 检查项目 |
94
- |---|------|---------|
95
- | 1 | 连接性 | 数据库连接、API 端点、消息队列 |
96
- | 2 | 认证 | SSO/OAuth、API Key 有效性 |
97
- | 3 | 数据 | Schema Migration、种子数据 |
98
- | 4 | 监控 | 指标收集、日志聚合、告警规则 |
99
- | 5 | 安全 | TLS、CORS、速率限制 |
100
- | 6 | 访问 | 团队权限、部署凭证 |
101
- | 7 | 备份 | 备份计划、恢复程序 |
102
- | 8 | DNS | 域名记录、SSL 证书、CDN |
196
+ |---|----------|-------------|
197
+ | 1 | **连接性 (Connectivity)** | 数据库连接、API 端点可达、消息队列连通性、缓存可用性 |
198
+ | 2 | **认证 (Authentication)** | SSO/OAuth 流程正常运作、API 密钥有效性、服务间认证、证书到期时间 |
199
+ | 3 | **数据 (Data)** | Schema 迁移已应用、种子数据已加载、数据完整性约束有效 |
200
+ | 4 | **监控 (Monitoring)** | 指标收集已激活、日志聚合正常工作、告警规则已部署、仪表盘可访问 |
201
+ | 5 | **安全 (Security)** | TLS 已配置、CORS 策略已设置、速率限制已激活、WAF 规则已应用 |
202
+ | 6 | **访问 (Access)** | 团队访问权限、部署凭据、管理控制台访问权限、VPN 连通性 |
203
+ | 7 | **备份 (Backup)** | 备份计划已配置、恢复程序已测试、保留策略已设置 |
204
+ | 8 | **DNS** | 域名记录正确、SSL 证书有效、CDN 配置、健康检查端点 |
205
+
206
+ ### 6.2 验证自动化
207
+
208
+ 团队应该 (SHOULD) 创建自动化验证脚本(冒烟测试)来验证各个类别:
209
+
210
+ ```bash
211
+ # Example: verify-environment.sh
212
+ ./checks/connectivity.sh # Test all service endpoints
213
+ ./checks/auth.sh # Validate authentication flows
214
+ ./checks/data.sh # Run schema validation
215
+ ./checks/monitoring.sh # Confirm metrics pipeline
216
+ ./checks/security.sh # TLS and policy checks
217
+ ./checks/access.sh # Permission validation
218
+ ./checks/backup.sh # Backup system health
219
+ ./checks/dns.sh # DNS resolution checks
220
+ ```
221
+
222
+ ---
223
+
224
+ ## 7. 临时环境生命周期
103
225
 
104
- ## 7. IaC 六大核心原则
226
+ ### 7.1 Preview 环境管理
227
+
228
+ Preview 环境(每个 PR)必须实现自动清理(automatic cleanup)机制:
229
+
230
+ ```
231
+ PR Opened → Build Preview Env → Run Checks → Review
232
+ │
233
+ PR Merged ──────────────────────────────────────►│
234
+ ▼
235
+ Auto-Destroy Preview Env
236
+ ```
105
237
 
106
- 1. **声明式优先**:描述期望的最终状态
107
- 2. **幂等性**:重复应用产生相同结果
108
- 3. **版本控制**:所有 IaC 代码存于 Git
109
- 4. **模块化**:使用可重用模块
110
- 5. **环境参数化**:以变量注入环境特定值
111
- 6. **不可变基础设施**:更新时替换而非就地修改
238
+ **要求:**
112
239
 
113
- ### IaC Code Review 检查清单
240
+ - 当 PR 合并或关闭时,Preview 环境必须自动销毁
241
+ - 清理必须包含所有已配置的资源(计算、存储、DNS 记录)
242
+ - 清理失败必须向基础设施团队发出告警
243
+ - 应该设置最大 TTL(例如 7 天)作为安全防线
114
244
 
115
- PR 包含 IaC 变更时,审查者必须评估以下四个方面:
245
+ ### 7.2 基础设施即代码
246
+
247
+ 所有环境的配置均必须通过基础设施即代码(IaC)进行记录:
248
+
249
+ - **构建文档 (Build Documentation)**:基础设施定义必须纳入版本控制
250
+ - **验证清单 (Verification Checklist)**:每个环境必须有相应的验证清单
251
+ - 环境必须仅凭 IaC 定义即可重现
252
+
253
+ ---
254
+
255
+ ## 8. 基础设施即代码(IaC)原则
256
+
257
+ ### 8.1 核心原则
258
+
259
+ 所有基础设施配置必须遵循以下六项 IaC 核心原则:
260
+
261
+ | # | 原则 | 描述 |
262
+ |---|------|------|
263
+ | 1 | **Declarative-First(声明式优先)** | 描述期望的最终状态而非过程步骤。声明式定义使基础设施具有可预测性且可被审计。 |
264
+ | 2 | **Idempotency(幂等性)** | 多次应用相同的配置必须产生相同的结果。重复执行不会产生副作用。 |
265
+ | 3 | **Version Control(版本控制)** | 所有 IaC 代码必须存储在 Git 中。变更通过提交历史进行跟踪、审查和审计。 |
266
+ | 4 | **Modularity(模块化)** | 基础设施应该由可重用的模块组成。避免在各环境之间复制粘贴造成重复。 |
267
+ | 5 | **Environment Parameterization(环境参数化)** | 在各环境中以不同的参数值使用相同的模块。环境特定值通过变量注入,而非硬编码。 |
268
+ | 6 | **Immutable Infrastructure(不可变基础设施)** | 更新基础设施时,替换资源而非就地修改。这可确保一致性并简化回滚。 |
269
+
270
+ ### 8.2 IaC 代码审查检查清单
271
+
272
+ 当 PR 包含 IaC 变更时,审查者必须评估以下四个方面:
116
273
 
117
274
  | # | 方面 | 检查项目 |
118
- |---|------|----------|
119
- | 1 | **安全性** | 最小权限、无硬编码 Secret、IAM 范围正确、网络暴露最小化 |
120
- | 2 | **成本影响** | 新资源已识别、实例大小合理、预估每月成本变化已记录 |
121
- | 3 | **回滚可行性** | 变更可逆、破坏性操作已标记、有状态资源备份策略 |
122
- | 4 | **环境一致性** | 变更维持各层级一致、环境特定覆写已记录、无配置漂移 |
275
+ |---|--------|-------------|
276
+ | 1 | **Security(安全性)** | 应用最小权限、无硬编码密钥、IAM 策略范围正确、网络暴露最小化 |
277
+ | 2 | **Cost Impact(成本影响)** | 新资源已识别、实例规格合理、预估每月成本变化已记录 |
278
+ | 3 | **Rollback Feasibility(回滚可行性)** | 变更可逆、破坏性操作已标记、有状态资源具有备份/快照策略 |
279
+ | 4 | **Environment Consistency(环境一致性)** | 变更维持各层级间的一致性、环境特定覆写已记录、未引入配置漂移 |
123
280
 
124
- ### Drift Detection(漂移检测)
281
+ ### 8.3 漂移检测
125
282
 
126
- 基础设施漂移指实际状态与 IaC 定义状态产生偏差(例如通过控制台手动变更):
283
+ 当资源的实际状态与 IaC 定义的状态发生偏离时(例如通过控制台手动变更),即会发生基础设施漂移。团队必须实施漂移检测实践:
127
284
 
128
285
  **检测:**
129
- - 定期执行漂移扫描(如 `terraform plan`、`pulumi preview`),建议 Production 每日执行
130
- - 将漂移检查集成至 CI/CD pipeline
286
+ - 按计划定期运行漂移检测扫描(例如 `terraform plan`、`pulumi preview`)(推荐:生产环境每日运行)
287
+ - 将实际基础设施状态与 IaC 定义的期望状态进行对比
288
+ - 将漂移检查集成至 CI/CD 流水线
131
289
 
132
290
  **通知:**
133
- - 检测到漂移必须通知负责团队(Slack、email 或告警系统)
291
+ - 检测到的漂移必须向负责团队发出通知(通过 Slack、电子邮件或告警系统)
292
+ - 漂移报告应该包含:受影响的资源、检测到的差异以及时间戳
134
293
 
135
294
  **修复:**
136
- - **更新 IaC**:若手动变更为有意为之,更新 IaC 代码
137
- - **还原基础设施**:若为未授权或意外变更,还原至 IaC 定义状态
295
+ - 团队必须使用以下两种方法之一解决漂移:
296
+ - **更新 IaC**:如果手动变更为有意为之,更新 IaC 代码以反映新的期望状态
297
+ - **还原基础设施**:如果手动变更为未授权或意外变更,还原基础设施以匹配 IaC 定义
298
+ - 漂移修复应该作为工单进行跟踪,并在定义的 SLA 内解决
299
+
300
+ ---
301
+
302
+ ## 参考资料
303
+
304
+ - [The Twelve-Factor App — Config](https://12factor.net/config) — 基于环境的配置原则
305
+ - [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) — 密钥处理最佳实践
306
+ - [NIST SP 800-123](https://csrc.nist.gov/publications/detail/sp/800-123/final) — 通用服务器安全指南
138
307
 
139
308
  ---
140
309
 
141
310
  **相关标准:**
142
- - [日志标准](logging-standards.md)
143
- - [部署标准](deployment-standards.md)
144
- - [安全标准](security-standards.md)
311
+ - [日志标准](logging-standards.md) — 按环境划分的结构化日志
312
+ - [部署标准](deployment-standards.md) — CI/CD 与部署流水线
313
+ - [安全标准](security-standards.md) — 安全控制与合规
314
+ - [可观测性标准](observability-standards.md) — 监控与告警
315
+
316
+ ---
317
+
318
+ ## 版本历史
319
+
320
+ | 版本 | 日期 | 变更内容 |
321
+ |---------|------|---------|
322
+ | 1.0.0 | 2026-03-31 | 初始版本:环境层级、配置层级、一致性、密钥管理、验证清单、临时环境 |
145
323
 
146
324
  ---
147
325