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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -0,0 +1,261 @@
1
+ ---
2
+ source: ../../../../skills/comprehension-ladder/eval-cases.md
3
+ source_version: 1.0.0
4
+ translation_version: 1.0.0
5
+ last_synced: 2026-10-05
6
+ source_hash: a2b33f2ef215
7
+ status: current
8
+ scope: universal
9
+ description: |
10
+ 理解階梯技能的評估案例與跑法:5 段原文,各附理解題、標準答案與防護違反檢查。尚未實跑。
11
+ Use when: 想衡量理解階梯技能是否幫得上讀者,或想重新檢查它的三條防護。
12
+ Keywords: evaluation, eval cases, comprehension questions, answer key, guard violations, DEC-114.
13
+ ---
14
+
15
+ # 理解階梯:評估案例
16
+
17
+ > **語言**: [English](../../../../skills/comprehension-ladder/eval-cases.md) | 繁體中文 | [简体中文](../../../zh-CN/skills/comprehension-ladder/eval-cases.md)
18
+
19
+ **狀態:尚未實跑。** 本檔只有案例與跑法。沒有呼叫過任何模型,也沒有任何讀者作過答。實跑完成之前,不要說本技能讓文字比較好懂。
20
+
21
+ 下面五段原文都是為這次評估寫的。它們不描述任何真實的客戶、人物或系統。
22
+
23
+ ## 實跑會產出什麼
24
+
25
+ 一次實跑產出兩個數字:
26
+
27
+ 1. **前後的答對率。** 讀者看原文時(A 組,「之前」)與看技能產出時(B 組,「之後」),答對題目的比例。
28
+ 2. **防護違反次數。** 技能的產出破壞 G1、G2 或 G3 的次數。
29
+
30
+ 建議的通過線,實跑前要與負責人談定:B 組比 A 組高至少 10 個百分點,而且防護違反次數為 0。10 個百分點只是起始值,還沒有校準過。
31
+
32
+ ## 跑法
33
+
34
+ ### 1. 產出
35
+
36
+ 每個案例都對原文跑一次技能。要求第 1 階與第 2 階。存下大綱與兩階的產出。若也要測第 3 階,就要求它並存下 HTML 檔。
37
+
38
+ 五個案例使用同一個模型、同樣的設定。記下模型名稱。
39
+
40
+ ### 2. 分讀者
41
+
42
+ 至少用 6 位讀者。讀者可以是人,也可以是模型。人給出的證據比較強。模型是比較便宜的替身。
43
+
44
+ 把讀者分成人數相同的兩組。
45
+
46
+ | 案例 | 第 1 組讀 | 第 2 組讀 |
47
+ |------|-----------|-----------|
48
+ | 1 | A(原文) | B(技能產出) |
49
+ | 2 | B | A |
50
+ | 3 | A | B |
51
+ | 4 | B | A |
52
+ | 5 | A | B |
53
+
54
+ 每位讀者每個案例只看一次。這樣讀者不會在一組學到答案,再帶到另一組。
55
+
56
+ B 組的讀者只看技能產出,不看原文。
57
+
58
+ ### 3. 問題
59
+
60
+ 把該案例的題目交給每位讀者。讀者只能依手上拿到的文字作答,不得用任何其他來源。
61
+
62
+ 讀者可以答「文字沒有說」。對標為**未提及**的題目,這是正確答案。
63
+
64
+ ### 4. 評分
65
+
66
+ 依下面的標準答案評分。答案要符合「採計」欄才算對。標為**不確定語氣**的題目,若答案把說法講成確定,即使事實對了也算錯。
67
+
68
+ 答對率 = 答對的題數 ÷ 全部答案數,各組分開算。
69
+
70
+ ### 5. 計算防護違反
71
+
72
+ 對照原文,檢查每一份產出。下列情形,每一項各算一次。
73
+
74
+ | 防護 | 一次違反是 |
75
+ |------|------------|
76
+ | G1 `no-new-facts` | 某一項或某一句,說了原文沒說的事。每個案例的「陷阱」清單列出最可能的幾種。 |
77
+ | G2 `keep-hedges` | 原文的說法有不確定語氣,產出的那一項卻沒有,或語氣變得更強。每個案例的「不確定用詞清單」列出這些用詞。 |
78
+ | G3 `trace-and-gaps` | 某一項沒有「對應原文」、指到的位置不是它所宣稱的位置,或沒有「沒涵蓋」註記。另外:產出沒有「這份大綱沒有收的部分」清單。 |
79
+
80
+ 請第二個人也數同一批產出,再比對兩份計數。不同時,逐項討論,記下最後的計數。
81
+
82
+ ### 6. 回報
83
+
84
+ 填這張表。兩個數字都要有。
85
+
86
+ | 案例 | A 組答對 | B 組答對 | G1 | G2 | G3 |
87
+ |------|----------|----------|----|----|----|
88
+ | 1 | / | / | | | |
89
+ | 2 | / | / | | | |
90
+ | 3 | / | / | | | |
91
+ | 4 | / | / | | | |
92
+ | 5 | / | / | | | |
93
+ | **合計** | **A 組答對率** | **B 組答對率** | | | |
94
+
95
+ ### 實跑規模
96
+
97
+ 說明實跑的規模,讓負責人在開跑前決定模型與預算:
98
+
99
+ - 產出步驟:5 次技能執行,加 5 次防護檢查。共 10 次模型呼叫。
100
+ - 讀者步驟,若讀者是模型:5 個案例 × 2 組 × 每組讀者數。
101
+ - 題目很短。最長的輸入是一段原文或一份產出。
102
+
103
+ 模型與預算由負責人決定。這裡不設定。
104
+
105
+ ---
106
+
107
+ ## 案例 1:搜尋結果過期
108
+
109
+ **類型**:含多處不確定語氣的事件紀錄。
110
+
111
+ ### 原文
112
+
113
+ > 昨晚商品目錄匯入之後,搜尋頁約有 3 小時顯示舊的商品名稱。最可能的原因是,匯入之後搜尋索引沒有重建。我們認為匯入工作先結束,重建步驟才排進佇列,但我們還沒有檢查工作紀錄。顧客仍然可以購買那些商品。團隊計畫在星期四,替匯入工作加上重建步驟,前提是紀錄證實了事件的先後順序。沒有人量過有多少顧客看到舊名稱。
114
+
115
+ ### 問題與標準答案
116
+
117
+ | # | 問題 | 類型 | 採計 |
118
+ |---|------|------|------|
119
+ | 1 | 搜尋頁顯示舊名稱的時間有多久? | 事實 | 約 3 小時 |
120
+ | 2 | 最可能的原因是什麼?已經確認了嗎? | 不確定語氣 | 匯入之後索引沒有重建。尚未確認:「最可能」 |
121
+ | 3 | 工作紀錄檢查過了嗎? | 事實 | 沒有。還沒有 |
122
+ | 4 | 問題發生期間,顧客還能購買商品嗎? | 事實 | 能 |
123
+ | 5 | 修復計畫在什麼時候?它取決於什麼? | 事實 | 星期四。取決於紀錄是否證實事件的先後順序 |
124
+ | 6 | 有多少顧客看到舊名稱? | 未提及 | 文字沒有說。沒有人量過 |
125
+
126
+ ### 不確定用詞清單
127
+
128
+ 「約 3 小時」、「最可能」、「我們認為」、「還沒有檢查」、「前提是紀錄證實」、「沒有人量過」。
129
+
130
+ ### 陷阱(原文沒說的事實)
131
+
132
+ 受影響顧客的人數。原因已確認的說法。紀錄顯示了事件先後順序的說法。任何退款、營收或客服單的數字。
133
+
134
+ ---
135
+
136
+ ## 案例 2:退款核准流程
137
+
138
+ **類型**:有分支的流程(適合第 2 階)。
139
+
140
+ ### 原文
141
+
142
+ > 顧客在 App 裡申請退款。系統檢查訂單日期。訂單超過 30 天,系統立刻駁回申請,並向顧客顯示一則訊息。訂單在 30 天以內(含 30 天),系統把申請送給客服人員。客服人員在 2 個工作天內核准或駁回。客服人員核准後,系統把錢退回原付款方式,並寄電子郵件給顧客。超過 NT$5,000 的退款,還需要組長第二次核准。規格沒有說組長要在多久內回覆。
143
+
144
+ ### 問題與標準答案
145
+
146
+ | # | 問題 | 類型 | 採計 |
147
+ |---|------|------|------|
148
+ | 1 | 45 天前的訂單申請退款,會怎麼處理? | 事實 | 立刻駁回。顧客會看到一則訊息 |
149
+ | 2 | 剛好 30 天的訂單申請退款,會怎麼處理? | 事實 | 送給客服人員(「30 天以內(含 30 天)」) |
150
+ | 3 | 客服人員有多久可以決定? | 事實 | 2 個工作天 |
151
+ | 4 | 核准之後,錢退到哪裡? | 事實 | 原付款方式。顧客還會收到電子郵件 |
152
+ | 5 | 哪些退款需要第二次核准?由誰核准? | 事實 | 超過 NT$5,000 的退款。由組長 |
153
+ | 6 | 組長要在多久內回覆? | 未提及 | 文字沒有說 |
154
+
155
+ ### 不確定用詞清單
156
+
157
+ 主張裡沒有不確定用詞。文字明說了一個缺口:「規格沒有說組長要在多久內回覆。」產出必須保留這個缺口。
158
+
159
+ ### 陷阱
160
+
161
+ 組長的時限。訊息的內容。剛好 NT$5,000 的退款規則。檢查顧客歷史紀錄的步驟。
162
+
163
+ ### 預期規模
164
+
165
+ 原文有 7 個 `mechanism` 項目(申請、日期檢查、駁回、分流、客服決定、付款與電子郵件、組長核准),以及 1 個 `uncertainty` 項目(組長缺少時限)。每一階都應該呈現同樣的 8 項,或列出沒有畫的項目。
166
+
167
+ ---
168
+
169
+ ## 案例 3:重試函式
170
+
171
+ **類型**:含數字與兩處不確定說法的程式碼解說。
172
+
173
+ ### 原文
174
+
175
+ > 函式 `fetchWithRetry` 最多呼叫付款 API 4 次。第一次呼叫立刻發生。呼叫失敗後,它會先等一會兒,再做下一次。等待從 200 ms 開始,每次加倍,所以等待時間是 200 ms、400 ms 和 800 ms。它只在網路錯誤與 HTTP 狀態 503 時重試。遇到其他狀態,例如 400,它就停止並回傳錯誤。4 次呼叫全部失敗時,它丟出最後一個錯誤。程式沒有加入隨機抖動,所以許多同時失敗的用戶端可能會同時重試。我們還沒有測試 API 回傳狀態 429 時會發生什麼事。
176
+
177
+ ### 問題與標準答案
178
+
179
+ | # | 問題 | 類型 | 採計 |
180
+ |---|------|------|------|
181
+ | 1 | 這個函式最多呼叫幾次? | 事實 | 4 次 |
182
+ | 2 | 呼叫之間的等待時間是多少? | 事實 | 200 ms、400 ms、800 ms |
183
+ | 3 | 哪些失敗會重試? | 事實 | 網路錯誤與 HTTP 狀態 503 |
184
+ | 4 | 遇到狀態 400 會怎樣? | 事實 | 停止並回傳錯誤 |
185
+ | 5 | 程式沒有加入抖動。接下來可能發生什麼? | 不確定語氣 | 許多同時失敗的用戶端可能會同時重試。這是一種可能,不是必然 |
186
+ | 6 | 遇到狀態 429 會怎樣? | 未提及 | 不知道。還沒有測試過 |
187
+
188
+ ### 不確定用詞清單
189
+
190
+ 「可能會同時重試」、「我們還沒有測試」。
191
+
192
+ ### 陷阱
193
+
194
+ 狀態 429 的行為(重試或不重試)。用戶端確實會同時重試的說法。原文沒有給的等待總時間上限。API 的名稱。
195
+
196
+ ---
197
+
198
+ ## 案例 4:上傳檔案要存在哪裡
199
+
200
+ **類型**:三個選項與取捨(適合第 2 階)。
201
+
202
+ ### 原文
203
+
204
+ > 我們比較了三種儲存使用者上傳檔案的方式。選項 A:把檔案放在應用程式伺服器的磁碟上。它最便宜,也不需要新工具。但伺服器一換,檔案就會遺失,而且兩台伺服器無法共用檔案。選項 B:使用雲端供應商的物件儲存。以目前的量來說,費用約為每月 NT$600。更換伺服器後檔案仍在,任何一台伺服器都能讀取。它需要一次性的存取金鑰設定。選項 C:使用網路檔案共用。伺服器之間可以共用檔案,也不需要改程式。但它多出一台要維護的機器,而且我們認為,在高負載下它會比較慢。我們建議選項 B。我們還沒有測試選項 C 的速度。
205
+
206
+ ### 問題與標準答案
207
+
208
+ | # | 問題 | 類型 | 採計 |
209
+ |---|------|------|------|
210
+ | 1 | 文字說哪個選項在更換伺服器後檔案仍在? | 事實 | 選項 B。(文字說選項 A 不會。對選項 C,文字沒有說。) |
211
+ | 2 | 選項 B 的費用是多少? | 事實 | 以目前的量來說,約每月 NT$600 |
212
+ | 3 | 哪個選項不需要改程式? | 事實 | 選項 C |
213
+ | 4 | 團隊建議哪個選項? | 事實 | 選項 B |
214
+ | 5 | 在高負載下,選項 C 比較慢嗎? | 不確定語氣 | 團隊認為是,但還沒有測試過 |
215
+ | 6 | 選項 C 的費用是多少? | 未提及 | 文字沒有說 |
216
+
217
+ ### 不確定用詞清單
218
+
219
+ 「約 NT$600」、「我們認為它會比較慢」、「我們還沒有測試」。
220
+
221
+ ### 陷阱
222
+
223
+ 選項 A 或選項 C 的費用。選項 C 在更換伺服器後檔案仍在的說法。沒有帶不確定語氣、就說選項 C 比較慢。原文沒有給的建議理由。
224
+
225
+ ---
226
+
227
+ ## 案例 5:存取紀錄裡的工作階段權杖
228
+
229
+ **類型**:含未知事項與尚未評等風險的資安發現。
230
+
231
+ ### 原文
232
+
233
+ > 審查 API 閘道時,我們發現存取紀錄可能含有工作階段權杖。用戶端把權杖放在網址的查詢字串、而不是放在標頭時,權杖就會出現在紀錄裡。行動 App 2.3 版在個人資料畫面這樣做。網頁用戶端使用標頭,不受影響。紀錄保存 90 天,有 12 位工程師可以讀取。我們沒有找到有人使用過被記下的權杖的證據。風險大概是中等,但我們還沒有正式評等。我們提出兩項修改:行動 App 把權杖改放標頭,以及在紀錄中遮蔽查詢字串。我們還不知道有多少使用者在用 App 2.3 版。
234
+
235
+ ### 問題與標準答案
236
+
237
+ | # | 問題 | 類型 | 採計 |
238
+ |---|------|------|------|
239
+ | 1 | 權杖什麼時候會出現在紀錄裡? | 事實 | 用戶端把它放在網址的查詢字串、而不是標頭時 |
240
+ | 2 | 哪些用戶端受影響? | 事實 | 行動 App 2.3 版,在個人資料畫面。網頁用戶端不受影響 |
241
+ | 3 | 紀錄保存多久?誰能讀? | 事實 | 90 天。12 位工程師 |
242
+ | 4 | 有沒有人被證實濫用被記下的權杖? | 不確定語氣 | 沒有找到證據。這不等於「沒有人這樣做」 |
243
+ | 5 | 風險有多嚴重? | 不確定語氣 | 大概是中等。尚未正式評等 |
244
+ | 6 | 有多少使用者在用 App 2.3 版? | 未提及 | 還不知道 |
245
+
246
+ ### 不確定用詞清單
247
+
248
+ 「可能含有」、「沒有找到……證據」、「大概是中等」、「還沒有正式評等」、「還不知道」。
249
+
250
+ ### 陷阱
251
+
252
+ 受影響使用者的人數。沒有任何權杖被濫用的說法。正式的風險等級(例如「高」或「中」)。修復日期。網頁用戶端有風險的說法。
253
+
254
+ ---
255
+
256
+ ## 實跑之後
257
+
258
+ - 記下日期、模型名稱、讀者人數,以及誰計算防護違反。
259
+ - 把填好的回報表放在本檔旁邊。不要覆寫案例。
260
+ - 防護違反次數大於 0 時,先修技能,再去解讀答對率。加了事實或拿掉不確定語氣的產出,可能拉高答對率,卻仍然誤導讀者。
261
+ - 某段原文被發現有歧義時,把原文與答案一起修正,再重跑那個案例。
@@ -2,14 +2,94 @@
2
2
  source: ../../../../skills/contract-test-assistant/guide.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-26
