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: ../../../../skills/documentation-guide/SKILL.md
3
3
  source_version: 2.1.0
4
4
  translation_version: 2.2.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: a23a49fa4b9c
6
7
  status: current
7
8
  description: |
8
9
  引导文档结构、内容需求与项目文档的最佳实践。
@@ -11,120 +12,152 @@ description: |
11
12
  Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文档, 说明文档, 技术文档.
12
13
  ---
13
14
 
14
- # 文件指南
15
+ # 文档指南
15
16
 
16
17
  > **语言**: [English](../../../../skills/documentation-guide/SKILL.md) | 简体中文
17
18
 
18
19
  **版本**: 2.1.0
19
- **最後更新**: 2026-03-17
20
- **適用範圍**: Claude Code Skills
20
+ **最后更新**: 2026-03-17
21
+ **适用范围**: Claude Code Skills
21
22
 
22
23
  ---
23
24
 
24
25
  ## 目的
25
26
 
26
- 本 Skill 提供项目文件的全面指導,包括:
27
- - 文件结构和文件組織
28
- - 依项目类型的内容需求
29
- - 技術文件的撰写标准
30
- - 常見文件类型的範本
27
+ 本 Skill 提供项目文档的全面指导,包括:
28
+ - 文档结构和文件组织
29
+ - 按项目类型划分的内容需求
30
+ - 技术文档的撰写标准
31
+ - 常见文档类型的模板
31
32
 
32
33
  ---
33
34
 
34
- ## 快速參考(YAML 壓縮格式)
35
+ ## 快速参考(YAML 压缩格式)
35
36
 
