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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/commit-standards/conventional-commits.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-25
5
+ last_synced: 2026-10-11
6
+ source_hash: 37d8f10f78c0
6
7
  status: current
7
8
  ---
8
9
 
@@ -11,8 +12,8 @@ status: current
11
12
  > **语言**: [English](../../../../skills/commit-standards/conventional-commits.md) | 简体中文
12
13
 
13
14
  **版本**: 1.0.0
14
- **最後更新**: 2025-12-24
15
- **適用範圍**: Claude Code Skills
15
+ **最后更新**: 2025-12-24
16
+ **适用范围**: Claude Code Skills
16
17
 
17
18
  ---
18
19
 
@@ -32,15 +33,15 @@ status: current
32
33
  <footer>
33
34
  ```
34
35
 
35
- ### 組成元素
36
+ ### 组成元素
36
37
 
37
38
  | 元素 | 必填 | 说明 |
38
39
  |-----------|----------|-------------|
39
40
  | `type` | ✅ 是 | 变更类型 |
40
- | `scope` | 選填 | 受影響的模組/元件 |
41
- | `subject` | ✅ 是 | 簡短描述(≤72 字元) |
41
+ | `scope` | 选填 | 受影响的模组/元件 |
42
+ | `subject` | ✅ 是 | 简短描述(≤72 字元) |
42
43
  | `body` | 建议填写 | 详细说明 |
43
- | `footer` | 選填 | 議題引用、破壞性变更 |
44
+ | `footer` | 选填 | 议题引用、破坏性变更 |
44
45
 
45
46
  ---
46
47
 
@@ -48,37 +49,37 @@ status: current
48
49
 
49
50
  ### 主要类型
50
51
 
51
- | 类型 | 使用时机 | 範例 |
52
+ | 类型 | 使用时机 | 范例 |
52
53
  |------|-------------|----------|
53
54
  | `feat` | 为使用者新增功能 | `feat(cart): Add quantity selector` |
54
- | `fix` | 为使用者修復错误 | `fix(login): Resolve password reset loop` |
55
- | `docs` | 僅文件变更 | `docs(api): Add authentication examples` |
56
- | `refactor` | 程序码变更但不涉及功能/修復 | `refactor(utils): Simplify date formatting` |
55
+ | `fix` | 为使用者修复错误 | `fix(login): Resolve password reset loop` |
56
+ | `docs` | 仅文件变更 | `docs(api): Add authentication examples` |
57
+ | `refactor` | 程序码变更但不涉及功能/修复 | `refactor(utils): Simplify date formatting` |
57
58
 
58
59
  ### 次要类型
59
60
 
60
- | 类型 | 使用时机 | 範例 |
61
+ | 类型 | 使用时机 | 范例 |
61
62
  |------|-------------|----------|
62
63
  | `style` | 格式化、空白字元 | `style: Apply prettier formatting` |
63
64
  | `test` | 新增/更新测试 | `test(auth): Add login integration tests` |
64
65
  | `perf` | 效能改进 | `perf(query): Add database index` |
65
- | `build` | 建置系统、依賴套件 | `build(deps): Upgrade React to v18` |
66
+ | `build` | 建置系统、依赖套件 | `build(deps): Upgrade React to v18` |
66
67
  | `ci` | CI/CD 流程 | `ci: Add deploy workflow` |
67
- | `chore` | 維護任务 | `chore: Update .gitignore` |
68
- | `revert` | 回復提交 | `revert: Revert "feat(auth): Add SSO"` |
69
- | `security` | 安全性修復 | `security(auth): Fix XSS vulnerability` |
68
+ | `chore` | 维护任务 | `chore: Update .gitignore` |
69
+ | `revert` | 回复提交 | `revert: Revert "feat(auth): Add SSO"` |
70
+ | `security` | 安全性修复 | `security(auth): Fix XSS vulnerability` |
70
71
 
71
72
  ---
72
73
 
73
74
  ## Scope 指南
74
75
 
75
- ### 命名規則
76
+ ### 命名规则
76
77
 
77
78
  1. **使用小写**: `auth`,而非 `Auth`
78
- 2. **多个单字使用連字号**: `user-profile`,而非 `userProfile`
79
- 3. **保持簡短**: 最多 1-2 个单字
79
+ 2. **多个单字使用连字号**: `user-profile`,而非 `userProfile`
80
+ 3. **保持简短**: 最多 1-2 个单字
80
81
 
81
- ### 常見 Scopes
82
+ ### 常见 Scopes
82
83
 
83
84
  **依层级**:
84
85
  - `api`, `ui`, `database`, `config`, `middleware`
@@ -90,30 +91,30 @@ status: current
90
91
  - `tests`, `docs`, `build`, `deps`
91
92
 
92
93
  **特殊**:
93
- - `*`: 影響多个範圍
94
- - (無 scope): 全域变更
94
+ - `*`: 影响多个范围
95
+ - (无 scope): 全域变更
95
96
 
96
97
  ---
97
98
 
98
- ## Subject 行規則
99
+ ## Subject 行规则
99
100
 
100
- 1. **長度**: ≤72 字元(理想为 50)
101
- 2. **时態**: 祈使語氣
101
+ 1. **长度**: ≤72 字元(理想为 50)
102
+ 2. **时态**: 祈使语气
102
103
  - ✅ "Add feature"
103
104
  - ❌ "Added feature"
104
105
  3. **大小写**: 首字母大写
105
- 4. **無句号**: 結尾不加句号
106
+ 4. **无句号**: 结尾不加句号
106
107
  5. **具体明确**: 描述变更内容
107
108
 
108
- ### 範例
109
+ ### 范例
109
110
 
110
111
  ```