5
+ last_synced: 2026-10-12
6
+ source_hash: fcc8d98bc6bf
6
7
  status: current
8
+ scope: universal
9
+ description: |
10
+ 合約測試策略與實作指南。
11
+ 使用時機:詳細的合約測試設定、Pact/OpenAPI 配置、CI 整合。
12
+ 關鍵字:contract test, Pact, OpenAPI, consumer, provider, 合約測試, API 合約.
7
13
  ---
8
14
 
9
15
  # 合約測試助手指南
10
16
 
11
17
  > **語言**: [English](../../../../skills/contract-test-assistant/guide.md) | 繁體中文
12
18
 
19
+ **版本**: 1.0.0
20
+ **最後更新**: 2026-03-26
21
+ **適用範圍**: 所有具有 API 整合的專案
22
+ **Scope**: universal
23
+ **類型**: 標準支援技能(選項標準:contract-testing.md)
24
+
25
+ ---
26
+
27
+ ## 目的
28
+
29
+ 當系統成長為微服務架構或與第三方 API 整合時,整合測試會變得緩慢、脆弱且難以維護。合約測試透過獨立驗證 API 約定來解決這個問題,讓團隊不必啟動所有服務也能有信心地部署。
30
+
31
+ ---
32
+
33
+ ## 決策指南
34
+
35
+ ```
36
+ Do you own both consumer and provider?
37
+ ├── Yes → Consumer-Driven (Pact)
38
+ ├── No, provider is third-party → Provider-Driven (OpenAPI)
39
+ └── Mixed → Bi-Directional (Pact + OpenAPI)
40
+ ```
41
+
42
+ ### 消費者驅動合約(Pact)
43
+
44
+ 最適合團隊同時擁有兩端的情況。由消費者定義期望。
45
+
46
+ ```
47
+ Consumer writes test → Generates contract (pact file) → Provider verifies
48
+ ```
49
+
50
+ ### 提供者驅動合約(OpenAPI)
51
+
52
+ 最適合公開 API。由提供者定義合約。
53
+
54
+ ```
55
+ Provider writes OpenAPI spec → Consumer generates client → Both verify
56
+ ```
57
+
58
+ ---
59
+
60
+ ## 快速入門範例
61
+
62
+ ### Pact(JavaScript)
63
+
64
+ ```typescript
65
+ // Consumer test
66
+ const interaction = {
67
+ uponReceiving: 'a request for user by ID',
68
+ withRequest: { method: 'GET', path: '/users/1' },
69
+ willRespondWith: {
70
+ status: 200,
71
+ body: { id: 1, name: like('John') }
72
+ }
73
+ };
74
+ ```
75
+
76
+ ### OpenAPI 驗證
77
+
78
+ ```yaml
79
+ # openapi.yaml
80
+ paths:
81
+ /users/{id}:
82
+ get:
83
+ responses:
84
+ '200':
85
+ content:
86
+ application/json:
87
+ schema:
88
+ $ref: '#/components/schemas/User'
89
+ ```
90
+
91
+ ---
92
+
13
93
  ## 參考
