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
@@ -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)
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/capability-declaration.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: 5890495db0da
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,102 +11,63 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/capability-declaration.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-15
15
- **適用範圍**: 所有工具、Adapter、Agent 組件
16
- **Scope**: universal
17
- **來源**: XSPEC-037(claude-code-book Ch.3 Fail-Closed buildTool factory)
18
-
19
- ---
14
+ > **來源**: XSPEC-037 | **借鑑自**: claude-code-book Ch.3
20
15
 
21
- ## 目的
16
+ ## 概述
22
17
 
23
- Fail-Closed 能力聲明:工具/Adapter/Agent 必須顯式聲明安全性,缺省為最保守預設。
24
-
25
- 所有工具、Adapter 和 Agent 能力預設為「不安全、需授權」。開發者必須顯式聲明 `isConcurrencySafe: true` 才能享受並行優化。「忘記設權限」的結果是保守行為而非危險行為。
26
-
27
- ---
18
+ 能力聲明標準要求所有工具、Adapter 和 Agent 顯式聲明其安全性質。**所有性質預設為最保守的(Fail-Closed)值**——忘記聲明能力的開發者得到的是安全行為,而非危險行為。
28
19
 
29
- ## 核心規範
20
+ 借鑑自 claude-code-book 的 `buildTool` 工廠設計:其中 `isConcurrencySafe()` 與 `isReadOnly()` 預設為 `false`,效能優化必須顯式選擇啟用。
30
21
 
31
- - 所有工具、Adapter、Agent 必須實作 `CapabilityDeclaration`(即使使用預設值)
32
- - `isConcurrencySafe` 和 `isReadOnly` 預設為 `false` — 必須顯式聲明才能解鎖優化路徑
33
- - 框架必須在缺少聲明時使用 `FAIL_CLOSED_DEFAULTS`,並記錄警告
34
- - 聲明必須反映實際能力,虛假聲明(如謊稱 `isReadOnly`)視為安全漏洞
35
- - `trustLevel` 影響沙箱隔離強度,不可降低至低於 `userSettings` 允許的等級
22
+ ## Fail-Closed 預設值
36
23
 
37
- ---
24
+ ```typescript
25
+ const FAIL_CLOSED_DEFAULTS: CapabilityDeclaration = {
26
+ isConcurrencySafe: false, // Cannot run in parallel
27
+ isReadOnly: false, // Assumed to have side effects
28
+ requiresUserConfirmation: true, // Must confirm before execution
29
+ trustLevel: "untrusted", // Maximum sandbox restrictions
30
+ };
31
+ ```
38
32
 
39
33
  ## CapabilityDeclaration 介面
40
34
 
41
35
  | 欄位 | 類型 | 預設值 | 說明 |
42
36
  |------|------|--------|------|
43
- | `isConcurrencySafe` | `boolean` | `false` | 是否對並行執行安全(無競態、無共享可變狀態)。設為 `true` 後可加入並行批次執行 |
44
- | `isReadOnly` | `boolean` | `false` | 是否為純讀取操作(不修改任何持久化狀態)。設為 `true` 後可跳過寫入相關的 Safety Hook 階段 |
45
- | `requiresUserConfirmation` | `boolean` | `true` | 執行前是否需要使用者明確確認。設為 `false` 後進入自動執行模式(需 `userSettings` 允許) |
46
- | `trustLevel` | enum | `untrusted` | 工具的信任等級,影響沙箱隔離強度 |
47
-
48
- ### trustLevel 值對應
49
-
50
- | 值 | 說明 |
51
- |----|------|
52
- | `trusted` | 內建工具或已審核插件,無沙箱限制 |
53
- | `sandboxed` | 第三方工具,在受限環境中執行 |
54
- | `untrusted` | 未知來源,最嚴格限制(預設) |
55
-
56
- ---
37
+ | `isConcurrencySafe` | boolean | **false** | 可安全地與其他操作並行執行 |
38
+ | `isReadOnly` | boolean | **false** | 不做任何持久化狀態變更 |
39
+ | `requiresUserConfirmation` | boolean | **true** | 執行前需要使用者明確核准 |
40
+ | `trustLevel` | enum | **untrusted** | 沙箱隔離等級 |
57
41
 