111
112
  ✅ feat(auth): Add OAuth2 Google login support
112
113
  ✅ fix(api): Resolve memory leak in session cache
113
114
  ✅ refactor(database): Extract query builder class
114
115
 
115
- ❌ fixed bug # 模糊、過去式
116
- ❌ feat(auth): added login. # 過去式、有句号
116
+ ❌ fixed bug # 模糊、过去式
117
+ ❌ feat(auth): added login. # 过去式、有句号
117
118
  ❌ Update stuff # 太模糊
118
119
  ```
119
120
 
@@ -121,9 +122,9 @@ status: current
121
122
 
122
123
  ## Body 指南
123
124
 
124
- 说明**为什麼**,而非**做什麼**(程序码已經展示做什麼)。
125
+ 说明**为什么**,而非**做什么**(程序码已经展示做什么)。
125
126
 
126
- ### 範本
127
+ ### 范本
127
128
 
128
129
  **功能类**:
129
130
  ```
@@ -136,7 +137,7 @@ What this implements:
136
137
  - Implementation detail 2
137
138
  ```
138
139
 
139
- **错误修復类**:
140
+ **错误修复类**:
140
141
  ```
141
142
  Why this occurred:
142
143
  - Root cause explanation
@@ -148,7 +149,7 @@ Testing:
148
149
  - How it was tested
149
150
  ```
150
151
 
151
- **重構类**:
152
+ **重构类**:
152
153
  ```
153
154
  Why this refactoring:
154
155
  - Motivation
@@ -164,17 +165,17 @@ Migration:
164
165
 
165
166
  ## Footer 指南
166
167
 
167
- ### 議題引用
168
+ ### 议题引用
168
169
 
169
170
  ```
170
- Closes #123 # 自动关閉議題
171
- Fixes #456 # 自动关閉議題
172
- Resolves #789 # 自动关閉議題
173
- Refs #101 # 連結但不关閉
171
+ Closes #123 # 自动关闭议题
172
+ Fixes #456 # 自动关闭议题
173
+ Resolves #789 # 自动关闭议题
174
+ Refs #101 # 连结但不关闭
174
175
  See also #999 # 相关引用
175
176
  ```
176
177
 
177
- ### 破壞性变更
178
+ ### 破坏性变更
178
179
 
179
180
  ```
180
181
  BREAKING CHANGE: <description>
@@ -186,7 +187,7 @@ Migration guide:
186
187
 
187
188
  ---
188
189
 
189
- ## 完整範例
190
+ ## 完整范例
190
191
 
191
192
  ```
192
193
  feat(export): Add CSV export functionality for user data
@@ -231,13 +232,13 @@ feat: add login, fix bugs, refactor database
231
232
 
232
233
  **修正**: 拆分成个别提交。
233
234
 
