universal-dev-standards 6.14.0-beta.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 (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 +10 -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 +92 -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
@@ -1,11 +1,15 @@
1
1
  # 繁體中文提交格式 - AI 優化選項
2
2
  # 父項: commit-message
3
+ #
4
+ # 2.0.0(XSPEC-475 OQ1):類型使用英文(feat、fix……,與 english 選項相同),主旨與本文使用繁體中文。
5
+ # 2.0.0 之前本檔列的是中文類型(功能、修正……),與人類可讀版本及採用者 commitlint 的 type-enum 不一致;
6
+ # 現在不再允許中文類型。
3
7
 
4
8
  id: traditional-chinese
5
9
  meta:
6
10
  parent: commit-message
7
- version: "1.0.0"
8
- description: 使用繁體中文的提交訊息格式
11
+ version: "2.0.0"
12
+ description: 英文類型加繁體中文主旨的提交訊息格式
9
13
  language: zh-TW
10
14
 
11
15
  best_for:
@@ -14,74 +18,78 @@ best_for:
14
18
  - 文件以繁體中文為主的專案
15
19
 
16
20
  format:
17
- template: "<類型>(<範圍>): <主旨>"
18
- note: 類型使用中文,範圍使用英文或中文
21
+ template: "<type>(<scope>): <繁體中文主旨>"
22
+ note: 類型使用英文(與 english 選項相同),範圍使用小寫英文或中文,主旨與內文可用繁體中文
19
23
 
20
24
  types:
21
- - type: 功能
22
- english: feat
25
+ - type: feat
23
26
  description: 新功能
27
+ example: "feat(auth): 加入 OAuth2 登入"
24
28
 
25
- - type: 修正
26
- english: fix
29
+ - type: fix
27
30
  description: 錯誤修正
31
+ example: "fix(api): 處理空值回應"
28
32
 
29
- - type: 重構
30
- english: refactor
31
- description: 程式碼重構
33
+ - type: refactor
34
+ description: 程式碼重構(無功能變更)
35
+ example: "refactor(core): 簡化驗證邏輯"
32
36
 
33
- - type: 文件
34
- english: docs
35
- description: 文件更新
37
+ - type: docs
38
+ description: 僅文件更新
39
+ example: "docs(readme): 更新安裝指南"
36
40
 
37
- - type: 樣式
38
- english: style
39
- description: 格式調整
41
+ - type: style
42
+ description: 格式調整(無邏輯變更)
43
+ example: "style(lint): 修正縮排"
40
44
 
41
- - type: 測試
42
- english: test
43
- description: 測試相關
45
+ - type: test
46
+ description: 新增或更新測試
47
+ example: "test(auth): 新增登入單元測試"
44
48
 
45
- - type: 效能
46
- english: perf
49
+ - type: perf
47
50
  description: 效能改善
51
+ example: "perf(query): 最佳化資料庫查詢"
48
52
 
49
- - type: 建置
50
- english: build
51
- description: 建置系統
53
+ - type: build
54
+ description: 建置系統或相依套件
55
+ example: "build(deps): 升級 lodash 至 4.17.21"
52
56
 
53
- - type: 整合
54
- english: ci
55
- description: 持續整合
57
+ - type: ci
58
+ description: CI/CD 流程變更
59
+ example: "ci(github): 新增程式碼覆蓋率工作流程"
56
60
 
57
- - type: 雜項
58
- english: chore
61
+ - type: chore
59
62
  description: 維護任務
63
+ example: "chore(deps): 更新開發相依套件"
60
64
 
61
- - type: 安全
62
- english: security
63
- description: 安全修正
65
+ - type: revert
66
+ description: 還原先前提交
67
+ example: "revert: feat(auth): 加入 OAuth2 登入"
68
+
69
+ - type: security
70
+ description: 安全漏洞修正
71
+ example: "security(auth): 修正 XSS 漏洞"
64
72
 
65
73
  rules:
66
- - id: chinese-type
74
+ - id: english-type
67
75
  trigger: 撰寫提交標頭時
68
- instruction: 使用中文類型(功能、修正、重構等)
76
+ instruction: 使用英文類型(feat、fix、docs 等);不可使用中文類型(例如 新增)
69
77
  priority: required
70
78
 
71
79
  - id: chinese-subject
72
80
  trigger: 撰寫主旨時
73
81
  instruction: 以繁體中文撰寫主旨
74
- priority: required
82
+ priority: recommended
75
83
 
76
84
  - id: chinese-body
77
85
  trigger: 撰寫內文時
78
86
  instruction: 以繁體中文撰寫內文
79
- priority: required
87
+ priority: recommended
80
88
 
81
89
  examples:
82
- simple: "功能(認證): 新增 OAuth2 登入支援"
90
+ simple: "feat(auth): 加入 OAuth2 登入支援"
83
91
  with_body: |
84
- 功能(認證): 新增 OAuth2 Google 登入支援
92
+ feat(auth): 加入 OAuth2 Google 登入支援
85
93
 
86
94
  實作 Google OAuth2 認證流程供使用者登入。
87
95
 
@@ -91,7 +99,7 @@ examples:
91
99
 
92
100
  關閉 #123
93
101
  breaking: |
94
- 功能(api)!: 變更使用者端點回應格式
102
+ feat(api)!: 變更使用者端點回應格式
95
103
 
96
104
  破壞性變更: 使用者 API 回應格式已變更
97
105
 
@@ -1,15 +1,18 @@
1
1
  ---
2
2
  source: ../../../core/acceptance-criteria-traceability.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-18
6
- status: stale
3
+ source_version: 1.2.0
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 06ca6a77af24
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 驗收標準可追溯性規範
10
11
 
11
12
  > **語言**: [English](../../../core/acceptance-criteria-traceability.md) | 繁體中文
12
13
 
14
+ **版本**: 1.2.0
15
+ **最後更新**: 2026-08-24
13
16
  **適用範圍**: 所有使用規格驅動或測試驅動工作流程的軟體專案
14
17
  **Scope**: universal
15
18
 
@@ -78,6 +81,13 @@ class TestAC1_UserLogin:
78
81
  Scenario: User login with valid credentials
79
82
  ```
80
83
 
84
+ > **鍵名拼寫(刻意設計,並非衝突)。** `acceptance-criteria`(kebab-case)
85
+ > 是給人看的/識別碼拼寫——文件標題、標準 id、AI 格式鍵。
86
+ > `acceptance_criteria`(snake_case)是 YAML **序列化**欄位(例如
87
+ > `structured-task-definition`)。`acceptanceCriteria`(camelCase)不使用。
88
+ > 這些是各層適用的拼寫(見術語表的欄位命名表),
89
+ > **不予**統一。
90
+
81
91
  ---
82
92
 
83
93
  ## 覆蓋狀態定義
@@ -89,28 +99,60 @@ Scenario: User login with valid credentials
89
99
  | **已覆蓋** | ✅ | AC 已完整測試 | AC 中所有條件都有對應的測試斷言 |
90
100
  | **部分覆蓋** | ⚠️ | AC 已部分測試 | 部分條件已測試,但缺少邊界情況或執行路徑 |
91
101
  | **未覆蓋** | ❌ | AC 沒有測試 | 沒有任何測試案例參照此 AC |
102
+ | **未實作** | 🚫 | AC 沒有對應的實作 | 功能程式碼不存在(不是測試缺口,而是程式碼缺口) |
103
+
104
+ ### `not_implemented` 與 `uncovered` 判斷樹
105
+
106
+ ```
107
+ Q1: Does the corresponding code exist in src/?
108
+ No → 🚫 not_implemented
109
+ Yes → Q2: Does any test reference this AC?
110
+ No → ❌ uncovered
111
+ Yes → Q3: Are all conditions in the AC tested?
112
+ Yes → ✅ covered
113
+ No → ⚠️ partial
114
+ ```
115
+
116
+ `not_implemented` 的典型訊號:`throw new NotImplementedException()`、空的 stub 本體、`// FEATURE_STUB:` 標記。
92
117
 
93
118
  ### 覆蓋率計算
94
119
 
95
120
  ```
96
- AC Coverage % = (covered_count / total_ac_count) × 100
121
+ AC Coverage % = (covered_count + partial_count × 0.5) / (total_ac_count - not_implemented_count) × 100
97
122
 
98
123
  Where:
99
124
  covered_count = count of AC with status "covered"
100
125
  total_ac_count = total number of AC in specification
126
+ not_implemented_count = count of AC with status "not_implemented" (excluded from denominator)
101
127
  partial counts as 0.5 for coverage calculation
102
128
  ```
103
129
 
104
130
  ### 計算範例
105
131
 
106
132
  ```
107
- SPEC-001: 8 AC total
108
- - 5 covered (✅)
109
- - 2 partial (⚠️)
110
- - 1 uncovered (❌)
133
+ SPEC-001: 20 AC total
134
+ - 15 covered (✅)
135
+ - 0 partial (⚠️)
136
+ - 2 uncovered (❌)
137
+ - 3 not_implemented (🚫)
138
+
139
+ Coverage = (15 + 0) / (20 - 3) × 100 = 88.2%
140
+ Status: BLOCKED by 3 not_implemented AC(s)
141
+ ```
142
+
143
+ ### `not_implemented` 的 CI 關卡
144
+
145
+ `not_implemented` AC 會觸發一道**阻擋性** CI 關卡,獨立於覆蓋率百分比關卡之外:
111
146
 
112
- Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
113
147
  ```
148
+ [AC-NOT-IMPL] 3 AC(s) marked not_implemented:
149
+ 🚫 AC-007 OrderCancellation
150
+ 🚫 AC-012 RefundCalculation
151
+ 🚫 AC-019 ExportToPDF
152
+ All not_implemented ACs must be resolved before UAT.
153
+ ```
154
+
155
+ 只有當所有 `not_implemented` AC 都更新為 `uncovered`、`partial` 或 `covered` 時,此關卡才會解除。
114
156
 
115
157
  ---
116
158
 
@@ -327,6 +369,8 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
327
369
  | 忽略未覆蓋的 AC | 驗證存在缺口 | 追蹤並規劃所有 AC 的覆蓋工作 |
328
370
  | AC 缺乏可測試性 | 無法驗證 | 確保所有 AC 都可測試 |
329
371
  | 覆蓋但缺乏斷言 | 測試執行但不驗證任何內容 | 確認測試含有有意義的斷言 |
372
+ | 對缺少的程式碼使用 `uncovered` | 掩蓋功能完整性缺口 | 程式碼不存在時使用 `not_implemented` |
373
+ | 將 `not_implemented` 計入分母 | 灌水覆蓋率指標 | 將 `not_implemented` 排除於分母之外 |
330
374
 
331
375
  ---
332
376
 
@@ -345,3 +389,5 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
345
389
  | 版本 | 日期 | 變更內容 |
346
390
  |------|------|---------|
347
391
  | 1.0.0 | 2026-03-18 | 初始版本 — 可追溯性矩陣、覆蓋率計算、規格生成規則 |
392
+ | 1.1.0 | 2026-05-12 | 新增第 4 種狀態 `not_implemented`;更新 CI 關卡公式;新增判斷樹(XSPEC-199) |
393
+ | 1.2.0 | 2026-08-24 | 為覆蓋缺口、門檻例外與報告行動項目新增指向 `deferred-item-exit` 的參照(XSPEC-391 R5) |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/acceptance-test-driven-development.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: c3209a2e8e02
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/adr-standards.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-08-24
5
+ last_synced: 2026-10-11
6
+ source_hash: 929da01fb617
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/agent-communication-protocol.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-30
5
+ last_synced: 2026-10-11
6
+ source_hash: fa627ef7668a
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/ai-command-behavior.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: d110d30416fc
6
7
  status: current
7
8
  ---
8
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) | 繁體中文
12
+ > **語言**: [English](../../../core/ai-instruction-standards.md) | 繁體中文 | [简体中文](../../zh-CN/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
 
@@ -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-CN/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,11 +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 的每一條,同時把結論埋起來;
34
- **而找不到答案的讀者,不會因為結尾有一個正確的導航區塊被告知下一步而得到幫助。**
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
+ 或是靠「比證據更肯定」來變得好讀。
35
38
 
36
39
  ---
37
40
 
@@ -109,11 +112,13 @@ status: current
109
112
 
110
113
  ---
111
114
 
112
- ## 導航之前的那個答案(規則 7–11,選用)
115
+ ## 導航之前的那個答案(規則 7–12)
113
116
 
114
117
  > **規則 7–9 借鑒自**:[`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)(MIT),十條中取三條。
115
118
  > **規則 10–11 於 1.3.0 新增**,來源不同——使用者在同一次工作階段中兩度指出,
116
119
  > 一個正確且完整的回答讀不懂。當時規則 7–9 已經出貨且正在被遵守。
120
+ > **規則 12 於 1.4.0 新增**,來源又不同:一則公開的建議——請 LLM 寫到「大約達到 ASD-STE100 的 80%」
121
+ > (ASD-STE100 是技術文件用的受控英文標準)。只取它的原則;它的英文詞典與時態規則不取(見規則 12)。
117
122
  > 其餘七條刪去:兩條已被上方規則 1–2 涵蓋,五條與本標準衝突
118
123
  > (它的「不要 recap/不要結語」與規則 1 的導航區塊直接矛盾;它的「清單上限 5 項」
119
124
  > 會切斷證據表格與走訪分母)或與 [estimation-standards](estimation-standards.md) 重複。
@@ -122,8 +127,9 @@ status: current
122
127
  一個回應可以把結論埋在一整面證據底下,只要結尾附上正確的導航區塊,
123
128
  它仍然滿足本標準的每一條。**找不到答案的讀者,不會因為被告知下一步而得到幫助。**
124
129
 
125
- **這五條是選用的**,語義同規則 6:採用專案不必啟用,既有 skill 也不需回頭補。
126
- 專案**可以**在自己的設定中把任一條提升為必須。**不可選的是它們必須有精確的觸發條件**——
130
+ **規則 7–11 是選用的**,語義同規則 6:採用專案不必啟用,既有 skill 也不需回頭補。
131
+ 專案**可以**在自己的設定中把任一條提升為必須。**規則 12 有一條必須(12.1)**,其餘(12.2)選用;
132
+ 為什麼這樣分,規則內部有論證。**任何一條都不可選的是它們必須有精確的觸發條件**——
127
133
  一條鬆到永遠不會啟動的規則,與沒有這條規則無從分辨。
128
134
 
129
135
  ### 規則 7:先講發現,不要先講過程(選用)
@@ -181,6 +187,9 @@ status: current
181
187
  **為什麼它與 R7 是兩條**:R7 規範的是**先講發現再給證據**的順序。R10 規範的是**語域**——
182
188
  一個回應可以先講發現,卻仍然用只有作者持有的詞彙講那個發現。兩者都讓讀者無法行動,但它們是不同的失效。
183
189
 
190
+ **白話不可以拿肯定語氣來換。** 把說明改成讀者的話就是一次改寫,而改寫正是「可能」悄悄變成「是」的地方。
191
+ 當 R10 套用在寫作者原本就有保留的論斷上,由[規則 12](#規則-12受控語言部分必須) 的 12.1(必須)管:不確定語氣要留著。
192
+
184
193
  ### 規則 11:每個選項都要帶自己的優劣(選用)
185
194
 
186
195
  **觸發條件**:要求讀者在兩個以上做法之間選擇的回應。
@@ -204,6 +213,93 @@ status: current
204
213
 
205
214
  **與規則 4 相輔**:選項數維持在 1–5。優劣讓每個選項讀起來更花力氣,所以這條規則讓規則 4 的上限**更**要緊,不是更不要緊。
206
215
 
216
+ ### 規則 12:受控語言(部分必須)
217
+
218
+ **觸發條件**:為「不是原作者」的讀者撰寫、改寫、縮短、簡化或翻譯文字——典型是一位非專業的讀者,要靠這段文字做判斷或核准。
219
+
220
+ 受控語言(用變化換可預測性的寫作規則)讓文字更好讀。它有一個已知的失敗方式:最好讀的句子是肯定的句子,
221
+ 所以「簡化」會朝肯定的方向漂移。本規則取受控寫作的原則,並對這個漂移設一道硬性的停損。
222
+
223
+ #### 12.1 簡化後的文字要保留不確定語氣(必須)
224
+
225
+ 不確定語氣是一個告訴讀者「這個論斷可以信到什麼程度」的詞:*可能、推斷、大概、尚未確認*——
226
+ *might、could、probably、appears to、not yet confirmed*。它是資訊,不是贅詞。
227
+
228
+ 縮短、簡化、改寫或翻譯時:
229
+
230
+ - **不可把不確定的論斷改成確定的。** 原文說「可能」,結果就說「可能」(或結果語言裡對等的說法)。
231
+ - **不可為了省字而刪掉不確定語氣。** 目標是更短的句子;更肯定的句子不被允許。
232
+ - **不可加入原文沒說的事實**——編出來的原因、編出來的「已確認」,是同一種失敗的另一個樣子。
233
+ - 只有在論斷之後**已經被驗證**時,不確定語氣才可以拿掉;而且要由驗證(查了什麼、結果是什麼)取代它的位置。
234
+ 只刪掉不確定語氣,不算驗證。
235
+
236
+ **為什麼只有這一條是必須的**:只有它的失敗會讓讀者**相信不真實的事**,而不只是讓文字更難讀。
237
+ 它也不需要校準——檢查就是拿改寫前後兩份文字比對,人或模型在任何語言都做得到;
238
+ 而下面每一個門檻都取決於語言與讀者。
239
+
240
+ #### 12.2 白話寫作原則(選用)
241
+
242
+ 讀者是非專業人士時套用。它們與語言無關:每一條都用該語言自己的單位來表達,不附任何詞表。
243
+
244
+ | 原則 | 要求什麼 |
245
+ |------|----------|
246
+ | **句子短,以該語言自己的單位計** | 一句一個意思。**起始範圍**,不是上限:英文大約 15–25 個詞,中文大約 25–40 個字。遠超過範圍是「該拆句」的訊號,不是要計數的缺陷。依語言與讀者校準 |
247
+ | **同一個東西只用一個名稱** | 每個東西選定一個名稱,全文都用它。不要為了文采換說法:讀者看到第二個名稱,會以為是第二個東西 |
248
+ | **主詞明確、主動語態** | 說清楚誰做了什麼。施事者不明或不重要時,才用被動 |
249
+ | **一步一動作** | 程序是編號清單,每項一個動作,不是一段文字 |
250
+ | **少用分號** | 分號把讀者必須同時記住的兩個意思接在一起。拆成兩句或一份清單 |
251
+ | **數字帶單位** | 「30 秒」「3 個檔案」「NT$1,200」——不要只寫「30」 |
252
+
253
+ **為什麼是選用**:上面的範圍只是起始點,**沒有**對照讀者實際理解度校準過,也沒有檢查器在執行。
254
+ 一條**必須**的規則若附帶沒人能驗證的門檻,會產生機械式的遵守——句子被拆到不再像句子——
255
+ 而專家讀者可能反而更適合比較密的文字。這些原則是寫作者憑判斷套用的指引;12.1 才是不會彎的那一部分。
256
+
257
+ #### 本規則不取 ASD-STE100 的什麼
258
+
259
+ ASD-STE100 的**核可詞典**(每個核可的英文單字只有一個意思,並有一份封閉的允許字表)與它的**時態限制**,
260
+ 都依賴英文這個語言。它們**不適用於中文**或其他非英文文字,本標準**不附任何形式的字表**。
261
+ 只取 12.2 的原則,並改寫成每一條都能在任何語言套用。
262
+
263
+ 同理,不要用「以空白或 ASCII 字元斷詞」的計數器去衡量非英文文字:它把一整段中文看成一個「詞」,
264
+ 不論多長都通過。一把在某個語言上永遠是綠燈的量尺,在那個語言上什麼也沒量到。
265
+
266
+ #### 範例:同一段文字、三種改寫,以及一個不被允許的改寫
267
+
268
+ 範例刻意用中文:本規則與語言無關,而中文正是只靠英文做法行不通的地方。三個有效版本都保留不確定語氣
269
+ 「可能」、「推斷」、「尚未」,且沒有加入原文沒有的事實。
270
+
271
+ **原文**
272
+
273
+ ```text
274
+ 經過檢查,登入頁面在高流量時段回應變慢,這個問題可能是資料庫連線池被耗盡所造成的,我們推斷是因為上週的改版新增了一個會長時間佔用連線的查詢;目前尚未在測試環境重現,所以修復後的效果還需要被確認,建議在確認之前先不要對外宣布已經解決。
275
+ ```
276
+
277
+ **約 80%**——句子較短,讀起來仍像一段文字
278
+
279
+ ```text
280
+ 登入頁面在高流量時段回應變慢。原因可能是資料庫連線池被耗盡。我們推斷,上週改版新增了一個查詢,它會長時間佔用連線。這一點尚未在測試環境重現,修復後有沒有效,也還沒確認。確認之前,建議先不要對外宣布已經解決。
281
+ ```
282
+
283
+ **嚴格**——一行一個意思、加標籤、保留不確定語氣
284
+
285
+ ```text
286
+ 登入頁面在高流量時段回應變慢。
287
+ 1. 原因:可能是資料庫連線池被耗盡。
288
+ 2. 推斷:上週改版新增了一個查詢,這個查詢可能長時間佔用連線。
289
+ 3. 狀態:尚未在測試環境重現。
290
+ 4. 修復效果:尚未確認。
291
+ 5. 建議:確認之前,不要對外宣布已解決。
292
+ ```
293
+
294
+ **不是有效的改寫**——最短,而且是錯的
295
+
296
+ ```text
297
+ 登入頁面變慢,原因是資料庫連線池被耗盡,已確認由上週改版造成。
298
+ ```
299
+
300
+ 最後這一版最短、也最好讀,卻兩度違反 12.1:「可能」變成直接陳述的原因,「尚未重現」變成「已確認」,
301
+ 而原文從沒說過這件事。讀者若憑它核准一個修復,就是被給了一件不真實的事。
302
+
207
303
  ---
208
304
 
209
305
  ## 情境模板
@@ -398,6 +494,7 @@ AI 需要使用者做出選擇或提供資訊時使用。
398
494
  | R9 | *(選用)* 不要開場白。結語仍為必須——見 R1 |
399
495
  | R10 | *(選用)* 白話是主詞;識別字放在主張之後當佐證 |
400
496
  | R11 | *(選用)* 每個選項都要說明換到什麼、代價是什麼——不只推薦那一個 |
497
+ | R12 | **12.1 *(必須)***:簡化、縮短或翻譯時,保留不確定語氣——不可把「可能」改成「是」。12.2 *(選用)*:句子短(以該語言自己的單位計)、同物同名、主動語態、一步一動作、少用分號、數字帶單位。不附英文詞典——它無法移到其他語言 |
401
498
 
402
499
  | 豁免 | 不豁免 |
403
500
  |------|--------|
@@ -421,6 +518,7 @@ AI 需要使用者做出選擇或提供資訊時使用。
421
518
 
422
519
  | 版本 | 日期 | 變更 |
423
520
  |------|------|------|
521
+ | 1.4.0 | 2026-10-05 | 新增 R12 受控語言(語言中立)。一條必須(12.1:簡化後的文字要保留寫作者的不確定語氣——「可能」不會變成「是」、也不新增原文沒有的事實);其餘(12.2:以該語言自己的單位計句長、同物同名、主動語態、一步一動作、少用分號、數字帶單位)屬選用,理由已寫進標準。取 ASD-STE100 的原則、不取它的英文詞典與時態規則,並在標準裡明說。附一組中文改寫對照(三種嚴格度),外加一個更短卻錯誤的改寫。R10 現在指向 R12,因為把論斷改成白話就是一次改寫,而改寫正是不確定語氣流失的地方 |
424
522
  | 1.3.0 | 2026-08-17 | 新增選用規則 R10–R11。R10 管語域:白話是句子的主詞、識別字當佐證——與 R7 不同,R7 管的是「先發現後證據」的順序,而一個回應可以先講發現卻仍用只有作者持有的詞彙講它。R11 把規則 2 從推薦選項擴及全部:只論證推薦項的清單等於把比較丟回給讀者,而沒標代價的選項讀起來像沒有代價 |
425
523
  | 1.2.0 | 2026-08-17 | 新增選用規則 R7–R9,管答案本身(先講發現、重述進度、不要開場白)。借鑒自 `ayghri/i-have-adhd`(MIT),十條取三;其餘七條因已被 R1–R2 涵蓋、與 R1 衝突、或與 estimation-standards 重複而刪去。規則 1–6 全部可以被一個把結論埋起來的回應滿足——R7–R9 補上這個缺口 |
426
524
  | 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
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/api-design-standards.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-06-24
5
+ last_synced: 2026-10-11
6
+ source_hash: c844144a19cb
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/behavior-driven-development.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: d6b5a50a5e9b
6
7
  status: current
7
8
  ---
8
9
 
@@ -40,24 +41,9 @@ BDD 構成雙循環 TDD(GOOS 模式)的**外層循環**,BDD 場景驅動
40
41
  | **參與者** | 開發人員 + BA + QA(Three Amigos) |
41
42
  | **工具** | Cucumber、Behave、SpecFlow |
42
43
 
43
- ## Gherkin 語法範例
44
-
45
- ```gherkin
46
- Feature: 使用者登入
47
- 作為一個已註冊的使用者
48
- 我希望能夠登入系統
49
- 以便存取我的個人資料
50
-
51
- Scenario: 使用有效憑證登入
52
- Given 使用者已在登入頁面
53
- When 使用者輸入有效的帳號和密碼
54
- Then 系統應重導至儀表板
55
- And 顯示歡迎訊息
56
- ```
57
-
58
44
  ## 相關標準
59
45
 
60
- - [測試驅動開發](../../../core/test-driven-development.md)
46
+ - [測試驅動開發](test-driven-development.md)
61
47
  - [驗收測試驅動開發](acceptance-test-driven-development.md)
62
48
  - [規格驅動開發](spec-driven-development.md)
63
49
  - [測試標準](testing-standards.md)