universal-dev-standards 6.14.0-beta.8 → 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 (712) 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 +2312 -1102
  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 +2291 -1110
  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 +77 -7
  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-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -1,521 +1,300 @@
1
1
  ---
2
- source: ../../core/anti-hallucination.md
3
- source_version: 1.4.0
2
+ source: ../../../../core/guides/anti-hallucination-guide.md
3
+ source_version: 1.0.0
4
4
  translation_version: 1.4.0
5
- last_synced: 2026-01-19
5
+ last_synced: 2026-10-16
6
+ source_hash: 884f338dfc76
6
7
  status: current
7
8
  ---
8
9
 
9
- # AI 協作防幻覺標準
10
+ # 防幻覺指引
10
11
 
11
- > **語言**: [English](../../../../core/anti-hallucination.md) | 繁體中文
12
+ > **語言**: [English](../../../../core/guides/anti-hallucination-guide.md) | 繁體中文
12
13
 
13
- **版本**: 1.4.0
14
- **最後更新**: 2026-01-19
15
- **適用範圍**: 所有使用 AI 助理協作的軟體專案
14
+ **版本**: 1.0.0
15
+ **最後更新**: 2026-01-29
16
+ **相關標準**: [防幻覺標準](../anti-hallucination.md)
16
17
 
17
18
  ---
18
19
 
19
20
  ## 目的
20
21
 
21
- 本標準定義 AI 助理的嚴格準則,以防止在分析程式碼、提出建議或撰寫系統文件時產生幻覺(生成錯誤或未經驗證的資訊)。
22
+ 本指引提供防止 AI 幻覺的詳細範例、對話模式與案例研究。關於核心規範、標籤系統與驗證檢查清單,請參見 [防幻覺標準](../anti-hallucination.md)。
22
23
 
23
24
  ---
24
25
 
25
- ## AI 助手互動規範
26
+ ## 目錄
26
27
 