234
- ### ❌ Subject 中包含实作細节
235
+ ### ❌ Subject 中包含实作细节
235
236
 
236
237
  ```
237
238
  fix: change line 45 from getUserById to getUserByEmail
238
239
  ```
239
240
 
240
- **修正**: 著重於目的,而非实作。
241
+ **修正**: 着重于目的,而非实作。
241
242
 
242
243
  ---
243
244
 
@@ -259,6 +260,6 @@ fix: change line 45 from getUserById to getUserByEmail
259
260
 
260
261
  ## 授权
261
262
 
262
- 本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
263
+ 本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
263
264
 
264
- **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
265
+ **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -2,81 +2,84 @@
2
2
  source: ../../../../skills/commit-standards/language-options.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-25
5
+ last_synced: 2026-10-11
6
+ source_hash: 36fc9d639905
6
7
  status: current
7
8
  ---
8
9
 
9
- # Commit Message 语言选项
10
+ # 输出语言选项
10
11
 
11
12
  > **语言**: [English](../../../../skills/commit-standards/language-options.md) | 简体中文
12
13
 
13
14
  **版本**: 1.0.0
14
- **最後更新**: 2025-12-24
15
- **適用範圍**: Claude Code Skills
15
+ **最后更新**: 2025-12-24
16
+ **适用范围**: Claude Code Skills
16
17
 
17
18
  ---
18
19
 
19
20
  ## 目的
20
21
 
21
- 本文件提供 commit message 类型的语言选项(英文、简体中文或雙語)。
22
+ 本文件提供 commit message 类型的语言选项(英文、繁体中文或双语)。
22
23
 
23
24
  ---
24
25
 
25
- ## 选项 A:英文(國际化)
26
+ ## 选项 A:英文(国际化)
26
27
 
27
- 適用於國际团队和最大化工具相容性。
28
+ 适用于国际团队和最大化工具相容性。
28
29
 
29
30
  | 类型 | 使用时机 |
30
31
  |------|----------|
31
32
  | `feat` | 新功能 |
32
- | `fix` | Bug 修復 |
33
- | `refactor` | 程序码重構 |
33
+ | `fix` | Bug 修复 |
34
+ | `refactor` | 程序码重构 |
34
35
  | `docs` | 文件更新 |
35
36
  | `style` | 格式化 |
36
37
  | `test` | 测试 |
37
38
  | `perf` | 效能改进 |
38
39
  | `build` | 建置系统 |
39
40
  | `ci` | CI/CD 变更 |
40
- | `chore` | 維護任务 |
41
+ | `chore` | 维护任务 |
41
42
  | `revert` | 回退提交 |
42
- | `security` | 安全修復 |
43
+ | `security` | 安全修复 |
43
44
 
44
- **範例**:
45
+ **范例**:
45
46
  ```
46
47
  feat(auth): Add OAuth2 Google login support
47
48
  ```
48
49
 
49
50
  ---
50
51
 
51
- ## 选项 B:简体中文(台灣团队)
52
+ ## 选项 B:繁体中文(台湾团队)
52
53
 
53
- 適用於偏好使用母語的本地团队。
54
+ 适用于偏好使用母语的本地团队。**类型维持英文**(与选项 A 同一份清单,commitlint 等工具才读得到);**主旨与正文使用繁体中文**。不可使用 `新增` 这类中文类型。
54
55
 
55
- | 类型 | 使用时机 | English |
56
+ | 类型 | 使用时机 | 范例 |
56
57
  |------|----------|------|