36
37
  ```yaml
37
- # === 项目类型 → 文件需求 ===
38
+ # === 项目类型 → 文档需求 ===
38
39
  document_matrix:
39
40
  # README ARCH API DB DEPLOY MIGRATE ADR CHANGE CONTRIB
40
41
  new: [REQ, REQ, if_app, if_app, REQ, NO, REC, REQ, REC]
41
42
  refactor: [REQ, REQ, REQ, REQ, REQ, REQ, REQ, REQ, REC]
42
43
  migration: [REQ, REQ, REQ, REQ, REQ, REQ, REQ, REQ, REC]
43
44
  maintenance:[REQ, REC, REC, REC, REC, NO, if_app, REQ, if_app]
44
- # REQ=必要, REC=建议, if_app=如適用, NO=不需要
45
+ # REQ=必要, REC=建议, if_app=如适用, NO=不需要
45
46
 
46
- # === 文件金字塔 ===
47
+ # === 文档金字塔 ===
47
48
  pyramid:
48
- level_1: "README.md → 入口点,快速概覽"
49
+ level_1: "README.md → 入口点,快速概览"
49
50
  level_2: "ARCHITECTURE.md → 系统概述"
50
- level_3: "API.md, DATABASE.md, DEPLOYMENT.md → 技術細节"
51
+ level_3: "API.md, DATABASE.md, DEPLOYMENT.md → 技术细节"
51
52
  level_4: "ADR/, MIGRATION.md, CHANGELOG.md → 变更历史"
52
53
 
53
54
  # === 必要文件 ===
54
55
  root_files:
55
- README.md: {required: true, purpose: "项目概述、快速入門"}
56
- CONTRIBUTING.md: {required: "recommended", purpose: "貢獻指南"}
56
+ README.md: {required: true, purpose: "项目概述、快速入门"}
57
+ CONTRIBUTING.md: {required: "recommended", purpose: "贡献指南"}
57
58
  CHANGELOG.md: {required: "recommended", purpose: "版本历史"}
58
- LICENSE: {required: "for OSS", purpose: "授权信息"}
59
+ LICENSE: {required: "for OSS", purpose: "许可信息"}
59
60
 
60
61
  docs_structure:
61
- INDEX.md: "文件索引"
62
- ARCHITECTURE.md: "系统架構"
63
- API.md: "API 文件"
64
- DATABASE.md: "数据庫綱要"
62
+ INDEX.md: "文档索引"
63
+ ARCHITECTURE.md: "系统架构"
64
+ API.md: "API 文档"
65
+ DATABASE.md: "数据库 schema"
65
66
  DEPLOYMENT.md: "部署指南"
66
- MIGRATION.md: "迁移计画(如適用)"
67
- ADR/: "架構决策记录"
67
+ MIGRATION.md: "迁移计划(如适用)"
68
+ ADR/: "架构决策记录"
68
69
 
69
70
  # === 文件命名 ===
70
71
  naming:
71
72
  root: "UPPERCASE.md (README.md, CONTRIBUTING.md, CHANGELOG.md)"
72
73
  docs: "lowercase-kebab-case.md (getting-started.md, api-reference.md)"
73
74
 
74
- # === 品质标准 ===
75
+ # === 质量标准 ===
75
76
  quality:
76
77
  format:
77
78
  language: "英文(或项目指定)"
78
79
  encoding: "UTF-8"
79
- line_length: "建议 ≤120 字元"
80
- diagrams: "優先使用 Mermaid,其次 ASCII Art"
81
- links: "內部連結使用相对路徑"
80
+ line_length: "建议 ≤120 字符"
81
+ diagrams: "优先使用 Mermaid,其次 ASCII Art"
82
+ links: "内部链接使用相对路径"
82
83
  maintenance:
83
- sync: "程序码变更时更新文件"
84
- version: "頂部標示版本和日期"
85
- review: "文件变更納入程序码审查"
86
- periodic: "每季检查文件是否過时"
84
+ sync: "代码变更时更新文档"
85
+ version: "顶部标示版本和日期"
86
+ review: "文档纳入代码审查"
87
+ periodic: "每季度检查文档是否过时"
88
+
89
+ # === DIÁTAXIS 分类 ===
90
+ diataxis:
91
+ tutorial: "以学习为导向(getting-started.md)"
92
+ how_to: "以任务为导向(deployment.md, migration.md)"
93
+ reference: "以信息为导向(api-reference.md, CHANGELOG.md)"
94
+ explanation: "以理解为导向(architecture.md, ADR/)"
95
+ header: "加入 **Document Type**: Tutorial | How-to | Reference | Explanation"
96
+
97
+ # === LLM 发现 ===
98
+ llm_discovery:
99
+ llms_txt: "位于项目根目录、供 LLM 检索的结构化索引"
100
+ llms_full_txt: "可选的完整串接文档"
101
+ when: "公开项目、公开 API、使用 AI 工具的项目"
102
+
103
+ # === 质量指标 ===
104
+ quality_metrics:
105
+ leading: ["覆盖率 ≥90%", "新鲜度 ≤90 天", "链接健康度 100%", "示例有效性 100%"]
106
+ lagging: ["支持工单减少", "上手时间", "与文档相关的 PR 评论"]
107
+ tools: [markdown-link-check, lychee, remark-lint, vale, textstat]
108
+
109
+ # === ADR 增强 ===
110
+ adr_enhanced:
111
+ new_fields: [Date, Deciders, Drivers, "supersedes/superseded-by"]
112
+ lifecycle: "proposed → accepted → [deprecated | superseded]"
113
+ decision_matrix: "影响 × 可逆性 → 是否需要 ADR?"
114
+
115
+ # === 翻译友好 ===
116
+ translation_friendly:
117
+ rules: ["完整句子", "不用习语", "术语一致", "简单的主谓宾结构", "明确的指代"]
118
+ glossary: "维护 glossary.md 以保持术语一致"
119
+ status_tracking: "以 YAML frontmatter 记录 translation_status、source_version"
87
120
  ```
88
121
 
89
122
  ---
90
123
 
91
- ## 项目类型文件需求
124
+ ## 项目类型文档需求
92
125
 
93
- ### 文件需求矩陣
126
+ ### 文档需求矩阵
94
127
 
95
- | 文件 | 新项目 | 重構 | 迁移 | 維護 |
128
+ | 文档 | 新项目 | 重构 | 迁移 | 维护 |
96
129
  |------|:------:|:----:|:----:|:----:|
97
130
  | **README.md** | ✅ 必要 | ✅ 必要 | ✅ 必要 | ✅ 必要 |
98
131
  | **ARCHITECTURE.md** | ✅ 必要 | ✅ 必要 | ✅ 必要 | ⚪ 建议 |
99
- | **API.md** | ⚪ 如適用 | ✅ 必要 | ✅ 必要 | ⚪ 建议 |
100
- | **DATABASE.md** | ⚪ 如適用 | ✅ 必要 | ✅ 必要 | ⚪ 建议 |
132
+ | **API.md** | ⚪ 如适用 | ✅ 必要 | ✅ 必要 | ⚪ 建议 |
133
+ | **DATABASE.md** | ⚪ 如适用 | ✅ 必要 | ✅ 必要 | ⚪ 建议 |
101
134
  | **DEPLOYMENT.md** | ✅ 必要 | ✅ 必要 | ✅ 必要 | ⚪ 建议 |
