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,36 +2,39 @@
2
2
  source: ../../../core/ai-instruction-standards.md
3
3
  source_version: 1.1.1
4
4
  translation_version: 1.1.1
5
- last_synced: 2026-08-19
5
+ last_synced: 2026-10-11
6
+ source_hash: 64bcd0b65483
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # AI 指令文件规范
10
11
 
11
- > **语言**: [English](../../../core/ai-instruction-standards.md) | [简体中文](../../zh-TW/core/ai-instruction-standards.md) | 简体中文
12
+ > **语言**: [English](../../../core/ai-instruction-standards.md) | [繁體中文](../../zh-TW/core/ai-instruction-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.1.0
14
- **最后更新**: 2026-05-28
14
+ **版本**: 1.1.1
15
+ **最后更新**: 2026-08-19
15
16
  **适用范围**: 所有使用 AI 编码助手的项目
17
+ **范围**: partial
18
+ **行业标准**: 无(新兴 AI 工具实践)
16
19
 
17
20
  ---
18
21
 
19
22
  ## 目的
20
23
 
21
- 本规范定义创建和维护 AI 指令文件(又称「系统提示词文件」)的最佳实践。这些文件引导 AI 助手理解项目特定的惯例、标准和工作流程。
24
+ 本规范定义创建和维护 AI 指令文件(又称「系统提示词文件」)的最佳实践。这些文件引导 AI 助手理解项目特定的惯例、标准和工作流程。v1.1.0 将范围扩展到 skill 层级的指令文件(SKILL.md),并新增 i18n 策略。
22
25
 
23
26
  ---
24
27
 
25
28
  ## 支持的 AI 工具
26
29
 
27
- | AI 工具 | 指令文件 | 格式 |
28
- |---------|---------|------|
29
- | Claude Code | `CLAUDE.md` | Markdown |
30
- | Cursor | `.cursorrules` | Markdown |
31
- | Windsurf | `.windsurfrules` | Markdown |
32
- | Cline | `.clinerules` | Markdown |
33
- | GitHub Copilot | `.github/copilot-instructions.md` | Markdown |
34
- | OpenCode | `.opencode/instructions.md` | Markdown |
30
+ | AI 工具 | 指令文件 | 格式 | Skill 层级指令 |
31
+ |---------|---------|------|---------------|
32
+ | Claude Code | `CLAUDE.md` | Markdown | `.claude/skills/{name}/SKILL.md` |
33
+ | Cursor | `.cursorrules` | Markdown | n/a |
34
+ | Windsurf | `.windsurfrules` | Markdown | n/a |
35
+ | Cline | `.clinerules` | Markdown | n/a |
36
+ | GitHub Copilot | `.github/copilot-instructions.md` | Markdown | n/a |
37
+ | OpenCode | `.opencode/instructions.md` | Markdown | n/a |
35
38
 
36
39
  ---
37
40
 
@@ -173,85 +176,104 @@ AI 指令档常需提供多语言版本——既为了国际采用者,也为
173
176
  | 层 | 内容 | Canonical (en) | Locale ({lang}) | 为何分这层 |
174
177
  |----|------|---------------|----------------|-----------|
175
178
  | **L1 — Metadata** | YAML frontmatter `description`、`argument-hint`、`allowed-tools` | **必须英文** | **必须对应 locale 语言** | AI 触发讯号;英文 token 效率最高 + 训练语料密度高 |
176
- | **L2 — 指令(Instructions)** | 对 AI 的命令式规则 | **必须英文** | 对应 locale 语言(可选;可保留英文)| AI 读英文指令最精准 |
177
- | **L3 — 输出范本(Output Templates)** | 范例输出、回应格式、情境范本 | 英文(canonical 锁定英文)| **强制对应 locale**(mandatory)| **唯一直接影响 AI 输出语言的层** |
178
- | **L4 — 人类文件** | 维护者注解、贡献者说明 | 英文 | 对应 locale 语言(强烈建议)| 给人类维护者读,AI 不读 |
179
+ | **L2 — 指令(Instructions)** | 对 AI 的命令式规则(步骤、行为、allowed-tools 的理由) | **必须英文** | 对应 locale 语言(可选;可保留英文)| AI 读英文指令最精准;只有维护者需要以自己的语言阅读指令时,locale 版才有用 |
180
+ | **L3 — 输出范本(Output Templates)** | 范例输出、回应格式、情境范本 | 英文(canonical 锁定英文)| **强制对应 locale**(mandatory)| **唯一直接影响 AI 输出语言的层**——AI 会沿用它看到的范本语言 |
181
+ | **L4 — 人类文件** | 维护者注解、操作说明、贡献者说明 | 英文 | 对应 locale 语言(强烈建议)| 给人类维护者读,AI 不读 |
179
182
 
180
- **关键 insight**:L1(description)是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3(output template)才是控制 AI 输出语言的唯一开关。**i18n 强制检查应该聚焦在 L3——加强 L1 的强制是常见错误。**
183
+ **关键 insight**:L1(description)是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3(output template)才是控制 AI 输出语言的唯一开关,因为 AI 会模仿它看到的范本语言。**i18n 强制检查应该聚焦在 L3——加强 L1 的强制是常见错误,解决的是错的问题。**
181
184
 
182
185
  ### Canonical / Locale 档案结构
183
186
 
184
187
  UDS 标准与 skill 的 locale 变体结构:
185
188
 
186
189
  ```text
187
- core/{name}.md
188
- core/{name}.ai.yaml
189
- locales/{lang}/core/{name}.md
190
- locales/{lang}/ai/standards/{name}.ai.yaml
191
- skills/{name}/SKILL.md
192
- locales/{lang}/skills/{name}/SKILL.md
190
+ core/{name}.md ← canonical (English) — single source of truth
191
+ core/{name}.ai.yaml ← canonical structured (English)
192
+ locales/{lang}/core/{name}.md ← locale variant (matches lang)
193
+ locales/{lang}/ai/standards/{name}.ai.yaml ← locale .ai.yaml (matches lang)
194
+ skills/{name}/SKILL.md ← canonical skill (English)
195
+ locales/{lang}/skills/{name}/SKILL.md ← locale skill variant
193
196
  ```
194
197
 
195
198
  **命名惯例**:使用 BCP 47 语言标签——`zh-TW`、`zh-CN`、`ja`、`ko`、`en-US` 等。
196
199
 
197
200
  ### Locale 变体 Frontmatter 必填栏位
198
201
 
202
+ 每个 locale 变体都必须带有可追溯的 frontmatter,才能侦测漂移:
203
+
199
204
  ```yaml
200
205
  ---
201
- name: {与 canonical 同名}
202
- source: {指回 canonical 的相对路径}
203
- source_version: {翻译时 canonical 的版本}
204
- translation_version: {本翻译的版本}
206
+ name: {same name as canonical}
207
+ source: {relative path back to canonical}
208
+ source_version: {version of canonical at time of translation}
209
+ translation_version: {version of this translation}
205
210
  ---
206
211
  ```
207
212
 
208
- `source_version` 落后超过 2 个 minor 版本会触发 drift 警告。
213
+ canonical 更新(bump `source_version`)时,locale 维护者应重新同步并 bump `translation_version`。`source_version` 落后超过 2 个 minor 版本会触发 drift 警告(见「Chimera 防范」)。
209
214
 
210
215
  ### 责任边界
211
216
 
212
217
  | 角色 | 拥有 | 必须做 |
213
218
  |------|------|--------|
214
- | **Canonical 拥有者** | `core/{name}.md` 等 | 维持 L1/L2/L3/L4 为英文;breaking change 时 bump `source_version` |
215
- | **Locale 维护者** | `locales/{lang}/...` | `translation_version` 对齐 `source_version`;翻译 L1(必)、L2(选)、L3(必)、L4(建议)|
216
- | **采用者** | 自己的 `.claude/skills/`、`CLAUDE.md` | 用 `uds init --locale {lang}`(首次)或 `uds update --locale {lang}`(重新同步)安装;**绝不**手动修改 canonical |
219
+ | **Canonical 拥有者** | `core/{name}.md`、`core/{name}.ai.yaml`、`skills/{name}/SKILL.md` | 维持 L1/L2/L3/L4 为英文;每次 breaking change 都 bump `source_version` |
220
+ | **Locale 维护者** | `locales/{lang}/...` 档案 | `translation_version` 对齐 `source_version`;翻译 L1(必)、L2(选)、L3(必)、L4(建议)|
221
+ | **采用者(下游项目)** | 自己的 `.claude/skills/`、`CLAUDE.md` 等 | 用 `uds init --locale {lang}`(首次)或 `uds update --locale {lang}`(重新同步)安装;**绝不**手动修改 canonical 档案(一律编辑 locale 变体或使用 overlay)|
217
222
 
218
223
  ### Chimera 防范
219
224
 
225
+ **Chimera** 指违反分层规则、混用语言的档案。常见的 chimera 模式:
226
+
220
227
  | 模式 | 严重度 | 侦测方式 |
221
228
  |------|--------|----------|
222
- | Canonical 的 `description` 含 CJK | ❌ Error | Lint |
223
- | Locale 变体的 `description` 是纯 ASCII | ❌ Error | Lint |
224
- | Locale 变体缺 `source:` frontmatter | ❌ Error | Lint |
225
- | Canonical L3 含非英文范例 | ⚠️ Warn | Lint |
226
- | 采用者档案与 canonical/locale 都不同 | ⚠️ Warn | Sync check |
227
- | `translation_version` 落后过多 | ⚠️ Warn | Drift check |
229
+ | Canonical 的 `description` 栏位含 CJK | ❌ Error | Lint: `canonical:description-must-be-ascii` |
230
+ | Locale 变体的 `description` 栏位是纯 ASCII | ❌ Error | Lint: `locale:description-must-match-language` |
231
+ | Locale 变体缺 `source:` frontmatter | ❌ Error | Lint: `locale:must-have-source-frontmatter` |
232
+ | Canonical L3 输出范本含非英文范例回应 | ⚠️ Warn | Lint: `canonical:l3-language-consistency` |
233
+ | `.claude/skills/` 中的采用者档案与 canonical 及任何 locale 变体都不同 | ⚠️ Warn | Sync check: `adopter:must-match-installed-locale` |
234
+ | `translation_version` 落后 `source_version` 超过 2 个 minor 版本 | ⚠️ Warn | Drift check |
235
+
236
+ Pre-commit / CI lint 应强制执行 error 级规则;warn 级规则显示在仪表板上,但不阻断。
228
237
 
229
238
  ### 采用者安装
230
239
 
240
+ 采用者通过 UDS CLI 安装指令档:
241
+
231
242
  ```bash
232
- uds init --locale zh-cn # 首次以简体中文安装 skills 与 standards
233
- uds update --locale zh-cn # 对既有采用重新同步
243
+ uds init --locale zh-tw # first-time install of skills + standards in Traditional Chinese
244
+ uds update --locale zh-tw # re-sync an existing adoption
234
245
  ```
235
246
 
236
- **Locale 解析优先顺序**:`--locale` flag > `.uds/install.yaml` > `UDS_LOCALE` env > fallback `en`
247
+ **Locale 解析优先顺序**:
248
+ 1. `--locale` CLI flag(最高优先)
249
+ 2. `.uds/install.yaml` 的 `locale:` 栏位
250
+ 3. 环境变量 `UDS_LOCALE`
251
+ 4. Fallback:`en`
252
+
253
+ **Locale 不存在时的 fallback**:某个 skill 没有所请求的 locale 变体时,CLI 会:
254
+ - 安装 canonical(英文)档案
255
+ - 发出 WARN,列出改用 fallback 的 skills
256
+ - **不**阻断安装
237
257
 
238
- Locale 不存在时 fallback 到 canonical + WARN,**不**阻断安装。
258
+ 这让 locale 覆盖不完整时,采用者仍能正常安装。采用者可查阅 `locales/COVERAGE.md`,取得哪些已翻译、哪些未翻译的权威清单。
239
259
 
240
260
  ### 迁移:已有 chimera 的采用者
241
261
 
242
- 1. **辨识 chimera**:比对采用者档案与 UDS canonical / locale 变体
243
- 2. **安装正确变体**:`uds update --locale {lang}`
244
- 3. **保留专案级客制**:抽出为 overlay
245
- 4. **丢弃纯翻译**:locale 变体取代之
262
+ 若采用者已在自己的项目中手动修改过 canonical 档案(例如翻译了 `.claude/skills/` 里的 description):
263
+
264
+ 1. **辨识 chimera**:比对采用者档案与 UDS canonical 及 canonical 的 locale 变体。
265
+ 2. **安装正确变体**:执行 `uds update --locale {lang}`,以 locale 变体取代 chimera 档案。
266
+ 3. **保留项目级客制**:若 chimera 含有正当的项目级客制(不只是翻译),将其抽出为 overlay,或记录在采用者的客制化纪录中(例如 `UDS-CUSTOMIZATION.md`)。
267
+ 4. **丢弃纯翻译**:只是翻译的 chimera 变更应丢弃——正确的 locale 变体会取代它们。
246
268
 
247
269
  ### 快速参考
248
270
 
249
271
  | 动作 | 何时 | 工具 / 档案 |
250
272
  |------|------|------------|
251
- | 新增语言支援 | 想支援新 locale | `locales/{lang}/...` |
252
- | 更新 canonical | 改进英文 source | Bump `source_version` |
253
- | 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version` |
254
- | 检查覆盖率 | 定期 review | `locales/COVERAGE.md` |
273
+ | 新增语言支援 | 想支援新 locale | 建立 `locales/{lang}/...`,镜射 canonical 结构 |
274
+ | 更新 canonical | 改进英文 source | Bump `source_version`;通知 locale 维护者 |
275
+ | 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version`;引用当前的 `source_version` |
276
+ | 检查覆盖率 | 定期 review | 查看自动产生的 `locales/COVERAGE.md` |
255
277
  | 带 locale 安装 | 采用者初设 | `uds init --locale {lang}` |
256
278
  | 带 locale 重新同步 | 既有采用 | `uds update --locale {lang}` |
257
279
  | 跑 i18n lint | Commit 前 / CI | `uds check --i18n` |
@@ -1,8 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/ai-response-navigation.md
3
- source_version: 1.3.0
4
- translation_version: 1.3.0
5
- last_synced: 2026-08-17
3
+ source_version: 1.4.0
4
+ translation_version: 1.4.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 1439c64bce23
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,8 +11,8 @@ status: current
10
11
 
11
12
  > **语言**: [English](../../../core/ai-response-navigation.md) | [繁體中文](../../zh-TW/core/ai-response-navigation.md) | 简体中文
12
13
 
13
- **版本**: 1.3.0
14
- **最后更新**: 2026-08-17
14
+ **版本**: 1.4.0
15
+ **最后更新**: 2026-10-05
15
16
  **适用范围**: 所有使用 AI 辅助开发的项目
16
17
  **范围**: universal
17
18
  **行业标准**: 无(新兴 AI 工具实践)
@@ -27,10 +28,13 @@ status: current
27
28
 
28
29
  **解决方案**:在每个实质性 AI 响应结尾附加标准化的「导航区块」,包含情境模板、推荐标记和弹性选项数量。
29
30
 
30
- **范围注记(v1.2.0,v1.3.0 扩充)**:规则 1–6 管的是答案**之后**要附什么。
31
- 规则 7–11 **全部属可选**,管的是答案本身:先讲发现(R7)、每轮重述进度(R8)、不要开场白(R9)、
32
- 白话是主语(R10)、每个选项都要带自己的利弊而非只有推荐项有(R11)。新增的理由是——
33
- 一个响应可以满足规则 1–6 的每一条,同时把结论埋起来;
31
+ **范围注记(v1.2.0,v1.3.0、v1.4.0 扩充)**:规则 1–6 管的是答案**之后**要附什么。
32
+ 规则 7–12 管的是答案本身:先讲发现(R7)、每轮重述进度(R8)、不要开场白(R9)、
33
+ 白话是主语(R10)、每个选项都要带自己的利弊而非只有推荐项有(R11)、受控语言(R12)。
34
+ 规则 7–11 **属可选**。**规则 12 是唯一的例外,而且只有一部分**:其中「简化后的文字要保留写作者的不确定语气」
35
+ 这一条**属必须**,其余部分属可选。新增的理由是——
36
+ 一个响应可以满足规则 1–6 的每一条,同时把结论埋起来、用只有作者持有的词汇讲它、列出读者还得自己比较的选项,
37
+ 或是靠「比证据更肯定」来变得好读;
34
38
  **而找不到答案的读者,不会因为结尾有一个正确的导航区块被告知下一步而得到帮助。**
35
39
 
36
40
  ---
@@ -109,11 +113,13 @@ status: current
109
113
 
110
114
  ---
111
115
 
112
- ## 导航之前的那个答案(规则 7–11,可选)
116
+ ## 导航之前的那个答案(规则 7–12)
113
117
 
114
118
  > **规则 7–9 借鉴自**:[`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)(MIT),十条中取三条。
115
119
  > **规则 10–11 于 1.3.0 新增**,来源不同——用户在同一次工作会话中两度指出,
116
120
  > 一个正确且完整的回答读不懂。当时规则 7–9 已经出货且正在被遵守。
121
+ > **规则 12 于 1.4.0 新增**,来源又不同:一则公开的建议——请 LLM 写到「大约达到 ASD-STE100 的 80%」
122
+ > (ASD-STE100 是技术文档用的受控英文标准)。只取它的原则;它的英文词典与时态规则不取(见规则 12)。
117
123
  > 其余七条删去:两条已被上方规则 1–2 涵盖,五条与本标准冲突
118
124
  > (它的「不要 recap/不要结语」与规则 1 的导航区块直接矛盾;它的「列表上限 5 项」
119
125
  > 会截断证据表格与遍历分母)或与 [estimation-standards](estimation-standards.md) 重复。
@@ -122,8 +128,9 @@ status: current
122
128
  一个响应可以把结论埋在一整面证据底下,只要结尾附上正确的导航区块,
123
129
  它仍然满足本标准的每一条。**找不到答案的读者,不会因为被告知下一步而得到帮助。**
124
130
 
125
- **这五条是可选的**,语义同规则 6:采用项目不必启用,既有 skill 也不需回头补。
126
- 项目**可以**在自己的配置中把任一条提升为必须。**不可选的是它们必须有精确的触发条件**——
131
+ **规则 7–11 是可选的**,语义同规则 6:采用项目不必启用,既有 skill 也不需回头补。
132
+ 项目**可以**在自己的配置中把任一条提升为必须。**规则 12 有一条必须(12.1)**,其余(12.2)可选;
133
+ 为什么这样分,规则内部有论证。**任何一条都不可选的是它们必须有精确的触发条件**——
127
134
  一条松到永远不会启动的规则,与没有这条规则无从分辨。
128
135
 
129
136
  ### 规则 7:先讲发现,不要先讲过程(可选)
@@ -181,6 +188,9 @@ status: current
181
188
  **为什么它与 R7 是两条**:R7 规范的是**先讲发现再给证据**的顺序。R10 规范的是**语域**——
182
189
  一个响应可以先讲发现,却仍然用只有作者持有的词汇讲那个发现。两者都让读者无法行动,但它们是不同的失效。
183
190
 
191
+ **白话不可以拿肯定语气来换。** 把说明改成读者的话就是一次改写,而改写正是「可能」悄悄变成「是」的地方。
192
+ 当 R10 用在写作者原本就有保留的论断上,由[规则 12](#规则-12受控语言部分必须) 的 12.1(必须)管:不确定语气要留着。
193
+
184
194
  ### 规则 11:每个选项都要带自己的利弊(可选)
185
195
 
186
196
  **触发条件**:要求读者在两个以上做法之间选择的响应。
@@ -204,6 +214,93 @@ status: current
204
214
 
205
215
  **与规则 4 相辅**:选项数维持在 1–5。利弊让每个选项读起来更花力气,所以这条规则让规则 4 的上限**更**要紧,不是更不要紧。
206
216
 
217
+ ### 规则 12:受控语言(部分必须)
218
+
219
+ **触发条件**:为「不是原作者」的读者撰写、改写、缩短、简化或翻译文字——典型是一位非专业的读者,要靠这段文字做判断或审批。
220
+
221
+ 受控语言(用变化换可预测性的写作规则)让文字更好读。它有一个已知的失败方式:最好读的句子是肯定的句子,
222
+ 所以「简化」会朝肯定的方向漂移。本规则取受控写作的原则,并对这个漂移设一道硬性的止损。
223
+
224
+ #### 12.1 简化后的文字要保留不确定语气(必须)
225
+
226
+ 不确定语气是一个告诉读者「这个论断可以信到什么程度」的词:*可能、推断、大概、尚未确认*——
227
+ *might、could、probably、appears to、not yet confirmed*。它是信息,不是赘词。
228
+
229
+ 缩短、简化、改写或翻译时:
230
+
231
+ - **不可把不确定的论断改成确定的。** 原文说「可能」,结果就说「可能」(或结果语言里对等的说法)。
232
+ - **不可为了省字而删掉不确定语气。** 目标是更短的句子;更肯定的句子不被允许。
233
+ - **不可加入原文没说的事实**——编出来的原因、编出来的「已确认」,是同一种失败的另一个样子。
234
+ - 只有在论断之后**已经被验证**时,不确定语气才可以拿掉;而且要由验证(查了什么、结果是什么)取代它的位置。
235
+ 只删掉不确定语气,不算验证。
236
+
237
+ **为什么只有这一条是必须的**:只有它的失败会让读者**相信不真实的事**,而不只是让文字更难读。
238
+ 它也不需要校准——检查就是拿改写前后两份文字比对,人或模型在任何语言都做得到;
239
+ 而下面每一个阈值都取决于语言与读者。
240
+
241
+ #### 12.2 白话写作原则(可选)
242
+
243
+ 读者是非专业人士时使用。它们与语言无关:每一条都用该语言自己的单位来表达,不附任何词表。
244
+
245
+ | 原则 | 要求什么 |
246
+ |------|----------|
247
+ | **句子短,以该语言自己的单位计** | 一句一个意思。**起始范围**,不是上限:英文大约 15–25 个词,中文大约 25–40 个字。远超过范围是「该拆句」的信号,不是要计数的缺陷。按语言与读者校准 |
248
+ | **同一个东西只用一个名称** | 每个东西选定一个名称,全文都用它。不要为了文采换说法:读者看到第二个名称,会以为是第二个东西 |
249
+ | **主语明确、主动语态** | 说清楚谁做了什么。施事者不明或不重要时,才用被动 |
250
+ | **一步一动作** | 流程是编号列表,每项一个动作,不是一段文字 |
251
+ | **少用分号** | 分号把读者必须同时记住的两个意思接在一起。拆成两句或一份列表 |
252
+ | **数字带单位** | 「30 秒」「3 个文件」「NT$1,200」——不要只写「30」 |
253
+
254
+ **为什么是可选**:上面的范围只是起始点,**没有**对照读者实际理解度校准过,也没有检查器在执行。
255
+ 一条**必须**的规则若附带没人能验证的阈值,会产生机械式的遵守——句子被拆到不再像句子——
256
+ 而专家读者可能反而更适合比较密的文字。这些原则是写作者凭判断使用的指引;12.1 才是不会弯的那一部分。
257
+
258
+ #### 本规则不取 ASD-STE100 的什么
259
+
260
+ ASD-STE100 的**核可词典**(每个核可的英文单词只有一个意思,并有一份封闭的允许词表)与它的**时态限制**,
261
+ 都依赖英文这个语言。它们**不适用于中文**或其他非英文文字,本标准**不附任何形式的词表**。
262
+ 只取 12.2 的原则,并改写成每一条都能在任何语言使用。
263
+
264
+ 同理,不要用「以空白或 ASCII 字符分词」的计数器去衡量非英文文字:它把一整段中文看成一个「词」,
265
+ 不论多长都通过。一把在某个语言上永远是绿灯的量尺,在那个语言上什么也没量到。
266
+
267
+ #### 示例:同一段文字、三种改写,以及一个不被允许的改写
268
+
269
+ 示例刻意用中文:本规则与语言无关,而中文正是只靠英文做法行不通的地方。三个有效版本都保留不确定语气
270
+ 「可能」、「推断」、「尚未」,且没有加入原文没有的事实。
271
+
272
+ **原文**
273
+
274
+ ```text
275
+ 经过检查,登录页面在高流量时段响应变慢,这个问题可能是数据库连接池被耗尽所造成的,我们推断是因为上周的改版新增了一个会长时间占用连接的查询;目前尚未在测试环境复现,所以修复后的效果还需要被确认,建议在确认之前先不要对外宣布已经解决。
276
+ ```
277
+
278
+ **约 80%**——句子较短,读起来仍像一段文字
279
+
280
+ ```text
281
+ 登录页面在高流量时段响应变慢。原因可能是数据库连接池被耗尽。我们推断,上周改版新增了一个查询,它会长时间占用连接。这一点尚未在测试环境复现,修复后有没有效,也还没确认。确认之前,建议先不要对外宣布已经解决。
282
+ ```
283
+
284
+ **严格**——一行一个意思、加标签、保留不确定语气
285
+
286
+ ```text
287
+ 登录页面在高流量时段响应变慢。
288
+ 1. 原因:可能是数据库连接池被耗尽。
289
+ 2. 推断:上周改版新增了一个查询,这个查询可能长时间占用连接。
290
+ 3. 状态:尚未在测试环境复现。
291
+ 4. 修复效果:尚未确认。
292
+ 5. 建议:确认之前,不要对外宣布已解决。
293
+ ```
294
+
295
+ **不是有效的改写**——最短,而且是错的
296
+
297
+ ```text
298
+ 登录页面变慢,原因是数据库连接池被耗尽,已确认由上周改版造成。
299
+ ```
300
+
301
+ 最后这一版最短、也最好读,却两度违反 12.1:「可能」变成直接陈述的原因,「尚未复现」变成「已确认」,
302
+ 而原文从没说过这件事。读者若凭它批准一个修复,就是被给了一件不真实的事。
303
+
207
304
  ---
208
305
 
209
306
  ## 情境模板
@@ -398,6 +495,7 @@ AI 需要用户做出选择或提供信息时使用。
398
495
  | R9 | *(可选)* 不要开场白。结语仍为必须——见 R1 |
399
496
  | R10 | *(可选)* 白话是主语;标识符放在论断之后当佐证 |
400
497
  | R11 | *(可选)* 每个选项都要说明换到什么、代价是什么——不只推荐那一个 |
498
+ | R12 | **12.1 *(必须)***:简化、缩短或翻译时,保留不确定语气——不可把「可能」改成「是」。12.2 *(可选)*:句子短(以该语言自己的单位计)、同物同名、主动语态、一步一动作、少用分号、数字带单位。不附英文词典——它无法移到其他语言 |
401
499
 
402
500
  | 豁免 | 不豁免 |
403
501
  |------|--------|
@@ -421,6 +519,7 @@ AI 需要用户做出选择或提供信息时使用。
421
519
 
422
520
  | 版本 | 日期 | 变更 |
423
521
  |------|------|------|
522
+ | 1.4.0 | 2026-10-05 | 新增 R12 受控语言(语言中立)。一条必须(12.1:简化后的文字要保留写作者的不确定语气——「可能」不会变成「是」、也不新增原文没有的事实);其余(12.2:以该语言自己的单位计句长、同物同名、主动语态、一步一动作、少用分号、数字带单位)属可选,理由已写进标准。取 ASD-STE100 的原则、不取它的英文词典与时态规则,并在标准里明说。附一组中文改写对照(三种严格度),外加一个更短却错误的改写。R10 现在指向 R12,因为把论断改成白话就是一次改写,而改写正是不确定语气流失的地方 |
424
523
  | 1.3.0 | 2026-08-17 | 新增可选规则 R10–R11。R10 管语域:白话是句子的主语、标识符当佐证——与 R7 不同,R7 管的是「先发现后证据」的顺序,而一个响应可以先讲发现却仍用只有作者持有的词汇讲它。R11 把规则 2 从推荐选项扩及全部:只论证推荐项的清单等于把比较丢回给读者,而没标代价的选项读起来像没有代价 |
425
524
  | 1.2.0 | 2026-08-17 | 新增可选规则 R7–R9,管答案本身(先讲发现、重述进度、不要开场白)。借鉴自 `ayghri/i-have-adhd`(MIT),十条取三;其余七条因已被 R1–R2 涵盖、与 R1 冲突、或与 estimation-standards 重复而删去。规则 1–6 全部可以被一个把结论埋起来的响应满足——R7–R9 补上这个缺口 |
426
525
  | 1.1.0 | 2026-06-10 | 新增规则 R6 可选模型级别标注(`〔模型:Fast|Standard|Capable〕`);与厂商无关;不强制既有技能回改 |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/anti-sycophancy-prompting.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 860d9e77855b
6
7
  status: current
7
8
  ---
8
9
 
@@ -20,9 +21,9 @@ status: current
20
21
 
21
22
  ## 目的
22
23
 
23
- 本标准定义一套技法与规则,用于设计能让 LLM 给出真实、批判性回应的提示词,而非迎合使用者的隐含偏好。
24
+ 本标准定义一套技法与规则,用于设计能让 LLM 给出真实、批判性回应的提示词,而非迎合用户的隐含偏好。
24
25
 
25
- LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人愉快的回应高分,导致模型将「让使用者满意」置于「准确性」之上。
26
+ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人愉快的回应高分,导致模型将「让用户满意」置于「准确性」之上。
26
27
 
27
28
  ---
28
29
 
@@ -40,31 +41,31 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
40
41
 
41
42
  **Prompt 模板**:
42
43
  ```
43
- 不要评估好坏。
44
- 针对以下想法,列出最致命的 3 个质疑:[你的想法]
45
- 每个质疑必须有技术依据,且让我无法轻易反驳。
44
+ Do not evaluate whether this is good or bad.
45
+ List the 3 most fatal objections to: [idea]
46
+ Each objection must be technically grounded and non-trivial to dismiss.
46
47
  ```
47
48
 
48
49
  ---
49
50
 
50
51
  ### 2. 先问立场防锚定协议(REQ-2)
51
52
 
52
- 在使用者揭示立场前先取得 LLM 的独立判断,防止锚定效应。
53
+ 在用户揭示立场前先取得 LLM 的独立判断,防止锚定效应。
53
54
 
54
55
  | 步骤 | 动作 |
55
56
  |------|------|
56
57
  | 1 | 在未揭示偏好的情况下询问中立比较 |
57
58
  | 2 | 取得独立判断 |
58
- | 3 | 揭示使用者立场 |
59
+ | 3 | 揭示用户立场 |
59
60
  | 4 | 若模型改变立场,要求提出明确的技术理由 |
60
61
 
61
62
  **工作流程**:
62
63
  ```
63
- 回合 1:「针对 [情境],[A] 和 [B] 哪个更好?」
64
- → 等待独立判断
64
+ Round 1: "Compare [A] vs [B] for [context]. Which is better?"
65
+ → Wait for independent judgment
65
66
 
66
- 回合 2:「我倾向 [A]。这改变你的评估吗?为什么?」
67
- → 模型若改口必须以技术事实为依据
67
+ Round 2: "I prefer [A]. Does this change your assessment? Why?"
68
+ → Model must justify any position change with technical facts
68
69
  ```
69
70
 
70
71
  ---
@@ -75,11 +76,11 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
75
76
 
76
77
  **必要格式**:
77
78
  ```
78
- | 支持这个决策的论点 | 反对这个决策的论点 |
79
- |-------------------|-------------------|
80
- | [同等份量的内容] | [同等份量的内容] |
79
+ | Arguments FOR the decision | Arguments AGAINST the decision |
80
+ |---------------------------|-------------------------------|
81
+ | [Equal weight content] | [Equal weight content] |
81
82
 
82
- 净建议:[必须明确表态,可以是「建议反对」]
83
+ Net Recommendation: [Must take a clear stance, may recommend against]
83
84
  ```
84
85
 
85
86
  **规则**:
@@ -95,9 +96,9 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
95
96
 
96
97
  **格式**:
97
98
  ```
98
- 建议:[具体行动]
99
- 信心:[1-5] — [不确定性原因]
100
- 未知:[哪些信息会改变这个评估]
99
+ Recommendation: [specific action]
100
+ Confidence: [1-5] — [reason for uncertainty]
101
+ Unknown: [what information would change this assessment]
101
102
  ```
102
103
 
103
104
  **信心度定义**:
@@ -124,7 +125,7 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
124
125
  | 信号类型 | 检测规则 |
125
126
  |----------|----------|
126
127
  | 正向开场 | 回应前 50 个 token 包含迎合性词语(如「很好」「有趣」「当然」「当然可以」) |
127
- | 立场翻转 | 使用者揭示偏好后,模型在没有新技术证据的情况下改变立场 |
128
+ | 立场翻转 | 用户揭示偏好后,模型在没有新技术证据的情况下改变立场 |
128
129
  | 风险淡化 | 句式:「虽然有些小问题,但整体上...」而未说明具体问题 |
129
130
  | 缺乏量化 | 重要建议缺少信心评分或具体度量指标 |
130
131
 
@@ -145,9 +146,9 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
145
146
 
146
147
  ## 与 Agent Prompt 的整合
147
148
 
148
- 套用至 AI Agent 时:
149
+ 应用至 AI Agent 时:
149
150
 
150
- | Agent 类型 | 套用规则 |
151
+ | Agent 类型 | 应用规则 |
151
152
  |------------|----------|
152
153
  | 代码审查 Agent | REQ-1(Socratic)+ REQ-3(双栏)+ REQ-5(检测) |
153
154
  | 架构建议 Agent | REQ-2(先问立场)+ REQ-4(信心度)+ REQ-5(检测) |
@@ -159,18 +160,18 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
159
160
  ## 完整防迎合 Prompt 模板
160
161
 
161
162
  ```
162
- 你是一位对我毫无感情的领域专家。
163
- 你的职责是找出我思考中的盲点,不是让我感觉良好。
163
+ You are a domain expert with no emotional investment in my satisfaction.
164
+ Your role is to identify flaws in my thinking, not to make me feel good.
164
165
 
165
- 规则:
166
- - 禁止以正向词语开场(很好、有趣、不错、当然)
167
- - 每个建议必须附上信心等级(1-5)和你不确定的地方
168
- - 若你认为我的方向是错的,直接说
166
+ Rules:
167
+ - Do NOT open with positive phrases (good, interesting, nice, certainly)
168
+ - Every recommendation must include a confidence level (1-5) and what you are uncertain about
169
+ - If my direction is wrong, say so directly
169
170
 
170
- 我的问题:[问题]
171
+ My question: [question]
171
172
 
172
- 请先列出这个问题中我可能持有的错误假设,
173
- 再给出你认为正确的建议。
173
+ First, list the incorrect assumptions I may be holding about this problem.
174
+ Then give your honest recommendation.
174
175
  ```
175
176
 
176
177
  ---
@@ -179,10 +180,10 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
179
180
 
180
181
  - [ ] 提示词未邀请认同(「这样好吗?」)
181
182
  - [ ] 明确禁止正向开场词语
182
- - [ ] 在揭示使用者偏好前先取得模型的独立立场(若适用)
183
+ - [ ] 在揭示用户偏好前先取得模型的独立立场(若适用)
183
184
  - [ ] 评估任务强制使用双栏格式
184
185
  - [ ] 重要建议需要信心等级
185
- - [ ] 对输出套用迎合性检测,再呈现给使用者
186
+ - [ ] 对输出应用迎合性检测,再呈现给用户
186
187
 
187
188
  ---
188
189