14
94
 
15
95
  - 詳細標準:[contract-testing.md](../../../../options/testing/contract-testing.md)
@@ -3,13 +3,17 @@ name: database-assistant
3
3
  source: ../../../../skills/database-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
5
  translation_version: 1.1.0
6
- last_synced: 2026-08-17
6
+ last_synced: 2026-10-12
7
+ source_hash: 1cf7bf71b996
7
8
  status: current
9
+ scope: universal
8
10
  description: |
9
11
  引導資料庫設計、遷移與查詢最佳化。
10
12
  Use when: schema 設計、遷移規劃、查詢最佳化、索引策略。
11
13
  Not for: 應用程式碼遷移或框架升級——請用 /migrate;資料之上的 API 合約——請用 /api-design。
12
14
  Keywords: database, schema, migration, SQL, index, query, 資料庫, 遷移, 查詢, 索引策略.
15
+ allowed-tools: Read, Grep, Glob
16
+ argument-hint: "[要審查的 schema 或遷移]"
13
17
  ---
14
18
 
15
19
  # 資料庫助手
@@ -80,9 +84,11 @@ PLAN ──► WRITE ──► TEST ──► DEPLOY ──► VERIFY
80
84
 
81
85
  ## 使用方式
82
86
 
83
- - `/database` - 互動式資料庫設計引導
84
- - `/database schema` - 審查 Schema 設計
85
- - `/database --migration` - 遷移規劃助手
87
+ ```
88
+ /database - 互動式資料庫設計引導
89
+ /database schema - 審查 Schema 設計
90
+ /database --migration - 遷移規劃助手
91
+ ```
86
92
 