102
135
  | **MIGRATION.md** | ❌ 不需要 | ✅ 必要 | ✅ 必要 | ❌ 不需要 |
103
- | **ADR/** | ⚪ 建议 | ✅ 必要 | ✅ 必要 | ⚪ 如適用 |
136
+ | **ADR/** | ⚪ 建议 | ✅ 必要 | ✅ 必要 | ⚪ 如适用 |
104
137
  | **CHANGELOG.md** | ✅ 必要 | ✅ 必要 | ✅ 必要 | ✅ 必要 |
105
138
 
106
- ### 项目类型快速參考
139
+ ### 项目类型快速参考
107
140
 
108
141
  ```
109
142
  🆕 新项目 → README + ARCHITECTURE + DEPLOYMENT + CHANGELOG
110
- 🔄 重構 → 所有文件 + MIGRATION + ADR(记录「为何重構」)
111
- 🚚 迁移 → 所有文件 + MIGRATION(核心文件)+ 数据验证
112
- 🔧 維護 → README + CHANGELOG(依变更範圍更新)
143
+ 🔄 重构 → 所有文档 + MIGRATION + ADR(记录“为何重构”)
144
+ 🚚 迁移 → 所有文档 + MIGRATION(核心文档)+ 数据验证
145
+ 🔧 维护 → README + CHANGELOG(依变更范围更新)
113
146
  ```
114
147
 
115
148
  ---
116
149
 
117
- ## 文件金字塔
150
+ ## 文档金字塔
118
151
 
119
152
  ```
120
153
  ┌─────────────┐
121
- │ README │ ← 入口点,快速概覽
154
+ │ README │ ← 入口点,快速概览
122
155
  ├─────────────┤
123
156
  ┌──┴─────────────┴──┐
124
157
  │ ARCHITECTURE │ ← 系统概述
125
158
  ├───────────────────┤
126
159
  ┌──┴───────────────────┴──┐
127
- │ API / DATABASE / DEPLOY │ ← 技術細节
160
+ │ API / DATABASE / DEPLOY │ ← 技术细节
128
161
  ├─────────────────────────┤
129
162
  ┌──┴─────────────────────────┴──┐
130
163
  │ ADR / MIGRATION / CHANGELOG │ ← 变更历史
@@ -133,97 +166,97 @@ quality:
133
166
 
134
167
  ---
135
168
 
136
- ## 文件範本(YAML 壓縮格式)
169
+ ## 文档模板(YAML 压缩格式)
137
170
 
138
171
  ```yaml
139
172
  # === README.md ===
140
173
  readme:
141
174
  minimum:
142
175
  - "# 项目名称"
143
- - "簡短的单行描述"
144
- - "## 安裝"
176
+ - "简短的单行描述"
177
+ - "## 安装"
145
178
  - "## 使用"
146
- - "## 授权"
179
+ - "## 许可"
147
180
  recommended:
148
181
  - "# 项目名称 + 徽章"
149
182
  - "## 功能(项目符号列表)"
150
- - "## 安裝"
151
- - "## 快速入門 / 使用"
152
- - "## 文件(連結至 docs/)"
153
- - "## 貢獻(連結至 CONTRIBUTING.md)"
154
- - "## 授权"
183
+ - "## 安装"
184
+ - "## 快速入门 / 使用"
185
+ - "## 文档(链接至 docs/)"
186
+ - "## 贡献(链接至 CONTRIBUTING.md)"
187
+ - "## 许可"
155
188
 
156
189
  # === ARCHITECTURE.md ===
157
190
  architecture:
158
191
  required:
159
- - system_overview: "目的、範圍、主要功能"
192
+ - system_overview: "目的、范围、主要功能"
160
193
  - architecture_diagram: "Mermaid 或 ASCII Art"
161
- - module_description: "職責、相依性"
194
+ - module_description: "职责、依赖"
162
195
  - technology_stack: "框架、语言、版本"
163
196
  - data_flow: "主要业务流程"
164
197
  recommended:
165
- - deployment_architecture: "生产環境拓撲"
166
- - design_decisions: "关鍵决策(或連結至 ADR)"
198
+ - deployment_architecture: "生产环境拓扑"
199
+ - design_decisions: "关键决策(或链接至 ADR)"
167
200
 
168
201
  # === API.md ===
169
202
  api:
170
203
  required:
171
- - api_overview: "版本、基礎 URL、身份验证"
172
- - authentication: "Token 取得、過期时间"
204
+ - api_overview: "版本、基础 URL、身份验证"
205
+ - authentication: "Token 获取、过期时间"
173
206
  - endpoint_list: "所有 API 端点"
174
207
  - endpoint_specs: "请求/响应格式"
175
208
  - error_codes: "错误码和说明"
176
209
  recommended:
177
- - code_examples: "常見语言的範例"
178
- - rate_limiting: "API 呼叫頻率限制"
210
+ - code_examples: "常见语言的示例"
211
+ - rate_limiting: "API 调用频率限制"
179
212
  endpoint_format: |
180
213
  ### POST /api/v1/resource
181
- **请求**: | 欄位 | 类型 | 必要 | 说明 |
182
- **响应**: | 欄位 | 类型 | 说明 |
214
+ **请求**: | 字段 | 类型 | 必要 | 说明 |
215
+ **响应**: | 字段 | 类型 | 说明 |
183
216
  **错误**: | 代码 | 说明 |
184
217
 
185
218
  # === DATABASE.md ===
186
219
  database:
187
220
  required:
188
- - db_overview: "类型、版本、連线信息"
221
+ - db_overview: "类型、版本、连接信息"
189
222
  - er_diagram: "实体关系图"
190
223
  - table_list: "所有数据表及用途"
191
- - table_specs: "欄位定義"
224
+ - table_specs: "字段定义"
192
225
  - index_docs: "索引策略"
193
226
  - migration_scripts: "脚本位置"
194
227
  recommended:
195
- - backup_strategy: "頻率、保留期限"
228
+ - backup_strategy: "频率、保留期限"
196
229
  table_format: |
197
230
  ### 数据表名称
198
- **欄位**: | 欄位 | 类型 | 可为空 | 预设值 | 说明 |
199
- **索引**: | 名称 | 欄位 | 类型 |
200
- **关联**: | 关联表 | 連接欄位 | 关系 |
231
+ **字段**: | 字段 | 类型 | 可为空 | 默认值 | 说明 |
232
+ **索引**: | 名称 | 字段 | 类型 |
233
+ **关联**: | 关联表 | 连接字段 | 关系 |
201
234
 
202
235
  # === DEPLOYMENT.md ===
203
236
  deployment:
204
237
  required:
205
- - environment_requirements: "硬体、软体、网络"
238
+ - environment_requirements: "硬件、软件、网络"
206
239
  - installation_steps: "详细流程"
207
- - configuration: "设置檔參數"
240
+ - configuration: "配置文件参数"
208
241
  - verification: "确认部署成功"
209
- - troubleshooting: "常見問題和解决方案"
242
+ - troubleshooting: "常见问题和解决方案"
210
243
  recommended:
211
- - monitoring: "健康检查、日誌位置"
212
- - scaling_guide: "水平/垂直擴展"
244
+ - monitoring: "健康检查、日志位置"
245
+ - scaling_guide: "水平/垂直扩展"
213
246
 
214
247
  # === MIGRATION.md ===
215
248
  migration:
216
249
  required:
217
- - overview: "目標、範圍、时程"
250
+ - overview: "目标、范围、时间表"
218
251
  - prerequisites: "必要准备工作"
219
252
  - migration_steps: "详细流程"
220
- - verification_checklist: "迁移後检查"
253
+ - verification_checklist: "迁移后检查"
221
254
  - rollback_plan: "失败时的步骤"
222
- - backward_compatibility: "API/数据庫相容性"
255
+ - backward_compatibility: "API/数据库兼容性"
223
256
  recommended:
224
257
  - partner_notification: "需通知的外部系统"
225
258
 
226
- # === ADR(架構决策记录)===
259
+ # === ADR(架构决策记录)===
227
260
  adr:
228
261
  filename: "NNN-kebab-case-title.md(例如:001-use-postgresql.md)"
229
262
  required:
@@ -231,9 +264,9 @@ adr:
231
264
  - status: "proposed | accepted | deprecated | superseded"
232
265
  - context: "为何需要此决策"
233
266
  - decision: "具体决策内容"
234
- - consequences: "影響(正面/負面)"
267
+ - consequences: "影响(正面/负面)"
235
268
  recommended:
236
- - alternatives: "考慮過的其他选项"
269
+ - alternatives: "考虑过的其他选项"
237
270
  ```
238
271
 
239
272
  ---
@@ -242,18 +275,18 @@ adr:
242
275
 
243
276
  ```
244
277
  project-root/
245
- ├── README.md # 项目入口文件
246
- ├── CONTRIBUTING.md # 貢獻指南
247
- ├── CHANGELOG.md # 变更日誌
248
- ├── LICENSE # 授权文件
249
- └── docs/ # 文件目录
250
- ├── INDEX.md # 文件索引
251
- ├── ARCHITECTURE.md # 架構文件
252
- ├── API.md # API 文件
253
- ├── DATABASE.md # 数据庫文件
254
- ├── DEPLOYMENT.md # 部署文件
255
- ├── MIGRATION.md # 迁移文件(如需要)
256
- └── ADR/ # 架構决策记录
278
+ ├── README.md # 项目入口文档
279
+ ├── CONTRIBUTING.md # 贡献指南
280
+ ├── CHANGELOG.md # 变更日志
281
+ ├── LICENSE # 许可文件
282
+ └── docs/ # 文档目录
283
+ ├── INDEX.md # 文档索引
284
+ ├── ARCHITECTURE.md # 架构文档
285
+ ├── API.md # API 文档
286
+ ├── DATABASE.md # 数据库文档
287
+ ├── DEPLOYMENT.md # 部署文档
288
+ ├── MIGRATION.md # 迁移文档(如需要)
289
+ └── ADR/ # 架构决策记录
257
290
  ├── 001-xxx.md
258
291
  └── ...
259
292
  ```
@@ -267,9 +300,9 @@ project-root/
267
300
  ```markdown
268
301
  # 项目名称
269
302
 
270
- 簡短的单行描述。
303
+ 简短的单行描述。
271
304
 
272
- ## 安裝
305
+ ## 安装
273
306
 
274
307
  ```bash
275
308
  npm install your-package
@@ -282,7 +315,7 @@ const lib = require('your-package');
282
315
  lib.doSomething();
283
316
  ```
284
317
 
285
- ## 授权
318
+ ## 许可
286
319
 
287
320
  MIT
288
321
  ```
@@ -290,23 +323,31 @@ MIT
290
323
  ### 建议的 README 章节
291
324
 
292
325
  1. **项目名称与描述**
293
- 2. **徽章**(CI 状态、覆蓋率、npm 版本)
326
+ 2. **徽章**(CI 状态、覆盖率、npm 版本)
294
327
  3. **功能**(项目符号列表)
295
- 4. **安裝**
296
- 5. **快速入門 / 使用**
297
- 6. **文件**(連結至 docs/)
298
- 7. **貢獻**(連結至 CONTRIBUTING.md)
299
- 8. **授权**
328
+ 4. **安装**
329
+ 5. **快速入门 / 使用**
330
+ 6. **文档**(链接至 docs/)
331
+ 7. **贡献**(链接至 CONTRIBUTING.md)
332
+ 8. **许可**
300
333
 
301
334
  ---
302
335
 
303
- ## ADR 範本
336
+ ## ADR 模板
304
337
 
305
338
  ```markdown
306
- # ADR-001: [决策標題]
339
+ # ADR-001: [决策标题]
307
340
 
308
- ## 状态
309
- 已接受
341
+ **日期**: YYYY-MM-DD
342
+ **状态**: proposed | accepted | deprecated | superseded
343
+ **决策者**: [参与人员列表]
344
+ **取代**: ADR-NNN(如适用)
345
+ **被取代于**: ADR-NNN(如适用)
346
+
347
+ ## 驱动因素
348
+
349
+ - [关键因素 1]
350
+ - [关键因素 2]
310
351
 
311
352
  ## 背景
312
353
  [为何需要此决策...]
@@ -314,71 +355,80 @@ MIT
314
355
  ## 决策
315
356
  [具体决策内容...]
316
357
 
317
- ## 影響
358
+ ## 影响
318
359
 
319
360
  ### 正面
320
361
  - 好处 1
321
362
  - 好处 2
322
363
 
323
- ### 負面
364
+ ### 负面
324
365
  - 缺点 1
325
366
  - 缺点 2
326
367
 
327
- ## 考慮過的替代方案
328
- 1. 方案 A - 因为...而被拒絕
329
- 2. 方案 B - 因为...而被拒絕
368
+ ## 考虑过的替代方案
369
+
370
+ ### 方案 A:[名称]
371
+ - **优点**: ...
372
+ - **缺点**: ...
373
+ - **否决原因**: ...
330
374
  ```
331
375
 
376
+ **何时撰写 ADR**(影响 × 可逆性):
377
+ - **高影响 + 难以逆转** → 必须撰写 ADR
378
+ - **高影响 + 容易逆转** → 可选
379
+ - **低影响 + 难以逆转** → 可选
380
+ - **低影响 + 容易逆转** → 不需要 ADR
381
+
332
382
  ---
333
383
 
334
- ## 文件稽核检查清单
384
+ ## 文档审计检查清单
335
385
 
336
- 审查项目文件时:
386
+ 审查项目文档时:
337
387
 
338
388
  ```
339
389
  □ README.md 存在且包含必要章节
340
- □ 安裝说明清楚且經過测试
341
- □ 使用範例已提供且可运作
342
- □ 已指定授权
343
- □ ARCHITECTURE.md 存在(非簡单项目)
390
+ □ 安装说明清楚且经过测试
391
+ □ 使用示例已提供且可运行
392
+ □ 已指定许可
393
+ □ ARCHITECTURE.md 存在(非简单项目)
344
394
  □ API.md 存在(如有暴露 API)
345
- □ DATABASE.md 存在(如使用数据庫)
395
+ □ DATABASE.md 存在(如使用数据库)
346
396
  □ DEPLOYMENT.md 存在(已部署的项目)
347
- □ ADR/ 存在於重大决策
397
+ □ 重大决策有对应的 ADR/
348
398
  □ CHANGELOG.md 遵循 Keep a Changelog 格式
349
- □ 所有內部連結正常运作
399
+ □ 所有内部链接正常
350
400
  □ 图表是最新的
351
- □ 無過时信息
401
+ □ 无过时信息
352
402
  ```
353
403
 
354
404
  ---
355
405
 
356
- ## 配置偵测
406
+ ## 配置检测
357
407
 
358
- ### 偵测順序
408
+ ### 检测顺序
359
409
 
360
- 1. 检查 `CONTRIBUTING.md` 中的「停用 Skills」區段
361
- 2. 检查 `CONTRIBUTING.md` 中的「文件语言」區段
362
- 3. 检查現有文件结构
363
- 4. 若未找到,**预设为英文**
410
+ 1. 检查 `CONTRIBUTING.md` 中的“Disabled Skills”区段
411
+ 2. 检查 `CONTRIBUTING.md` 中的“Documentation Language”区段
412
+ 3. 检查现有文档结构
413
+ 4. 若未找到,**默认为英文**
364
414
 
365
415
  ### 首次设置
366
416
 
367
- 如果缺少文件:
417
+ 如果缺少文档:
368
418
 
369
- 1. 詢問:「此项目没有完整的文件。应該使用哪种语言?(English / 中文)」
370
- 2. 判斷项目类型(新项目/重構/迁移/維護)
371
- 3. 依矩陣建立必要文件
419
+ 1. 询问:“此项目没有完整的文档。应该使用哪种语言?(English / 中文)”
420
+ 2. 判断项目类型(新项目/重构/迁移/维护)
421
+ 3. 依矩阵创建必要文档
372
422
  4. 建议在 `CONTRIBUTING.md` 中记录:
373
423
 
374
424
  ```markdown
375
- ## 文件标准
425
+ ## 文档标准
376
426
 
377
427
  ### 语言
378
- 此项目使用 **英文** 作为文件语言。
428
+ 此项目使用 **英文** 作为文档语言。
379
429
 
380
- ### 必要文件
381
- 根据项目类型,我們維護:
430
+ ### 必要文档
431
+ 根据项目类型,我们维护:
382
432
  - README.md
383
433
  - ARCHITECTURE.md
384
434
  - DEPLOYMENT.md
@@ -389,70 +439,45 @@ MIT
389
439
 
390
440
  ## 详细指南
391
441
 
392
- 完整标准請參阅:
393
- - [文件撰写标准](../../../../core/documentation-writing-standards.md)
394
- - [文件结构标准](../../../../core/documentation-structure.md)
395
- - [README 範本](./readme-template.md)
396
-
397
- ---
398
-
399
- ## 相关标准
400
-
401
- - [文件撰写标准](../../../../core/documentation-writing-standards.md) - 内容需求
402
- - [文件结构标准](../../../../core/documentation-structure.md) - 文件組織
403
- - [变更日誌标准](../../../../core/changelog-standards.md) - CHANGELOG 格式
404
- - [变更日誌指南技能](../changelog-guide/SKILL.md) - CHANGELOG 技能
405
-
406
- ---
407
-
408
- ## 版本历史
409
-
410
- | 版本 | 日期 | 变更 |
411
- |------|------|------|
412
- | 2.0.0 | 2026-01-12 | 新增:项目类型矩陣、文件範本、文件金字塔 |
413
- | 1.0.0 | 2025-12-24 | 初始版本 |
442
+ 完整标准请参阅:
443
+ - [文档撰写标准](../../../../core/documentation-writing-standards.md)
444
+ - [文档结构标准](../../../../core/documentation-structure.md)
445
+ - [README 模板](./readme-template.md)
414
446
 
415
447
  ---
416
448
 
417
- ## 授权
418
-
419
- 本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
420
-
421
- **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
422
-
449
+ ## 下一步引导
423
450
 
424
- ## Next Steps Guidance | 下一步引導
451
+ `/docs-guide` 完成后,AI 助手应建议:
425
452
 
426
- After `/docs-guide` completes, the AI assistant should suggest:
427
-
428
- > **文件結構與需求已釐清。建議下一步 / Documentation structure and requirements clarified. Suggested next steps:**
429
- > - 執行 `/docs` 根據指南直接產生專案文件 ⭐ **Recommended / 推薦** — 立即將文件指南化為行動 / Turn documentation guidelines into action immediately
430
- > - 執行 `/changelog` 建立或更新 CHANGELOG.md — 確保變更歷史完整 / Ensure change history is complete
431
- > - 執行 `/sdd` 將文件需求納入規格驅動開發 — 確保文件與功能同步 / Ensure docs stay in sync with features
453
+ > **文档结构与需求已厘清。建议下一步:**
454
+ > - 执行 `/docs` 根据指南直接生成项目文档 ⭐ **推荐** — 立即将文档指南化为行动
455
+ > - 执行 `/changelog` 创建或更新 CHANGELOG.md — 确保变更历史完整
456
+ > - 执行 `/sdd` 将文档需求纳入规格驱动开发 — 确保文档与功能同步
432
457
 
433
458
  ---
434
459
 
435
- ## Related Standards
460
+ ## 相关标准
436
461
 
437
- - [Documentation Writing Standards](../../core/documentation-writing-standards.md) - Content requirements
438
- - [Documentation Structure](../../core/documentation-structure.md) - File organization
439
- - [Changelog Standards](../../core/changelog-standards.md) - CHANGELOG format
440
- - [Changelog Guide Skill](../changelog-guide/SKILL.md) - CHANGELOG skill
462
+ - [文档撰写标准](../../../../core/documentation-writing-standards.md) - 内容需求
463
+ - [文档结构标准](../../../../core/documentation-structure.md) - 文件组织
464
+ - [变更日志标准](../../../../core/changelog-standards.md) - CHANGELOG 格式
465
+ - [变更日志指南技能](../changelog-guide/SKILL.md) - CHANGELOG 技能
441
466
 
442
467
  ---
443
468
 
444
- ## Version History
469
+ ## 版本历史
445
470
 
446
- | Version | Date | Changes |
447
- |---------|------|---------|
448
- | 2.1.0 | 2026-03-17 | Added: Diátaxis classification, LLM discovery, quality metrics, enhanced ADR template, translation-friendly writing |
449
- | 2.0.0 | 2026-01-12 | Added: Project type matrix, document templates, documentation pyramid |
450
- | 1.0.0 | 2025-12-24 | Initial release |
471
+ | 版本 | 日期 | 变更 |
472
+ |------|------|------|
473
+ | 2.1.0 | 2026-03-17 | 新增:Diátaxis 分类、LLM 发现、质量指标、增强版 ADR 模板、翻译友好写作 |
474
+ | 2.0.0 | 2026-01-12 | 新增:项目类型矩阵、文档模板、文档金字塔 |
475
+ | 1.0.0 | 2025-12-24 | 初始版本 |
451
476
 
452
477
  ---
453
478
 
454
- ## License
479
+ ## 许可
455
480
 
456
- This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
481
+ 本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
457
482
 
458
- **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
483
+ **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)