58
- ## Fail-Closed 預設值
59
-
60
- 缺少聲明時使用的保守預設:
61
-
62
- | 欄位 | 值 |
63
- |------|-----|
64
- | `isConcurrencySafe` | `false` |
65
- | `isReadOnly` | `false` |
66
- | `requiresUserConfirmation` | `true` |
67
- | `trustLevel` | `untrusted` |
68
-
69
- 使用預設時記錄警告:`[WARN] Capability not declared, using Fail-Closed defaults for: {component_name}`
70
-
71
- ---
42
+ ## 信任等級
72
43
 
73
- ## 常見工具聲明範例
44
+ | 等級 | 說明 | 沙箱 |
45
+ |------|------|------|
46
+ | `trusted` | 內建或已審核插件 | 無限制 |
47
+ | `sandboxed` | 第三方工具 | 受限的執行環境 |
48
+ | `untrusted` | 未知來源 | 最嚴格限制(預設) |
74
49
 
75
- | 工具 | `isConcurrencySafe` | `isReadOnly` | `requiresUserConfirmation` | `trustLevel` |
76
- |------|--------------------|--------------|-----------------------------|-------------|
77
- | GrepTool | `true` | `true` | `false` | `trusted` |
78
- | GlobTool | `true` | `true` | `false` | `trusted` |
79
- | FileReadTool | `true` | `true` | `false` | `trusted` |
80
- | FileEditTool | `false` | `false` | `true` | `trusted` |
81
- | BashTool | `false` | `false` | `true` | `sandboxed` |
50
+ ## 常見工具聲明
82
51
 
83
- ---
52
+ | 工具 | isConcurrencySafe | isReadOnly | requiresConfirmation | trustLevel |
53
+ |------|-------------------|------------|---------------------|------------|
54
+ | GrepTool | ✅ true | ✅ true | ❌ false | trusted |
55
+ | GlobTool | ✅ true | ✅ true | ❌ false | trusted |
56
+ | FileReadTool | ✅ true | ✅ true | ❌ false | trusted |
57
+ | FileEditTool | ❌ false | ❌ false | ✅ true | trusted |
58
+ | BashTool | ❌ false | ❌ false | ✅ true | sandboxed |
84
59
 
85
60
  ## 執行規範
86
61
 
87
- | 情況 | 行動 |
88
- |------|------|
89
- | 缺少聲明 | 使用 `FAIL_CLOSED_DEFAULTS`,記錄警告 |
90
- | 虛假聲明(聲明 `isReadOnly: true` 但實際執行了寫入) | 記錄 `CAPABILITY_MISMATCH` 事件,降級至 `FAIL_CLOSED_DEFAULTS` |
91
-
92
- ---
93
-
94
- ## 適用組件
62
+ - **缺少聲明**:使用 `FAIL_CLOSED_DEFAULTS` 並記錄 `[WARN] Capability not declared for: {name}`
63
+ - **虛假聲明偵測**:若聲明 `isReadOnly: true` 卻執行寫入 → 記錄 `CAPABILITY_MISMATCH` 事件,退回 Fail-Closed
64
+ - **並行**:只有 `isConcurrencySafe: true` 的組件可被批次納入並行執行
95
65
 
96
- - AgentAdapter 實作(採用層;如 ClaudeAdapter / OpenCodeAdapter / CliAdapter)
97
- - Tool 呼叫系統(採用層)
98
- - ToolExecutor 實作(採用層)
99
- - Agent(採用層;planner / builder / evaluator 等)
100
- - 所有 MCP 工具插件
66
+ ## 參考資料
101
67
 