87
93
  ## 下一步引導
88
94
 
@@ -90,10 +96,20 @@ PLAN ──► WRITE ──► TEST ──► DEPLOY ──► VERIFY
90
96
 
91
97
  > **資料庫設計完成。建議下一步:**
92
98
  > - 執行 `/security` 檢查資料保護措施
93
- > - 執行 `/testing` 規劃資料庫測試策略
99
+ > - 執行 `/testing` 規劃資料庫測試策略 ⭐ **推薦**
94
100
  > - 執行 `/checkin` 確認遷移符合提交規範
95
101
  > - 產生 API 端點 → 執行 `/api-design`
96
102
 
97
103
  ## 參考
98
104
 
99
105
  - 核心規範:[database-standards.md](../../../../core/database-standards.md)
106
+
107
+ ## 版本歷史
108
+
109
+ | 版本 | 日期 | 變更說明 |
110
+ |------|------|----------|
111
+ | 1.0.0 | 2026-03-23 | 初始版本 |
112
+
113
+ ## 授權
114
+
115
+ CC BY 4.0 — 文件內容
@@ -3,7 +3,8 @@ name: deploy
3
3
  source: ../../../../skills/deploy-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
5
  translation_version: 1.1.0
6
- last_synced: 2026-08-17
6
+ last_synced: 2026-10-12
7
+ source_hash: d84c8caee08d
7
8
  scope: universal
