universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -1,19 +1,21 @@
1
1
  ---
2
2
  source: ../../../core/developer-memory.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-02-07
6
- status: stale
3
+ source_version: 1.2.1
4
+ translation_version: 1.2.1
5
+ last_synced: 2026-10-11
6
+ source_hash: 4f480ae3038e
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 開發者持久記憶標準
10
11
 
11
12
  > [English](../../../core/developer-memory.md) | **繁體中文**
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-02-07
14
+ **版本**: 1.2.1
15
+ **最後更新**: 2026-10-07
15
16
  **適用範圍**: 所有使用 AI 助手的軟體專案
16
17
  **範圍**: 通用 (Universal)
18
+ **負責規格**: XSPEC-291(developer-memory 沒有專屬的功能 XSPEC;由 XSPEC-291 負責)
17
19
  **產業標準**: 無 (UDS 原創)
18
20
 
19
21
  ---
@@ -241,11 +243,13 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
241
243
 
242
244
  #### 退役建議
243
245
 
244
- | 觸發條件 | 動作 |
245
- |---------|------|
246
- | `confidence < 0.2` | 建議退役 |
247
- | 超過 180 天未浮現且 `confidence < 0.5` | 建議退役 |
248
- | 5+ 筆 `invalid` 回饋 | 建議退役 |
246
+ 以下閾值為 UDS 預設值(可依專案設定);每個值都記錄了理由,使其可供稽核而非任意設定。
247
+
248
+ | 觸發條件 | 動作 | 理由 |
249
+ |---------|------|------|
250
+ | `confidence < 0.2` | 建議退役 | 一再被判定無效的知識,雜訊多於訊號 |
251
+ | 超過 180 天未浮現且 `confidence < 0.5` | 建議退役 | 半年未被使用再加上低信心度,代表此記憶已與當前工作無關;180 天的時間窗與下方「過時偵測」的過時/衰減模型一致 |
252
+ | 5+ 筆 `invalid` 回饋 | 建議退役 | 持續的負面回饋表示此記憶有誤或已過時 |
249
253
 
250
254
  #### 過時偵測
251
255
 
@@ -254,6 +258,26 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
254
258
  | `validity.type == "versioned"` 且版本已過時 | 標記為過時 |
255
259
  | `validity.type == "temporal"` 且 `expires_at` 已過 | 標記為已過期 |
256
260
  | `validity.type == "evergreen"` | 跳過版本檢查 |
