universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.11

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 (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +11 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +113 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -2,7 +2,8 @@
2
2
  source: ../../../../core/guides/file-placement-guide.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-04
5
+ last_synced: 2026-10-11
6
+ source_hash: ed790154a974
6
7
  status: current
7
8
  ---
8
9
 
@@ -33,40 +34,40 @@ status: current
33
34
  从这里开始。识别文件的主要分类,然后沿着分支进行。
34
35
 
35
36
  ```
36
- 你要放置什么类型的文件?
37
+ What kind of file are you placing?
37
38
  │
38
- ├── 代码(源代码、测试、脚本、生成代码)
39
- │ ├── 应用程序逻辑? → src/{module}/
40
- │ ├── 测试文件? → tests/(或依语言惯例放在源代码旁)
41
- │ ├── 脚本/工具? → tools/ 或 scripts/
42
- │ ├── 生成代码? → src/generated/{type}/
43
- │ └── 工具函数/辅助? → 参见 §3 代码组织深入辨析
39
+ ├── CODE (source, test, script, generated)
40
+ │ ├── Application logic? → src/{module}/
41
+ │ ├── Test file? → tests/ (or alongside source, per language convention)
42
+ │ ├── Script/tool? → tools/ or scripts/
43
+ │ ├── Generated code? → src/generated/{type}/
44
+ │ └── Utility/helper? → See §3 Code Organization Deep Dive
44
45
  │
45
- ├── 文档(正式、工作中、参考)
46
- │ ├── 正式(稳定、版本化)?
47
- │ │ ├── 架构决策 → docs/ADR/NNN-title.md
48
- │ │ ├── 规格 → docs/specs/
49
- │ │ ├── API 参考 → docs/api-reference.md
50
- │ │ ├── 使用指南 → docs/
51
- │ │ └── 流程/图表 → docs/flows/ 或 docs/diagrams/
52
- │ └── 工作中(进行中、临时)?
53
- │ ├── 头脑风暴 → docs/working/brainstorms/
46
+ ├── DOCUMENTATION (formal, working, reference)
47
+ │ ├── Formal (stable, versioned)?
48
+ │ │ ├── Architecture decision → docs/ADR/NNN-title.md
49
+ │ │ ├── Specification → docs/specs/
50
+ │ │ ├── API reference → docs/api-reference.md
51
+ │ │ ├── User guide → docs/
52
+ │ │ └── Flow/diagram → docs/flows/ or docs/diagrams/
53
+ │ └── Working (in-progress, temporary)?
54
+ │ ├── Brainstorm → docs/working/brainstorms/
54
55
  │ ├── RFC → docs/working/rfcs/
55
- │ ├── 技术调查 → docs/working/investigations/
56
+ │ ├── Investigation → docs/working/investigations/
56
57
  │ ├── POC → docs/working/poc/{name}/
57
- │ └── 会议记录 → docs/working/meeting-notes/
58
+ │ └── Meeting notes → docs/working/meeting-notes/
58
59
  │
59
- ├── 配置文件
60
- │ ├── 工具配置(linter、formatter、bundler) → 项目根目录 /
61
- │ ├── 应用程序运行时配置 → config/ 或 src/config/
62
- │ ├── 环境变量 → .env(gitignored)
63
- │ ├── CI/CD 管线 → .github/workflows/ 或 .gitlab-ci.yml
64
- │ └── 基础设施即代码 → infra/ 或 deploy/
60
+ ├── CONFIGURATION
61
+ │ ├── Tool config (linter, formatter, bundler) → Project root /
62
+ │ ├── App runtime config → config/ or src/config/
63
+ │ ├── Environment variables → .env (gitignored)
64
+ │ ├── CI/CD pipeline → .github/workflows/ or .gitlab-ci.yml
65
+ │ └── Infrastructure as Code → infra/ or deploy/
65
66
  │
66
- └── 资源(静态文件、媒体)
67
- ├── Web 公开资源 → public/ 或 static/
68
- ├── 源资源(需处理) → assets/ 或 src/assets/
69
- └── 文档图片 → docs/images/ 或 docs/diagrams/
67
+ └── ASSET (static files, media)
68
+ ├── Web public assets → public/ or static/
69
+ ├── Source assets (needs processing) → assets/ or src/assets/
70
+ └── Documentation images → docs/images/ or docs/diagrams/
70
71
  ```
71
72
 
72
73
  ---
@@ -143,15 +144,48 @@ status: current
143
144
  | `utils/` | **无状态 + 通用** | `formatDate()`、`slugify()`、`retry()` |
144
145
  | `helpers/` | **层级绑定** | `tests/helpers/mockUser()`、`views/helpers/formatCurrency()` |
145
146
  | `shared/` | **跨模块边界** | `shared/types/User.ts`、`shared/constants/` |
146
- | `common/` | shared/ 的别名 | 避免使用;建议用 `shared/` |
147
+ | `common/` | shared/ 的别名 | 避免使用;建议用 `shared/` 以求清晰 |
147
148
  | `lib/` | **包装依赖** | `lib/http-client/`(包装 axios)、`lib/logger/` |
148
- | `internal/` | **包私有**(Go 惯例) | `internal/parser/`(外部无法 import) |
149
+ | `internal/` | **包私有**(Go 惯例) | `internal/parser/`(模块外部无法 import) |
150
+
151
+ #### 决策图
152
+
153
+ ```
154
+ ┌─────────────────────┐
155
+ │ New shared code │
156
+ └──────────┬──────────┘
157
+ │
158
+ ┌──────────▼──────────┐
159
+ │ Is it stateless and │
160
+ │ has no business │
161
+ │ logic? │
162
+ └──────────┬──────────┘
163
+ YES/ \NO
164
+ / \
165
+ ┌───────────▼┐ ┌─▼───────────────┐
166
+ │ Reusable │ │ Used by 2+ │
167
+ │ across the │ │ modules? │
168
+ │ project? │ └──────┬───────────┘
169
+ └─────┬──────┘ YES/ \NO
170
+ YES/ \NO / \
171
+ / \ ┌─────▼──┐ ┌─▼──────────────┐
172
+ ┌─────▼──┐ ┌─▼─────┐│shared/│ │ Wrapping a │
173
+ │utils/ │ │Tied to││ │ │ third-party │
174
+ │ │ │layer? │└────────┘ │ dependency? │
175
+ └────────┘ └──┬───┘ └──────┬─────────┘
176
+ YES/ \NO YES/ \NO
177
+ / \ / \
178
+ ┌─────▼───┐ ┌▼────────┐┌────▼──┐ ┌─▼──────────┐
179
+ │helpers/ │ │module/ ││lib/ │ │owning │
180
+ │(in layer)│ │ │└───────┘ │module/ │
181
+ └──────────┘ └────────┘ └─────────────┘
182
+ ```
149
183
 
150
184
  #### 详细标准
151
185
 
152
186
  **`utils/`** — 纯工具函数
153
187
  - 无副作用、无状态、无业务逻辑
154
- - 可以被提取为 npm/pip 包
188
+ - 可以被提取为 npm 包 / pip 包
155
189
  - 示例:`formatDate()`、`deepClone()`、`slugify()`、`retry()`
156
190
  - 反模式:`utils/userService.js`(有业务逻辑 → 属于 `services/`)
157
191
 
@@ -168,7 +202,7 @@ status: current
168
202
  - 示例:`shared/types/User.ts`、`shared/validation/email.ts`
169
203
 
170
204
  **`lib/`** — 包装/Vendored 库
171
- - 包装第三方依赖并加入项目特定默认
205
+ - 包装第三方依赖并加入项目特定默认值
172
206
  - 提供稳定的内部接口,即使外部库变更
173
207
  - 示例:`lib/http-client/`(包装 axios)、`lib/logger/`(包装 winston)
174
208
 
@@ -183,6 +217,28 @@ status: current
183
217
 
184
218
  工作文件从创建到毕业(或归档)遵循一个生命周期。
185
219
 
220
+ ### 状态图
221
+
222
+ ```
223
+ ┌──────────┐
224
+ │ draft │ ← Initial creation
225
+ └────┬─────┘
226
+ │ Start active work
227
+ ┌────▼─────┐
228
+ │ active │ ← Under discussion / development
229
+ └────┬─────┘
230
+ │
231
+ ┌────┴─────────────────┐
232
+ │ │
233
+ ▼ ▼
234
+ ┌──────────┐ ┌──────────┐
235
+ │graduated │ │ archived │
236
+ │ │ │ │
237
+ └──────────┘ └──────────┘
238
+ Creates formal No longer
239
+ document relevant
240
+ ```
241
+
186
242
  ### 毕业路径
187
243
 
188
244
  | 来源 | 目的地 | 触发条件 |
@@ -210,7 +266,17 @@ status: current
210
266
 
211
267
  ### 步骤 1:盘点
212
268
 
213
- 列出所有可能放错位置的文件。
269
+ 列出所有可能放错位置的文件:
270
+
271
+ ```bash
272
+ # Find files at unexpected depths
273
+ find . -maxdepth 1 -name "*.md" ! -name "README.md" ! -name "CONTRIBUTING.md" \
274
+ ! -name "CHANGELOG.md" ! -name "LICENSE" ! -name "SECURITY.md" ! -name "CODE_OF_CONDUCT.md"
275
+
276
+ # Find orphaned docs not in docs/
277
+ find . -name "*.md" -not -path "./docs/*" -not -path "./node_modules/*" \
278
+ -not -path "./.git/*" | head -20
279
+ ```
214
280
 
215
281
  ### 步骤 2:分类
216
282
 
@@ -219,11 +285,11 @@ status: current
219
285
  ### 步骤 3:移动
220
286
 
221
287
  ```bash
222
- # 创建目标目录
288
+ # Create target directories
223
289
  mkdir -p docs/working/{brainstorms,investigations,rfcs,meeting-notes,poc}
224
290
  mkdir -p src/generated
225
291
 
226
- # 移动文件(之后更新引用)
292
+ # Move files (update imports/references after)
227
293
  git mv old/path/file.md new/path/file.md
228
294
  ```
229
295
 
@@ -244,31 +310,31 @@ git mv old/path/file.md new/path/file.md
244
310
  ```
245
311
  ❌ project/
246
312
  ├── package.json
247
- ├── brainstorm.md # 应放在 docs/working/brainstorms/
248
- ├── investigation-oom.md # 应放在 docs/working/investigations/
249
- ├── TODO.md # 应在 issue tracker 中
250
- └── notes.md # 应放在 docs/working/
313
+ ├── brainstorm.md # Should be in docs/working/brainstorms/
314
+ ├── investigation-oom.md # Should be in docs/working/investigations/
315
+ ├── TODO.md # Should be in issue tracker
316
+ └── notes.md # Should be in docs/working/
251
317
  ```
252
318
 
253
319
  ### ❌ docs/ 作为垃圾桶
254
320
 
255
321
  ```
256
322
  ❌ docs/
257
- ├── architecture.md # ✓ 正确
323
+ ├── architecture.md # ✓ Correct
258
324
  ├── brainstorm-2024.md # → docs/working/brainstorms/
259
325
  ├── meeting-jan-15.md # → docs/working/meeting-notes/
260
326
  ├── poc-redis.md # → docs/working/poc/redis/
261
- └── random-thoughts.md # → docs/working/brainstorms/ 或删除
327
+ └── random-thoughts.md # → docs/working/brainstorms/ or delete
262
328
  ```
263
329
 
264
330
  ### ❌ utils/ 作为万能桶
265
331
 
266
332
  ```
267
333
  ❌ src/utils/
268
- ├── formatDate.js # ✓ 正确(纯工具函数)
269
- ├── userService.js # → src/services/(有业务逻辑)
270
- ├── database.js # → src/config/ 或 lib/(基础设施)
271
- └── authMiddleware.js # → src/middleware/(层级特定)
334
+ ├── formatDate.js # ✓ Correct (pure utility)
335
+ ├── userService.js # → src/services/ (has business logic)
336
+ ├── database.js # → src/config/ or lib/ (infrastructure)
337
+ └── authMiddleware.js # → src/middleware/ (layer-specific)
272
338
  ```
273
339
 
274
340
  ### ❌ 目录没有 README
@@ -277,14 +343,32 @@ git mv old/path/file.md new/path/file.md
277
343
  ❌ docs/working/poc/redis-cache/
278
344
  ├── benchmark-results.txt
279
345
  ├── test-script.sh
280
- └── (没有 README.md — 结论是什么?)
346
+ └── (no README.md — what was the conclusion?)
281
347
 
282
348
  ✅ docs/working/poc/redis-cache/
283
- ├── README.md # 目的、发现、结论、后续步骤
349
+ ├── README.md # Purpose, findings, conclusion, next steps
284
350
  ├── benchmark-results.txt
285
351
  └── test-script.sh
286
352
  ```
287
353
 
354
+ ### ❌ 生成代码与源代码混杂
355
+
356
+ ```
357
+ ❌ src/
358
+ ├── api-client.ts # Hand-written
359
+ ├── api-client.generated.ts # Generated — hard to tell apart
360
+ └── models/
361
+ ├── User.ts # Hand-written
362
+ └── User.generated.ts # Generated
363
+
364
+ ✅ src/
365
+ ├── api-client.ts
366
+ ├── models/User.ts
367
+ └── generated/
368
+ ├── api-client.ts # Clearly separated
369
+ └── models/User.ts
370
+ ```
371
+
288
372
  ---
289
373
 
290
374
  ## 相关标准
@@ -2,44 +2,46 @@
2
2
  source: core/guides/performance-guide.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 22e50e7f3f83
5
7
  status: current
6
8
  ---
7
9
 
8
- # Performance Guide
10
+ # 性能指南
9
11
 
10
- > **语言**: [English](../../../../core/guides/performance-guide.md) | 简体中文
12
+ > **语言**: [English](../../../../core/guides/performance-guide.md) | [繁體中文](../../../zh-TW/core/guides/performance-guide.md) | 简体中文
11
13
 
12
- **Version**: 1.0.0
13
- **Last Updated**: 2026-01-29
14
- **Related Standard**: [Performance Standards](../performance-standards.md)
14
+ **版本**: 1.0.0
15
+ **最后更新**: 2026-01-29
16
+ **相关标准**: [性能标准](../performance-standards.md)
15
17
 
16
18
  ---
17
19
 
18
- ## Purpose
20
+ ## 目的
19
21
 
20
- 本指南为软件性能工程提供详细的说明、优化技巧与教学内容。关于性能预算(performance budget)、阈值与必备检查清单,请参阅 [Performance Standards](../performance-standards.md)。
22
+ 本指南为软件性能工程提供详细的说明、优化技巧与教学内容。关于性能预算(performance budget)、阈值与必备检查清单,请参阅 [性能标准](../performance-standards.md)。
21
23
 
22
24
  ---
23
25
 
24
- ## Table of Contents
26
+ ## 目录
25
27
 
26
- 1. [Performance Fundamentals](#performance-fundamentals)
27
- 2. [Performance Testing Deep Dive](#performance-testing-deep-dive)
28
- 3. [Metrics Explained](#metrics-explained)
29
- 4. [Optimization Strategies](#optimization-strategies)
30
- 5. [Database Performance Tuning](#database-performance-tuning)
31
- 6. [API Performance Optimization](#api-performance-optimization)
32
- 7. [Frontend Performance Techniques](#frontend-performance-techniques)
33
- 8. [Caching Architecture](#caching-architecture)
34
- 9. [Monitoring and Observability](#monitoring-and-observability)
35
- 10. [Capacity Planning Process](#capacity-planning-process)
36
- 11. [References](#references)
28
+ 1. [性能基础](#性能基础)
29
+ 2. [性能测试深入解析](#性能测试深入解析)
30
+ 3. [指标详解](#指标详解)
31
+ 4. [优化策略](#优化策略)
32
+ 5. [数据库性能调优](#数据库性能调优)
33
+ 6. [API 性能优化](#api-性能优化)
34
+ 7. [前端性能技巧](#前端性能技巧)
35
+ 8. [缓存架构](#缓存架构)
36
+ 9. [监控与可观测性](#监控与可观测性)
37
+ 10. [容量规划流程](#容量规划流程)
38
+ 11. [参考资料](#参考资料)
37
39
 
38
40
  ---
39
41
 
40
- ## Performance Fundamentals
42
+ ## 性能基础
41
43
 
42
- ### ISO 25010 Performance Efficiency
44
+ ### ISO 25010 性能效率
43
45
 
44
46
  ```
45
47
  ┌─────────────────────────────────────────────────────────────────┐
@@ -63,9 +65,9 @@ ISO 25010 将性能效率(performance efficiency)定义为八项质量特性
63
65
 
64
66
  ---
65
67
 
66
- ## Performance Testing Deep Dive
68
+ ## 性能测试深入解析
67
69
 
68
- ### Testing Types Explained
70
+ ### 测试类型详解
69
71
 
70
72
  ```
71
73
  ┌─────────────────────────────────────────────────────────────────┐
@@ -100,7 +102,7 @@ ISO 25010 将性能效率(performance efficiency)定义为八项质量特性
100
102
  └─────────────────────────────────────────────────────────────────┘
101
103
  ```
102
104
 
103
- ### k6 Load Test Example
105
+ ### k6 负载测试示例
104
106
 
105
107
  ```javascript
106
108
  // Example: k6 Load Test Configuration
@@ -133,9 +135,9 @@ export default function () {
133
135
 
134
136
  ---
135
137
 
136
- ## Metrics Explained
138
+ ## 指标详解
137
139
 
138
- ### The RED Method (Request-oriented)
140
+ ### RED 方法(面向请求)
139
141
 
140
142
  RED 方法聚焦于请求级别(request-level)的指标,最适合用于服务:
141
143
 
@@ -145,7 +147,7 @@ RED 方法聚焦于请求级别(request-level)的指标,最适合用于服
145
147
  | **E**rrors | 错误率百分比 | 质量指标 |
146
148
  | **D**uration | 响应时间分布 | 用户体验 |
147
149
 
148
- ### The USE Method (Resource-oriented)
150
+ ### USE 方法(面向资源)
149
151
 
150
152
  USE 方法聚焦于资源使用率(resource utilization),最适合用于基础设施:
151
153
 
@@ -155,7 +157,7 @@ USE 方法聚焦于资源使用率(resource utilization),最适合用于
155
157
  | **S**aturation | 队列长度 | 队列持续增长 |
156
158
  | **E**rrors | 错误计数 | 任何增加 |
157
159
 
158
- ### The Four Golden Signals (SRE)
160
+ ### 四大黄金信号(SRE)
159
161
 
160
162
  Google 的 SRE 著作将以下四项定义为任何系统最重要的指标:
161
163
 
@@ -188,9 +190,9 @@ Google 的 SRE 著作将以下四项定义为任何系统最重要的指标:
188
190
  └─────────────────────────────────────────────────────────────────┘
189
191
  ```
190
192
 
191
- ### Understanding Percentiles
193
+ ### 理解百分位数
192
194
 
193
- | Percentile | 含义 | 使用场景 |
195
+ | 百分位数 | 含义 | 使用场景 |
194
196
  |------------|---------|----------|
195
197
  | **p50 (median)** | 一半的请求比此更快 | 典型体验 |
196
198
  | **p90** | 90% 的请求比此更快 | 多数用户 |
@@ -202,9 +204,9 @@ Google 的 SRE 著作将以下四项定义为任何系统最重要的指标:
202
204
 
203
205
  ---
204
206
 
205
- ## Optimization Strategies
207
+ ## 优化策略
206
208
 
207
- ### General Optimization Principles
209
+ ### 通用优化原则
208
210
 
209
211
  ```
210
212
  ┌─────────────────────────────────────────────────────────────────┐
@@ -232,7 +234,7 @@ Google 的 SRE 著作将以下四项定义为任何系统最重要的指标:
232
234
  └─────────────────────────────────────────────────────────────────┘
233
235
  ```
234
236
 
235
- ### Optimization Techniques by Level
237
+ ### 各层级优化技巧
236
238
 
237
239
  | 层级 | 技巧 | 影响 | 投入成本 |
238
240
  |-------|-----------|--------|--------|
@@ -247,9 +249,9 @@ Google 的 SRE 著作将以下四项定义为任何系统最重要的指标:
247
249
 
248
250
  ---
249
251
 
250
- ## Database Performance Tuning
252
+ ## 数据库性能调优
251
253
 
252
- ### Index Guidelines
254
+ ### 索引指南
253
255
 
254
256
  ```sql
255
257
  -- ✅ Good: Index for frequently queried columns
@@ -268,7 +270,7 @@ WHERE status = 'pending';
268
270
 
269
271
  **为何使用 partial index?** 它们更小、更快,因为只包含符合特定条件的数据行。非常适合用于频繁查询的数据子集。
270
272
 
271
- ### N+1 Query Problem
273
+ ### N+1 查询问题
272
274
 
273
275
  N+1 问题是最常见的性能问题之一:
274
276
 
@@ -287,9 +289,9 @@ const users = await User.findAll({
287
289
 
288
290
  ---
289
291
 
290
- ## API Performance Optimization
292
+ ## API 性能优化
291
293
 
292
- ### API Design for Performance
294
+ ### 面向性能的 API 设计
293
295
 
294
296
  ```typescript
295
297
  // ❌ Bad: Returns all fields, all records
@@ -313,9 +315,9 @@ POST /api/users/batch
313
315
 
314
316
  ---
315
317
 
316
- ## Frontend Performance Techniques
318
+ ## 前端性能技巧
317
319
 
318
- ### Core Web Vitals Explained
320
+ ### Core Web Vitals 详解
319
321
 
320
322
  | 指标 | 衡量内容 | 目标 | 如何改善 |
321
323
  |--------|------------------|--------|----------------|
@@ -323,7 +325,7 @@ POST /api/users/batch
323
325
  | **INP** | Interaction to Next Paint | < 200ms | 减少 JavaScript、延后非关键脚本 |
324
326
  | **CLS** | Cumulative Layout Shift | < 0.1 | 为图片设置尺寸、为动态内容预留空间 |
325
327
 
326
- ### Performance Budget Example
328
+ ### 性能预算示例
327
329
 
328
330
  ```yaml
329
331
  # Example Performance Budget
@@ -350,9 +352,9 @@ lighthouse_scores:
350
352
 
351
353
  ---
352
354
 
353
- ## Caching Architecture
355
+ ## 缓存架构
354
356
 
355
- ### Cache Levels
357
+ ### 缓存层级
356
358
 
357
359
  ```
358
360
  ┌─────────────────────────────────────────────────────────────────┐
@@ -382,7 +384,7 @@ lighthouse_scores:
382
384
  └─────────────────────────────────────────────────────────────────┘
383
385
  ```
384
386
 
385
- ### Cache Invalidation Strategies
387
+ ### 缓存失效策略
386
388
 
387
389
  | 策略 | 运作方式 | 最适用于 |
388
390
  |----------|--------------|----------|
@@ -391,7 +393,7 @@ lighthouse_scores:
391
393
  | **Version-based** | 新版本 = 新的 cache key | 部署 |
392
394
  | **Stale-while-revalidate** | 先提供过期内容,后台刷新 | 高可用性 |
393
395
 
394
- ### Cache Headers
396
+ ### 缓存标头
395
397
 
396
398
  ```http
397
399
  # Static assets (versioned filename)
@@ -410,9 +412,9 @@ Last-Modified: Wed, 21 Oct 2025 07:28:00 GMT
410
412
 
411
413
  ---
412
414
 
413
- ## Monitoring and Observability
415
+ ## 监控与可观测性
414
416
 
415
- ### Dashboard Layout
417
+ ### 仪表板布局
416
418
 
417
419
  ```
418
420
  ┌─────────────────────────────────────────────────────────────────┐
@@ -447,7 +449,7 @@ Last-Modified: Wed, 21 Oct 2025 07:28:00 GMT
447
449
 
448
450
  ---
449
451
 
450
- ## Capacity Planning Process
452
+ ## 容量规划流程
451
453
 
452
454
  ```
453
455
  ┌─────────────────────────────────────────────────────────────────┐
@@ -482,7 +484,7 @@ Last-Modified: Wed, 21 Oct 2025 07:28:00 GMT
482
484
  └─────────────────────────────────────────────────────────────────┘
483
485
  ```
484
486
 
485
- ### Scaling Strategies Compared
487
+ ### 扩展策略比较
486
488
 
487
489
  | 策略 | 优点 | 缺点 | 何时使用 |
488
490
  |----------|------|------|-------------|
@@ -492,24 +494,24 @@ Last-Modified: Wed, 21 Oct 2025 07:28:00 GMT
492
494
 
493
495
  ---
494
496
 
495
- ## References
497
+ ## 参考资料
496
498
 
497
- ### Standards
498
- - [ISO/IEC 25010:2011](https://www.iso.org/standard/35733.html) - Performance Efficiency
499
+ ### 标准
500
+ - [ISO/IEC 25010:2011](https://www.iso.org/standard/35733.html) - 性能效率
499
501
  - [Web Vitals](https://web.dev/vitals/) - Google Core Web Vitals
500
502
 
501
- ### Books
503
+ ### 书籍
502
504
  - Brendan Gregg - "Systems Performance: Enterprise and the Cloud" (2020)
503
505
  - Google - "Site Reliability Engineering" (2016)
504
506
  - Martin Kleppmann - "Designing Data-Intensive Applications" (2017)
505
507
 
506
- ### Tools
507
- - [k6](https://k6.io/) - Load testing
508
- - [Lighthouse](https://developer.chrome.com/docs/lighthouse/) - Frontend performance
509
- - [Grafana](https://grafana.com/) - Performance dashboards
508
+ ### 工具
509
+ - [k6](https://k6.io/) - 负载测试
510
+ - [Lighthouse](https://developer.chrome.com/docs/lighthouse/) - 前端性能
511
+ - [Grafana](https://grafana.com/) - 性能仪表板
510
512
 
511
513
  ---
512
514
 
513
- ## License
515
+ ## 许可证
514
516
 
515
- This guide is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
517
+ 本指南以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
@@ -2,6 +2,8 @@
2
2
  source: core/guides/security-guide.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: efb5c611807a
5
7
  status: current
6
8
  ---
7
9