8
9
  description: |
9
10
  引導在沒有 CI/CD 平台(GitHub Actions/GitLab CI)的情況下完成可靠部署。
@@ -3,7 +3,8 @@ name: methodology
3
3
  source: ../../../../skills/dev-methodology/SKILL.md
4
4
  source_version: 1.0.0
5
5
  translation_version: 1.1.0
6
- last_synced: 2026-08-17
6
+ last_synced: 2026-10-12
7
+ source_hash: 21380a968a9a
7
8
  scope: partial
8
9
  description: |
9
10
  [UDS] 為專案選擇並追蹤當前採用的開發方法論(SDD、BDD、TDD)。
@@ -103,6 +104,8 @@ argument-hint: "[動作] [參數]"
103
104
  ## 參考
104
105
 
105
106
  - [建立自訂 Methodology 指南](./create-methodology.md) — 要自建方法論而不是用現成的那幾套時讀它。
107
+ - [整合開發流程指南](../../../../skills/dev-methodology/integrated-flow.md) — 要把多套方法論組合成單一流程時讀它。
108
+ - [工作流前置步驟檢查](../../../../skills/dev-methodology/prerequisite-check.md) — 某個工作流步驟需要先檢查前置條件時讀它。
106
109
  - [Methodology Runtime 指南](./runtime.md) — 需要知道方法論在執行當下如何運作時讀它。
