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,24 +1,28 @@
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
- > **语言**: [English](../../../core/checkin-standards.md) | 繁体中文
12
+ > **语言**: [English](../../../core/checkin-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.5.0
14
- **最后更新**: 2026-03-18
15
- **适用范围**: 所有使用版本控制的软体专案
14
+ **版本**: 1.8.0
15
+ **最后更新**: 2026-07-09
16
+ **适用范围**: 所有使用版本控制的软件项目
17
+ **范围**: 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
 
19
23
  ## 目的
20
24
 
21
- 本标准定义提交程序码到版本控制前必须通过的品质关卡。确保每次提交都维持程序码库的稳定性与品质。
25
+ 本标准定义提交代码到版本控制前必须通过的质量关卡。确保每次提交都维持代码库的稳定性与质量。
22
26
 
23
27
  ---
24
28
 
@@ -26,7 +30,7 @@ status: stale
26
30
 
27
31
  **每次提交应该**:
28
32
  - ✅ 是完整的逻辑工作单元
29
- - ✅ 让程序码库处于可运作状态
33
+ - ✅ 让代码库处于可运作状态
30
34
  - ✅ 可回退而不破坏功能
31
35
  - ✅ 包含自己的测试(新功能)
32
36
  - ✅ 让未来开发者能理解
@@ -35,9 +39,9 @@ status: stale
35
39
 
36
40
  ## 必检清单
37
41
 
38
- ### 1. 建置验证
42
+ ### 1. 构建验证
39
43
 
40
- - [ ] **程序码成功编译**
44
+ - [ ] **代码成功编译**
41
45
  - Zero build errors
42
46
  - Zero build warnings (or documented exceptions)
43
47
 
@@ -46,7 +50,7 @@ status: stale
46
50
  - Dependency versions locked/documented
47
51
  - No missing imports or modules
48
52
 
49
- **专案特定建置指令**:
53
+ **项目特定构建命令**:
50
54
  ```bash
51
55
  # Example: .NET project
52
56
  dotnet build --configuration Release --warnaserror
@@ -68,13 +72,13 @@ pip install -r requirements.txt && python -m py_compile src/**/*.py
68
72
  ### 2. 测试验证
69
73
 
70
74
  - [ ] **所有相关测试通过**
71
- - 单元测试:已修改模组的所有测试通过
72
- - 集成测试:与已变更元件相关的所有测试通过
75
+ - 单元测试:已修改模块的所有测试通过
76
+ - 集成测试:与已变更组件相关的所有测试通过
73
77
  - 端对端测试(如适用):所有关键路径测试通过
74
78
 
75
- > **注意**:「相关测试」指直接执行已变更程序码的测试,以及可能受变更影响的测试。如有可用的测试影响分析工具,请使用。
79
+ > **注意**:「相关测试」指直接执行已变更代码的测试,以及可能受变更影响的测试。如有可用的测试影响分析工具,请使用。
76
80
 
77
- - [ ] **新程序码已测试**
81
+ - [ ] **新代码已测试**
78
82
  - New features have corresponding tests
79
83
  - Bug fixes include regression tests
80
84
  - Edge cases are covered
@@ -85,10 +89,10 @@ pip install -r requirements.txt && python -m py_compile src/**/*.py
85
89
 
86
90
  - [ ] **AC 覆盖率已验证**(如使用规格驱动工作流)
87
91
  - 所有验收条件有对应测试(参见[验收条件追溯标准](acceptance-criteria-traceability.md))
88
- - AC 覆盖率达到专案阈值(预设:签入时 80%)
92
+ - AC 覆盖率达到项目阈值(默认:签入时 80%)
89
93
  - 已覆盖的 AC 未退化为未覆盖
90
94
 
91
- **专案特定测试指令**:
95
+ **项目特定测试命令**:
92
96
  ```bash
93
97
  # Example: .NET project
94
98
  dotnet test --no-build --verbosity normal
@@ -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
 
@@ -124,10 +128,10 @@ pytest --cov=src tests/
124
128
  | 单纯的 typo 修正 | 再发风险低 |
125
129
  | 显而易见的逻辑错误(如 `>` 写成 `<`) | 审查时容易发现 |
126
130
  | 已被现有测试覆盖 | 避免重复测试 |
127
- | 一次性的配置错误 | 不会在程序码中再发生 |
131
+ | 一次性的配置错误 | 不会在代码中再发生 |
128
132
 
129
133
  **快速决策问题**:
130
- 1. 这个 bug 是否可能因未来的程序码变更而重现? → 是 = 加测试
134
+ 1. 这个 bug 是否可能因未来的代码变更而重现? → 是 = 加测试
131
135
  2. 现有的测试是否能捕捉到这个 bug? → 否 = 加测试
132
136
  3. 这是否影响核心功能或关键路径? → 是 = 加测试
133
137
  4. 这个 bug 曾经出现过吗? → 是 = 加测试
@@ -143,26 +147,32 @@ describe('Regression: [BUG-ID or description]', () => {
143
147
 
144
148
  ---
145
149
 
146
- ### 3. 程序码品质
150
+ ### 3. 代码质量
147
151
 
148
152
  - [ ] **遵循编码标准**
149
153
  - Naming conventions adhered to
150
154
  - Code formatting consistent
151
155
  - Comments/documentation present
152
156
 
153
- - [ ] **无程序码异味**
157
+ - [ ] **无代码异味**
154
158
  - Methods ≤50 lines (or project standard)
155
159
  - Nesting depth ≤3 levels
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
162
172
  - No XSS vulnerabilities
163
173
  - No insecure dependencies
164
174
 
165
- **专案特定品质工具**:
175
+ **项目特定质量工具**:
166
176
  ```bash
167
177
  # Example: ESLint for JavaScript
168
178
  npx eslint src/
@@ -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 在发布准备阶段更新,而非每次提交时更新
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
  ```
@@ -240,10 +250,10 @@ def authenticate(username: str, password: str) -> Optional[str]:
240
250
 
241
251
  | 项目 | 何时适用 | 何时不适用 |
242
252
  |------|---------|-----------|
243
- | **README 更新** | 新增功能、设定变更、API 行为变更 | 内部重构、仅测试变更、依赖更新 |
244
- | **CHANGELOG 条目** | 使用者可见的变更、影响使用者的错误修复、重大变更 | 内部重构、仅测试变更、仅文件变更、开发依赖更新 |
245
- | **端对端测试** | 使用者流程变更、关键路径受影响、集成点修改 | 纯后端变更且无 UI 影响、独立的工具函数 |
246
- | **API 文档** | 公开 API 变更、新增端点、参数含义变更 | 私有方法、内部工具、测试程序码 |
253
+ | **README 更新** | 新增功能、配置变更、API 行为变更 | 内部重构、仅测试变更、依赖更新 |
254
+ | **CHANGELOG 条目** | 用户可见的变更、影响用户的错误修复、重大变更 | 内部重构、仅测试变更、仅文件变更、开发依赖更新 |
255
+ | **端对端测试** | 用户流程变更、关键路径受影响、集成点修改 | 纯后端变更且无 UI 影响、独立的工具函数 |
256
+ | **API 文档** | 公开 API 变更、新增端点、参数含义变更 | 私有方法、内部工具、测试代码 |
247
257
 
248
258
  ---
249
259
 
@@ -253,7 +263,7 @@ def authenticate(username: str, password: str) -> Optional[str]:
253
263
  - Follows project convention (e.g., `feature/`, `fix/`)
254
264
  - Descriptive name used
255
265
 
256
- - [ ] **Commit 讯息已格式化**
266
+ - [ ] **Commit 消息已格式化**
257
267
  - Follows conventional commits or project standard
258
268
  - Clear and descriptive
259
269
 
@@ -303,7 +313,7 @@ git status
303
313
  - Application can run/start
304
314
  - Core functionality not broken
305
315
 
306
- **范例情境**:
316
+ **示例情境**:
307
317
  ```
308
318
  ✅ GOOD: "feat(auth): add OAuth2 Google login support"
309
319
  - OAuth flow implemented
@@ -330,7 +340,7 @@ git status
330
340
 
331
341
  | 指标 | 建议值 | 说明 |
332
342
  |------|--------|------|
333
- | 档案数量 | 1-10 个 | 超过 10 个档案应考虑拆分 |
343
+ | 文件数量 | 1-10 个 | 超过 10 个文件应考虑拆分 |
334
344
  | 变更行数 | 50-300 行 | 过大难以 review,过小缺乏意义 |
335
345
  | 功能范围 | 单一关注点 | 一个 commit 只做一件事 |
336
346
 
@@ -405,7 +415,7 @@ git status
405
415
  |--------|------|---------|
406
416
  | Phase 完成 | 完成一个开发阶段 | 建议 |
407
417
  | Checkpoint | 到达定义的检查点 | 建议 |
408
- | 变更累积 | 档案 ≥5 个 或 行数 ≥200 行 | 建议 |
418
+ | 变更累积 | 文件 ≥5 个 或 行数 ≥200 行 | 建议 |
409
419
  | 连续跳过 | 连续跳过签入 3 次 | 警告 |
410
420
  | 工作完成 | 结束前有未 commit 变更 | 强烈建议 |
411
421
  | 批次阈值 | 待处理变更达到配置阈值 | 建议 |
@@ -420,11 +430,11 @@ git status
420
430
 
421
431
  ```
422
432
  ┌────────────────────────────────────────────────┐
423
- │ 🔔 签入检查点 │
433
+ │ 🔔 Check-in Checkpoint │
424
434
  ├────────────────────────────────────────────────┤
425
- │ Phase 1 已完成 │
435
+ │ Phase 1 completed │
426
436
  │ │
427
- │ 变更统计: │
437
+ │ Change Statistics: │
428
438
  │ - Files: 5 │
429
439
  │ - Added: 180 lines │
430
440
  │ - Deleted: 12 lines │
@@ -441,19 +451,6 @@ git status
441
451
  └────────────────────────────────────────────────┘
442
452
  ```
443
453
 
444
- ### 跳过后的追踪
445
-
446
- 当用户选择「稍后再 commit」时:
447
-
448
- 1. **记录跳过次数**
449
- 2. **连续跳过 3 次** → Display warning:
450
- ```
451
- ⚠️ Warning: You have skipped check-in 3 times consecutively
452
- Current accumulated changes: 15 files, +520 lines
453
- Recommend committing soon to avoid changes becoming too large to review
454
- ```
455
- 3. **工作结束前** → If uncommitted changes exist, strongly recommend check-in
456
-
457
454
  ### 批次阈值触发
458
455
 
459
456
  当使用自动化 Pipeline 与变更批次处理时(参见[变更批次合并标准](change-batching-standards.md)):
@@ -465,27 +462,40 @@ git status
465
462
 
466
463
  ### 自动签入
467
464
 
468
- 当 Pipeline 配置中启用 `autoCheckin` 时(参见 [Pipeline 整合标准](pipeline-integration-standards.md)):
465
+ 当 Pipeline 配置中启用 `autoCheckin` 时(参见 [Pipeline 集成标准](pipeline-integration-standards.md)):
469
466
 
470
467
  | 前提条件 | 必须 | 说明 |
471
468
  |---------|------|------|
472
469
  | 所有测试通过 | 是 | 完整测试套件通过,包括新测试 |
473
- | Lint 通过 | 是 | 变更档案无 lint 错误 |
474
- | AC 覆盖率达标 | 是 | AC 覆盖率达到专案阈值 |
470
+ | Lint 通过 | 是 | 变更文件无 lint 错误 |
471
+ | AC 覆盖率达标 | 是 | AC 覆盖率达到项目阈值 |
475
472
  | 无冲突 | 是 | 与目标分支可干净合并 |
476
473
  | 批次已验证 | 是(如启用批次) | 批次中所有变更已一并验证 |
477
474
 
478
475
  **安全规则**:
479
476
  - 自动签入**不得**推送到受保护的分支
480
- - 自动签入**必须**创建正式的 commit 讯息(非「auto-commit」)
481
- - 自动签入**必须**可稽核(记录 who/what/when)
477
+ - 自动签入**必须**创建正式的 commit 消息(非「auto-commit」)
478
+ - 自动签入**必须**可审计(记录 who/what/when)
482
479
  - 用户可随时以手动 commit 覆盖
483
480
 
481
+ ### 跳过后的追踪
482
+
483
+ 当用户选择「稍后再 commit」时:
484
+
485
+ 1. **记录跳过次数**
486
+ 2. **连续跳过 3 次** → Display warning:
487
+ ```
488
+ ⚠️ Warning: You have skipped check-in 3 times consecutively
489
+ Current accumulated changes: 15 files, +520 lines
490
+ Recommend committing soon to avoid changes becoming too large to review
491
+ ```
492
+ 3. **工作结束前** → If uncommitted changes exist, strongly recommend check-in
493
+
484
494
  ---
485
495
 
486
496
  ## 特殊情境处理
487
497
 
488
- ### 紧急离开
498
+ ### 紧急离开(下班时)
489
499
 
490
500
  当需要暂时离开但工作未完成时:
491
501
 
@@ -516,7 +526,7 @@ git cherry-pick <wip-commit>
516
526
 
517
527
  进行技术探索或 POC 时:
518
528
 
519
- 1. **建立实验分支**
529
+ 1. **创建实验分支**
520
530
  ```bash
521
531
  git checkout -b experiment/redis-stream-poc
522
532
  ```
@@ -536,7 +546,7 @@ git cherry-pick <wip-commit>
536
546
 
537
547
  生产环境紧急问题:
538
548
 
539
- 1. **从 main 建立 hotfix 分支**
549
+ 1. **从 main 创建 hotfix 分支**
540
550
  ```bash
541
551
  git checkout main
542
552
  git checkout -b hotfix/critical-null-pointer
@@ -546,7 +556,7 @@ git cherry-pick <wip-commit>
546
556
 
547
557
  3. **快速验证**: Ensure tests pass
548
558
 
549
- 4. **Commit 讯息标注紧急性**:
559
+ 4. **Commit 消息标注紧急性**:
550
560
  ```
551
561
  fix(matching): [URGENT] fix null pointer causing match failures
552
562
 
@@ -561,7 +571,7 @@ git cherry-pick <wip-commit>
561
571
 
562
572
  ### ❌ 不适合提交的时机
563
573
 
564
- 1. **建置失败**
574
+ 1. **构建失败**
565
575
  - Compilation errors present
566
576
  - Unresolved dependencies
567
577
 
@@ -574,12 +584,12 @@ git cherry-pick <wip-commit>
574
584
  - Would break existing functionality
575
585
  - Missing critical components
576
586
 
577
- 4. **实验性程序码**
587
+ 4. **实验性代码**
578
588
  - TODO comments scattered
579
589
  - Debugging code left in
580
590
  - Commented-out code blocks
581
591
 
582
- **范例情境**:
592
+ **示例情境**:
583
593
  ```
584
594
  ❌ BAD: "WIP: trying to fix login"
585
595
  - Build has errors
@@ -601,7 +611,7 @@ git cherry-pick <wip-commit>
601
611
 
602
612
  ## AI 助理集成
603
613
 
604
- 当 AI 助理完成程序码变更时,必须遵循此工作流程:
614
+ 当 AI 助理完成代码变更时,必须遵循此工作流程:
605
615
 
606
616
  ### Step 1: 评估签入时机
607
617
 
@@ -610,7 +620,7 @@ git cherry-pick <wip-commit>
610
620
  - Is the codebase in a working state?
611
621
  - Are there incomplete TODOs?
612
622
 
613
- **评估范例**:
623
+ **评估示例**:
614
624
  ```
615
625
  ✅ Complete: "Implemented user registration with validation, tests, and docs"
616
626
  ⚠️ Incomplete: "Added registration form but backend validation pending"
@@ -630,7 +640,7 @@ git cherry-pick <wip-commit>
630
640
 
631
641
  **检查清单输出格式**:
632
642
  ```
633
- ### 检查结果
643
+ ### Checklist Results
634
644
 
635
645
  ✅ Build: dotnet build --no-warnings succeeded
636
646
  ✅ Code Quality: Follows project C# standards
@@ -641,22 +651,22 @@ git cherry-pick <wip-commit>
641
651
 
642
652
  ---
643
653
 
644
- ### Step 3: 提示使用者确认
654
+ ### Step 3: 提示用户确认
645
655
 
646
656
  **AI MUST use this mandatory prompt format**:
647
657
 
648
658
  ```
649
- ## 请确认是否签入
659
+ ## Please Confirm Check-in
650
660
 
651
- 已完成: [Brief description of work completed]
661
+ Completed: [Brief description of work completed]
652
662
 
653
- ### 检查结果
663
+ ### Checklist Results
654
664
  ✅ Item 1
655
665
  ✅ Item 2
656
666
  ⚠️ Item 3 (needs user verification)
657
667
  ✅ Item 4
658
668
 
659
- 建议 commit message:
669
+ Suggested commit message:
660
670
  ```
661
671
  <type>(<scope>): <description>
662
672
 
@@ -665,7 +675,7 @@ git cherry-pick <wip-commit>
665
675
  <footer>
666
676
  ```
667
677
 
668
- 是否立即建立 commit?
678
+ Proceed with commit now?
669
679
  ```
670
680
 
671
681
  ---
@@ -684,11 +694,11 @@ git cherry-pick <wip-commit>
684
694
 
685
695
  ---
686
696
 
687
- ## 专案特定化
697
+ ## 项目特定化
688
698
 
689
- 每个专案应透过以下方式自订此标准:
699
+ 每个项目应通过以下方式自定义此标准:
690
700
 
691
- ### 1. 定义建置指令
701
+ ### 1. 定义构建命令
692
702
 
693
703
  Create a `BUILD.md` or add to `CONTRIBUTING.md`:
694
704
  ```markdown
@@ -712,7 +722,7 @@ npm run build:strict
712
722
 
713
723
  ---
714
724
 
715
- ### 2. 定义测试指令
725
+ ### 2. 定义测试命令
716
726
 
717
727
  ```markdown
718
728
  ## Test Commands
@@ -739,7 +749,7 @@ npm run test:coverage
739
749
 
740
750
  ---
741
751
 
742
- ### 3. 定义品质工具
752
+ ### 3. 定义质量工具
743
753
 
744
754
  ```markdown
745
755
  ## Code Quality Tools
@@ -769,22 +779,22 @@ npm audit
769
779
  ### 4. 定义「完成定义」
770
780
 
771
781
  ```markdown
772
- ## 功能完成定义
773
-
774
- 功能完成定义:
775
- 1. ✅ 所有验收标准达成
776
- 2. ✅ 2 位团队成员已审查程序码
777
- 3. ✅ 已撰写测试(最低 80% 覆盖率)
778
- 4. ✅ 文件已更新
779
- 5. ✅ 已部署至测试环境
780
- 6. ✅ 产品负责人已核准
782
+ ## Definition of Done
783
+
784
+ A feature is considered "done" when:
785
+ 1. ✅ All acceptance criteria met
786
+ 2. ✅ Code reviewed by 2 team members
787
+ 3. ✅ Tests written (min 80% coverage)
788
+ 4. ✅ Documentation updated
789
+ 5. ✅ Deployed to staging environment
790
+ 6. ✅ Product owner approved
781
791
  ```
782
792
 
783
793
  ---
784
794
 
785
795
  ## 执行机制
786
796
 
787
- ### 提交前挂钩
797
+ ### 提交前钩子
788
798
 
789
799
  Use Git hooks to automate checks:
790
800
 
@@ -854,11 +864,11 @@ jobs:
854
864
 
855
865
  ## 提交前目录卫生
856
866
 
857
- ### IDE 与工具产生档案
867
+ ### IDE 与工具生成文件
858
868
 
859
- 提交前,验证没有不需要的档案被加入暂存区:
869
+ 提交前,验证没有不需要的文件被加入暂存区:
860
870
 
861
- **常见需检查的档案**:
871
+ **常见需检查的文件**:
862
872
 
863
873
  | Pattern | Source | Action |
864
874
  |---------|--------|--------|
@@ -870,7 +880,7 @@ jobs:
870
880
  | `.DS_Store` | macOS | Should be gitignored |
871
881
  | `Thumbs.db` | Windows | Should be gitignored |
872
882
 
873
- ### 验证指令
883
+ ### 验证命令
874
884
 
875
885
  ```bash
876
886
  # Check for common unwanted files in staging area
@@ -915,14 +925,14 @@ node_modules/
915
925
 
916
926
  > **适用范围**:.NET Framework、MSBuild `.csproj` 及任何需要显式登记文件的旧版格式。
917
927
 
918
- 旧版项目格式(如 `.NET Framework .csproj`)不会自动包含磁盘上的源码文件——每个文件都必须在项目 manifest 中显式列出。未登记的文件在**编译时被静默排除,不会产生任何错误或警告**。
928
+ 旧版项目格式(如 `.NET Framework .csproj`)不会自动包含磁盘上的源码文件——每个文件都必须在项目 manifest 中显式列出。未登记的文件在**编译时被静默排除,不会生成任何错误或警告**。
919
929
 
920
930
  **风险**:新增 `.cs`/`.aspx.cs` 文件后重建 DLL,该文件被排除。测试通过(测试的是旧 DLL),正式环境崩溃并显示"无法加载类型"。
921
931
 
922
932
  **预提交检查**:
923
933
 
924
934
  ```bash
925
- # 找出磁盘上未登记于 .csproj 的 .cs 文件
935
+ # Find .cs files on disk not registered in .csproj
926
936
  comm -23 \
927
937
  <(find . -name "*.cs" | sort) \
928
938
  <(grep -oP '(?<=Include=")[^"]+\.cs' MyProject.csproj | sort)
@@ -955,7 +965,7 @@ git commit -m "trying stuff"
955
965
 
956
966
  ---
957
967
 
958
- ### 违规 2: 提交注解程序码
968
+ ### 违规 2: 提交注释代码
959
969
 
960
970
  **问题**:
961
971
  ```javascript
@@ -1010,9 +1020,10 @@ git commit -m "feat(module-c): add export to CSV feature"
1010
1020
 
1011
1021
  | 版本 | 日期 | 变更 |
1012
1022
  |---------|------|---------|
1023
+ | 1.7.0 | 2026-06-18 | 新增:代码异味阈值的出处与可配置说明(McCabe 1976 圈复杂度;linter 默认值)(XSPEC-292 T8) |
1013
1024
  | 1.5.0 | 2026-03-18 | 新增:AC 覆盖率验证、批次阈值触发、自动签入规则 |
1014
1025
  | 1.4.0 | 2026-01-16 | 新增:Bug 修复测试评估章节与决策矩阵 |
1015
- | 1.3.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 6 章(软体配置管理)至参考资料 |
1026
+ | 1.3.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 6 章(软件配置管理)至参考资料 |
1016
1027
  | 1.2.5 | 2025-12-16 | Clarified: CHANGELOG update is for user-facing changes only, added to [Unreleased] section |
1017
1028
  | 1.2.4 | 2025-12-11 | Added: Pre-commit directory hygiene section (IDE artifacts, verification commands) |
1018
1029
  | 1.2.3 | 2025-12-05 | Added: Reference to testing-standards.md |
@@ -1027,57 +1038,106 @@ git commit -m "feat(module-c): add export to CSV feature"
1027
1038
 
1028
1039
  ### 规则严重性分类
1029
1040
 
1041
+ 将 lint 规则分为三个严重性层级,并明确对应的 CI 行为:
1042
+
1030
1043
  | 层级 | CI 行为 | 适用场景 | 示例 |
1031
1044
  |------|---------|----------|------|
1032
1045
  | **Error** | 阻断 CI(build 失败) | 可能的 Bug、安全问题 | 未使用变量、未处理 Promise、`eval` 使用 |
1033
- | **Warning** | 通过但报告 | 质量建议 | 函数过长、嵌套过深、TODO 标记 |
1034
- | **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
+ ```
1035
1061
 
1036
1062
  ### Auto-fix 策略
1037
1063
 
1038
- | 类别 | 示例 | 允许自动修复 |
1039
- |------|------|-------------|
1040
- | **安全修复** | 缩进、分号、import 排序 | 是 |
1041
- | **需确认** | 变量重命名、类型推断 | 确认后修复 |
1042
- | **禁止自动修复** | 移除未使用变量、重构复杂逻辑 | 否(需人工判断) |
1064
+ 并非所有 lint 规则都应自动修复。按安全性分类:
1065
+
1066
+ | 类别 | 条件 | 示例 | 允许自动修复 |
1067
+ |------|------|------|-------------|
1068
+ | **✅ 可安全自动修复** | 修复结果确定,不改变语义 | 缩进、分号、import 排序、尾随逗号 | 是 |
1069
+ | **⚠️ 需确认** | 修复可能改变语义 | 变量重命名、类型推断 | 确认后再应用 |
1070
+ | **❌ 禁止自动修复** | 修复需要理解上下文 | 移除未使用变量、重构复杂逻辑 | 绝不——需要人工判断 |
1043
1071
 
1044
1072
  **Auto-fix 时机:**
1045
1073
 
1046
1074
  | 时机 | 行为 | 理由 |
1047
1075
  |------|------|------|
1048
- | **Pre-commit hook** | 修复安全规则(格式化) | 快速反馈、干净提交 |
1076
+ | **Pre-commit hook** | 自动修复安全规则(格式化) | 快速反馈、干净提交 |
1049
1077
  | **CI pipeline** | 仅检查,不修复 | 确保开发者了解问题 |
1050
1078
  | **PR review** | 以 PR 评论建议 | 不阻断、具教育意义 |
1051
1079
 
1052
1080
  ### 团队一致性原则
1053
1081
 
1082
+ 目标不是统一的通用风格,而是**团队内部的一致性**:
1083
+
1054
1084
  | 原则 | 说明 |
1055
1085
  |------|------|
1056
1086
  | **团队决定** | 风格选择由团队投票,非个人偏好 |
1057
1087
  | **配置纳入版控** | Lint 配置文件必须提交至 Git |
1058
- | **决定后不辩论** | 采用后全员遵循,避免 bikeshedding |
1088
+ | **决定后不辩论(no bikeshedding)** | 一经采用,全员遵循;尽量减少风格争论 |
1059
1089
  | **自动化优先** | 能由工具强制的规则不依赖人工审查 |
1060
1090
  | **新项目严格** | 新项目使用严格规则集;既有项目渐进采用 |
1061
1091
 
1062
1092
  ### 渐进采用
1063
1093
 
1094
+ 既有项目引入 linting 时:
1095
+
1064
1096
  1. **仅对新增/修改文件应用严格规则** — 不要求一次修复整个 codebase
1065
- 2. **允许 `// eslint-disable-next-line` 但设上限** — 例如每项目 < 100 个
1066
- 3. **每季减少 disable 数量** — 每季减少 25%
1067
- 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
+ ```
1068
1127
 
1069
1128
  ---
1070
1129
 
1071
1130
  ## 相关标准
1072
1131
 
1073
- - [专案结构标准](project-structure.md)
1132
+ - [项目结构标准](project-structure.md)
1074
1133
  - [测试标准](testing-standards.md)(或使用 `/testing-guide` 技能)
1075
- - [Commit 讯息规范](commit-message-guide.md)
1076
- - [程序码审查清单](code-review-checklist.md)
1077
- - [部署标准](deployment-standards.md) - 品质关卡与部署就绪性
1134
+ - [Commit 消息规范](commit-message-guide.md)
1135
+ - [代码审查清单](code-review-checklist.md)
1136
+ - [部署标准](deployment-standards.md) - 质量关卡与部署就绪性
1078
1137
  - [验收条件追溯标准](acceptance-criteria-traceability.md) - AC 覆盖率验证
1079
1138
  - [变更批次合并标准](change-batching-standards.md) - 批次阈值触发
1080
- - [Pipeline 整合标准](pipeline-integration-standards.md) - 自动签入
1139
+ - [Pipeline 集成标准](pipeline-integration-standards.md) - 自动签入
1140
+ - [发布就绪关卡](release-readiness-gate.md) - **签入 ≠ 发布就绪**:通过每次提交的关卡是投入生产的必要条件但非充分条件;发布时“完成”的含义请参见 16 维度发布关卡
1081
1141
 
1082
1142
  ---
1083
1143
 
@@ -1086,7 +1146,7 @@ git commit -m "feat(module-c): add export to CSV feature"
1086
1146
  - [Conventional Commits](https://www.conventionalcommits.org/)
1087
1147
  - [The Art of the Commit](https://alistapart.com/article/the-art-of-the-commit/)
1088
1148
  - [Git Best Practices](https://sethrobertson.github.io/GitBestPractices/)
1089
- - [SWEBOK v4.0 - 第 6 章:软体配置管理](https://www.computer.org/education/bodies-of-knowledge/software-engineering) - IEEE Computer Society
1149
+ - [SWEBOK v4.0 - 第 6 章:软件配置管理](https://www.computer.org/education/bodies-of-knowledge/software-engineering) - IEEE Computer Society
1090
1150
 
1091
1151
  ---
1092
1152