102
- ---
68
+ - AI 最佳化版本:[ai/standards/capability-declaration.ai.yaml](../../../ai/standards/capability-declaration.ai.yaml)
69
+ - XSPEC-037:跨專案規格
70
+ - 借鑑自:[claude-code-book](https://github.com/lintsinghua/claude-code-book) Ch.3 `buildTool` Fail-Closed 工廠
103
71
 
104
- ## 錯誤碼
105
72
 
106
- | 代碼 | 說明 |
107
- |------|------|
108
- | `CAP-001` | `CAPABILITY_NOT_DECLARED` — 使用 Fail-Closed 預設 |
109
- | `CAP-002` | `CAPABILITY_MISMATCH` — 實際行為與聲明不符 |
110
- | `CAP-003` | `TRUST_LEVEL_INSUFFICIENT` — `trustLevel` 低於場景要求 |
111
- | `CAP-004` | `CONCURRENT_UNSAFE` — 嘗試並行執行 `isConcurrencySafe: false` 的組件 |
73
+ **Scope**: universal
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/change-batching-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-18
5
+ last_synced: 2026-10-11
6
+ source_hash: 3ba2c359b2f9
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/changelog-standards.md
3
3
  source_version: 1.0.2
4
4
  translation_version: 1.0.2
5
- last_synced: 2025-12-30
5
+ last_synced: 2026-10-11
6
+ source_hash: bb36e2ce7d8f
6
7
  status: current
7
8
  ---
8
9
 
@@ -13,6 +14,9 @@ status: current
13
14
  **版本**: 1.0.2
14
15
  **最後更新**: 2025-12-24
15
16
  **適用範圍**: 所有有版本發布的軟體專案
17
+ **範圍**: universal
18
+ **產業標準**: Keep a Changelog 1.1.0
19
+ **參考資源**: [keepachangelog.com](https://keepachangelog.com/)
16
20
 
17
21
  ---
18
22
 
@@ -85,14 +89,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
85
89
 
86
90
  ### 變更分類
87
91
 
88
- | 分類 | 使用時機 |
89
- |------|----------|
90
- | **Added** | 新功能 |
91
- | **Changed** | 現有功能的變更 |
92
- | **Deprecated** | 即將移除的功能 |
93
- | **Removed** | 已移除的功能 |
94
- | **Fixed** | 錯誤修復 |
95
- | **Security** | 安全性修補 |
92
+ | 分類 | 用途 | 使用時機 |
93
+ |------|------|----------|
94
+ | **Added** | 新功能 | 為使用者新增的功能 |
95
+ | **Changed** | 修改 | 現有功能的變更 |
96
+ | **Deprecated** | 即將移除 | 未來將被移除的功能 |
97
+ | **Removed** | 已移除的功能 | 本版本中移除的功能 |
98
+ | **Fixed** | 錯誤修復 | 任何錯誤修復 |
99
+ | **Security** | 安全性修補 | 弱點修復 |
96
100
 
97
101
  ### 版本標題格式
98
102
 
@@ -536,6 +540,7 @@ git ls-files | grep -E "path/to/file"
536
540
  - [Versioning Standard](versioning.md) - 語義化版本標準
537
541
  - [Commit Message Guide](commit-message-guide.md) - Commit 訊息規範
538
542
  - [Git Workflow Standards](git-workflow.md) - Git 工作流程標準
543
+ - [Deployment Standards](deployment-standards.md) - 記錄已部署的變更
539
544
 
540
545
  ---
541
546
 
@@ -1,18 +1,22 @@
1
1
  ---
2
2
  source: ../../../core/checkin-standards.md
3
- source_version: 1.6.0
4
- translation_version: 1.6.0
5
- last_synced: 2026-04-20
6
- status: stale
3
+ source_version: 1.8.0
4
+ translation_version: 1.8.0
5
+ last_synced: 2026-10-11
6
+ source_hash: cba0d018453b
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 程式碼簽入檢查點標準
10
11
 
11
12
  > **語言**: [English](../../../core/checkin-standards.md) | 繁體中文
12
13
 
13
- **版本**: 1.5.0
14
- **最後更新**: 2026-03-18
14
+ **版本**: 1.8.0
15
+ **最後更新**: 2026-07-09
15
16
  **適用範圍**: 所有使用版本控制的軟體專案
17
+ **Scope**: partial
18
+ **業界標準**: SWEBOK v4.0 第 6 章
19
+ **參考資料**: [computer.org](https://www.computer.org/education/bodies-of-knowledge/software-engineering/v4)
16
20
 
17
21
  ---
18
22
 
@@ -101,7 +105,7 @@ pytest --cov=src tests/
101
105
  ```
102
106
 
103
107
  **驗證**:
104
- - Run all test suites locally
108
+ - 在本機執行所有相關測試(參見上方「所有相關測試通過」——直接執行已變更程式碼的測試,以及受變更影響的測試;若專案有測試影響分析工具則加以使用);當範圍不明確,或變更觸及共用/核心路徑時,改為執行完整測試套件
105
109
  - Review test coverage report
106
110
  - Ensure new code paths are tested
107
111
 
@@ -156,6 +160,12 @@ describe('Regression: [BUG-ID or description]', () => {
156
160
  - Cyclomatic complexity ≤10
157
161
  - No duplicated code blocks
158
162
 
163
+ > 以上門檻為 UDS 預設值,可依專案調整。循環複雜度
164
+ > ≤10 遵循 McCabe 的原始建議(McCabe, 1976)——也是多數
165
+ > linter(ESLint `complexity`、SonarQube)的預設值;方法長度與
166
+ > 巢狀深度限制則是以可讀性為目標的常見風格指南預設值,並非
167
+ > 硬性規則。請依你的語言/團隊調整。
168
+
159
169
  - [ ] **安全性已檢查**
160
170
  - No hardcoded secrets (passwords, API keys)
161
171
  - No SQL injection vulnerabilities
@@ -199,11 +209,11 @@ dotnet list package --vulnerable
199
209
  - Breaking changes noted
200
210
  - Setup instructions current
201
211
 
202
- - [ ] **CHANGELOG 已更新(如適用)**
203
- - 對於使用者可感知的變更:已新增條目至 `[Unreleased]` 區段
212
+ - [ ] **CHANGELOG 已更新(僅限發布前)**
213
+ - CHANGELOG 於發布準備期間更新,而非每次 commit 更新
214
+ - 對於使用者可感知的變更:發布前已新增條目至 `[Unreleased]` 區段
204
215
  - Breaking changes marked with **BREAKING** prefix
205
- - 遵循 [versioning.md](versioning.md) 和 [changelog-standards.md](changelog-standards.md) 排除規則
206
- - 注意:內部重構、僅測試、僅文件的變更通常不需要 CHANGELOG 條目
216
+ - 各工作流程的更新時機請參見 [changelog-standards.md](changelog-standards.md)
207
217
 
208
218
  **文件格式**:
209
219
  ```
@@ -485,7 +495,7 @@ git status
485
495
 
486
496
  ## 特殊情境處理
487
497
 
488
- ### 緊急離開
498
+ ### 緊急離開(下班前)
489
499
 
490
500
  當需要暫時離開但工作未完成時:
491
501
 
@@ -911,8 +921,6 @@ obj/
911
921
  node_modules/
912
922
  ```
913
923
 
914
- ---
915
-
916
924
  ### 舊版專案檔案同步(project-file-sync)
917
925
 
918
926
  > **適用範圍**:.NET Framework、MSBuild `.csproj` 及任何需要明確登錄檔案的舊版格式。
@@ -1012,6 +1020,7 @@ git commit -m "feat(module-c): add export to CSV feature"
1012
1020
 
1013
1021
  | 版本 | 日期 | 變更 |
1014
1022
  |---------|------|---------|
1023
+ | 1.7.0 | 2026-06-18 | 新增:程式碼異味門檻的來源與可調整說明(McCabe 1976 循環複雜度;linter 預設值)(XSPEC-292 T8) |
1015
1024
  | 1.5.0 | 2026-03-18 | 新增:AC 覆蓋率驗證、批次閾值觸發、自動簽入規則 |
1016
1025
  | 1.4.0 | 2026-01-16 | 新增:Bug 修復測試評估章節與決策矩陣 |
1017
1026
  | 1.3.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 6 章(軟體配置管理)至參考資料 |
@@ -1029,19 +1038,36 @@ git commit -m "feat(module-c): add export to CSV feature"
1029
1038
 
1030
1039
  ### 規則嚴重性分類
1031
1040
 
1041
+ 將 lint 規則分為三個嚴重性層級,並明確定義 CI 行為:
1042
+
1032
1043
  | 層級 | CI 行為 | 適用場景 | 範例 |
1033
1044
  |------|---------|----------|------|
1034
1045
  | **Error** | 阻擋 CI(build 失敗) | 可能的 Bug、安全問題 | 未使用變數、未處理 Promise、`eval` 使用 |
1035
- | **Warning** | 通過但回報 | 品質建議 | 函式過長、巢狀過深、TODO 標記 |
1036
- | **Info** | 靜默通過 | 風格偏好 | 行尾空白、import 排序 |
1046
+ | **Warning** | 通過但回報 | 品質建議,應修正 | 函式過長、巢狀過深、TODO 標記 |
1047
+ | **Info** | 靜默通過 | 風格偏好、資訊性 | 行尾空白、import 排序 |
1048
+
1049
+ **規則分類決策樹:**
1050
+
1051
+ ```
1052
+ Could this rule violation cause a bug?
1053
+ ├─ Yes → Error
1054
+ └─ No
1055
+ ├─ Could it degrade maintainability?
1056
+ │ ├─ Yes → Warning
1057
+ │ └─ No → Info
1058
+ └─ Does it involve security?
1059
+ └─ Yes → Error
1060
+ ```
1037
1061
 
1038
1062
  ### Auto-fix 策略
1039
1063
 
1040
- | 類別 | 範例 | 允許自動修復 |
1041
- |------|------|-------------|
1042
- | **安全修復** | 縮排、分號、import 排序 | 是 |
1043
- | **需確認** | 變數重命名、型別推斷 | 確認後修復 |
1044
- | **禁止自動修復** | 移除未使用變數、重構複雜邏輯 | 否(需人工判斷) |
1064
+ 並非所有 lint 規則都應自動修復。依安全性分類:
1065
+
1066
+ | 類別 | 條件 | 範例 | 允許自動修復 |
1067
+ |------|------|------|-------------|
1068
+ | **✅ 可安全自動修復** | 修復結果確定,不改變語意 | 縮排、分號、import 排序、尾隨逗號 | 是 |
1069
+ | **⚠️ 需確認** | 修復可能改變語意 | 變數重命名、型別推斷 | 確認後修復 |
1070
+ | **❌ 禁止自動修復** | 修復需要理解上下文 | 移除未使用變數、重構複雜邏輯 | 否(需人工判斷) |
1045
1071
 
1046
1072
  **Auto-fix 時機:**
1047
1073
 
@@ -1053,20 +1079,51 @@ git commit -m "feat(module-c): add export to CSV feature"
1053
1079
 
1054
1080
  ### 團隊一致性原則
1055
1081
 
1082
+ 目標不是通用的風格——而是**團隊內的一致性**:
1083
+
1056
1084
  | 原則 | 說明 |
1057
1085
  |------|------|
1058
1086
  | **團隊決定** | 風格選擇由團隊投票,非個人偏好 |
1059
1087
  | **設定納入版控** | Lint 設定檔必須提交至 Git |
1060
- | **決定後不辯論** | 採用後全員遵循,避免 bikeshedding |
1088
+ | **決定後不辯論(no bikeshedding)** | 採用後全員遵循,盡量減少風格爭論 |
1061
1089
  | **自動化優先** | 能由工具強制的規則不依賴人工審查 |
1062
1090
  | **新專案嚴格** | 新專案使用嚴格規則集;既有專案漸進採用 |
1063
1091
 
1064
1092
  ### 漸進採用
1065
1093
 
1094
+ 既有專案導入 linting 時:
1095
+
1066
1096
  1. **僅對新增/修改檔案套用嚴格規則** — 不要求一次修復整個 codebase
1067
- 2. **允許 `// eslint-disable-next-line` 但設上限** — 例如每專案 < 100 個
1068
- 3. **每季減少 disable 數量** — 每季減少 25%
1069
- 4. **全面強制** — 最終於所有檔案啟用
1097
+ 2. **允許 `// eslint-disable-next-line` 但設上限** — 允許既有違規使用 disable 標記,但設定最大數量(例如每專案 < 100 個)
1098
+ 3. **每季減少 disable 數量** — 每季將允許的 disable 數量減少 25%
1099
+ 4. **全面強制** — 最終於所有檔案啟用完整強制
1100
+
1101
+ ### 語言無關的設定範本
1102
+
1103
+ 為任何語言設定 linting 時,可參考此語言無關的 YAML 範本:
1104
+
1105
+ ```yaml
1106
+ # Lint Configuration Strategy (language-agnostic)
1107
+ rules:
1108
+ # Error-level: Block CI
1109
+ security: error # Security-related checks (e.g., eval, SQL injection patterns)
1110
+ possible-bugs: error # Likely bug patterns (e.g., unused vars, unreachable code)
1111
+ type-safety: error # Type-related issues (if applicable)
1112
+
1113
+ # Warning-level: Report but pass CI
1114
+ maintainability: warning # Complexity, duplication, long functions
1115
+ naming: warning # Naming conventions
1116
+ documentation: warning # Missing docs for public APIs
1117
+
1118
+ # Info-level: Silent
1119
+ style: info # Formatting preferences
1120
+ import-order: info # Import organization
1121
+
1122
+ auto_fix:
1123
+ on_save: true # Format on save in editor
1124
+ on_commit: true # Fix safe rules in pre-commit hook
1125
+ on_ci: false # CI only checks, never fixes
1126
+ ```
1070
1127
 
1071
1128
  ---
1072
1129
 
@@ -1076,10 +1133,11 @@ git commit -m "feat(module-c): add export to CSV feature"
1076
1133
  - [測試標準](testing-standards.md)(或使用 `/testing-guide` 技能)
1077
1134
  - [Commit 訊息規範](commit-message-guide.md)
1078
1135
  - [程式碼審查清單](code-review-checklist.md)
1079
- - [部署標準](deployment-standards.md) - 品質關卡與部署就緒性
1136
+ - [部署標準](deployment-standards.md) - 品質關卡是部署就緒性的輸入
1080
1137
  - [驗收條件追溯標準](acceptance-criteria-traceability.md) - AC 覆蓋率驗證
1081
1138
  - [變更批次合併標準](change-batching-standards.md) - 批次閾值觸發
1082
1139
  - [Pipeline 整合標準](pipeline-integration-standards.md) - 自動簽入
1140
+ - [發布就緒關卡](release-readiness-gate.md) - **簽入 ≠ 發布就緒**:通過每次 commit 的關卡是上線的必要條件但非充分條件;發布時「完成」的意義請參見 16 維度發布關卡
1083
1141
 
1084
1142
  ---
1085
1143