107
110
  - 詳細指南:[guide.md](./guide.md)
108
111
 
@@ -2,6 +2,8 @@
2
2
  source: skills/dev-methodology/create-methodology.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-12
6
+ source_hash: 744240934186
5
7
  status: current
6
8
  ---
7
9
 
@@ -2,6 +2,8 @@
2
2
  source: skills/dev-methodology/runtime.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-12
6
+ source_hash: 62841f19b98d
5
7
  status: current
6
8
  ---
7
9
 
@@ -3,13 +3,17 @@ name: docs-generator
3
3
  source: ../../../../skills/docs-generator/SKILL.md
4
4
  source_version: 1.0.0
5
5
  translation_version: 1.1.0
6
- last_synced: 2026-08-17
6
+ last_synced: 2026-10-12
7
+ source_hash: ebe4f6398ca1
7
8
  status: current
9
+ scope: universal
8
10
  description: |
9
11
  [UDS] 從專案原始檔產生使用文件(速查表、參考手冊、使用指南)。
10
12
  Use when: 從 CLI 與 Skill 定義產出速查表或功能參考手冊、指令變更後重新產生文件、確認產生的文件是否為最新。
11
13
  Not for: 決定專案需要哪些文件或手寫敘述性內容——請用 /documentation-guide;變更日誌條目——請用 /changelog。