57
- | `新增` | 新功能 | feat |
58
- | `修正` | Bug 修復 | fix |
59
- | `重構` | 重構 | refactor |
60
- | `文件` | 文件更新 | docs |
61
- | `样式` | 格式化 | style |
62
- | `测试` | 测试 | test |
63
- | `效能` | 效能改进 | perf |
64
- | `建置` | 建置系统 | build |
65
- | `集成` | CI/CD | ci |
66
- | `維護` | 維護任务 | chore |
67
- | `回退` | 回退提交 | revert |
68
- | `安全` | 安全修復 | security |
69
-
70
- **範例**:
58
+ | `feat` | 新功能 | `feat(auth): 加入 OAuth2 登入` |
59
+ | `fix` | Bug 修復 | `fix(api): 處理空值回應` |
60
+ | `refactor` | 重構 | `refactor(core): 簡化驗證邏輯` |
61
+ | `docs` | 文件更新 | `docs(readme): 更新安裝指南` |
62
+ | `style` | 格式化 | `style(lint): 修正縮排` |
63
+ | `test` | 測試 | `test(auth): 新增登入單元測試` |
64
+ | `perf` | 效能改進 | `perf(query): 最佳化資料庫查詢` |
65
+ | `build` | 建置系統 | `build(deps): 升級 lodash` |
66
+ | `ci` | CI/CD | `ci(github): 新增覆蓋率工作流程` |
67
+ | `chore` | 維護任務 | `chore(deps): 更新開發相依套件` |
68
+ | `revert` | 回退提交 | `revert: feat(auth): 加入 OAuth2 登入` |
69
+ | `security` | 安全修復 | `security(auth): 修正 XSS 漏洞` |
70
+
71
+ **范例**:
71
72
  ```
72
- 新增(认证): 实作 OAuth2 Google 登入支援
73
+ feat(auth): 實作 OAuth2 Google 登入支援
73
74
  ```
74
75
 
76
+ > 旧版曾列出中文类型(`新增`、`修正`……)。迁移方式:改写成英文类型——`新增`→`feat`、`修正`→`fix`、`重構`→`refactor`、`文件`→`docs`、`樣式`→`style`、`測試`→`test`、`效能`→`perf`、`建置`→`build`、`整合`→`ci`、`維護`→`chore`、`回退`→`revert`、`安全`→`security`。
77
+
75
78
  ---
76
79
 
77
- ## 选项 C:雙語模式(雙語对照)
80
+ ## 选项 C:双语模式(双语对照)
78
81
 
79
- 使用英文 `type`/`scope` 以獲得工具相容性,搭配雙語 subject/body。
82
+ 使用英文 `type`/`scope` 以获得工具相容性,搭配双语 subject/body。
80
83
 
81
84
  **格式**:
82
85
  ```
@@ -89,7 +92,7 @@ feat(auth): Add OAuth2 Google login support
89
92
  <footer>
90
93
  ```
91
94
 
92
- **範例**:
95
+ **范例**:
93
96
  ```
94
97
  feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援。
95
98
 
@@ -114,18 +117,18 @@ Closes #123
114
117
 
115
118
  | 因素 | English | 中文 | Bilingual |
116
119
  |--------|---------|------|----------|
117
- | **团队** | 國际化 | 本地 | 混合 |
120
+ | **团队** | 国际化 | 本地 | 混合 |
118
121
  | **工具相容性** | ✅ 最佳 | ⚠️ 有限 | ✅ 良好 |
119
122
  | **Changelog 自动化** | ✅ 完整 | ⚠️ 需客制化 | ✅ 支援 |
120
- | **開源项目** | ✅ 推荐 | ❌ 不推荐 | ✅ 良好 |
123
+ | **开源项目** | ✅ 推荐 | ❌ 不推荐 | ✅ 良好 |
121
124
 
122
125
  ### 快速选择
123
126
 
124
- - **開源项目** → English(选项 A)
125
- - **本地团队、內部项目** → 中文(选项 B)
126
- - **本地团队但有國际协作** → Bilingual(选项 C)
127
+ - **开源项目** → English(选项 A)
128
+ - **本地团队、内部项目** → 中文(选项 B)
129
+ - **本地团队但有国际协作** → Bilingual(选项 C)
127
130
 
128
- **重要**: 一旦選定,請保持一致。不要混用语言。
131
+ **重要**: 一旦选定,请保持一致。不要混用语言。
129
132
 
130
133
  ---
131
134
 
@@ -134,18 +137,18 @@ Closes #123
134
137
  在 `CONTRIBUTING.md` 中记录你的选择:
135
138
 
136
139
  ```markdown
137
- ## Commit Message 语言
140
+ ## Output Language
138
141
 
139
- 本项目使用 **[English / 简体中文 / Bilingual]** commit 类型。
142
+ 本项目使用 **[English / 繁体中文 / Bilingual]** commit 类型。
140
143
 
141
- ### 允許的类型
144
+ ### 允许的类型
142
145
  [根据你的选择列出类型]