27
- ### 對話語言
28
+ 1. [理解 AI 幻覺](#understanding-ai-hallucination)
29
+ 2. [對話語言指引](#conversation-language-guidelines)
30
+ 3. [建議的最佳實務](#recommendation-best-practices)
31
+ 4. [依類別的詳細範例](#detailed-examples-by-category)
32
+ 5. [審查情境](#review-scenarios)
33
+ 6. [AI 助理工作流程](#ai-assistant-workflow)
34
+ 7. [語言無關應用](#language-agnostic-application)
35
+ 8. [與程式碼審查整合](#integration-with-code-review)
28
36
 
29
- AI 助手應適應使用者的偏好語言。當專案指定對話語言時,請遵循以下準則:
37
+ ---
30
38
 
31
- | 情境 | 準則 | 範例 |
32
- |------|------|------|
33
- | 對話互動 | 使用專案指定語言 | 繁體中文、英文等 |
34
- | 確定性標籤 | 使用專案指定語言 | `[已確認]` 或 `[Confirmed]` |
35
- | 錯誤訊息解釋 | 使用專案指定語言 | 以使用者語言解釋編譯/執行錯誤 |
36
- | 技術術語 | 保留原文 | JWT、BCrypt、API、Token |
37
- | 程式碼註解 | 遵循專案慣例 | 通常為英文 |
38
- | Commit 訊息 | 遵循專案慣例 | 如 `feat(auth): 新增登入功能` |
39
+ ## 理解 AI 幻覺
39
40
 
40
- ### 選項建議原則
41
+ AI 幻覺發生於 AI 助理生成看似具權威性但實際上卻是:
42
+ - **捏造**:毫無證據憑空編造
43
+ - **假設**:基於模式而非事實
44
+ - **過時**:來自訓練資料,而非當前現實
45
+ - **錯誤歸屬**:與相似但不同的系統混淆
41
46
 
42
- **規則**: 當提供多個選項時,必須同時提出最推薦的選項並說明理由。
47
+ ### 為什麼這在軟體開發中很重要
43
48
 
44
- | 情境 | 要求 | 範例 |
49
+ | 風險 | 影響 | 範例 |
45
50
  |------|------|------|
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 端點已實作。
87
-
88
- **建議下一步**:
89
- 1. **[推薦]** 為新端點新增單元測試 (`src/tests/api/`)
90
- 2. 更新 API 文件 (`docs/api-reference.md`)
91
- 3. 開始前端整合
92
- ```
51
+ | **捏造的 API** | 執行期錯誤、浪費除錯時間 | 「呼叫 `user.authenticate()` 方法」(不存在) |
52
+ | **錯誤的設定** | 安全性弱點、系統故障 | 「在正式環境中設定 `DEBUG=true`」(錯誤的變數) |
53
+ | **假設的需求** | 建置錯誤的功能 | 「使用者需要 SSO」(從未被指定) |
54
+ | **過時的模式** | 技術債、安全性問題 | 「使用 `componentWillMount`」(在 React 17 中已棄用) |
93
55
 
94
56
  ---
95
57
 
96
- ## 核心原則
97
-
98
- ### 1. 僅基於證據的分析
99
-
100
- **規則**: 僅分析和引用已明確提供或讀取的內容。
101
-
102
- **指引**:
103
- - ✅ 分析已使用檔案讀取工具讀取的程式碼檔案
104
- - ✅ 引用已擷取的文件
105
- - ✅ 引用已檢查的設定檔
106
- - ❌ 不要推測未見過的 API、函式或設定
107
- - ❌ 不要在未驗證的情況下假設框架行為
108
- - ❌ 不要捏造需求細節
58
+ ## 對話語言指引
109
59
 
110
- **範例**:
60
+ ### 適應使用者偏好
111
61
 
112
- ✅ **正確**:
113
- ```
114
- [證據] 在 src/auth/service.ts:45,JWT 驗證邏輯使用 'jsonwebtoken' 函式庫
115
- [證據] package.json 檔案(第 12-18 行)列出 Express 4.18.2 作為相依項目
116
- ```
62
+ AI 助理應適應使用者的偏好語言,同時保持技術準確性:
117
63
 
118
- ❌ **錯誤**:
119
- ```
120
- 此系統使用 Redis 進行快取(程式碼未審查)
121
- UserService 應該有 authenticate() 方法(API 未驗證)
122
- 需求指出我們需要 SSO 登入支援(需求未確認)
123
- ```
64
+ | 情境 | 準則 | 範例 |
65
+ |------|------|------|
66
+ | 對話 | 使用專案指定語言 | 繁體中文、英文等 |
67
+ | 確定性標籤 | 使用專案指定語言 | `[Confirmed]` 或 `[已確認]` |
68
+ | 錯誤解釋 | 使用專案指定語言 | 以使用者的語言解釋編譯/執行期錯誤 |
69
+ | 技術術語 | 保留原文 | JWT、BCrypt、API、Token |
70
+ | 程式碼註解 | 遵循專案慣例 | 通常為英文 |
71
+ | Commit 訊息 | 遵循專案慣例 | 例如 `feat(auth): add login feature` |
124
72
 
125
73
  ---
126
74
 
127
- ### 2. 明確來源標註
128
-
129
- **規則**: 所有引用必須包含來源類型、位置與可驗證性資訊。
130
-
131
- #### 2.1 來源類型
75
+ ## 建議的最佳實務
132
76
 
133
- | 來源類型 | 標籤 | 說明 | 可靠度 |
134
- |---------|------|------|--------|
135
- | 專案程式碼 | `[來源: 程式碼]` | 直接從程式碼庫讀取 | ⭐⭐⭐⭐⭐ 最高 |
136
- | 專案文件 | `[來源: 文件]` | README、Wiki、程式碼註解 | ⭐⭐⭐⭐ 高 |
137
- | 外部文件 | `[來源: 外部]` | 官方文件(附 URL) | ⭐⭐⭐⭐ 高 |
138
- | 網路搜尋 | `[來源: 搜尋]` | 搜尋結果(包含日期) | ⭐⭐⭐ 中 |
139
- | AI 知識 | `[來源: 知識]` | AI 訓練資料(需驗證) | ⭐⭐ 低 |
140
- | 使用者提供 | `[來源: 使用者]` | 使用者對話中的資訊 | ⭐⭐⭐ 中 |
141
-
142
- #### 2.2 標註格式
143
-
144
- **程式碼引用**:
145
- ```
146
- [來源: 程式碼] 檔案路徑:行號 - 描述
147
- ```
77
+ ### 永遠包含推薦的選項
148
78
 
149
- **外部文件**:
150
- ```
151
- [來源: 外部] URL - 描述(版本: x.x.x,存取: YYYY-MM-DD)
152
- ```
79
+ 當提供多個選項時,永遠包含推薦的選項並說明理由:
153
80
 
154
- **AI 知識**:
155
- ```
156
- [來源: 知識] 主題 - 描述(⚠️ 需要驗證)
81
+ **❌ 錯誤**:
157
82
  ```
83
+ There are three options:
84
+ 1. Use Redis caching
85
+ 2. Use in-memory caching
86
+ 3. Use file-based caching
158
87
 
159
- #### 2.3 範例
160
-
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
88
+ Please choose one.
170
89
  ```
171
90
 
172
- ❌ **錯誤**:
173
- ```
174
- 驗證服務使用 BCrypt(無來源類型,無檔案引用)
175
- 設定檔案中某處有資料庫連線(模糊引用)
176
- 我認為 README 提到 .NET 8(不確定語言,無來源)
177
- React useState 的運作方式是...(無版本,無引用)
91
+ **✅ 正確**:
178
92
  ```
93
+ There are three options:
94
+ 1. Use Redis caching
95
+ 2. Use in-memory caching
96
+ 3. Use file-based caching
179
97
 
180
- #### 2.4 版本敏感性
181
-
182
- **規則**: 引用函式庫、框架或 API 時,必須包含版本資訊(如有)。
183
-
184
- **為何重要**:
185
- - API 在不同版本間會改變
186
- - 已棄用的功能可能仍出現在 AI 訓練資料中
187
- - 安全性漏洞是版本特定的
188
-
189
- **範例**:
98
+ **Recommended: Option 1 (Redis)**: Given the project already has Redis infrastructure
99
+ and needs cross-instance cache sharing, Redis is the most suitable choice.
190
100
  ```
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
- ```
195
-
196
- ---
197
101
 
198
- ### 3. 分類確定性等級
199
-
200
- **規則**: 明確區分已確認事實、推測與未知事項。
201
-
202
- **分類標籤**:
203
-
204
- | 標籤 | 使用時機 |
205
- |-----|---------|
206
- | `[已確認]` | 直接來自程式碼/文件的證據 |
207
- | `[推測]` | 基於現有證據的邏輯推論 |
208
- | `[假設]` | 基於常見模式(需驗證)|
209
- | `[未知]` | 資訊不可得 |
210
- | `[需確認]` | 需要使用者澄清 |
102
+ ### 下一步建議
211
103
 
212
- **範例**:
104
+ 當完成一項任務或子任務時,永遠建議合理的下一步:
213
105
 
214
- ✅ **正確**:
215
- ```
216
- [已確認] src/database/connection.ts:12 - 使用 PostgreSQL 驅動程式 'pg'
217
- [推測] 基於 src/repositories/ 中的 repository 模式,可能使用依賴注入
218
- [假設] 專案可能使用 OAuth2,但需要審查驗證設定
219
- [未知] API 速率限制策略未記錄
220
- [需確認] 新功能是否應支援多租戶?
106
+ **✅ 正確**:
221
107
  ```
108
+ Task completed: API endpoint implemented.
222
109
 
223
- ❌ **錯誤**:
224
- ```
225
- 系統使用 Redis(無分類,無證據)
226
- 我們應該實作快取(以事實呈現,非建議)
227
- 使用者需要 SSO 支援(假設以已確認需求呈現)
110
+ **Suggested Next Steps**:
111
+ 1. **[Recommended]** Add unit tests for the new endpoint (`src/tests/api/`)
112
+ 2. Update API documentation (`docs/api-reference.md`)
113
+ 3. Start frontend integration
228
114
  ```
229
115
 
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
- 用於從已核准來源生成測試、規格或文件時。參見[正向推演標準](../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
- | 規格生成 | 推導標籤 | 確定性標籤(用於未知)|
265
-
266
116
  ---
267
117
 
268
- ### 4. 禁止行為
269
-
270
- **AI 助手不得**:
271
-
272
- 1. **捏造 API 或函式簽名**
273
- - ❌ 不要編造方法名稱、參數或回傳類型
274
- - ✅ 要讀取實際原始碼或詢問使用者
275
-
276
- 2. **假設需求**
277
- - ❌ 不要猜測使用者需求或業務規則
278
- - ✅ 當需求模糊時要提出澄清問題
279
-
280
- 3. **推測未讀取的程式碼**
281
- - ❌ 不要描述未審查檔案的功能
282
- - ✅ 要明確表示「需要讀取 [檔案] 以確認」
118
+ ## 各類別詳細範例
283
119
 
284
- 4. **編造設定**
285
- - ❌ 不要假設環境變數、設定鍵或資料庫結構
286
- - ✅ 要審查實際設定檔
120
+ ### 1. 捏造 API 或函式簽名
287
121
 
288
- 5. **憑空產生錯誤或 Bug**
289
- - ❌ 不要在無證據的情況下聲稱程式碼有問題
290
- - ✅ 要分析實際程式碼並引用特定行號
291
-
292
- 6. **提出選項但不推薦**
293
- - ❌ 不要列出選項後要求使用者選擇而不提供指引
294
- - ✅ 要永遠包含推薦選項並附理由
295
-
296
- 7. **未分析副作用即實作**
297
- - ❌ 不要在未識別潛在副作用的情況下開始寫程式碼
298
- - ✅ 要在實作前列出至少 3 個潛在副作用
299
- - ✅ 要考慮:狀態變更、相依性、連鎖效應
300
-
301
- #### 詳細範例
302
-
303
- ##### 1. 捏造 API 或函式名稱
304
-
305
- ❌ **錯誤**:
122
+ **❌ 錯誤**:
306
123
  ```
307
- 助理: 「你可以呼叫 UserService.GetUserById(int id) 來取得使用者」
124
+ Assistant: "You can call UserService.GetUserById(int id) to retrieve users"
308
125
  ```
309
126
  **問題**: 方法不存在或簽名不同。
310
127
 
311
- ✅ **正確**:
128
+ **✅ 正確**:
312
129
  ```
313
- 助理: 「讓我讀取 UserService 檔案以找到正確的方法簽名。」
130
+ Assistant: "Let me read the UserService file to find the correct method signature."
314
131
 
315
- [讀取 src/services/UserService.cs 後]
132
+ [After reading src/services/UserService.cs]
316
133
 
317
- [來源: 程式碼] UserService.cs:45 - 找到方法: FindUser(Guid userId)
318
- 實際方法使用 Guid 而非 int 作為使用者 ID 參數。
134
+ [Source: Code] UserService.cs:45 - Found method: FindUser(Guid userId)
135
+ The actual method uses Guid instead of int for the user ID parameter.
319
136
  ```
320
137
 
321
138
  ---
322
139
 
323
- ##### 2. 假設使用者需求
140
+ ### 2. 假設需求
324
141
 
325
- ❌ **錯誤**:
142
+ **❌ 錯誤**:
326
143
  ```
327
- 助理: 「系統需要支援 OAuth 和 SAML 以提供企業 SSO。」
144
+ Assistant: "The system needs to support OAuth and SAML for enterprise SSO."
328
145
  ```
329
- **問題**: 使用者只詢問認證,未指定協議。
146
+ **問題**: 使用者只詢問驗證,未指定協定。
330
147
 
331
- ✅ **正確**:
148
+ **✅ 正確**:
332
149
  ```
333
- 助理: 「[需確認] 您提到需要驗證功能。
334
- 能否澄清:
335
- 1. 這是給內部使用者、外部客戶,還是兩者都有?
336
- 2. 您需要企業 SSO(OAuth/SAML)還是簡單的使用者名稱/密碼?
337
- 3. 有任何需要整合的現有身分提供者嗎?
150
+ Assistant: "[Need Confirmation] You mentioned needing authentication.
151
+ Could you clarify:
152
+ 1. Is this for internal users, external customers, or both?
153
+ 2. Do you need enterprise SSO (OAuth/SAML) or simple username/password?
154
+ 3. Any existing identity providers to integrate with?
338
155
 
339
- 這將幫助我推薦最適合的方法。」
156
+ This will help me recommend the most appropriate approach."
340
157
  ```
341
158
 
342
159
  ---
343
160
 
344
- ##### 3. 描述未讀取的程式碼功能
161
+ ### 3. 推測未讀取的程式碼
345
162
 
346
- ❌ **錯誤**:
163
+ **❌ 錯誤**:
347
164
  ```
348
- 助理: 「PaymentService 處理信用卡處理並與 Stripe 整合。」
165
+ Assistant: "The PaymentService handles credit card processing and integrates with Stripe."
349
166
  ```
350
167
  **問題**: 檔案未讀取,功能僅從名稱假設。
351
168
 
352
- ✅ **正確**:
169
+ **✅ 正確**:
353
170
  ```
354
- 助理: 「我在您的專案結構中看到名為 PaymentService.cs 的檔案。
171
+ Assistant: "I see a file named PaymentService.cs in your project structure.
355
172
 
356
- [未知] 我尚未讀取此檔案,因此無法確認其功能。
173
+ [Unknown] I haven't read this file yet, so I cannot confirm its functionality.
357
174
 
358
- 您想讓我讀取 src/services/PaymentService.cs 以了解:
359
- - 它使用哪個支付提供者?
360
- - 支援哪些支付方式?
361
- - 交易如何處理?」
175
+ Would you like me to read src/services/PaymentService.cs to understand:
176
+ - Which payment provider it uses?
177
+ - What payment methods are supported?
178
+ - How transactions are processed?"
362
179
  ```
363
180
 
364
181
  ---
365
182
 
366
- ##### 4. 編造設定細節
183
+ ### 4. 編造設定
367
184
 
368
- ❌ **錯誤**:
185
+ **❌ 錯誤**:
369
186
  ```
370
- 助理: 「設定 DATABASE_URL 環境變數以連線到 PostgreSQL。
371
- 您的連線字串應在 appsettings.json 的 'ConnectionStrings:DefaultConnection' 下。」
187
+ Assistant: "Set the DATABASE_URL environment variable to connect to PostgreSQL.
188
+ Your connection string should be in appsettings.json under 'ConnectionStrings:DefaultConnection'."
372
189
  ```
373
- **問題**: 設定結構和變數名稱未經驗證即假設。
190
+ **問題**: 設定結構與變數名稱未經驗證即假設。
374
191
 
375
- ✅ **正確**:
192
+ **✅ 正確**:
376
193
  ```
377
- 助理: 「讓我檢查您的實際設定檔。」
194
+ Assistant: "Let me check your actual configuration files."
378
195
 
379
- [讀取 appsettings.json 後]
196
+ [After reading appsettings.json]
380
197
 
381
- [來源: 程式碼] appsettings.json:8-12 - 找到資料庫設定:
382
- - 連線字串鍵: "ConnectionStrings:MainDb"(非 "DefaultConnection")
383
- - 使用 SQL Server,非 PostgreSQL
384
- - 額外設定 "CommandTimeout": 30
198
+ [Source: Code] appsettings.json:8-12 - Found database configuration:
199
+ - Connection string key: "ConnectionStrings:MainDb" (not "DefaultConnection")
200
+ - Using SQL Server, not PostgreSQL
201
+ - Additional setting "CommandTimeout": 30
385
202
 
386
- 您的專案使用與 .NET 預設不同的鍵名稱。
203
+ Your project uses a different key name than the .NET default.
387
204
  ```
388
205
 
389
206
  ---
390
207
 
391
- ##### 5. 斷言程式碼有 Bug(無證據)
208
+ ### 5. 憑空產生錯誤或 Bug
392
209
 
393
- ❌ **錯誤**:
210
+ **❌ 錯誤**:
394
211
  ```
395
- 助理: 「您的驗證程式碼有安全性漏洞 -
396
- 您沒有正確進行密碼雜湊。」
212
+ Assistant: "Your authentication code has a security vulnerability -
213
+ you're not hashing passwords properly."
397
214
  ```
398
215
  **問題**: 未讀取實際程式碼即聲稱有 Bug。
399
216
 
400
- ✅ **正確**:
217
+ **✅ 正確**:
401
218
  ```
402
- 助理: 「讓我審查您的驗證實作。」
219
+ Assistant: "Let me review your authentication implementation."
403
220
 
404
- [讀取 src/auth/AuthService.cs 後]
221
+ [After reading src/auth/AuthService.cs]
405
222
 
406
- [已確認] AuthService.cs:67 - 找到密碼雜湊實作:
407
- - 使用 BCrypt,work factor 為 12 ✅
408
- - Salt 自動生成 ✅
409
- - 未偵測到時序攻擊漏洞 ✅
223
+ [Confirmed] AuthService.cs:67 - Password hashing implementation found:
224
+ - Using BCrypt with work factor 12 ✅
225
+ - Salt is auto-generated ✅
226
+ - No timing attack vulnerabilities detected ✅
410
227
 
411
- 您的密碼雜湊實作遵循安全性最佳實務。
412
- 在審查的程式碼中未發現問題。
228
+ Your password hashing implementation follows security best practices.
229
+ No issues found in the reviewed code.
413
230
  ```
414
231
 
415
232
  ---
416
233
 
417
- ##### 6. 選項未附推薦
234
+ ### 6. 提出選項但不推薦
418
235
 
419
- ❌ **錯誤**:
236
+ **❌ 錯誤**:
420
237
  ```
421
- 助理: 「您可以使用: 1) JWT 2) Session 3) OAuth。您偏好哪個?」
238
+ Assistant: "You can use: 1) JWT 2) Session 3) OAuth. Which do you prefer?"
422
239
  ```
423
- **問題**: 列出選項但未提供指引或考慮情境。
240
+ **問題**: 列出選項但未提供指引或考量情境。
424
241
 
425
- ✅ **正確**:
242
+ **✅ 正確**:
426
243
  ```
427
- 助理: 「基於您的需求:
244
+ Assistant: "Based on your requirements:
428
245
 
429
- **選項**:
430
- 1. JWT - 無狀態、可擴展、適合 API
431
- 2. Session - 伺服器端狀態、傳統 Web 應用程式
432
- 3. OAuth - 第三方身分提供者
246
+ **Options**:
247
+ 1. JWT - Stateless, scalable, good for APIs
248
+ 2. Session - Server-side state, traditional web apps
249
+ 3. OAuth - Third-party identity providers
433
250
 
434
- **推薦: JWT**
251
+ **Recommended: JWT**
435
252
 
436
- [推測] 基於您的微服務架構(見於 docker-compose.yml),
437
- JWT 是最適合的,因為:
438
- - 無狀態: 跨服務不需要 session 儲存
439
- - 可擴展: 每個服務可獨立驗證 token
440
- - 標準: 在您的技術堆疊(.NET、React)中有良好支援
253
+ [Inferred] Based on your microservices architecture (seen in docker-compose.yml),
254
+ JWT is the best fit because:
255
+ - Stateless: No session store needed across services
256
+ - Scalable: Each service can validate tokens independently
257
+ - Standard: Well-supported across your tech stack (.NET, React)
441
258
 
442
- 如果之後需要社交登入,可以在 JWT 之上加入 OAuth。」
259
+ If you need social login later, you can add OAuth on top of JWT."
443
260
  ```
444
261
 
445
262
  ---
446
263
 
447
- ##### 7. 未分析副作用即實作
264
+ ### 7. 未分析副作用即實作
448
265
 
449
- ❌ **錯誤**:
266
+ **❌ 錯誤**:
450
267
  ```
451
- 使用者: 「新增一個刪除使用者帳號的功能」
452
- 助理: 「這是實作:
268
+ User: "Add a function to delete user accounts"
269
+ Assistant: "Here's the implementation:
453
270
 
454
271
  public async Task DeleteUser(Guid userId) {
455
272
  await _dbContext.Users.Where(u => u.Id == userId).DeleteAsync();
456
273
  }
457
- 」
274
+ "
458
275
  ```
459
- **問題**: 未考慮連鎖效應即直接實作。
276
+ **問題**: 未考量連鎖效應即直接實作。
460
277
 
461
- ✅ **正確**:
278
+ **✅ 正確**:
462
279
  ```
463
- 使用者: 「新增一個刪除使用者帳號的功能」
464
- 助理: 「在實作前,讓我先識別潛在副作用:
280
+ User: "Add a function to delete user accounts"
281
+ Assistant: "Before implementing, let me identify potential side effects:
465
282
 
466
- **潛在副作用**:
467
- 1. **資料完整性**: 相關記錄(訂單、評論、工作階段)可能變成孤立資料
468
- 2. **外部系統**: 可能需要通知第三方服務(支付提供者、電子郵件服務)
469
- 3. **稽核軌跡**: 刪除可能違反合規要求(GDPR 被遺忘權 vs. 稽核日誌)
283
+ **Potential Side Effects**:
284
+ 1. **Data Integrity**: Related records (orders, comments, sessions) may become orphaned
285
+ 2. **External Systems**: May need to notify third-party services (payment provider, email service)
286
+ 3. **Audit Trail**: Deletion may violate compliance requirements (GDPR right to be forgotten vs. audit logs)
470
287
 
471
- [需確認] 應如何處理:
472
- - 相關使用者資料(級聯刪除 vs. 匿名化)?
473
- - 活動中的工作階段?
474
- - 用於報表的歷史記錄?
288
+ [Need Confirmation] How should we handle:
289
+ - Related user data (cascade delete vs. anonymize)?
290
+ - Active sessions?
291
+ - Historical records for reporting?
475
292
 
476
- 一旦確認後,我會提供實作。」
293
+ Once clarified, I'll provide the implementation."
477
294
  ```
478
295
 
479
296
  ---
480
297
 
481
- ## 實施檢查清單
482
-
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
- - 當提出選項時,我是否包含了推薦選項?
512
-
513
- - [ ] **已識別副作用**
514
- - 我是否在實作前列出至少 3 個潛在副作用?
515
- - 我是否考慮了:狀態變更、相依性、外部系統、資料完整性?
516
-
517
- ---
518
-
519
298
  ## 審查情境
520
299
 
521
300
  ### 情境 1: 程式碼分析
@@ -524,23 +303,23 @@ public async Task DeleteUser(Guid userId) {
524
303
 
525
304
  **❌ 不良回應**:
526
305
  ```
527
- 您的驗證系統使用 JWT 搭配 RS256 簽名。
528
- Token 在 1 小時後過期。
529
- 您應該加入 refresh token 支援。
306
+ Your authentication system uses JWT with RS256 signing.
307
+ The tokens expire after 1 hour.
308
+ You should add refresh token support.
530
309
  ```
531
310
  **問題**: 未讀取程式碼即做出聲明,假設實作細節。
532
311
 
533
312
  **✅ 良好回應**:
534
313
  ```
535
- [需確認] 哪個檔案包含驗證邏輯?
536
- 可能的位置包括:
314
+ [Need Confirmation] Which file contains the authentication logic?
315
+ Possible locations might be:
537
316
  - src/auth/
538
317
  - src/services/auth
539
318
  - src/middleware/
540
319
 
541
- 請引導我找到正確的檔案,以便我提供準確分析。
320
+ Please direct me to the correct file so I can provide accurate analysis.
542
321
 
543
- 或者,我可以搜尋程式碼庫中與驗證相關的檔案。
322
+ Alternatively, I can search the codebase for authentication-related files.
544
323
  ```
545
324
 
546
325
  ---
@@ -551,28 +330,28 @@ Token 在 1 小時後過期。
551
330
 
552
331
  **❌ 不良回應**:
553
332
  ```
554
- 基於您現有的架構,您應該:
555
- 1. 在 src/services/ 建立 PaymentService
556
- 2. 使用 Stripe API
557
- 3. 將交易儲存在 payments 資料表
333
+ Based on your existing architecture, you should:
334
+ 1. Create PaymentService in src/services/
335
+ 2. Use the Stripe API
336
+ 3. Store transactions in the payments table
558
337
  ```
559
338
  **問題**: 未經證據即假設架構、支付提供者和資料庫結構。
560
339
 
561
340
  **✅ 良好回應**:
562
341
  ```
563
- 為了提供準確的建議,我需要了解您目前的架構:
342
+ To provide an accurate recommendation, I need to understand your current architecture:
564
343
 
565
- [需確認]
566
- 1. 您計劃使用哪個支付提供者?(Stripe、PayPal、自訂等)
567
- 2. 您現有的服務層結構是什麼?
568
- 3. 您使用什麼資料庫?
344
+ [Need Confirmation]
345
+ 1. What payment provider do you plan to use? (Stripe, PayPal, custom, etc.)
346
+ 2. What is your existing service layer structure?
347
+ 3. What database are you using?
569
348
 
570
- 能否分享:
571
- - 專案結構(ls -R src/ 或類似)
572
- - 現有服務範例
573
- - 資料庫結構或 ORM 模型
349
+ Could you share:
350
+ - Project structure (ls -R src/ or similar)
351
+ - Existing service examples
352
+ - Database schema or ORM models
574
353
 
575
- 一旦我審查了這些,就能建議與您的模式一致的結構。
354
+ Once I review these, I can suggest a structure that aligns with your patterns.
576
355
  ```
577
356
 
578
357
  ---
@@ -583,26 +362,26 @@ Token 在 1 小時後過期。
583
362
 
584
363
  **❌ 不良回應**:
585
364
  ```
586
- 問題可能在您的 validateCredentials() 函式中。
587
- 您可能需要在比對前對密碼進行雜湊。
365
+ The issue is likely in your validateCredentials() function.
366
+ You probably need to hash the password before comparison.
588
367
  ```
589
368
  **問題**: 未看程式碼即猜測原因。
590
369
 
591
370
  **✅ 良好回應**:
592
371
  ```
593
- 要調查登入失敗,我需要更多資訊:
372
+ To investigate the login failure, I need more information:
594
373
 
595
- [需確認]
596
- 1. 您看到什麼錯誤訊息?(主控台日誌、錯誤回應)
597
- 2. 哪個檔案包含登入邏輯?
598
- 3. 能否分享相關的程式碼片段或日誌?
374
+ [Need Confirmation]
375
+ 1. What error message are you seeing? (console logs, error responses)
376
+ 2. Which file contains the login logic?
377
+ 3. Can you share relevant code snippets or logs?
599
378
 
600
- 建議的除錯步驟:
601
- - 分享登入控制器/服務程式碼
602
- - 提供主控台/伺服器的錯誤日誌
603
- - 描述預期與實際行為
379
+ Suggested debugging steps:
380
+ - Share the login controller/service code
381
+ - Provide error logs from console/server
382
+ - Describe expected vs actual behavior
604
383
 
605
- 一旦我審查了實際程式碼和錯誤,就能找出根本原因。
384
+ Once I review the actual code and errors, I can identify the root cause.
606
385
  ```
607
386
 
608
387
  ---
@@ -613,32 +392,32 @@ Token 在 1 小時後過期。
613
392
 
614
393
  **❌ 不良回應**:
615
394
  ```
616
- 您有幾個選項:
395
+ You have several options:
617
396
  1. Redis
618
397
  2. Memcached
619
- 3. 記憶體快取
398
+ 3. In-memory cache
620
399
 
621
- 讓我知道您想使用哪一個。
400
+ Let me know which one you'd like to use.
622
401
  ```
623
- **問題**: 列出選項但未推薦或考慮情境。
402
+ **問題**: 列出選項但未提供推薦或考量情境。
624
403
 
625
404
  **✅ 良好回應**:
626
405
  ```
627
- 基於可用的選項:
628
- 1. Redis - 分散式、持久化、豐富的資料結構
629
- 2. Memcached - 簡單、快速、分散式
630
- 3. 記憶體快取 - 僅本機、無需設定
406
+ Based on the options available:
407
+ 1. Redis - Distributed, persistent, rich data structures
408
+ 2. Memcached - Simple, fast, distributed
409
+ 3. In-memory cache - Local only, no setup required
631
410
 
632
- **推薦: Redis**
411
+ **Recommended: Redis**
633
412
 
634
- [需確認] 在最終決定前,我想了解:
635
- - 您需要跨多個實例共享快取嗎?
636
- - 需要資料持久化嗎?
637
- - 您現有的基礎設施是什麼?
413
+ [Need Confirmation] Before finalizing, I'd like to understand:
414
+ - Do you need cache sharing across multiple instances?
415
+ - Is data persistence required?
416
+ - What's your existing infrastructure?
638
417
 
639
- 如果您已有 Redis 基礎設施或需要跨實例共享,
640
- Redis 是最佳選擇。如果這是單實例應用程式且有
641
- 簡單的快取需求,記憶體快取就足夠了。
418
+ If you already have Redis infrastructure or need cross-instance sharing,
419
+ Redis is the best choice. If this is a single-instance application with
420
+ simple caching needs, in-memory cache would suffice.
642
421
  ```
643
422
 
644
423
  ---
@@ -647,62 +426,62 @@ Redis 是最佳選擇。如果這是單實例應用程式且有
647
426
 
648
427
  ```
649
428
  ┌─────────────────────────────────┐
650
- │ 收到使用者請求 │
429
+ │ User Request Received │
651
430
  └─────────────┬───────────────────┘
652
431
  │
653
432
  ▼
654
433
  ┌─────────────────────────────────┐
655
- │ 識別所需資訊 │
656
- │ - 程式碼檔案? │
657
- │ - 設定? │
658
- │ - 需求? │
434
+ │ Identify Information Needed │
435
+ │ - Code files? │
436
+ │ - Configuration? │
437
+ │ - Requirements? │
659
438
  └─────────────┬───────────────────┘
660
439
  │
661
440
  ▼
662
441
  ┌─────────────────────────────────┐
663
- │ 識別潛在副作用 │
664
- │ - 狀態變更? │
665
- │ - 受影響的相依性? │
666
- │ - 外部系統影響? │
442
+ │ Identify Potential Side Effects│
443
+ │ - State changes? │
444
+ │ - Dependencies affected? │
445
+ │ - External system impacts? │
667
446
  └─────────────┬───────────────────┘
668
447
  │
669
448
  ▼
670
449
  ┌────┴────┐
671
- │ 可取得? │
450
+ │ Available? │
672
451
  └────┬────┘
673
452
  │
674
453
  ┌───────┴───────┐
675
454
  │ │
676
- 是 否
455
+ YES NO
677
456
  │ │
678
457
  ▼ ▼
679
458
  ┌──────────┐ ┌─────────────┐
680
- │ 讀取/ │ │ 向使用者 │
681
- │ 分析 │ │ 詢問資訊 │
459
+ │ Read/ │ │ Ask User │
460
+ │ Analyze │ │ for Info │
682
461
  └────┬─────┘ └──────┬──────┘
683
462
  │ │
684
463
  ▼ ▼
685
464
  ┌─────────────────────────────────┐
686
- │ 為回應加上標籤: │
687
- │ - [已確認] 用於事實 │
688
- │ - [推測] 用於推論 │
689
- │ - [需確認] 用於缺口 │
465
+ │ Tag Response with: │
466
+ │ - [Confirmed] for facts │
467
+ │ - [Inferred] for deductions │
468
+ │ - [Need Confirmation] for gaps │
690
469
  └─────────────┬───────────────────┘
691
470
  │
692
471
  ▼
693
472
  ┌─────────────────────────────────┐
694
- │ 引用來源(檔案:行號) │
473
+ │ Cite Sources (file:line) │
695
474
  └─────────────┬───────────────────┘
696
475
  │
697
476
  ▼
698
477
  ┌─────────────────────────────────┐
699
- │ 包含推薦 │
700
- │ (如提出選項) │
478
+ │ Include Recommendation │
479
+ │ (if presenting options) │
701
480
  └─────────────┬───────────────────┘
702
481
  │
703
482
  ▼
704
483
  ┌─────────────────────────────────┐
705
- │ 提供回應 │
484
+ │ Deliver Response │
706
485
  └─────────────────────────────────┘
707
486
  ```
708
487
 
@@ -734,46 +513,14 @@ Redis 是最佳選擇。如果這是單實例應用程式且有
734
513
 
735
514
  **審查評論範本**:
736
515
  ```
737
- [檔案:行號] - [嚴重性]
738
- [問題描述與程式碼摘錄]
739
- [證據或推理]
740
- [建議修正或澄清問題]
516
+ [file:line] - [Severity]
517
+ [Description of issue with code excerpt]
518
+ [Evidence or reasoning]
519
+ [Suggested fix or question for clarification]
741
520
  ```
742
521
 
743
522
  ---
744
523
 
745
- ## 相關標準
746
-
747
- - [測試標準](../testing-standards.md) - 確保驗證 AI 分析結果(或使用 `/testing-guide` 技能)
748
- - [程式碼審查清單](../code-review-checklist.md) - 審查 AI 生成內容
749
- - [程式碼簽入標準](../checkin-standards.md) - AI 協作簽入流程
750
-
751
- ---
752
-
753
- ## 版本歷史
754
-
755
- | 版本 | 日期 | 變更 |
756
- |------|------|------|
757
- | 1.4.0 | 2026-01-19 | 新增: 副作用分析規則(第 7 條禁止行為)、工作流程步驟及檢查清單項目 |
758
- | 1.3.1 | 2025-12-24 | 新增: 相關標準章節 |
759
- | 1.3.0 | 2025-12-22 | 增強: 禁止行為章節,新增詳細對比範例 |
760
- | 1.2.0 | 2025-12-15 | 新增: AI 助手互動規範章節(對話語言、推薦原則) |
761
- | 1.1.0 | 2025-12-10 | 增強來源標註,新增來源類型、版本敏感性與可靠度評級 |
762
- | 1.0.0 | 2025-11-12 | 初版發布 |
763
-
764
- ---
765
-
766
- ## 授權
767
-
768
- 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
769
- 您可以自由調整用於您的專案,但需註明出處。
770
-
771
- ---
772
-
773
- **專案特定化**
524
+ ## 授權條款
774
525
 
775
- 專案可透過以下方式擴充本標準:
776
- - 領域特定驗證需求(如醫療領域的 HIPAA 合規檢查)
777
- - 工具特定指引(如如何驗證 Terraform 設定)
778
- - 團隊特定證據格式(如 JIRA ticket 引用)
779
- - AI 助手對話的語言偏好
526
+ 本指南以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。