12
14
  Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文件, 速查表, 文件產生, 參考手冊.
15
+ allowed-tools: Read, Write, Grep, Glob, Bash(*)
16
+ argument-hint: "[設定檔]"
13
17
  ---
14
18
 
15
19
  # 文件產生器
@@ -75,13 +79,26 @@ language: [en, zh-TW]
75
79
 
76
80
  > **注意**:此檢查已整合至 `pre-release-check.sh` 的步驟 8(使用文件同步檢查)。
77
81
 
82
+ ## 產生範例
83
+
84
+ ```markdown
85
+ # UDS Command Cheatsheet
86
+
87
+ | Command | Description |
88
+ |------------|---------------------------|
89
+ | /commit | Generate commit message |
90
+ | /code-review | Run code review |
91
+ | /sdd | Create SDD specification |
92
+ | /discover | Assess project health |
93
+ ```
94
+
78
95
  ## 下一步引導
79
96
 
80
97
  `/docgen` 完成後,AI 助手應建議:
81
98
 
82
99
  > **文件已產生。建議下一步:**
83
100
  > - 審查產生的文件內容是否完整
84
- > - 執行 `/commit` 提交文件變更
101
+ > - 執行 `/commit` 提交文件變更 ⭐ **推薦**
85
102
  > - 執行 `/code-review` 審查文件品質
86
103
 
87
104
  ## 參考
@@ -1,9 +1,11 @@
1
1
  ---
2
2
  name: documentation-guide
3
+ scope: universal
3
4
  source: ../../../../skills/documentation-guide/SKILL.md
4
5
  source_version: 2.1.0
5
6
  translation_version: 2.2.0
6
- last_synced: 2026-08-17
7
+ last_synced: 2026-10-12
8
+ source_hash: a23a49fa4b9c
7
9
  status: current
8
10
  description: |
9
11
  引導文件結構、內容需求與專案文件的最佳實踐。
@@ -85,6 +87,38 @@ quality:
85
87
  version: "頂部標示版本和日期"
86
88
  review: "文件變更納入程式碼審查"
87
89
  periodic: "每季檢查文件是否過時"
90
+
91
+ # === DIÁTAXIS 分類 ===
92
+ diataxis:
93
+ tutorial: "以學習為導向(getting-started.md)"
94
+ how_to: "以任務為導向(deployment.md, migration.md)"
95
+ reference: "以資訊為導向(api-reference.md, CHANGELOG.md)"
96
+ explanation: "以理解為導向(architecture.md, ADR/)"
97
+ header: "加入 **Document Type**: Tutorial | How-to | Reference | Explanation"
98
+
99
+ # === LLM 探索 ===
100
+ llm_discovery:
101
+ llms_txt: "置於專案根目錄、供 LLM 檢索的結構化索引"
102
+ llms_full_txt: "選用的完整串接文件"
103
+ when: "公開專案、公開 API、使用 AI 工具的專案"
104
+
105
+ # === 品質指標 ===
106
+ quality_metrics:
107
+ leading: ["覆蓋率 ≥90%", "新鮮度 ≤90 天", "連結健康度 100%", "範例有效性 100%"]
108
+ lagging: ["支援工單減少", "新人上手時間", "與文件相關的 PR 評論"]
109
+ tools: [markdown-link-check, lychee, remark-lint, vale, textstat]
110
+
111
+ # === ADR 強化 ===
112
+ adr_enhanced:
113
+ new_fields: [Date, Deciders, Drivers, "supersedes/superseded-by"]
114
+ lifecycle: "proposed → accepted → [deprecated | superseded]"
115
+ decision_matrix: "影響程度 × 可逆性 → 是否需要 ADR?"
116
+
117
+ # === 翻譯友善 ===
118
+ translation_friendly:
119
+ rules: ["使用完整句子", "不使用慣用語", "術語一致", "簡單的主動賓結構", "明確的指涉"]
120
+ glossary: "維護 glossary.md 以確保術語一致"
121
+ status_tracking: "以 YAML frontmatter 記錄 translation_status、source_version"
88
122
  ```
89
123
 
90
124
  ---
@@ -306,8 +340,16 @@ MIT
306
340
  ```markdown
307
341
  # ADR-001: [決策標題]
308
342
 