143
146
 
144
- ### 允許的範圍
145
- - auth: 认证模組
147
+ ### 允许的范围
148
+ - auth: 认证模组
146
149
  - api: API 层
147
150
  - ui: 使用者界面
148
- [新增项目特定的範圍]
151
+ [新增项目特定的范围]
149
152
  ```
150
153
 
151
154
  ---
@@ -167,6 +170,6 @@ Closes #123
167
170
 
168
171
  ## 授权
169
172
 
170
- 本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
173
+ 本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
171
174
 
172
- **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
175
+ **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -0,0 +1,289 @@
1
+ ---
2
+ name: comprehend
3
+ source: ../../../../skills/comprehension-ladder/SKILL.md
4
+ source_version: 1.0.0
5
+ translation_version: 1.0.0
6
+ last_synced: 2026-10-05
7
+ source_hash: 7c69dc2bfc9f
8
+ status: current
9
+ scope: universal
10
+ description: |
11
+ [UDS] 把一段难懂的 AI 输出换成较好懂的形式:受控文字、Mermaid 图、单文件 HTML 解说页。所有形式都来自同一份大纲,所以形式会变,事实不会变。
12
+ Use when: AI 的说明、规格或代码解说太密、读的人看不出该不该核准;非专业的人必须靠它做核准;想要它的图或离线解说页。
13
+ Not for: 写新内容或加新分析——本技能只把既有的文字换形式;从源代码产生文档——请用 /docgen;为专家读者缩短文字——直接改写即可。
14
+ Keywords: comprehension ladder, explainer, controlled language, Mermaid, HTML explainer, outline, plain language, understand AI output, 理解阶梯, 受控语言, 流程图, 解说页, 换形式不换事实.
15
+ allowed-tools: Read, Glob, Grep, Write
16
+ argument-hint: "[text or file | 原文或文件] [rungs: 1 | 2 | 3]"
17
+ ---
18
+
19
+ # 理解阶梯
20
+
21
+ > **语言**: [English](../../../../skills/comprehension-ladder/SKILL.md) | [繁體中文](../../../zh-TW/skills/comprehension-ladder/SKILL.md) | 简体中文
22
+
23
+ **版本**: 1.0.0 | **最后更新**: 2026-10-05 | **适用**: Claude Code Skills
24
+
25
+ 把一段难懂的 AI 输出换成较好懂的形式。形式会变,事实不会变。
26
+
27
+ ## 目的
28
+
29
+ 现在慢的不是拿到答案,而是看懂答案并判断它。本技能帮忙这一步。它拿一份原文,最多做出三种形式,每一种叫一「阶」。
30
+
31
+ 本技能的文字依 [ai-response-navigation](../../core/ai-response-navigation.md) 第 12 条(受控语言)写成。它自己也遵守自己的防护。
32
+
33
+ ## 阶梯
34
+
35
+ 阶梯正好有三阶。每一阶都从同一份大纲产生(见[大纲](#大纲))。任何一阶都不得在大纲之外加东西。
36
+
37
+ | 阶 | 形式 | 适合 | 产出 |
38
+ |----|------|------|------|
39
+ | 1 | 受控文字 | 任何原文。永远是第一阶 | 短句或编号列,放在对话或文件里 |
40
+ | 2 | Mermaid 图 | 有流程、先后顺序、多个角色,或 3 个以上选项的原文 | 一个 Mermaid 代码区块,外加一份画不出来的项目文字清单 |
41
+ | 3 | 单文件 HTML 解说页 | 需要探索或核准的读者 | 一个可离线打开的 `.html` 文件 |
42
+
43
+ 先问用户要哪几阶。用户没说,就先做第 1 阶,再提议另外两阶。
44
+
45
+ 没有视频阶。视频需要语音服务,而且会把原文送给第三方。
46
+
47
+ ## 三条防护
48
+
49
+ 这三条防护**必须**遵守。破坏任何一条的那一阶,就还没做完。不得交出去。
50
+
51
+ | 编号 | 防护 | 等级 |
52
+ |------|------|------|
53
+ | G1 | `no-new-facts`:不加原文没有的事实 | **必须(Required)** |
54
+ | G2 | `keep-hedges`:保留每一个不确定语气。不得把不确定的说法改成确定 | **必须(Required)** |
55
+ | G3 | `trace-and-gaps`:每一项都附「对应原文哪一段」与「没涵盖什么」 | **必须(Required)** |
56
+
57
+ G2 与 [ai-response-navigation](../../core/ai-response-navigation.md) 的 12.1 条是同一条规则。这里把它用在本技能的三阶。
58
+
59
+ ### G1 `no-new-facts`(必须)
60
+
61
+ 每一阶的每一个说法都必须来自原文。不要加原因、数字、名字、日期或「已确认」。不要加你知道、但原文没写的背景。
62
+
63
+ **正例**——原文写:「订单有时会在付款步骤失败。」
64
+
65
+ ```text
66
+ O1 订单有时会在付款步骤失败。
67
+ ```
68
+
69
+ **反例**——同一份原文:
70
+
71
+ ```text
72
+ O1 订单会在付款步骤失败。这也会让退款坏掉。
73
+ ```
74
+
75
+ 「退款」是添加的事实。「有时」也不见了,所以 G2 同时被破坏。
76
+
77
+ ### G2 `keep-hedges`(必须)
78
+
79
+ 不确定语气告诉读者,一个说法可以信到什么程度。例如:可能、推断、大概、尚未确认、might、could、probably。它是信息,不是赘字。
80
+
81
+ - 原文写「可能」,这一阶就写「可能」。
82
+ - 图里也要保留。不确定的项目用虚线画,标签里留下那个词。
83
+ - HTML 里也要保留。不确定的项目要显示看得见的「尚未确认」标记。
84
+ - 只有在原文自己说这个说法已经验证时,才可以拿掉不确定语气。这时要写出检查了什么。
85
+
86
+ **正例**——原文写:「原因可能是缓存留着旧的价目表。」
87
+
88
+ ```text
89
+ O2 原因可能是缓存留着旧的价目表。 [hedge: 可能]
90
+ ```
91
+
92
+ **反例**——同一份原文:
93
+
94
+ ```text
95
+ O2 原因是缓存留着旧的价目表。
96
+ ```
97
+
98
+ 反例比较短,也比较好读。但它与原文不符。读的人若凭这一行核准修复,就被误导了。
99
+
100
+ ### G3 `trace-and-gaps`(必须)
101
+
102
+ 每一项都带两个注记:
103
+
104
+ - **对应原文**:这一项出自原文的哪个位置。用段落与句子编号,或文件名与行号,再加一段 12 个词以内的引文(中文约 20 字以内)。
105
+ - **没涵盖**:这一项没说到什么,或它证明不了什么。原文没有更多内容时,写「原文没有更多内容」。
106
+
107
+ 最后一项之后,加一份清单,叫做**这份大纲没有收的部分**。它列出原文中所有没变成项目的部分。
108
+
109
+ **正例**
110
+
111
+ ```text
112
+ O3 我们尚未在测试环境重现这个问题。
113
+ 对应原文:第 1 段第 3 句——「尚未在测试环境重现」
114
+ 没涵盖:为什么没有重现。原文没有给理由。
115
+ ```
116
+
117
+ **反例**
118
+
119
+ ```text
120
+ O3 这个问题已在测试环境重现。
121
+ 对应原文:那份报告。
122
+ ```
123
+
124
+ 「那份报告」没有指向某个位置。这个说法也与原文相反。而且没有「没涵盖」注记。
125
+
126
+ ## 大纲
127
+
128
+ 大纲是唯一共享的事实来源。先做大纲,再做任何一阶。不要直接从原文写某一阶。
129
+
130
+ 每个大纲项目有一个编号和一个种类。
131
+
132
+ | 种类 | 意思 |
133
+ |------|------|
134
+ | `claim` | 原文提出的说法 |
135
+ | `mechanism` | 一个步骤、一个原因,或两件事之间的关联 |
136
+ | `uncertainty` | 原文说不知道或尚未确认的事 |
137
+ | `example` | 原文拿来说明某个说法的案例 |
138
+
139
+ 每个项目写成这个样子:
140
+
141
+ ```text
142
+ O<编号> | 种类 | 文字 | hedge: <原文的不确定用词,或 none>
143
+ 对应原文:<位置> — 「<引文,12 个词以内>」
144
+ 没涵盖:<这一项没说到的事>
145
+ ```
146
+
147
+ 依原文的顺序编号。编号不得重复使用。三阶都用同一组编号。
148
+
149
+ ## 工作流程
150
+
151
+ ### 步骤 1——读原文
152
+
153
+ 读完整份原文。原文是文件,就读那个文件。读完之前,不要开始做大纲。
154
+
155
+ ### 步骤 2——创建大纲
156
+
157
+ 抽出项目。一项一个事实。每个不确定用词都要原样抄下。
158
+
159
+ ### 步骤 3——为每一项标出处
160
+
161
+ 为每一项写「对应原文」与「没涵盖」。再写「这份大纲没有收的部分」清单。
162
+
163
+ ### 步骤 4——把大纲给用户看
164
+
165
+ 项目超过 5 个,或用户要求时,就把大纲给用户看。让用户删除或修正项目。用户否决的大纲,不要拿去做任何一阶。
166
+
167
+ ### 步骤 5——做出各阶
168
+
169
+ 用户要哪几阶,就做哪几阶。照下面各阶的规则做。
170
+
171
+ #### 第 1 阶:受控文字
172
+
173
+ 照 [ai-response-navigation](../../core/ai-response-navigation.md) 的 12.2 条:
174
+
175
+ - 一句一件事。英文约 15 到 25 个词,中文约 25 到 40 个字。
176
+ - 一物一名。不要为了文采换名称。
177
+ - 写清楚谁做什么。
178
+ - 一步一动作。流程写成编号列表。
179
+ - 少用分号。
180
+ - 数字要带单位。
181
+
182
+ 每一行开头保留项目编号,读的人才找得到它在大纲里的位置。
183
+
184
+ #### 第 2 阶:Mermaid 图
185
+
186
+ 1. 步骤与因果用 `flowchart TD`。角色与交接用 `flowchart LR`。
187
+ 2. 每个 `mechanism` 项目画一个节点。用项目编号当节点编号。
188
+ 3. 节点标签取自项目文字。标签里要留下不确定用词。
189
+ 4. 不确定的项目画成虚线节点或虚线边(`-.->`)。
190
+ 5. 不要画没有大纲编号的节点。
191
+ 6. 在图的下面,用文字列出你没有画的每一项,并各附一个理由。
192
+
193
+ ```mermaid
194
+ flowchart TD
195
+ O1["O1 订单有时在付款步骤失败"]
196
+ O2["O2 可能:缓存留着旧的价目表"]
197
+ O1 -.-> O2
198
+ ```
199
+
200
+ #### 第 3 阶:单文件 HTML 解说页
201
+
202
+ 页面必须是一个文件。必须能离线打开。不得从网络加载任何东西。
203
+
204
+ 页面**必须**符合:
205
+
206
+ - 所有 CSS 都放在一个 `<style>` 元素里。
207
+ - 所有脚本(若有)都放在一个内嵌的 `<script>` 元素里。关掉脚本,页面仍要能用。
208
+ - `src`、`href`、`action`、`@import`、`url()` 里不得有 `http://`、`https://` 或 `//` 开头的网址。只允许页内的 `#` 锚点链接。
209
+ - 不得有 `<link>` 元素。不得有网络字体、CDN 或外部图片。
210
+ - 不得调用 `fetch`、`XMLHttpRequest`、`WebSocket` 或 `import()`。
211
+ - 不要加载 Mermaid 函数库。把图画成内嵌 SVG,或画成有样式的清单。
212
+ - 原文中 HTML 会当成标记的字符,都要跳脱。
213
+
214
+ 页面依序包含:
215
+
216
+ 1. 标题,加一句话说明原文是什么。
217
+ 2. 图(若用户要了第 2 阶)。
218
+ 3. 每个大纲项目一张卡片。卡片显示编号、文字、有不确定语气时的「尚未确认」标记、对应原文,以及没涵盖注记。
219
+ 4. 「这份大纲没有收的部分」清单。
220
+
221
+ 最小骨架:
222
+
223
+ ```html
224
+ <!doctype html>
225
+ <html lang="zh-Hant">
226
+ <head>
227
+ <meta charset="utf-8">
228
+ <meta name="viewport" content="width=device-width, initial-scale=1">
229
+ <title>解说页:原文的简短名称</title>
230
+ <style>
231
+ body { font: 16px/1.6 system-ui, sans-serif; max-width: 46rem; margin: 2rem auto; padding: 0 1rem; }
232
+ .card { border: 1px solid #8884; border-radius: 8px; padding: .75rem 1rem; margin: .75rem 0; }
233
+ .badge { background: #fd0; color: #000; border-radius: 4px; padding: 0 .4rem; font-size: .85em; }
234
+ </style>
235
+ </head>
236
+ <body>
237
+ <h1>解说页</h1>
238
+ <p>一句话:原文是什么。</p>
239
+ <section class="card" id="O2">
240
+ <strong>O2</strong> 原因可能是缓存留着旧的价目表。
241
+ <span class="badge">尚未确认:可能</span>
242
+ <p><em>对应原文:</em>第 1 段第 2 句</p>
243
+ <p><em>没涵盖:</em>是哪一个缓存。原文没有说。</p>
244
+ </section>
245
+ </body>
246
+ </html>
247
+ ```
248
+
249
+ ### 步骤 6——交出之前先检查
250
+
251
+ 五项检查都要跑。有一项没过,就修好那一阶,再跑一次。
252
+
253
+ 1. **数量**:每一阶的项目数,等于大纲的项目数,减去你列为「没有画」的项目。原文有 5 个步骤,每一阶就是 5 个步骤。不是 4,也不是 6。
254
+ 2. **没有新项目**:每一阶的每个项目都有大纲编号。找找看有没有项目没有编号。
255
+ 3. **不确定语气比对**:`hedge:` 不是 `none` 的每一项,每一阶都要有同一个不确定用词。比对的是该阶与原文。任何语言都做得到。
256
+ 4. **出处**:每一项都有指向某个位置的「对应原文」,也有「没涵盖」注记。
257
+ 5. **离线**(只用于第 3 阶):在文件里搜索 `http`、`//`、`<link`、`fetch(` 与 `XMLHttpRequest`。每一项搜索,除了你从原文引用的文字,都必须是零命中。
258
+
259
+ ### 步骤 7——回报
260
+
261
+ 结尾放这张表。没有这张表,不要交出任何一阶。
262
+
263
+ | 项目 | 第 1 阶 | 第 2 阶 | 第 3 阶 | 保留不确定语气 | 对应原文 | 没涵盖 |
264
+ |------|---------|---------|---------|----------------|----------|--------|
265
+ | O1 | 有 | 有 | 有 | 不适用 | 第 1 段第 1 句 | 「有时」的频率 |
266
+
267
+ 有任何一项防护检查没过、又修不好,就说是哪一项、为什么。不要回报成功。
268
+
269
+ ## 什么时候不要用
270
+
271
+ - 原文不到约 150 字。用 [ai-response-navigation](../../core/ai-response-navigation.md) 的 12.2 条改写,并保留不确定语气。不要做各阶。
272
+ - 读者是专家,需要密度高的原形。
273
+ - 任务是找出新的事实。本技能不做这件事。
274
+
275
+ ## 衡量它有没有帮助
276
+
277
+ 本技能还没有被证明有帮助。[eval-cases.md](eval-cases.md) 有 5 段原文,各附理解题与标准答案,并附一套跑法,会产出两个数字:前后的答对率,以及防护违反次数。实跑需要模型调用,目前还没做。实跑完成之前,不要宣称本技能有效。
278
+
279
+ ## 相关
280
+
281
+ - [ai-response-navigation](../../core/ai-response-navigation.md):第 12 条,受控语言。12.1 条是防护 G2 的基础。
282
+ - [documentation-guide](../documentation-guide/SKILL.md):Mermaid 图在项目文档中该放哪里。
283
+ - [brainstorm-assistant](../brainstorm-assistant/SKILL.md):相反方向,还没有原文时用。
284
+
285
+ ## 版本历史
286
+
287
+ | 版本 | 日期 | 变更 |
288
+ |------|------|------|
289
+ | 1.0.0 | 2026-10-05 | 首次发布。从同一份大纲做出三阶。三条必须遵守的防护。评估案例。落实 dev-platform XSPEC-450 / DEC-125 D4。 |