261
+ | 被召回的記憶引用的檔案路徑或符號(函式/類別)已不存在於該位置,或已移動 | 標記為 `code-reference` 過時——見下方 |
262
+
263
+ #### 程式碼參照過時(`code-reference`)
264
+
265
+ 程式碼會移動;針對舊位置記錄的記憶不會自行更新。此檢查用於捕捉以下情況:記憶的洞察仍然成立,但其引用(檔案路徑或函式/類別名稱)已不成立。
266
+
267
+ 此檢查沿用 **[Knowledge Graph Memory](knowledge-graph-memory.md) §2 已定義的兩種運作模式**,而不另創第三種:
268
+
269
+ | 模式 | 時機 | 方式 |
270
+ |------|------|------|
271
+ | 降級模式(無圖引擎) | 任何工具皆可、無需額外設定——預設模式 | 使用記憶前,助手自行確認所引用的路徑/符號仍存在(`Glob`/`Grep`/`Read`)——與 §5 記憶驗證原則既有要求的機制相同 |
272
+ | 引擎模式(已建立圖引擎索引,例如 [EngramGraph](https://github.com/AsiaOstrich/EngramGraph) 的 `egr refs check`) | 可用時 | 引擎回報每個引用的狀態:`present`/`moved`(附新位置)/`missing`/`unresolvable` |
273
+
274
+ > 正確實作在兩種模式下產生相同形狀的答案(Knowledge Graph Memory §2.2)——引擎模式只是更快更完整,並非本質不同。
275
+
276
+ **`unresolvable` 不得(MUST NOT)被視為 `present` 或 `missing`。** 它表示檢查器無法對該引用得出答案(例如超出索引範圍的跨 repo 參照,見 Knowledge Graph Memory §2.2 的跨域注意事項)——這種不確定性必須以獨立狀態傳達給助手,而不是悄悄變成偽陽性(視為仍有效)或偽陰性(視為已消失)。
277
+
278
+ **時機**:此檢查作為 `proactive-surfacing`(§4.1)的一部分執行——在記憶顯示之前,而非之後。引用解析為 `missing` 的記憶,不會被當作沒有任何變化般悄悄浮現。
279
+
280
+ **範圍(第一批)**:僅限檔案路徑與符號名稱(函式/類別名稱)。`file:line` 參照明確**不在範圍內**——行號會隨該檔案任何無關的編輯而漂移,這與「此檔案/符號已不存在」屬於不同種類的過時(見 DEC-115 OQ-1;預定於 2027-01-31 前重新檢視)。
257
281
 
258
282
  #### 修訂建議
259
283
 
@@ -284,6 +308,7 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
284
308
  | 冷卻期 | 每條目 7 天 | 防止重複建議 |
285
309
  | 每次觸發上限 | 3–5 條 | 防止資訊過載 |
286
310
  | 溢出處理 | AI 歸納為分組洞察 | 當 > 5 個匹配時 |
311
+ | 程式碼參照檢查 | 浮現前執行(§3.4 `code-reference` 過時檢查,降級或引擎模式) | 檔案/符號引用已無法解析的記憶,不得未加標記就浮現 |
287
312
 
288
313
  #### 浮現格式
289
314
 
@@ -337,7 +362,35 @@ AI 應偵測這些開發者信號並建議記錄:
337
362
 
338
363
  ---
339
364
 
340
- ## 5. 雜訊控制
365
+ ## 5. Memory Verification Principle(記憶是線索,非結論)
366
+
367
+ > 借鑑 lintsinghua/claude-code-book 記憶驗證原則。
368
+
369
+ 記憶提供方向,但**不能直接作為事實使用**。使用記憶前須獨立驗證:
370
+
371
+ | 記憶內容 | 驗證方法 | 衝突時處理 |
372
+ |---------|---------|-----------|
373
+ | 檔案路徑 | 確認檔案仍存在(Glob/Read) | 標記記憶為 `needs-revision` |
374
+ | 函式名稱/API flag | 確認仍存在(Grep/文件) | 標記記憶為 `needs-revision` |
375
+ | 架構快照/Repo 狀態 | 優先信任 `git log`/原始碼 | 更新記憶為當前狀態 |
376
+ | 套件版本/相依 | 確認 package.json/lockfile | 以實際版本為準 |
377
+
378
+ ### 禁止行為
379
+
380
+ - 直接引用記憶中的具體 API/路徑/函式名稱推薦給使用者,未先驗證
381
+ - 宣稱「根據記憶,X 存在」而未執行獨立確認
382
+ - 因記憶內容與現況衝突時,選擇信任記憶而非當前觀察
383
+
384
+ ### 記憶用途場景
385
+
386
+ 記憶適合提供:
387
+ - **搜尋方向**:「這類問題上次在 X 模組找到答案」
388
+ - **模式線索**:「這個錯誤模式對應已知 pitfall MEM-2026-0042」
389
+ - **決策背景**:「此設計決策的歷史背景是...」
390
+
391
+ ---
392
+
393
+ ## 6. 雜訊控制
341
394
 
342
395
  ### 推送層級
343
396
 
@@ -517,6 +570,7 @@ by_category:
517
570
  - [AI 指令標準](ai-instruction-standards.md) — Token 效率優化的記憶系統指令格式
518
571
  - [AI 友善架構](ai-friendly-architecture.md) — 支援記憶整合的專案結構
519
572
  - [文件撰寫標準](documentation-writing-standards.md) — 記憶條目的撰寫品質
573
+ - [知識圖記憶](knowledge-graph-memory.md) — `code-reference` 過時檢查(§3.4)所沿用的降級/引擎雙模式來源
520
574
 
521
575
  ---
522
576
 
@@ -563,10 +617,55 @@ AI 載入 developer-memory.ai.yaml
563
617
 
564
618
  ---
565
619
 
620
+ ## 11. 工具採用範例:程式碼參照檢查(非規範性)
621
+
622
+ 本節示範一種將 `code-reference` 過時檢查(§3.4)接入工具自身自動化的方式。這僅是說明文件——UDS 不提供此 hook,`uds init`/`uds update` 也不會安裝它。
623
+
624
+ ### Claude Code
625
+
626
+ Claude Code 的自動記憶位於 repo 之外的 `~/.claude/projects/<project-path>/memory/`。`SessionStart` hook 可在該 session 第一次浮現記憶前,對該目錄執行檢查;沒有圖引擎時則退回降級模式:
627
+
628
+ ```bash
629
+ #!/usr/bin/env bash
630
+ # Illustrative only — not installed by any UDS command.
631
+ MEMORY_DIR="$HOME/.claude/projects/$(pwd | tr '/' '-')/memory"
632
+
633
+ if command -v egr >/dev/null 2>&1 && [ -f .engram/graph.db ]; then
634
+ # Engine mode (§3.4): egr resolves each cited path/symbol.
635
+ egr refs check "$MEMORY_DIR"
636
+ else
637
+ # Degraded mode (§3.4): no engine configured — nothing to run up
638
+ # front; the assistant verifies each citation itself before use (§5).
639
+ echo "[developer-memory] no graph engine detected; degraded mode applies"
640
+ fi
641
+ ```
642
+
643
+ ### 其他工具
644
+
645
+ 沒有 session 啟動 hook 的工具,仍可透過以下任一方式符合本標準:
646
+
647
+ - 在 repo 自身的指令檔(`CLAUDE.md`、`AGENTS.md`、`.cursorrules`、`.clinerules`、`.windsurfrules`、`copilot-instructions.md`、`GEMINI.md`、`.roo/rules/` 等)中加入規則,指示助手在依賴某筆記憶前先驗證其引用的路徑/符號;或
648
+ - 以 pre-commit 檢查掃描 repo 自身的指令檔,找出已無法解析的引用。
649
+
650
+ ---
651
+
652
+ ## 邊界:本標準不放什麼
653
+
654
+ 下面兩種資訊不在本標準的範圍內,寫進這裡是錯的:
655
+
656
+ - **個人、跨專案、可識別的資訊**(誰負責什麼、怎麼連到某個環境)。去識別化(見上方的 schema)會把這些剝掉,所以它們不能是一筆記憶條目。它們屬於使用者自己的 AI 工具的記憶——那種記憶綁定該使用者與該機器,不被分享。
657
+ - **專案之間的協調**(哪件工作在等哪件工作)。那是開放工作,不是記憶:見 [Open Work Tracking](open-work-tracking.md)(OWT-027–OWT-029)。
658
+
659
+ ---
660
+
566
661
  ## 版本歷史
567
662
 
568
663
  | 版本 | 日期 | 變更 |
569
664
  |------|------|------|
665
+ | 1.2.1 | 2026-10-07 | 新增:邊界章節——個人、跨專案、可識別的資訊,以及專案之間的協調,都不是記憶條目(XSPEC-460 R5;patch,無行為變更) |
666
+ | 1.2.0 | 2026-09-25 | 新增:審查(§3.4)的 `code-reference` 過時檢查——引用已移動/遺失之檔案路徑或符號的記憶會在浮現前被標記;沿用 Knowledge Graph Memory 的降級/引擎雙模式而非另創第三種;`unresolvable` 不得被解讀為 present 或 missing;範圍僅限檔案路徑與符號名稱(`file:line` 明確排除,DEC-115 OQ-1);§11 新增非規範性的 Claude Code 採用範例(DEC-115-L1) |
667
+ | 1.1.1 | 2026-06-18 | 新增:指向 XSPEC-291 的 `Owning Spec` 標頭(patch,無行為變更;XSPEC-291 §11 處置) |
668
+ | 1.1.0 | 2026-06-18 | 新增:退役建議閾值加上理由欄與可設定說明(XSPEC-292 T8) |
570
669
  | 1.0.0 | 2026-02-07 | 初始標準:schema、4 項操作、主動協議、雜訊控制、架構決策(Always-On Protocol) |
571
670
 
572
671
  ---
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/documentation-lifecycle.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-27
5
+ last_synced: 2026-10-11
6
+ source_hash: 3b074ed1b0bb
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/documentation-structure.md
3
3
  source_version: 1.5.0
4
4
  translation_version: 1.5.0
5
- last_synced: 2026-03-17
5
+ last_synced: 2026-10-11
6
+ source_hash: 453295968842
6
7
  status: current
7
8
  ---
8
9
 
@@ -1393,6 +1394,14 @@ graduated-to: path/to/formal-doc.md # 若已畢業
1393
1394
 
1394
1395
  文件中的程式碼範例應進行驗證,以防止與實際實作脫節:
1395
1396
 
1397
+ ```markdown
1398
+ <!-- doctest: lang=bash, skip=false -->
1399
+ ```bash
1400
+ npm install your-package
1401
+ npm test
1402
+ ```
1403
+ ```
1404
+
1396
1405
  **驗證方式**:
1397
1406
 
1398
1407
  | 方式 | 說明 | 最適用於 |
@@ -1434,16 +1443,16 @@ graduated-to: path/to/formal-doc.md # 若已畢業
1434
1443
 
1435
1444
  ## 版本歷史
1436
1445
 
1437
- | Version | Date | Changes |
1446
+ | 版本 | 日期 | 變更 |
1438
1447
  |---------|------|---------|
1439
1448
  | 1.5.0 | 2026-03-17 | 新增:Diátaxis 文件分類、LLM 發現檔案(llms.txt)、文件測試標準(5 層測試、追溯矩陣、CI/CD 整合) |
1440
1449
  | 1.4.0 | 2026-03-04 | 新增:開發中間產物(docs/working/)目錄與生命週期管理、擴展文件類型矩陣 |
1441
- | 1.3.0 | 2026-01-24 | Added: 規格文件標準與 specs/ 目錄結構 |
1442
- | 1.2.2 | 2025-12-24 | Added: Related Standards section |
1443
- | 1.2.1 | 2025-12-12 | Added: Physical DFD layer, Flows vs Diagrams separation clarification |
1444
- | 1.2.0 | 2025-12-11 | Added: Flow documentation standards, Cross-reference standards, Index document standards, CHANGELOG documentation integration, Document requirements matrix, DFD standards |
1445
- | 1.1.0 | 2025-12-11 | Added: File naming conventions, Document version alignment standard |
1446
- | 1.0.0 | 2025-11-12 | Initial documentation structure standard |
1450
+ | 1.3.0 | 2026-01-24 | 新增:規格文件標準與 specs/ 目錄結構 |
1451
+ | 1.2.2 | 2025-12-24 | 新增:相關標準章節 |
1452
+ | 1.2.1 | 2025-12-12 | 新增:實體 DFD 層級、釐清流程與圖表的分離 |
1453
+ | 1.2.0 | 2025-12-11 | 新增:流程文件規範、交叉連結規範、索引文件規範、CHANGELOG 文件變更整合、文件需求矩陣、DFD 規範 |
1454
+ | 1.1.0 | 2025-12-11 | 新增:檔案命名規範、文件版本對齊標準 |
1455
+ | 1.0.0 | 2025-11-12 | 初始文件結構標準 |
1447
1456
 
1448
1457
  ---
1449
1458
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/dual-phase-output.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 6a2398bdff72
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,71 +11,21 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/dual-phase-output.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-15
15
- **適用範圍**: 所有需要 LLM 審查的場景(Judge、Evaluator、Guardian、AutoCompact)
16
- **Scope**: universal
17
- **來源**: XSPEC-035(claude-code-book Ch.7 formatCompactSummary dual-phase output)
18
-
19
- ---
20
-
21
- ## 目的
22
-
23
- 雙階段 LLM 輸出模式:`<analysis>` 思考丟棄,`<summary>` 結構化保留。
24
-
25
- 讓 LLM 充分推理的同時,避免思考過程累積在上下文中消耗 token 預算。
26
-
27
- ---
28
-
29
- ## 核心規範
30
-
31
- - 所有 LLM 審查 Agent 必須要求雙階段輸出格式(`<analysis>` + `<summary>`)
32
- - `<analysis>` 在後處理時必須丟棄,不得寫入持久化上下文或對話歷史
33
- - `<summary>` 必須包含結構化結論欄位(`decision`、`confidence`、`findings`、`next_action`)
34
- - 若回應缺少雙階段格式,後處理器必須降級相容(完整回應視為 summary)並記錄警告
35
- - `summary` 欄位命名需遵循本標準,各應用場景可擴充但不可刪減核心欄位
36
-
37
- ---
38
-
39
- ## 輸出格式
40
-
41
- ### `<analysis>` 標籤
42
-
43
- - **用途**:LLM 思考草稿 — 後處理時丟棄
44
- - **內容指引**:
45
- - 逐條審查邏輯
46
- - 邊界情境考量
47
- - 替代方案比較
14
+ > **來源**: XSPEC-035 | **借鑑自**: claude-code-book Ch.7 AutoCompact
48
15
 
49
- ### `<summary>` 標籤
16
+ ## 概述
50
17
 
51
- - **用途**:結構化結論 — 後處理時保留
18
+ 雙階段 LLM 輸出模式要求 LLM 審查 Agent 在單一回應中產出兩個 XML 區塊:`<analysis>` 思考草稿(處理後丟棄)與 `<summary>` 結構化結論(保留)。如此能讓模型充分推理,同時避免思考過程累積在對話上下文中。
52
19
 
53
- **核心欄位**(必填):
20
+ ## 問題
54
21
 
55
- | 欄位 | 類型 | 值 |
56
- |------|------|-----|
57
- | `decision` | enum | `approved \| rejected \| needs_revision` |
58
- | `confidence` | enum | `high \| medium \| low` |
59
- | `findings` | array | `[type] description` 格式 |
60
- | `next_action` | string | 建議的後續行動 |
22
+ 審查 Agent(Judge、Evaluator、Guardian)通常產生 2000–5000 token 的回應,其中 50–70% 是會累積在對話歷史中的推理內容。在重複審查情境(Fix Loop 重試 3 次)下,每個任務會浪費 3000–10500 token。
61
23
 
62
- **擴充欄位**(依場景新增,不可刪減核心欄位):
63
-
64
- | 場景 | 額外欄位範例 |
65
- |------|------------|
66
- | 安全審查 | `severity: critical \| high \| medium \| low`, `cwe_ids: [CWE-NNN]` |
67
- | 品質審查 | `test_coverage: number`, `tech_debt_score: number` |
68
-
69
- ---
70
-
71
- ## Prompt 模板
72
-
73
- ```
74
- You MUST respond using EXACTLY this two-phase XML structure:
24
+ ## 格式
75
25
 
26
+ ```xml
76
27
  <analysis>
77
- [Your reasoning process — will be DISCARDED after processing]
28
+ [Reasoning scratchpad — DISCARDED after processing]
78
29
  - Step-by-step evaluation
79
30
  - Edge case considerations
80
31
  - Alternative comparisons
@@ -87,46 +38,33 @@ findings:
87
38
  - [type] description
88
39
  next_action: [recommended follow-up action]
89
40
  </summary>
90
-
91
- IMPORTANT: The <analysis> block is your scratchpad. Only <summary> persists.
92
41
  ```
93
42
 
94
- ---
95
-
96
43
  ## 後處理規則
97
44
 
98
- | 步驟 | 動作 |
99
- |------|------|
100
- | 提取 summary | 用正則 `<summary>([\s\S]*?)</summary>` 擷取 |
101
- | 丟棄 analysis | 用正則 `<analysis>([\s\S]*?)</analysis>` 移除 |
102
- | 降級相容 | 若缺少 `<summary>` 標籤,完整回應視為 summary 內容,記錄 `warn` 日誌 |
45
+ 1. 擷取 `<summary>` 內容 → 持久化至上下文
46
+ 2. 丟棄 `<analysis>` 內容 → 絕不寫入對話歷史
47
+ 3. 若缺少 `<summary>` 標籤 → 降級處理:將完整回應視為 summary,並記錄 `[WARN] dual-phase format missing`
103
48
 
104
- ---
49
+ ## 擴充欄位
105
50
 
106
- ## Token 節省估算
51
+ 各應用可在 `<summary>` 內新增欄位,但不得刪除核心欄位:
52
+ - **安全(Guardian)**:`severity: critical | high | medium | low`、`cwe_ids: [CWE-NNN]`
53
+ - **品質(Evaluator)**:`test_coverage: number`、`tech_debt_score: number`
107
54
 
108
- | 指標 | 數值 |
109
- |------|------|
110
- | `<analysis>` 佔一般審查回應比例 | 50–70% |
111
- | 每次審查節省 token | 1,000–3,500 |
112
- | Fix Loop 3 輪累計節省 | 3,000–10,500 |
113
- | 備註 | 節省效果在重複審查場景(Fix Loop、Feedback Loop)中累積 |
55
+ ## Token 影響
114
56
 
115
- ---
57
+ | 情境 | 節省量 |
58
+ |------|--------|
59
+ | 單次審查 | 1000–3500 token |
60
+ | Fix Loop(重試 3 次) | 3000–10500 token |
61
+ | 多 Agent 管線(evaluator + guardian;採用層) | 每次執行 2000–7000 token |
116
62
 
117
- ## 適用 Agent
63
+ ## 參考資料
118
64
 
119
- - Judge Agent(採用層)
120
- - Evaluator Agent(採用層)
121
- - Guardian Agent(採用層)
122
- - 任何 LLM 驅動的 AutoCompact/摘要組件
65
+ - AI 最佳化版:[ai/standards/dual-phase-output.ai.yaml](../../../ai/standards/dual-phase-output.ai.yaml)
66
+ - XSPEC-035:跨專案規格
67
+ - 借鑑自:[claude-code-book](https://github.com/lintsinghua/claude-code-book) Ch.7 `formatCompactSummary`
123
68
 
124
- ---
125
-
126
- ## 錯誤碼
127
69
 
128
- | 代碼 | 說明 |
129
- |------|------|
130
- | `DPO-001` | `summary` 標籤缺失 — 降級相容已啟用 |
131
- | `DPO-002` | `analysis` 標籤缺失 — 完整回應照常處理 |
132
- | `DPO-003` | `summary` 必填欄位缺失 — 解析錯誤 |
70
+ **Scope**: universal
@@ -1,14 +1,25 @@
1
1
  ---
2
2
  source: ../../../core/error-code-standards.md
3
- source_version: 1.2.0
4
- translation_version: 1.2.0
5
- last_synced: 2026-03-18
6
- status: stale
3
+ source_version: 1.2.1
4
+ translation_version: 1.2.1
5
+ last_synced: 2026-10-11
6
+ source_hash: 52ddb355e07f
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 錯誤碼標準
10
11
 
11
- > 版本: 1.2.0 | 最後更新: 2026-03-18
12
+ > **語言**: [English](../../../core/error-code-standards.md) | 繁體中文
13
+
14
+ **版本**: 1.2.1
15
+ **最後更新**: 2026-06-18
16
+ **適用範圍**: 所有軟體專案
17
+ **範疇**: universal
18
+ **Owning Spec**: XSPEC-291(無專屬功能 XSPEC;本標準由 XSPEC-291 負責)
19
+ **業界標準**: RFC 7807、RFC 9457
20
+ **參考資料**: [datatracker.ietf.org](https://datatracker.ietf.org/doc/html/rfc7807)
21
+
22
+ ---
12
23
 
13
24
  ## 概述
14
25
 
@@ -31,7 +42,7 @@ status: stale
31
42
  ### 範例
32
43
 
33
44
  ```
34
- AUTH_VAL_001 → 驗證驗證錯誤
45
+ AUTH_VAL_001 → 身份驗證的驗證錯誤
35
46
  PAY_SYS_503 → 支付系統不可用
36
47
  USR_BIZ_100 → 使用者業務規則違反
37
48
  API_NET_408 → API 網路逾時
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/execution-history.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-11
6
+ source_hash: aeb25be7272f
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/failure-source-taxonomy.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 56c9d4057405
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,135 +11,76 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/failure-source-taxonomy.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-16
15
- **適用範圍**: 所有 Agent 執行結果的失敗分類
16
- **Scope**: universal
17
- **來源**: XSPEC-045(claw-code ROADMAP Phase 2 Failure Taxonomy,DEC-035)
18
-
19
- ---
20
-
21
- ## 目的
22
-
23
- 失敗來源分類法:在 `TaskStatus`(what)之上新增 `failureSource`(why)維度,提供 8 類結構化失敗來源。
14
+ > **來源**: XSPEC-045 | **借鑑自**: ultraworkers/claw-code ROADMAP Phase 2 Failure Taxonomy
24
15
 
25
- 現有的 `TaskStatus` 只回答「發生了什麼」,`failureSource` 補充「為什麼失敗」。結構化的失敗來源使下游恢復機制(Recovery Recipe Registry,XSPEC-046)能精準匹配策略,避免用同一套重試邏輯處理本質不同的失敗類型。
16
+ ## 概述
26
17
 
27
- ---
28
-
29
- ## 核心規範
30
-
31
- - 所有失敗結果應攜帶 `failureSource`,使恢復策略可精準匹配
32
- - `failureSource` 為 optional 欄位,不得破壞現有不含此欄位的程式碼
33
- - 在同一失敗事件中,選擇最根本的來源作為 `failureSource`(例如 `branch_divergence` 比 `compilation` 更根本)
34
- - `failureSource` 應由偵測到失敗的元件設定(QualityGate / Adapter / SafetyHook / BranchDriftChecker)
35
- - 各採用層各自獨立定義 `FailureSource` type,語義保持一致
36
-
37
- ---
18
+ 失敗來源分類法在既有的 `TaskStatus`(what)之上新增 `failureSource`(why)維度。結構化的失敗來源讓下游恢復機制(Recovery Recipe Registry,XSPEC-046)能精準匹配策略,避免以同一套重試邏輯處理本質不同的失敗類型。
38
19
 
39
20
  ## 8 類失敗來源
40
21
 
41
- ### `prompt_delivery`
42
-
43
- - **描述**:Prompt 未正確傳遞給 LLM(API 4xx、空回應、格式解析失敗)
44
- - **偵測提示**:API 回傳 4xx / 空回應 / JSON 解析失敗
45
- - **建議恢復**:重試或 `model_switch`
46
- - **嚴重度範圍**:critical, high
47
-
48
- ### `model_degradation`
49
-
50
- - **描述**:LLM 降智或回應品質明顯下降(重複輸出、無關回應、品質驟降)
51
- - **偵測提示**:輸出品質評分低於基準線 / 連續重複輸出 / 評估分數 < 30
52
- - **建議恢復**:`model_switch`
53
- - **嚴重度範圍**:critical, high, medium
54
-
55
- ### `branch_divergence`
56
-
57
- - **描述**:工作分支落後基底分支,可能導致合併衝突或假回歸
58
- - **偵測提示**:`git rev-list --count HEAD..origin/{baseBranch} > 0`
59
- - **建議恢復**:`rebase_and_retry`
60
- - **嚴重度範圍**:critical, high, medium
61
- - **備註**:severity 由落後 commit 數決定:1-5 為 medium,6+ 為 high/critical
62
-
63
- ### `compilation`
64
-
65
- - **描述**:編譯或型別檢查錯誤(TypeScript tsc、Go build、Rust cargo 等)
66
- - **偵測提示**:build / tsc / compile 指令 exit code != 0
67
- - **建議恢復**:`fix_loop`
68
- - **嚴重度範圍**:high, medium, low
69
-
70
- ### `test_failure`
71
-
72
- - **描述**:測試失敗(unit / integration / system / e2e 任一層級)
73
- - **偵測提示**:test 指令 exit code != 0
74
- - **建議恢復**:`fix_loop`
75
- - **嚴重度範圍**:high, medium, low
22
+ | 來源 | 說明 | 建議恢復方式 |
23
+ |------|------|--------------|
24
+ | `prompt_delivery` | Prompt 未傳遞給 LLM(API 4xx、空回應、解析錯誤) | retry 或 model_switch |
25
+ | `model_degradation` | LLM 品質下降(重複輸出、無關回應) | model_switch |
26
+ | `branch_divergence` | 工作分支落後基底分支 | rebase_and_retry |
27
+ | `compilation` | 編譯或型別檢查錯誤(tsc、cargo、go build) | fix_loop |
28
+ | `test_failure` | 測試失敗(unit / integration / system / e2e) | fix_loop |
29
+ | `tool_failure` | 工具層失敗(MCP server 無回應、Plugin 載入失敗) | 先 circuit_breaker 再 retry |
30
+ | `policy_violation` | 安全/治理策略攔截(Guardian deny、SafetyHook) | human_checkpoint |
31
+ | `resource_exhaustion` | 資源耗盡(token 預算超限、逾時、美元預算) | degraded_mode 或 human_checkpoint |
76
32
 
77
- ### `tool_failure`
78
-
79
- - **描述**:工具層失敗(MCP server 無回應、Plugin 載入失敗、CLI 工具不存在)
80
- - **偵測提示**:MCP / Plugin / shell 工具執行失敗或 timeout
81
- - **建議恢復**:circuit_breaker 保護後重試,或降級模式繼續
82
- - **嚴重度範圍**:critical, high, medium
83
-
84
- ### `policy_violation`
85
-
86
- - **描述**:安全或治理策略攔截(Guardian deny、SafetyHook 阻擋、Fail-Closed 觸發)
87
- - **偵測提示**:`SecurityDecision` 為 deny / Guardian verdict 為 `blocking: true`
88
- - **建議恢復**:`human_checkpoint`(不自動重試,需人工審查)
89
- - **嚴重度範圍**:critical, high
90
-
91
- ### `resource_exhaustion`
92
-
93
- - **描述**:資源耗盡(token 預算超限、時間 timeout、美元預算耗盡)
94
- - **偵測提示**:`error_max_turns` / `error_max_budget_usd` / token zone BLOCKING
95
- - **建議恢復**:`degraded_mode` 或 `human_checkpoint`
96
- - **嚴重度範圍**:critical, high
97
-
98
- ---
99
-
100
- ## 類型定義
101
-
102
- ### FailureSource
103
-
104
- 8 類失敗來源的 union type:
33
+ ## 優先級規則
105
34
 
106
- ```
107
- prompt_delivery | model_degradation | branch_divergence | compilation |
108
- test_failure | tool_failure | policy_violation | resource_exhaustion
35
+ 當多個失敗來源並存時,依下列規則處理:
36
+
37
+ 1. `branch_divergence` > `compilation` — 分支漂移通常是編譯失敗的根因
38
+ 2. `policy_violation` > 其他 — 安全優先,不嘗試繞過
39
+ 3. `resource_exhaustion` > 其他 — 資源耗盡時重試沒有意義
40
+ 4. 其他情況:採用最先偵測到的來源
41
+
42
+ ## 型別
43
+
44
+ ```typescript
45
+ type FailureSource =
46
+ | "prompt_delivery"
47
+ | "model_degradation"
48
+ | "branch_divergence"
49
+ | "compilation"
50
+ | "test_failure"
51
+ | "tool_failure"
52
+ | "policy_violation"
53
+ | "resource_exhaustion";
54
+
55
+ interface FailureDetail {
56
+ source: FailureSource;
57
+ raw_error: string;
58
+ detected_by: string; // quality-gate / claude-adapter / safety-hook / branch-drift
59
+ timestamp: string; // ISO 8601
60
+ }
109
61
  ```
110
62
 
111
- ### FailureDetail
63
+ ## 指引
112
64
 
113
- | 欄位 | 類型 | 說明 |
114
- |------|------|------|
115
- | `source` | `FailureSource` | 失敗來源 |
116
- | `raw_error` | `string` | 原始錯誤訊息 |
117
- | `detected_by` | `string` | 偵測元件名稱(quality-gate / claude-adapter / safety-hook / branch-drift) |
118
- | `timestamp` | `string` | ISO 8601 格式 |
65
+ - 所有失敗結果都應攜帶 `failureSource`,以便精準匹配恢復策略
66
+ - `failureSource` 為**選填**欄位 — 不得破壞既有不含此欄位的程式碼
67
+ - 在單一失敗事件中,選擇最根本的來源作為 `failureSource`
68
+ - `failureSource` 應由偵測到失敗的元件設定
69
+ - 各採用層各自獨立定義自己的 `FailureSource` 型別(授權隔離)
119
70
 
120
- ---
71
+ ## 適用情境
121
72
 
122
- ## 優先級規則
73
+ - Quality Gate(採用層)失敗結果的資訊補充
74
+ - Pipeline Runner(採用層)`agent:error` 事件 payload
75
+ - Recovery Recipe Registry(XSPEC-046)匹配鍵
76
+ - 遙測失敗分析維度
123
77
 
124
- 當多個失敗來源並存時:
78
+ ## 參考資料
125
79
 
126
- | 規則 | 說明 |
127
- |------|------|
128
- | `branch_divergence` > `compilation` | 分支漂移通常是 compilation 失敗的根因 |
129
- | `policy_violation` > 其他 | 安全優先,不嘗試繞過 |
130
- | `resource_exhaustion` > 其他 | 資源耗盡時無意義重試 |
131
- | 其他情況 | 取最先偵測到的來源 |
80
+ - AI 最佳化版:[ai/standards/failure-source-taxonomy.ai.yaml](../../../ai/standards/failure-source-taxonomy.ai.yaml)
81
+ - XSPEC-045:跨專案規格
82
+ - 相依於:Recovery Recipe Registry(XSPEC-046)
83
+ - 借鑑自:[ultraworkers/claw-code](https://github.com/ultraworkers/claw-code) ROADMAP Phase 2 Failure Taxonomy
132
84
 
133
- ---
134
85
 
135
- ## 整合點
136
-
137
- > 整合指引(informative;具體檔案路徑屬於採用層自訂範圍)。
138
-
139
- ### 預期呼叫點
140
-
141
- - 核心型別模組 — `TaskResult.failureSource` / `FailureSource` type
142
- - quality-gate 模組 — `QualityGateResult.failureSource` 推斷
143
- - agent adapter — `resource_exhaustion` / `network_error` 映射
144
- - pipeline runner — `agent:error` / `agent:retry` 事件 payload
86
+ **Scope**: universal