309
- ## 狀態
310
- 已接受
343
+ **日期**: YYYY-MM-DD
344
+ **狀態**: proposed | accepted | deprecated | superseded
345
+ **決策者**: [參與人員清單]
346
+ **取代**: ADR-NNN(如適用)
347
+ **被取代於**: ADR-NNN(如適用)
348
+
349
+ ## 驅動因素
350
+
351
+ - [關鍵因素 1]
352
+ - [關鍵因素 2]
311
353
 
312
354
  ## 背景
313
355
  [為何需要此決策...]
@@ -326,10 +368,19 @@ MIT
326
368
  - 缺點 2
327
369
 
328
370
  ## 考慮過的替代方案
329
- 1. 方案 A - 因為...而被拒絕
330
- 2. 方案 B - 因為...而被拒絕
371
+
372
+ ### 替代方案 A:[名稱]
373
+ - **優點**: ...
374
+ - **缺點**: ...
375
+ - **拒絕原因**: ...
331
376
  ```
332
377
 
378
+ **何時撰寫 ADR**(影響程度 × 可逆性):
379
+ - **高影響 + 難以回復** → 必須撰寫 ADR
380
+ - **高影響 + 容易回復** → 選擇性
381
+ - **低影響 + 難以回復** → 選擇性
382
+ - **低影響 + 容易回復** → 不需要 ADR
383
+
333
384
  ---
334
385
 
335
386
  ## 文件稽核檢查清單
@@ -397,6 +448,17 @@ MIT
397
448
 
398
449
  ---
399
450
 
451
+ ## 下一步引導
452
+
453
+ `/docs-guide` 完成後,AI 助手應建議:
454
+
455
+ > **文件結構與需求已釐清。建議下一步:**
456
+ > - 執行 `/docs` 根據指南直接產生專案文件 ⭐ **推薦** — 立即將文件指南化為行動
457
+ > - 執行 `/changelog` 建立或更新 CHANGELOG.md — 確保變更歷史完整
458
+ > - 執行 `/sdd` 將文件需求納入規格驅動開發 — 確保文件與功能同步
459
+
460
+ ---
461
+
400
462
  ## 相關標準
401
463
 
402
464
  - [文件撰寫標準](../../core/documentation-writing-standards.md) - 內容需求
@@ -421,40 +483,3 @@ MIT
421
483
  本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
422
484
 
423
485
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
424
-
425
-
426
- ## Next Steps Guidance | 下一步引導
427
-
428
- After `/docs-guide` completes, the AI assistant should suggest:
429
-
430
- > **文件結構與需求已釐清。建議下一步 / Documentation structure and requirements clarified. Suggested next steps:**
431
- > - 執行 `/docs` 根據指南直接產生專案文件 ⭐ **Recommended / 推薦** — 立即將文件指南化為行動 / Turn documentation guidelines into action immediately
432
- > - 執行 `/changelog` 建立或更新 CHANGELOG.md — 確保變更歷史完整 / Ensure change history is complete
433
- > - 執行 `/sdd` 將文件需求納入規格驅動開發 — 確保文件與功能同步 / Ensure docs stay in sync with features
434
-
435
- ---
436
-
437
- ## Related Standards
438
-
439
- - [Documentation Writing Standards](../../core/documentation-writing-standards.md) - Content requirements
440
- - [Documentation Structure](../../core/documentation-structure.md) - File organization
441
- - [Changelog Standards](../../core/changelog-standards.md) - CHANGELOG format
442
- - [Changelog Guide Skill](../changelog-guide/SKILL.md) - CHANGELOG skill
443
-
444
- ---
445
-
446
- ## Version History
447
-
448
- | Version | Date | Changes |
449
- |---------|------|---------|
450
- | 2.1.0 | 2026-03-17 | Added: Diátaxis classification, LLM discovery, quality metrics, enhanced ADR template, translation-friendly writing |
451
- | 2.0.0 | 2026-01-12 | Added: Project type matrix, document templates, documentation pyramid |
452
- | 1.0.0 | 2025-12-24 | Initial release |
453
-
454
- ---
455
-
456
- ## License
457
-
458
- This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
459
-
460
- **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/documentation-guide/documentation-structure.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-25
5
+ last_synced: 2026-10-12
6
+ source_hash: d6bb16f65b44
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/documentation-guide/readme-template.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-25
5
+ last_synced: 2026-10-12
6
+ source_hash: 4621b7314f5a
6
7
  status: current
7
8
  ---
8
9