universal-dev-standards 6.14.0-beta.9 → 6.14.0

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 (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,94 +2,28 @@
2
2
  source: ../../../core/anti-hallucination.md
3
3
  source_version: 1.5.1
4
4
  translation_version: 1.5.1
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-16
6
+ source_hash: 7fa06b7d5665
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # AI 协作防幻觉标准
10
11
 
11
- > **语言**: [English](../../../core/anti-hallucination.md) | 繁体中文
12
+ > **语言**: [English](../../../core/anti-hallucination.md) | [繁體中文](../../zh-TW/core/anti-hallucination.md) | 简体中文
12
13
 
13
- **版本**: 1.4.0
14
- **最后更新**: 2026-01-19
15
- **适用范围**: 所有使用 AI 助理协作的软体专案
14
+ **版本**: 1.5.1
15
+ **最后更新**: 2026-04-13
16
+ **适用范围**: 所有使用 AI 助手的软件项目
17
+ **范围**: universal
18
+ **行业标准**: 无(UDS 原创)
16
19
 
17
- ---
18
-
19
- ## 目的
20
-
21
- 本标准定义 AI 助理的严格准则,以防止在分析程序码、提出建议或撰写系统文件时产生幻觉(生成错误或未经验证的资讯)。
20
+ > **有关详细示例和案例研究,请参阅[防幻觉指南](../../../core/guides/anti-hallucination-guide.md)**
22
21
 
23
22
  ---
24
23
 
25
- ## AI 助手互动规范
26
-
27
- ### 对话语言
28
-
29
- AI 助手应适应使用者的偏好语言。当专案指定对话语言时,请遵循以下准则:
30
-
31
- | 情境 | 准则 | 范例 |
32
- |------|------|------|
33
- | 对话互动 | 使用专案指定语言 | 繁体中文、英文等 |
34
- | 确定性标签 | 使用专案指定语言 | `[已确认]` 或 `[Confirmed]` |
35
- | 错误讯息解释 | 使用专案指定语言 | 以使用者语言解释编译/执行错误 |
36
- | 技术术语 | 保留原文 | JWT、BCrypt、API、Token |
37
- | 程序码注解 | 遵循专案惯例 | 通常为英文 |
38
- | Commit 讯息 | 遵循专案惯例 | 如 `feat(auth): 新增登入功能` |
39
-
40
- ### 选项建议原则
41
-
42
- **规则**: 当提供多个选项时,必须同时提出最推荐的选项并说明理由。
43
-
44
- | 情境 | 要求 | 范例 |
45
- |------|------|------|
46
- | 提供 2+ 选项 | 必须明确标示推荐选项并说明理由 | 「推荐选项 A,因为...」 |
47
- | 选项优劣明显 | 直接推荐最佳选项,说明理由 | 「建议使用 BCrypt,因为安全性较高」 |
48
- | 选项各有优劣 | 推荐最适合当前情境的选项,说明权衡考量 | 「考量专案需求,推荐选项 B」 |
49
- | 无法判断优劣 | 说明需要哪些资讯才能给出推荐 | 「需要确认效能需求才能推荐」 |
50
-
51
- **范例**:
52
-
53
- ❌ **错误**:
54
- ```
55
- 有三个选项:
56
- 1. 使用 Redis 快取
57
- 2. 使用记忆体快取
58
- 3. 使用档案快取
59
-
60
- 请选择一个。
61
- ```
62
-
63
- ✅ **正确**:
64
- ```
65
- 有三个选项:
66
- 1. 使用 Redis 快取
67
- 2. 使用记忆体快取
68
- 3. 使用档案快取
69
-
70
- **推荐: 选项 1 (Redis)**: 考量专案已有 Redis 基础设施且需要跨实例共享快取,Redis 是最适合的选择。
71
- ```
72
-
73
- ### 下一步建议
74
-
75
- **规则**: 当完成一项任务或子任务时,AI 助手**必须**建议合理的下一步工作,并明确标示**最推荐**的选项。
76
-
77
- **指引**:
78
- - **主动性**: 不要等待使用者问「接下来呢?」。
79
- - **情境相关**: 建议应遵循专案的工作流程(如:提案 -> 实作 -> 测试)。
80
- - **明确推荐**: 使用 `[推荐]` 或 `[Recommended]` 标示最佳路径。
81
-
82
- **范例**:
83
-
84
- ✅ **正确**:
85
- ```
86
- 任务完成: API 端点已实作。
24
+ ## 目的
87
25
 
88
- **建议下一步**:
89
- 1. **[推荐]** 为新端点新增单元测试 (`src/tests/api/`)
90
- 2. 更新 API 文件 (`docs/api-reference.md`)
91
- 3. 开始前端集成
92
- ```
26
+ 本标准为 AI 助手定义了严格的准则,以防止在分析代码、提出建议或记录系统文档时产生幻觉(生成虚假或未经验证的信息)。
93
27
 
94
28
  ---
95
29
 
@@ -97,702 +31,187 @@ AI 助手应适应使用者的偏好语言。当专案指定对话语言时,
97
31
 
98
32
  ### 1. 仅基于证据的分析
99
33
 
100
- **规则**: 仅分析和引用已明确提供或读取的内容。
101
-
102
- **指引**:
103
- - ✅ 分析已使用档案读取工具读取的程序码档案
104
- - ✅ 引用已撷取的文件
105
- - ✅ 引用已检查的设定档
106
- - ❌ 不要推测未见过的 API、函式或设定
107
- - ❌ 不要在未验证的情况下假设框架行为
108
- - ❌ 不要捏造需求细节
109
-
110
- **范例**:
111
-
112
- ✅ **正确**:
113
- ```
114
- [证据] 在 src/auth/service.ts:45,JWT 验证逻辑使用 'jsonwebtoken' 函式库
115
- [证据] package.json 档案(第 12-18 行)列出 Express 4.18.2 作为相依项目
116
- ```
117
-
118
- ❌ **错误**:
119
- ```
120
- 此系统使用 Redis 进行快取(程序码未审查)
121
- UserService 应该有 authenticate() 方法(API 未验证)
122
- 需求指出我们需要 SSO 登入支援(需求未确认)
123
- ```
124
-
125
- ---
34
+ | 应做 | 禁止 |
35
+ |----|--------|
36
+ | ✅ 分析已读取的代码文件 | ❌ 推测未见过的 API、函数或配置 |
37
+ | ✅ 引用已获取的文档 | ❌ 在未经核实的情况下假设框架行为 |
38
+ | ✅ 引用已检查的配置文件 | ❌ 捏造需求细节 |
126
39
 
127
40
  ### 2. 明确来源标注
128
41
 
129
- **规则**: 所有引用必须包含来源类型、位置与可验证性资讯。
130
-
131
- #### 2.1 来源类型
132
-
133
- | 来源类型 | 标签 | 说明 | 可靠度 |
134
- |---------|------|------|--------|
135
- | 专案程序码 | `[来源: 程序码]` | 直接从程序码库读取 | ⭐⭐⭐⭐⭐ 最高 |
136
- | 专案文件 | `[来源: 文件]` | README、Wiki、程序码注解 | ⭐⭐⭐⭐ 高 |
137
- | 外部文件 | `[来源: 外部]` | 官方文件(附 URL) | ⭐⭐⭐⭐ 高 |
138
- | 网路搜寻 | `[来源: 搜寻]` | 搜寻结果(包含日期) | ⭐⭐⭐ 中 |
139
- | AI 知识 | `[来源: 知识]` | AI 训练资料(需验证) | ⭐⭐ 低 |
140
- | 使用者提供 | `[来源: 使用者]` | 使用者对话中的资讯 | ⭐⭐⭐ 中 |
141
-
142
- #### 2.2 标注格式
143
-
144
- **程序码引用**:
42
+ **代码引用格式**:
145
43
  ```
146
- [来源: 程序码] 档案路径:行号 - 描述
44
+ [Source: Code] file_path:line_number - Description
147
45
  ```
148
46
 
149
- **外部文件**:
47
+ **外部文档格式**:
150
48
  ```
151
- [来源: 外部] URL - 描述(版本: x.x.x,存取: YYYY-MM-DD)
49
+ [Source: External] URL - Description (Version: x.x.x, Accessed: YYYY-MM-DD)
152
50
  ```
153
51
 
154
- **AI 知识**:
52
+ **AI 知识格式**:
155
53
  ```
156
- [来源: 知识] 主题 - 描述(⚠️ 需要验证)
54
+ [Source: Knowledge] Topic - Description (⚠️ Requires verification)
157
55
  ```
158
56
 
159
- #### 2.3 范例
57
+ ### 3. 来源类型可靠度
160
58
 
161
- ✅ **正确**:
162
- ```
163
- [来源: 程序码] UserService.cs:142 - 密码杂凑使用 BCrypt
164
- [来源: 程序码] app.config:23-28 - 资料库连线字串设定为 SQL Server
165
- [来源: 文件] README.md:15 - 专案需要 .NET 8.0 SDK
166
- [来源: 外部] https://react.dev/reference/react/useState - useState hook API(版本: React 18,存取: 2025-12-10)
167
- [来源: 搜寻] "Express.js middleware order" - 中介软体依注册顺序执行(搜寻: 2025-12-10)
168
- [来源: 知识] HTTP 状态码 - 404 表示资源未找到(⚠️ 一般知识,请验证您的 API)
169
- [来源: 使用者] 使用者在对话中表示 - 验证必须支援 OAuth2
170
- ```
171
-
172
- ❌ **错误**:
173
- ```
174
- 验证服务使用 BCrypt(无来源类型,无档案引用)
175
- 设定档案中某处有资料库连线(模糊引用)
176
- 我认为 README 提到 .NET 8(不确定语言,无来源)
177
- React useState 的运作方式是...(无版本,无引用)
178
- ```
179
-
180
- #### 2.4 版本敏感性
181
-
182
- **规则**: 引用函式库、框架或 API 时,必须包含版本资讯(如有)。
183
-
184
- **为何重要**:
185
- - API 在不同版本间会改变
186
- - 已弃用的功能可能仍出现在 AI 训练资料中
187
- - 安全性漏洞是版本特定的
188
-
189
- **范例**:
190
- ```
191
- ✅ [来源: 外部] Next.js App Router (v14.x) - Server Components 是预设值
192
- ✅ [来源: 程序码] package.json:12 - 使用 "express": "^4.18.2"
193
- ❌ "Next.js 使用 Server Components"(哪个版本?v12 和 v14 行为不同)
194
- ```
59
+ | 来源类型 | 标签 | 可靠度 |
60
+ |-------------|-----|-------------|
61
+ | 项目代码 | `[Source: Code]` | ⭐⭐⭐⭐⭐ 最高 |
62
+ | 项目文档 | `[Source: Docs]` | ⭐⭐⭐⭐ 高 |
63
+ | 外部文档 | `[Source: External]` | ⭐⭐⭐⭐ 高 |
64
+ | 网络搜索 | `[Source: Search]` | ⭐⭐⭐ 中 |
65
+ | 用户提供 | `[Source: User]` | ⭐⭐⭐ 中 |
66
+ | AI 知识 | `[Source: Knowledge]` | ⭐⭐ 低 |
195
67
 
196
68
  ---
197
69
 
198
- ### 3. 分类确定性等级
199
-
200
- **规则**: 明确区分已确认事实、推测与未知事项。
201
-
202
- **分类标签**:
70
+ ## 确定性分类标签
203
71
 
204
72
  | 标签 | 使用时机 |
205
- |-----|---------|
206
- | `[已确认]` | 直接来自程序码/文件的证据 |
207
- | `[推测]` | 基于现有证据的逻辑推论 |
208
- | `[假设]` | 基于常见模式(需验证)|
209
- | `[未知]` | 资讯不可得 |
210
- | `[需确认]` | 需要使用者澄清 |
211
-
212
- **范例**:
213
-
214
- ✅ **正确**:
215
- ```
216
- [已确认] src/database/connection.ts:12 - 使用 PostgreSQL 驱动程序 'pg'
217
- [推测] 基于 src/repositories/ 中的 repository 模式,可能使用依赖注入
218
- [假设] 专案可能使用 OAuth2,但需要审查验证设定
219
- [未知] API 速率限制策略未记录
220
- [需确认] 新功能是否应支援多租户?
221
- ```
222
-
223
- ❌ **错误**:
224
- ```
225
- 系统使用 Redis(无分类,无证据)
226
- 我们应该实作快取(以事实呈现,非建议)
227
- 使用者需要 SSO 支援(假设以已确认需求呈现)
228
- ```
229
-
230
- #### 统一标签系统
231
-
232
- 本标准定义两类互补的标签类别,用于相关标准:
233
-
234
- **类别 1:确定性标签**(用于分析现有内容)
235
-
236
- 用于分析程序码、审查文件或讨论系统时。参见[反向工程标准](reverse-engineering-standards.md)。
237
-
238
- | 标签 | 用途 | 范例情境 |
239
- |-----|------|---------|
240
- | `[已确认]` | 直接来自程序码/文件的证据 | 程序码分析、测试提取 |
241
- | `[推测]` | 基于模式的逻辑推论 | 行为分析、架构审查 |
242
- | `[假设]` | 需验证的合理猜测 | 缺口识别、推测 |
243
- | `[未知]` | 无法从现有资讯判断 | 缺少文件 |
244
- | `[需确认]` | 需要人类输入 | 模糊的需求 |
245
-
246
- **类别 2:推导标签**(用于生成新内容)
247
-
248
- 用于从已核准来源生成测试、规格或文件时。参见[正向推演标准](../../../core/forward-derivation-standards.md)。
249
-
250
- | 标签 | 用途 | 范例情境 |
251
- |-----|------|---------|
252
- | `[来源]` | 直接来自规格/需求的内容 | SPEC 标题、AC 文字原文 |
253
- | `[推导]` | 从来源内容转换而来 | 从条列 AC 转换的 GWT |
254
- | `[生成]` | AI 生成的结构 | 测试骨架、TODO 注解 |
255
- | `[待办]` | 需要人类实作 | Step definitions、断言 |
256
-
257
- **何时使用哪种**:
258
-
259
- | 工作流程 | 主要标签 | 次要标签 |
260
- |----------|---------|---------|
261
- | 程序码分析 | 确定性标签 | - |
262
- | 反向工程 | 确定性标签 | - |
263
- | 正向推演 | 推导标签 | 确定性标签(用于缺口)|
264
- | 规格生成 | 推导标签 | 确定性标签(用于未知)|
73
+ |-----|----------|
74
+ | `[Confirmed]` | 来自代码/文档的直接证据 |
75
+ | `[Inferred]` | 基于现有证据的逻辑推论 |
76
+ | `[Assumption]` | 基于常见模式(需验证) |
77
+ | `[Unknown]` | 信息不可得 |
78
+ | `[Need Confirmation]` | 需要用户澄清 |
265
79
 
266
80
  ---
267
81
 
268
- ### 4. 禁止行为
269
-
270
- **AI 助手不得**:
271
-
272
- 1. **捏造 API 或函式签名**
273
- - ❌ 不要编造方法名称、参数或回传类型
274
- - ✅ 要读取实际原始码或询问使用者
275
-
276
- 2. **假设需求**
277
- - ❌ 不要猜测使用者需求或业务规则
278
- - ✅ 当需求模糊时要提出澄清问题
279
-
280
- 3. **推测未读取的程序码**
281
- - ❌ 不要描述未审查档案的功能
282
- - ✅ 要明确表示「需要读取 [档案] 以确认」
283
-
284
- 4. **编造设定**
285
- - ❌ 不要假设环境变数、设定键或资料库结构
286
- - ✅ 要审查实际设定档
287
-
288
- 5. **凭空产生错误或 Bug**
289
- - ❌ 不要在无证据的情况下声称程序码有问题
290
- - ✅ 要分析实际程序码并引用特定行号
82
+ ## 推导标签(用于生成内容)
291
83
 
292
- 6. **提出选项但不推荐**
293
- - ❌ 不要列出选项后要求使用者选择而不提供指引
294
- - ✅ 要永远包含推荐选项并附理由
295
-
296
- 7. **未分析副作用即实作**
297
- - ❌ 不要在未识别潜在副作用的情况下开始写程序码
298
- - ✅ 要在实作前列出至少 3 个潜在副作用
299
- - ✅ 要考虑:状态变更、相依性、连锁效应
300
-
301
- #### 详细范例
302
-
303
- ##### 1. 捏造 API 或函式名称
304
-
305
- ❌ **错误**:
306
- ```
307
- 助理: 「你可以呼叫 UserService.GetUserById(int id) 来取得使用者」
308
- ```
309
- **问题**: 方法不存在或签名不同。
310
-
311
- ✅ **正确**:
312
- ```
313
- 助理: 「让我读取 UserService 档案以找到正确的方法签名。」
314
-
315
- [读取 src/services/UserService.cs 后]
316
-
317
- [来源: 程序码] UserService.cs:45 - 找到方法: FindUser(Guid userId)
318
- 实际方法使用 Guid 而非 int 作为使用者 ID 参数。
319
- ```
84
+ | 标签 | 用途 | 示例场景 |
85
+ |-----|---------|-----------------|
86
+ | `[Source]` | 直接来自规格/需求的内容 | SPEC 标题、AC 逐字文本 |
87
+ | `[Derived]` | 从源内容转换而来 | 从条列式 AC 转换的 GWT |
88
+ | `[Generated]` | AI 生成的结构 | 测试骨架、TODO 注释 |
89
+ | `[TODO]` | 需要人工实现 | 步骤定义、断言 |
320
90
 
321
91
  ---
322
92
 
323
- ##### 2. 假设使用者需求
324
-
325
- ❌ **错误**:
326
- ```
327
- 助理: 「系统需要支援 OAuth 和 SAML 以提供企业 SSO。」
328
- ```
329
- **问题**: 使用者只询问认证,未指定协议。
330
-
331
- ✅ **正确**:
332
- ```
333
- 助理: 「[需确认] 您提到需要验证功能。
334
- 能否澄清:
335
- 1. 这是给内部使用者、外部客户,还是两者都有?
336
- 2. 您需要企业 SSO(OAuth/SAML)还是简单的使用者名称/密码?
337
- 3. 有任何需要集成的现有身分提供者吗?
93
+ ## 禁止行为
338
94
 
339
- 这将帮助我推荐最适合的方法。」
340
- ```
95
+ | # | 禁止行为 | 替代做法 |
96
+ |---|-------------|---------|
97
+ | 1 | **捏造 API 或函数签名** | 读取实际源代码或询问用户 |
98
+ | 2 | **假设需求** | 当需求模糊时提出澄清问题 |
99
+ | 3 | **推测未读取的代码** | 声明“需要读取 [文件] 以确认” |
100
+ | 4 | **编造配置** | 审查实际配置文件 |
101
+ | 5 | **凭空捏造错误或 Bug** | 分析实际代码并引用具体行号 |
102
+ | 6 | **提出选项但不推荐** | 始终包含推荐选项并说明理由 |
103
+ | 7 | **未分析副作用即实现** | 在实现前列出至少 3 个潜在副作用 |
341
104
 
342
105
  ---
343
106
 
344
- ##### 3. 描述未读取的程序码功能
345
-
346
- ❌ **错误**:
347
- ```
348
- 助理: 「PaymentService 处理信用卡处理并与 Stripe 集成。」
349
- ```
350
- **问题**: 档案未读取,功能仅从名称假设。
351
-
352
- ✅ **正确**:
353
- ```
354
- 助理: 「我在您的专案结构中看到名为 PaymentService.cs 的档案。
107
+ ## 推荐要求
355
108
 
356
- [未知] 我尚未读取此档案,因此无法确认其功能。
109
+ **规则**: 当提供多个选项时,始终包含推荐选项并说明理由。
357
110
 
358
- 您想让我读取 src/services/PaymentService.cs 以了解:
359
- - 它使用哪个支付提供者?
360
- - 支援哪些支付方式?
361
- - 交易如何处理?」
362
- ```
111
+ | 场景 | 要求 |
112
+ |----------|-------------|
113
+ | 提供 2 个以上选项 | 必须标明推荐选项并说明理由 |
114
+ | 优劣明显 | 直接推荐最佳选项并说明理由 |
115
+ | 存在权衡取舍 | 基于当前上下文推荐,并说明权衡考量 |
116
+ | 无法判断 | 说明需要哪些信息才能给出推荐 |
363
117
 
364
118
  ---
365
119
 
366
- ##### 4. 编造设定细节
367
-
368
- ❌ **错误**:
369
- ```
370
- 助理: 「设定 DATABASE_URL 环境变数以连线到 PostgreSQL。
371
- 您的连线字串应在 appsettings.json 的 'ConnectionStrings:DefaultConnection' 下。」
372
- ```
373
- **问题**: 设定结构和变数名称未经验证即假设。
374
-
375
- ✅ **正确**:
376
- ```
377
- 助理: 「让我检查您的实际设定档。」
378
-
379
- [读取 appsettings.json 后]
380
-
381
- [来源: 程序码] appsettings.json:8-12 - 找到资料库设定:
382
- - 连线字串键: "ConnectionStrings:MainDb"(非 "DefaultConnection")
383
- - 使用 SQL Server,非 PostgreSQL
384
- - 额外设定 "CommandTimeout": 30
120
+ ## 下一步建议
385
121
 
386
- 您的专案使用与 .NET 预设不同的键名称。
387
- ```
122
+ **规则**: 完成一项任务或子任务后,建议合理的后续步骤并指出最推荐的选项。
388
123
 
389
- ---
390
-
391
- ##### 5. 断言程序码有 Bug(无证据)
392
-
393
- ❌ **错误**:
394
- ```
395
- 助理: 「您的验证程序码有安全性漏洞 -
396
- 您没有正确进行密码杂凑。」
397
- ```
398
- **问题**: 未读取实际程序码即声称有 Bug。
399
-
400
- ✅ **正确**:
401
- ```
402
- 助理: 「让我审查您的验证实作。」
403
-
404
- [读取 src/auth/AuthService.cs 后]
405
-
406
- [已确认] AuthService.cs:67 - 找到密码杂凑实作:
407
- - 使用 BCrypt,work factor 为 12 ✅
408
- - Salt 自动生成 ✅
409
- - 未侦测到时序攻击漏洞 ✅
410
-
411
- 您的密码杂凑实作遵循安全性最佳实务。
412
- 在审查的程序码中未发现问题。
413
- ```
414
-
415
- ---
416
-
417
- ##### 6. 选项未附推荐
418
-
419
- ❌ **错误**:
420
- ```
421
- 助理: 「您可以使用: 1) JWT 2) Session 3) OAuth。您偏好哪个?」
422
- ```
423
- **问题**: 列出选项但未提供指引或考虑情境。
424
-
425
- ✅ **正确**:
426
- ```
427
- 助理: 「基于您的需求:
428
-
429
- **选项**:
430
- 1. JWT - 无状态、可扩展、适合 API
431
- 2. Session - 服务器端状态、传统 Web 应用程序
432
- 3. OAuth - 第三方身分提供者
433
-
434
- **推荐: JWT**
435
-
436
- [推测] 基于您的微服务架构(见于 docker-compose.yml),
437
- JWT 是最适合的,因为:
438
- - 无状态: 跨服务不需要 session 储存
439
- - 可扩展: 每个服务可独立验证 token
440
- - 标准: 在您的技术堆叠(.NET、React)中有良好支援
441
-
442
- 如果之后需要社交登入,可以在 JWT 之上加入 OAuth。」
443
- ```
444
-
445
- ---
446
-
447
- ##### 7. 未分析副作用即实作
448
-
449
- ❌ **错误**:
450
- ```
451
- 使用者: 「新增一个删除使用者帐号的功能」
452
- 助理: 「这是实作:
453
-
454
- public async Task DeleteUser(Guid userId) {
455
- await _dbContext.Users.Where(u => u.Id == userId).DeleteAsync();
456
- }
457
- 」
458
- ```
459
- **问题**: 未考虑连锁效应即直接实作。
460
-
461
- ✅ **正确**:
462
- ```
463
- 使用者: 「新增一个删除使用者帐号的功能」
464
- 助理: 「在实作前,让我先识别潜在副作用:
465
-
466
- **潜在副作用**:
467
- 1. **资料完整性**: 相关记录(订单、评论、工作阶段)可能变成孤立资料
468
- 2. **外部系统**: 可能需要通知第三方服务(支付提供者、电子邮件服务)
469
- 3. **稽核轨迹**: 删除可能违反合规要求(GDPR 被遗忘权 vs. 稽核日志)
470
-
471
- [需确认] 应如何处理:
472
- - 相关使用者资料(级联删除 vs. 匿名化)?
473
- - 活动中的工作阶段?
474
- - 用于报表的历史记录?
475
-
476
- 一旦确认后,我会提供实作。」
477
- ```
124
+ **指引**:
125
+ - **主动性**: 不要等待用户询问“接下来做什么?”
126
+ - **符合上下文**: 建议应遵循项目的工作流程
127
+ - **明确推荐**: 使用 `[Recommended]` 标出最佳路径
478
128
 
479
129
  ---
480
130
 
481
131
  ## 实施检查清单
482
132
 
483
- 在对程序码、需求或架构做出任何陈述前,请验证:
484
-
485
- - [ ] **来源已验证**
486
- - 我是否已读取实际的档案/文件?
487
-
488
- - [ ] **来源类型已标注**
489
- - 我是否已指定来源类型?(`[来源: 程序码]`、`[来源: 外部]`、`[来源: 知识]` 等)
490
-
491
- - [ ] **引用已标注**
492
- - 我是否已包含档案路径与行号(程序码)?
493
- - 我是否已包含 URL 与存取日期(外部文件)?
494
-
495
- - [ ] **版本已标注**
496
- - 我是否已包含适用的函式库/框架版本?
497
-
498
- - [ ] **确定性已分类**
499
- - 我是否已标注为 [已确认]、[推测]、[假设]、[未知] 或 [需确认]?
500
-
501
- - [ ] **AI 知识已标记**
502
- - 我是否已对 `[来源: 知识]` 标记 ⚠️ 验证警告?
503
-
504
- - [ ] **无捏造**
505
- - 我是否避免了捏造 API、设定或需求?
506
-
507
- - [ ] **使用者澄清**
508
- - 我是否对模糊点请求澄清?
509
-
510
- - [ ] **包含推荐**
511
- - 当提出选项时,我是否包含了推荐选项?
133
+ 在对代码、需求或架构做出任何陈述之前:
512
134
 
513
- - [ ] **已识别副作用**
514
- - 我是否在实作前列出至少 3 个潜在副作用?
515
- - 我是否考虑了:状态变更、相依性、外部系统、资料完整性?
135
+ - [ ] **来源已验证**: 我是否已读取实际的文件/文档?
136
+ - [ ] **来源类型已标注**: 我是否已指明来源类型?
137
+ - [ ] **引用已注明**: 我是否包含了文件路径和行号(针对代码)?
138
+ - [ ] **版本已指明**: 在适用情况下,我是否包含了库/框架的版本?
139
+ - [ ] **确定性已分类**: 我是否已标注为 [Confirmed]、[Inferred] 等?
140
+ - [ ] **AI 知识已标记**: 我是否对 `[Source: Knowledge]` 加上了 ⚠️ 警告?
141
+ - [ ] **绝无捏造**: 我是否避免了编造 API、配置或需求?
142
+ - [ ] **用户澄清**: 我是否对模糊不清之处请求了澄清?
143
+ - [ ] **包含推荐**: 在提供选项时,我是否包含了推荐选项?
144
+ - [ ] **已识别副作用**: 我是否在实现前列出了潜在副作用?
516
145
 
517
146
  ---
518
147
 
519
- ## 审查情境
148
+ ## 版本敏感性
520
149
 
521
- ### 情境 1: 程序码分析
150
+ **规则**: 引用库、框架或 API 时,只要可用,始终包含版本信息。
522
151
 
523
- **使用者请求**: 「审查验证逻辑」
524
-
525
- **❌ 不良回应**:
526
- ```
527
- 您的验证系统使用 JWT 搭配 RS256 签名。
528
- Token 在 1 小时后过期。
529
- 您应该加入 refresh token 支援。
530
- ```
531
- **问题**: 未读取程序码即做出声明,假设实作细节。
532
-
533
- **✅ 良好回应**:
534
- ```
535
- [需确认] 哪个档案包含验证逻辑?
536
- 可能的位置包括:
537
- - src/auth/
538
- - src/services/auth
539
- - src/middleware/
540
-
541
- 请引导我找到正确的档案,以便我提供准确分析。
542
-
543
- 或者,我可以搜寻程序码库中与验证相关的档案。
544
- ```
152
+ | ✅ 良好 | ❌ 不良 |
153
+ |---------|--------|
154
+ | `[Source: External] Next.js App Router (v14.x) - Server Components are the default` | "Next.js uses Server Components" |
155
+ | `[Source: Code] package.json:12 - Using "express": "^4.18.2"` | "Express handles routing" |
545
156
 
546
157
  ---
547
158
 
548
- ### 情境 2: 架构建议
549
-
550
- **使用者请求**: 「我应该如何架构新的付款模组?」
551
-
552
- **❌ 不良回应**:
553
- ```
554
- 基于您现有的架构,您应该:
555
- 1. 在 src/services/ 建立 PaymentService
556
- 2. 使用 Stripe API
557
- 3. 将交易储存在 payments 资料表
558
- ```
559
- **问题**: 未经证据即假设架构、支付提供者和资料库结构。
560
-
561
- **✅ 良好回应**:
562
- ```
563
- 为了提供准确的建议,我需要了解您目前的架构:
159
+ ## 对话语言准则
564
160
 
565
- [需确认]
566
- 1. 您计划使用哪个支付提供者?(Stripe、PayPal、自订等)
567
- 2. 您现有的服务层结构是什么?
568
- 3. 您使用什么资料库?
569
-
570
- 能否分享:
571
- - 专案结构(ls -R src/ 或类似)
572
- - 现有服务范例
573
- - 资料库结构或 ORM 模型
574
-
575
- 一旦我审查了这些,就能建议与您的模式一致的结构。
576
- ```
577
-
578
- ---
579
-
580
- ### 情境 3: Bug 调查
581
-
582
- **使用者请求**: 「登入失败」
583
-
584
- **❌ 不良回应**:
585
- ```
586
- 问题可能在您的 validateCredentials() 函式中。
587
- 您可能需要在比对前对密码进行杂凑。
588
- ```
589
- **问题**: 未看程序码即猜测原因。
590
-
591
- **✅ 良好回应**:
592
- ```
593
- 要调查登入失败,我需要更多资讯:
594
-
595
- [需确认]
596
- 1. 您看到什么错误讯息?(主控台日志、错误回应)
597
- 2. 哪个档案包含登入逻辑?
598
- 3. 能否分享相关的程序码片段或日志?
599
-
600
- 建议的除错步骤:
601
- - 分享登入控制器/服务程序码
602
- - 提供主控台/服务器的错误日志
603
- - 描述预期与实际行为
604
-
605
- 一旦我审查了实际程序码和错误,就能找出根本原因。
606
- ```
607
-
608
- ---
609
-
610
- ### 情境 4: 技术选型
611
-
612
- **使用者请求**: 「我应该使用什么快取解决方案?」
613
-
614
- **❌ 不良回应**:
615
- ```
616
- 您有几个选项:
617
- 1. Redis
618
- 2. Memcached
619
- 3. 记忆体快取
620
-
621
- 让我知道您想使用哪一个。
622
- ```
623
- **问题**: 列出选项但未推荐或考虑情境。
624
-
625
- **✅ 良好回应**:
626
- ```
627
- 基于可用的选项:
628
- 1. Redis - 分散式、持久化、丰富的资料结构
629
- 2. Memcached - 简单、快速、分散式
630
- 3. 记忆体快取 - 仅本机、无需设定
631
-
632
- **推荐: Redis**
633
-
634
- [需确认] 在最终决定前,我想了解:
635
- - 您需要跨多个实例共享快取吗?
636
- - 需要资料持久化吗?
637
- - 您现有的基础设施是什么?
638
-
639
- 如果您已有 Redis 基础设施或需要跨实例共享,
640
- Redis 是最佳选择。如果这是单实例应用程序且有
641
- 简单的快取需求,记忆体快取就足够了。
642
- ```
643
-
644
- ---
645
-
646
- ## AI 助理工作流程
647
-
648
- ```
649
- ┌─────────────────────────────────┐
650
- │ 收到使用者请求 │
651
- └─────────────┬───────────────────┘
652
- │
653
- ▼
654
- ┌─────────────────────────────────┐
655
- │ 识别所需资讯 │
656
- │ - 程序码档案? │
657
- │ - 设定? │
658
- │ - 需求? │
659
- └─────────────┬───────────────────┘
660
- │
661
- ▼
662
- ┌─────────────────────────────────┐
663
- │ 识别潜在副作用 │
664
- │ - 状态变更? │
665
- │ - 受影响的相依性? │
666
- │ - 外部系统影响? │
667
- └─────────────┬───────────────────┘
668
- │
669
- ▼
670
- ┌────┴────┐
671
- │ 可取得? │
672
- └────┬────┘
673
- │
674
- ┌───────┴───────┐
675
- │ │
676
- 是 否
677
- │ │
678
- ▼ ▼
679
- ┌──────────┐ ┌─────────────┐
680
- │ 读取/ │ │ 向使用者 │
681
- │ 分析 │ │ 询问资讯 │
682
- └────┬─────┘ └──────┬──────┘
683
- │ │
684
- ▼ ▼
685
- ┌─────────────────────────────────┐
686
- │ 为回应加上标签: │
687
- │ - [已确认] 用于事实 │
688
- │ - [推测] 用于推论 │
689
- │ - [需确认] 用于缺口 │
690
- └─────────────┬───────────────────┘
691
- │
692
- ▼
693
- ┌─────────────────────────────────┐
694
- │ 引用来源(档案:行号) │
695
- └─────────────┬───────────────────┘
696
- │
697
- ▼
698
- ┌─────────────────────────────────┐
699
- │ 包含推荐 │
700
- │ (如提出选项) │
701
- └─────────────┬───────────────────┘
702
- │
703
- ▼
704
- ┌─────────────────────────────────┐
705
- │ 提供回应 │
706
- └─────────────────────────────────┘
707
- ```
708
-
709
- ---
710
-
711
- ## 语言无关应用
712
-
713
- 本标准适用于任何程序语言、框架或领域:
714
-
715
- - **Web 开发**: 未经证据不假设 Express/Django/Spring Boot
716
- - **行动开发**: 未经证据不假设 React Native/Flutter
717
- - **资料科学**: 未经证据不假设 TensorFlow/PyTorch
718
- - **DevOps**: 未经证据不假设 Docker/Kubernetes
719
-
720
- **通用规则**: 先读取,再分析,永远以证据报告。
161
+ | 上下文 | 指引 |
162
+ |---------|-----------|
163
+ | 对话互动 | 使用项目指定语言 |
164
+ | 确定性标签 | 使用项目指定语言 |
165
+ | 错误解释 | 使用项目指定语言 |
166
+ | 技术术语 | 保留原文(JWT、BCrypt、API、Token) |
167
+ | 代码注释 | 遵循项目惯例 |
168
+ | Commit 信息 | 遵循项目惯例 |
721
169
 
722
170
  ---
723
171
 
724
- ## 与程序码审查集成
725
-
726
- 执行程序码审查时,应用这些原则:
172
+ ## 相关标准
727
173
 
728
- 1. **引用行号**: 所有审查评论必须引用特定行号
729
- 2. **以证据分类严重性**:
730
- - `[已确认 Bug]` - 程序码明显损坏
731
- - `[潜在问题]` - 程序码可能造成问题
732
- - `[建议]` - 改善想法(非缺陷)
733
- 3. **避免假设**: 如不确定设计意图,询问作者
734
-
735
- **审查评论范本**:
736
- ```
737
- [档案:行号] - [严重性]
738
- [问题描述与程序码摘录]
739
- [证据或推理]
740
- [建议修正或澄清问题]
741
- ```
174
+ - [测试标准](testing-standards.md) - 确保验证 AI 分析结果
175
+ - [代码审查清单](code-review-checklist.md) - 审查 AI 生成的内容
176
+ - [代码签入标准](checkin-standards.md) - AI 协作签入流程
177
+ - [反向工程标准](reverse-engineering-standards.md) - 确定性标签的使用
178
+ - [正向推导标准](forward-derivation-standards.md) - 推导标签的使用
742
179
 
743
180
  ---
744
181
 
745
182
  ## Agent 认识论校准(v1.4.0,XSPEC-008)
746
183
 
747
- Agent 必须使用 Answer / Ask / Abstain 框架声明其认识论状态:
184
+ Agent 必须使用 Answer/Ask/Abstain 框架声明其认识论状态:
748
185
 
749
186
  | 动作 | 使用时机 | 必填字段 |
750
- |------|---------|---------|
751
- | `answer` | 拥有足够信息 | 无(completeness/confidence 为选填)|
187
+ |--------|-------------|----------------|
188
+ | `answer` | 拥有足够信息 | 无(completeness/confidence 为选填) |
752
189
  | `ask` | 缺少关键信息 | `missing_variables` 列表 |
753
- | `abstain` | 真正超出能力范围 | `abstain_reason` |
190
+ | `abstain` | 确实超出能力范围 | `abstain_reason` |
754
191
 
755
192
  **Fail-closed Agent**(必须始终回答):`evaluator`、`guardian`
756
193
 
757
194
  **向后兼容**:缺少 `epistemic` 字段时默认为 `action_type: "answer"`。
758
195
 
759
- 参见:XSPEC-008、DEC-014(PassiveQA)
760
-
761
- ---
762
-
763
- ## 相关标准
764
-
765
- - [测试标准](testing-standards.md) - 确保验证 AI 分析结果(或使用 `/testing-guide` 技能)
766
- - [程序码审查清单](code-review-checklist.md) - 审查 AI 生成内容
767
- - [程序码签入标准](checkin-standards.md) - AI 协作签入流程
196
+ 参见:XSPEC-008、DEC-014 (PassiveQA)
768
197
 
769
198
  ---
770
199
 
771
200
  ## 版本历史
772
201
 
773
202
  | 版本 | 日期 | 变更 |
774
- |------|------|------|
775
- | 1.5.1 | 2026-04-13 | 新增: Agent 认识论校准(Answer/Ask/Abstain)框架(XSPEC-008)|
776
- | 1.4.0 | 2026-01-19 | 新增: 副作用分析规则(第 7 条禁止行为)、工作流程步骤及检查清单项目 |
777
- | 1.3.1 | 2025-12-24 | 新增: 相关标准章节 |
778
- | 1.3.0 | 2025-12-22 | 增强: 禁止行为章节,新增详细对比范例 |
779
- | 1.2.0 | 2025-12-15 | 新增: AI 助手互动规范章节(对话语言、推荐原则) |
780
- | 1.1.0 | 2025-12-10 | 增强来源标注,新增来源类型、版本敏感性与可靠度评级 |
781
- | 1.0.0 | 2025-11-12 | 初版发布 |
203
+ |---------|------|---------|
204
+ | 1.5.1 | 2026-04-13 | 新增:Agent 认识论校准(Answer/Ask/Abstain)框架(XSPEC-008) |
205
+ | 1.5.0 | 2026-01-29 | 重构:拆分为规则与指南,将示例移至指南 |
206
+ | 1.4.0 | 2026-01-19 | 新增:副作用分析规则 |
207
+ | 1.3.1 | 2025-12-24 | 新增:相关标准章节 |
208
+ | 1.3.0 | 2025-12-22 | 增强:包含详细示例的禁止行为 |
209
+ | 1.2.0 | 2025-12-15 | 新增:AI 助手互动规范 |
210
+ | 1.1.0 | 2025-12-10 | 增强:带有来源类型的来源标注 |
211
+ | 1.0.0 | 2025-11-12 | 初始标准发布 |
782
212
 
783
213
  ---
784
214
 
785
- ## 授权
215
+ ## 许可协议
786
216
 
787
217
  本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
788
- 您可以自由调整用于您的专案,但需注明出处。
789
-
790
- ---
791
-
792
- **专案特定化**
793
-
794
- 专案可透过以下方式扩充本标准:
795
- - 领域特定验证需求(如医疗领域的 HIPAA 合规检查)
796
- - 工具特定指引(如如何验证 Terraform 设定)
797
- - 团队特定证据格式(如 JIRA ticket 引用)
798
- - AI 助手对话的语言偏好