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

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 +11 -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 +113 -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
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/observability-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: 00f5ea242d6d
6
7
  status: current
7
8
  description: |
8
9
  引导可观测性建设、指标设计与告警配置。
@@ -15,6 +16,12 @@ description: |
15
16
 
16
17
  > **语言**: [English](../../../../skills/observability-assistant/SKILL.md) | 简体中文
17
18
 
19
+ **版本**: 1.0.0
20
+ **最后更新**: 2026-06-19
21
+ **适用范围**: Claude Code Skills
22
+
23
+ > **核心规范**:本技能实现 [可观测性标准](../../../../core/observability-standards.md)。权威方法论(Metrics/Traces 的完整细节、采样、OTel 集成)请参阅核心规范。
24
+
18
25
  引导三支柱可观测性实现:Logs、Metrics、Traces。
19
26
 
20
27
  ## 功能
@@ -37,6 +44,73 @@ description: |
37
44
  /observability "payment-service" # 特定服务的引导
38
45
  ```
39
46
 
47
+ ## 三支柱框架
48
+
49
+ 每个支柱提供不同的视角;其威力在于彼此关联。
50
+
51
+ | 支柱 | 捕获内容 | 使用时机 | 粒度 |
52
+ |------|----------|----------|------|
53
+ | **Logs** | 带上下文的离散事件 | 调试、审计轨迹、错误细节 | 高(每个事件) |
54
+ | **Metrics** | 随时间变化的数值度量 | 仪表板、告警、容量规划 | 低(聚合) |
55
+ | **Traces** | 跨服务的请求流 | 延迟分析、依赖关系映射 | 中(每个请求) |
56
+
57
+ **关联字段**:`trace_id` 串起 Logs ↔ Traces ↔ Metrics(经由 Exemplars);
58
+ `service.name` 可过滤全部三个支柱。工作流:指标异常 → exemplar →
59
+ trace → 日志中的 `trace_id`。
60
+
61
+ ## 四大黄金信号
62
+
63
+ 基于 Google SRE。每个服务在上线前都应该(SHOULD)监控全部四项。
64
+
65
+ | 信号 | 度量 | 指标示例 | 告警(SLO-based) |
66
+ |------|------|----------|-------------------|
67
+ | **Latency** | 通过 Histogram 取 P50/P95/P99,区分成功/错误 | `http.server.request.duration.seconds` | P99 > X ms 持续 5 分钟 |
68
+ | **Traffic** | 每秒请求数,按 route/method 区分 | `http.server.request.total`(rate) | 下降 > 50% 或激增 > 200% |
69
+ | **Errors** | 错误数 / 总请求数 | `...request.total{status=~"5.."}` ÷ total | 错误率 > X% 持续 5 分钟 |
70
+ | **Saturation** | CPU/内存/连接池/磁盘使用率 | `system.cpu.utilization`(Gauge) | 资源 > 80% 持续 10 分钟 |
71
+
72
+ ## Metric 类型
73
+
74
+ | 类型 | 行为 | 使用时机 |
75
+ |------|------|----------|
76
+ | **Counter** | 只增不减(重启时归零) | 请求数、错误数、发送字节数 |
77
+ | **Gauge** | 某一时点的值,可升可降 | 队列深度、活跃连接数、内存 |
78
+ | **Histogram** | 跨 bucket 的分布 | 请求耗时、响应大小 |
79
+ | **Summary** | 客户端计算的百分位数 | 旧式用法,无服务端聚合 |
80
+
81
+ **命名**:`<domain>.<entity>.<action>.<unit>`,使用 `snake_case`(例如
82
+ `db.client.query.duration.seconds`)。**标签基数**:每个标签的唯一值保持在
83
+ 约 1000 个以下——绝不要把 `user_id` / `request_id` / 原始 `url` / `ip` 当作
84
+ 标签;这些应记录在 Logs 或 Traces 中。
85
+
86
+ ## 成熟度模型(L0–L4)
87
+
88
+ | 等级 | 名称 | 特征 | 升级行动 |
89
+ |------|------|------|----------|
90
+ | **L0** | 无可观测性 | 只有 stdout/stderr;靠 SSH + `tail -f` 调试 | 结构化日志;集中收集 |
91
+ | **L1** | 基础日志 | 结构化 JSON 日志,集中存放、可搜索 | 加入业务指标;建立第一个仪表板 |
92
+ | **L2** | 指标驱动 | Logs + Metrics、仪表板、阈值告警 | 启用追踪;SLO-based 告警 |
93
+ | **L3** | 完整可观测性 | 三支柱 + 关联 + SLO 告警 + 黄金信号 | 异常检测;自动修复 |
94
+ | **L4** | 智能化 | AIOps 异常检测、预测式告警、自动修复 | 维持、优化、分享经验 |
95
+
96
+ **自我检查**:能跨服务找到单一请求的日志(L1+)→ 有错误率与延迟的仪表板
97
+ (L2+)→ 能追踪请求从入口→DB→返回(L3+)→ 能在用户反馈前自动检测
98
+ 异常(L4)。
99
+
100
+ ## 上线前检查表
101
+
102
+ 将服务部署到生产环境之前:
103
+
104
+ - [ ] **结构化日志** — JSON 格式并带 `trace_id` 关联
105
+ - [ ] **HTTP/gRPC 入口指标** — 每个端点的请求数、耗时 histogram、错误率
106
+ - [ ] **业务操作指标** — 追踪关键事件(订单、支付)
107
+ - [ ] **分布式追踪** — span 传播、采样率、W3C Trace Context headers
108
+ - [ ] **健康检查** — liveness(是否运行?)与 readiness(能否服务?)探针
109
+ - [ ] **黄金信号仪表板** — 可视化 Latency、Traffic、Errors、Saturation
110
+ - [ ] **告警规则** — 至少要有 SLO burn-rate 告警
111
+ - [ ] **日志保留** — 按日志级别设置保留策略
112
+ - [ ] **排除敏感数据** — 日志/追踪中不含密码、token 或 PII
113
+
40
114
  ## 下一步引导
41
115
 
42
116
  > **可观测性引导完成。建议下一步:**
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/pr-automation-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: a54acd269f70
6
7
  status: current
7
8
  description: |
8
9
  引导 pull request 创建、审查自动化与合并策略。
@@ -15,6 +16,9 @@ description: |
15
16
 
16
17
  > **语言**: [English](../../../../skills/pr-automation-assistant/SKILL.md) | 简体中文
17
18
 
19
+ > ⚠️ **状态:Reference(参考用,非可执行流程)** — PR 生命周期协调(5 步骤 CREATE→REVIEW→APPROVE→MERGE→CLEANUP、>400 行 size gate、CI gate、squash/merge 策略、gh CLI 集成)已于 2026-04-28 移至 **adoption layer(XSPEC-095)**。此处保留 PR 描述模板、合并策略决策矩阵、auto-review 触发规则供参考。
20
+ > 生命周期协调已移至采用层(XSPEC-095);本文档**仅供参考**。如需强制执行,请使用你的采用层工具链。
21
+
18
22
  简化从创建到合并的 Pull Request 生命周期。
19
23
 
20
24
  ## PR 创建检查清单
@@ -68,19 +72,27 @@ description: |
68
72
  CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP
69
73
  ```
70
74
 
75
+ 1. **Create(创建)** — 建分支、提交、推送,并以模板开启 PR
76
+ 2. **Review(审查)** — 自动化检查 + 人工审查
77
+ 3. **Approve(批准)** — 所有检查通过,满足必要的批准数
78
+ 4. **Merge(合并)** — 套用选定的合并策略
79
+ 5. **Cleanup(清理)** — 删除来源分支,更新关联的 issue
80
+
71
81
  ## 使用方式
72
82
 
73
- - `/pr` - 引导创建当前分支的 PR
74
- - `/pr create` - 使用模板创建 PR
75
- - `/pr --template` - 显示 PR 描述模板
76
- - `/pr review 123` - 审查特定 PR
83
+ ```
84
+ /pr - 引导创建当前分支的 PR
85
+ /pr create - 使用模板创建 PR
86
+ /pr --template - 显示 PR 描述模板
87
+ /pr review 123 - 审查特定 PR
88
+ ```
77
89
 
78
90
  ## 下一步引导
79
91
 
80
92
  `/pr` 完成后,AI 助手应建议:
81
93
 
82
94
  > **PR 操作完成。建议下一步:**
83
- > - 执行 `/code-review` 进行详细代码审查
95
+ > - 执行 `/code-review` 进行详细代码审查 ⭐ **推荐**
84
96
  > - 执行 `/commit` 修正审查发现的问题
85
97
  > - 执行 `/changelog` 更新变更日志
86
98
  > - 检查 CI 状态 → `gh pr checks`
@@ -89,3 +101,17 @@ CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP
89
101
 
90
102
  - 核心规范:[code-review-checklist.md](../../../../core/code-review-checklist.md)
91
103
  - 核心规范:[git-workflow.md](../../../../core/git-workflow.md)
104
+
105
+ ## 版本历史
106
+
107
+ | 版本 | 日期 | 变更说明 |
108
+ |------|------|----------|
109
+ | 1.0.0 | 2026-03-23 | 初始版本 |
110
+
111
+ ## AI 代理行为
112
+
113
+ > 完整的 AI 行为定义请参阅对应的命令文件:[`/pr`](../commands/pr.md#ai-agent-behavior--ai-代理行为)
114
+
115
+ ## 授权
116
+
117
+ CC BY 4.0 — 文档内容
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/project-discovery/SKILL.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: c52920f316a7
6
7
  status: current
7
8
  description: |
8
9
  [UDS] 在既有代码库新增功能之前,评估项目健康度、架构与风险。
@@ -113,7 +114,7 @@ docs/risks/
113
114
  `/discover` 完成后,AI 助手应根据评估结果建议:
114
115
 
115
116
  > **根据评估结果,建议下一步:**
116
- > - **新功能** → 执行 `/sdd` 建立规格
117
+ > - **新功能** → 执行 `/sdd` 建立规格 ⭐ **推荐**
117
118
  > - **遗留代码** → 执行 `/reverse spec` 提取现有行为
118
119
  > - **重构** → 执行 `/refactor decide` 选择策略
119
120
  > - **快速修复** → 执行 `/tdd` 撰写针对性测试并修复
@@ -122,4 +123,9 @@ docs/risks/
122
123
 
123
124
  ## 参考
124
125
 
126
+ - 分步工作流程:[workflow.md](../../../../skills/project-discovery/workflow.md) — 依序列出探索步骤(代码健康度、架构、文档盘点、审查快照、依赖与安全)。实际执行探索时阅读,而非在决定要不要执行时阅读。
125
127
  - 详细指南:[guide.md](./guide.md)
128
+
129
+ ## AI 代理行为
130
+
131
+ > 完整的 AI 行为定义请参阅对应的命令文件:[`/discover`](../commands/discover.md#ai-代理行为)
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/project-structure-guide/SKILL.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: 0c1ad1961de0
6
7
  status: current
7
8
  description: |
8
9
  依各语言的最佳实践组织项目目录结构的指南。
@@ -17,27 +18,37 @@ description: |
17
18
 
18
19
  **版本**:1.1.0
19
20
  **最后更新**:2026-03-04
20
- **適用性**:Claude Code Skills
21
+ **适用性**:Claude Code Skills
21
22
 
22
23
  ---
23
24
 
24
25
  ## 目的
25
26
 
26
- 此技能提供根据语言和框架慣例建構项目的指引,協助建立一致、可維護的目录佈局。
27
+ 此技能提供根据语言和框架惯例组织项目的指引,协助建立一致、可维护的目录布局。
27
28
 
28
- ## 觸發时机
29
+ # [Physical Binding]
30
+ ## 现实检查(Reality Check)
31
+ 在确认项目结构有效之前,你**必须**:
32
+ 1. 执行验证器:`uds check --standard project-structure`
33
+ 2. 若 exit_code != 0:
34
+ - 阅读错误信息(例如 "Missing required directories")。
35
+ - 向用户报告违规之处。
36
+ - 建议具体的修复命令(`mkdir ...`)。
37
+ - 修复后**重新**执行验证。
38
+
39
+ ## 触发时机
29
40
 
30
41
  在以下情况使用此技能:
31
- - 建立新项目
42
+ - 创建新项目
32
43
  - 重组现有项目结构
33
44
  - 新增模块或功能
34
45
  - 设置构建配置
35
- - 建立 .gitignore 文件
46
+ - 创建 .gitignore 文件
36
47
  - 决定文件的放置位置(代码、文档、配置、资源)
37
48
  - 在 utils/、helpers/、shared/、lib/ 或 internal/ 之间做选择
38
49
  - 放置开发中间产物(头脑风暴、RFC、POC、技术调查)
39
50
 
40
- ## 支援的语言
51
+ ## 支持的语言
41
52
 
42
53
  | 语言 | 框架/模式 |
43
54
  |------|-----------|
@@ -45,35 +56,35 @@ description: |
45
56
  | Python | Django、Flask、FastAPI |
46
57
  | Java | Spring Boot、Maven、Gradle |
47
58
  | .NET | ASP.NET Core、Console |
48
- | Go | 标准佈局、cmd/pkg |
59
+ | Go | 标准布局、cmd/pkg |
49
60
  | Rust | Binary、Library、Workspace |
50
61
  | Kotlin | Gradle、Android、Multiplatform |
51
62
  | PHP | Laravel、Symfony、PSR-4 |
52
63
  | Ruby | Rails、Gem、Sinatra |
53
64
  | Swift | SPM、iOS App、Vapor |
54
65
 
55
- ## 常見结构模式
66
+ ## 常见结构模式
56
67
 
57
68
  ### 标准目录
58
69
 
59
70
  ```
60
71
  project-root/
61
- ├── src/ # 原始码
72
+ ├── src/ # 源代码
62
73
  ├── tests/ # 测试文件
63
- ├── docs/ # 文件
64
- ├── tools/ # 建構/部署脚本
65
- ├── examples/ # 使用範例
74
+ ├── docs/ # 文档
75
+ ├── tools/ # 构建/部署脚本
76
+ ├── examples/ # 使用示例
66
77
  ├── config/ # 配置文件
67
78
  └── .github/ # GitHub 配置
68
79
  ```
69
80
 
70
- ### 建構输出(始終 gitignore)
81
+ ### 构建输出(始终 gitignore)
71
82
 
72
83
  ```
73
- dist/ # 發佈输出
74
- build/ # 编譯产物
84
+ dist/ # 发布输出
85
+ build/ # 编译产物
75
86
  out/ # 输出目录
76
- bin/ # 二进位执行檔
87
+ bin/ # 二进制可执行文件
77
88
  ```
78
89
 
79
90
  ## 语言特定指南
@@ -121,23 +132,23 @@ project/
121
132
 
122
133
  ## 快速操作
123
134
 
124
- ### 建立项目结构
135
+ ### 创建项目结构
125
136
 
126
- 當被要求建立项目时:
127
- 1. 詢問语言/框架
128
- 2. 生成適當的目录结构
129
- 3. 建立必要的配置文件
137
+ 当被要求创建项目时:
138
+ 1. 询问语言/框架
139
+ 2. 生成适当的目录结构
140
+ 3. 创建必要的配置文件
130
141
  4. 生成 .gitignore
131
142
 
132
143
  ### 审查结构
133
144
 
134
- 审查現有结构时:
135
- 1. 检查语言慣例
145
+ 审查现有结构时:
146
+ 1. 检查语言惯例
136
147
  2. 验证 gitignore 模式
137
148
  3. 建议改进
138
- 4. 識别放錯位置的文件
149
+ 4. 识别放错位置的文件
139
150
 
140
- ## 規則
151
+ ## 规则
141
152
 
142
153
  1. **遵循语言惯例** - 每种语言都有既定模式
143
154
  2. **分离关注点** - 将源代码、测试、文档分开
@@ -148,29 +159,21 @@ project/
148
159
  7. **工作文档放 docs/working/** - 头脑风暴、RFC、POC、技术调查放在 docs/working/ 并进行生命周期管理
149
160
  8. **生成代码分离** - 放在 src/generated/{type}/,永不与手写代码混合
150
161
 
151
- ## 相关标准
152
-
153
- - [各语言的项目结构](./language-patterns.md) — 按语言列出的实际目录布局(Node.js/TypeScript、Python、Go 等)。要为某个特定语言安排项目结构时读它。
154
- - [核心:项目结构](../../core/project-structure.md)
155
- - [核心:文档结构](../../core/documentation-structure.md)
156
- - [指南:文件归档决策指南](../../core/guides/file-placement-guide.md)
157
- - [AI:项目结构选项](../../../../options/project-structure/)
158
-
159
-
160
- ## Next Steps Guidance | 下一步引導
162
+ ## 下一步引导
161
163
 
162
- After `/project-structure` completes, the AI assistant should suggest:
164
+ `/project-structure` 完成后,AI 助手应建议:
163
165
 
164
- > **專案結構已建立或審查完成。建議下一步 / Project structure created or reviewed. Suggested next steps:**
165
- > - 執行 `/sdd` 開始規格驅動開發,將專案結構納入正式規格 ⭐ **Recommended / 推薦** — 確保結構決策有規格追蹤 / Ensures structure decisions are tracked in specs
166
- > - 執行 `/docs` 產生專案文件(README、ARCHITECTURE.md 等) — 讓結構決策有文件記錄 / Document structure decisions
167
- > - 執行 `/ai-friendly-architecture` 設定 AI 上下文配置 — 讓 AI 助手更好地理解專案結構 / Help AI assistants understand the project structure
166
+ > **项目结构已创建或审查完成。建议下一步:**
167
+ > - 执行 `/sdd` 开始规格驱动开发,将项目结构纳入正式规格 ⭐ **推荐** — 确保结构决策有规格追踪
168
+ > - 执行 `/docs` 生成项目文档(README、ARCHITECTURE.md 等) — 让结构决策有文档记录
169
+ > - 执行 `/ai-friendly-architecture` 设置 AI 上下文配置 — 让 AI 助手更好地理解项目结构
168
170
 
169
171
  ---
170
172
 
171
- ## Related Standards
173
+ ## 相关标准
172
174
 
173
- - [Core: Project Structure](../../core/project-structure.md)
174
- - [Core: Documentation Structure](../../core/documentation-structure.md)
175
- - [Guide: File Placement Decision Guide](../../core/guides/file-placement-guide.md)
176
- - [AI: Project Structure Options](../../ai/options/project-structure/)
175
+ - [各语言的项目结构](./language-patterns.md) — 按语言列出的实际目录布局(Node.js/TypeScript、Python、Go 等)。要为某个特定语言安排项目结构时读它。
176
+ - [核心:项目结构](../../../../core/project-structure.md)
177
+ - [核心:文档结构](../../../../core/documentation-structure.md)
178
+ - [指南:文件归档决策指南](../../../../core/guides/file-placement-guide.md)
179
+ - [AI:项目结构选项](../../../../ai/options/project-structure/)
@@ -2,13 +2,14 @@
2
2
  source: ../../../../skills/project-structure-guide/language-patterns.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-30
5
+ last_synced: 2026-10-11
6
+ source_hash: 4164884da2d0
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 语言特定项目模式
10
11
 
11
- 各语言项目结构快速參考。
12
+ 各语言项目结构快速参考。
12
13
 
13
14
  ## Node.js / TypeScript
14
15
 
@@ -89,7 +90,7 @@ project/
89
90
 
90
91
  ## Go
91
92
 
92
- ### 标准佈局
93
+ ### 标准布局
93
94
 
94
95
  ```
95
96
  project/
@@ -240,13 +241,13 @@ project/
240
241
  ### 通用
241
242
 
242
243
  ```gitignore
243
- # 建構输出
244
+ # 构建输出
244
245
  dist/
245
246
  build/
246
247
  out/
247
248
  bin/
248
249
 
249
- # 環境
250
+ # 环境
250
251
  .env
251
252
  .env.*
252
253
 
@@ -255,7 +256,7 @@ bin/
255
256
  .vscode/
256
257
  *.swp
257
258
 
258
- # 作业系统
259
+ # 操作系统
259
260
  .DS_Store
260
261
  Thumbs.db
261
262
  ```
@@ -267,5 +268,5 @@ Thumbs.db
267
268
  | Node.js | node_modules/、*.log |
268
269
  | Python | __pycache__/、*.pyc、.venv/ |
269
270
  | Go | vendor/(如不使用 modules) |
270
- | Rust | target/、Cargo.lock(函式庫) |
271
+ | Rust | target/、Cargo.lock(库项目) |
271
272
  | Java/.NET | *.class、bin/、obj/ |
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/refactoring-assistant/SKILL.md
3
3
  source_version: 2.0.0
4
4
  translation_version: 2.1.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: 22be2c4ae81e
6
7
  status: current
7
8
  description: |
8
9
  [UDS] 引导重构决策与策略选择,包含「重构还是重写」这个判断。
@@ -62,12 +63,27 @@ description: |
62
63
  4. **执行** - 遵循逐步工作流程,包含安全检查
63
64
  5. **验证** - 执行测试以确认行为未被改变
64
65
 
66
+ ## 使用示例
67
+
68
+ ```
69
+ User: /refactor src/legacy-auth/
70
+ AI: 正在分析 src/legacy-auth/...
71
+ 测试覆盖率:23% — 建议采用安全优先的做法。
72
+ 建议策略:特征化测试 + 准备式重构
73
+ ```
74
+
75
+ ```
76
+ User: /refactor decide
77
+ AI: 我来帮你决定该重构还是重写。
78
+ 问题 1:这段代码目前是否在生产环境中正常运行?[Y/N]
79
+ ```
80
+
65
81
  ## 下一步引导
66
82
 
67
83
  `/refactor` 完成后,AI 助手应建议:
68
84
 
69
85
  > **重构完成。建议下一步:**
70
- > - 执行 `/checkin` 通过品质关卡
86
+ > - 执行 `/checkin` 通过品质关卡 ⭐ **推荐**
71
87
  > - 执行 `/coverage` 确认重构后覆盖率不下降
72
88
  > - 执行 `/commit` 提交重构变更
73
89
 
@@ -75,3 +91,7 @@ description: |
75
91
 
76
92
  - 详细指南:[guide.md](./guide.md)
77
93
  - 核心规范:[refactoring-standards.md](../../../../core/refactoring-standards.md)
94
+
95
+ ## AI 代理行为
96
+
97
+ > 完整的 AI 行为定义请参阅对应的命令文件:[`/refactor`](../commands/refactor.md#ai-代理行为)
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/release-standards/SKILL.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: e9e935fd95a0
6
7
  status: current
7
8
  description: |
8
9
  [UDS] 引导发布流程——语义化版本、发布模式,以及 start/finish/promote/deploy 的顺序。
@@ -19,34 +20,62 @@ description: |
19
20
 
20
21
  ## 子命令
21
22
 
22
- | 子命令 | 说明 | Description |
23
- |--------|------|-------------|
24
- | `start` | 开始发布流程 | Start a release branch/process |
25
- | `finish` | 完成发布(标签、合并) | Finalize release (tag, merge) |
26
- | `changelog` | 产生或更新变更日志 | Generate or update CHANGELOG.md |
27
- | `check` | 执行发布前检查 | Run pre-release verification |
23
+ | 子命令 | 模式 | 说明 |
24
+ |--------|------|------|
25
+ | `start` | All | 开始发布流程 |
26
+ | `finish` | CI/CD | 完成发布(标签、合并) |
27
+ | `promote` | Manual/Hybrid | RC → Stable 晋升 |
28
+ | `deploy` | Manual/Hybrid | 记录部署记录 |
29
+ | `manifest` | Manual/Hybrid | 生成打包信息清单(build-manifest.json) |
30
+ | `verify` | Manual/Hybrid | 验证清单一致性 |
31
+ | `changelog` | All | 生成或更新变更日志 |
32
+ | `check` | All | 执行发布前检查 |
33
+
34
+ ## 发布模式
35
+
36
+ 通过 `uds init` 或 `uds config --type release_mode` 配置:
37
+
38
+ | 模式 | 说明 |
39
+ |------|------|
40
+ | `ci-cd` | 通过 CI/CD 流水线自动发布(默认) |
41
+ | `manual` | 手动打包 + RC 工作流程 |
42
+ | `hybrid` | CI 构建产物 + 手动部署 |
28
43
 
29
44
  ## 版本类型
30
45
 
31
46
  | 类型 | 格式 | npm Tag | 用途 |
32
47
  |------|------|---------|------|
33
- | 正式版 | `X.Y.Z` | `@latest` | Stable |
34
- | 公开测试 | `X.Y.Z-beta.N` | `@beta` | Beta |
35
- | 内部测试 | `X.Y.Z-alpha.N` | `@alpha` | Alpha |
36
- | 候选版本 | `X.Y.Z-rc.N` | `@rc` | RC |
48
+ | Stable | `X.Y.Z` | `@latest` | 正式版 |
49
+ | Beta | `X.Y.Z-beta.N` | `@beta` | 公开测试 |
50
+ | Alpha | `X.Y.Z-alpha.N` | `@alpha` | 内部测试 |
51
+ | RC | `X.Y.Z-rc.N` | `@rc` | 候选版本 |
37
52
 
38
53
  ## 工作流程
39
54
 
40
55
  1. **决定版本** - 根据变更决定版本类型(MAJOR/MINOR/PATCH)
41
- 2. **更新版本文件** - 更新 package.json 和相关版本引用
42
- 3. **更新 CHANGELOG** - 将 [Unreleased] 条目移至新版本区段
43
- 4. **执行发布前检查** - 验证测试、lint 和标准合规
44
- 5. **建立 git tag** - 使用 `vX.Y.Z` 格式标签
45
- 6. **提交并推送** - 提交版本更新并推送标签
56
+ 2. **分流未关闭的 issue/PR** - `gh pr list` + `gh issue list`;将每一项二分为 **带上(bring-in)或延后(defer)**(XSPEC-265)
57
+ 3. **更新版本文件** - 更新 package.json 和相关版本引用
58
+ 4. **更新 CHANGELOG** - 将 [Unreleased] 条目移至新版本区段
59
+ 5. **执行发布前检查** - 验证测试、lint、标准合规,**以及 issue/PR 分流闸门**
60
+ 6. **创建 git tag** - 使用 `vX.Y.Z` 格式标签
61
+ 7. **提交并推送** - 提交版本更新并推送标签
62
+
63
+ ### 发版前 issue/PR 分流闸门(XSPEC-265)
64
+
65
+ 递增版本号之前,扫描未关闭的 issue/PR,并对每一项做出有意识的决定——**不要**依赖记忆:
66
+
67
+ | 类别 | 动作 |
68
+ |------|------|
69
+ | **带上(Bring-in)** | patch 级 dependabot PR / 阻塞发布的 bug / 与本版主题相关的修复 → 在递增版本前合并 |
70
+ | **延后(Defer)** | major PR、审计/增强类 issue、需要另行评估者 → 记录在签核(signoff)的 "deferred" 中,并写入发布说明的 Known Issues |
71
+
72
+ - 确认 `cross-project/sub-project-triage.md` 快照是近期的(≤7 天);若已过期则刷新。
73
+ - 将结果记录在发布签核(Tier-1)中:`Pre-release issue/PR triage | PASS | N PRs / M issues: X merged / Y deferred`。
74
+ - **不要求清空 backlog**——只要求每一项都有有意识的决定 + 留下记录。
46
75
 
47
76
  ### 版本递增规则
48
77
 
49
- | 变更类型 | 递增 | 范例 |
78
+ | 变更类型 | 递增 | 示例 |
50
79
  |---------|------|------|
51
80
  | 破坏性变更 | MAJOR | 1.9.5 → 2.0.0 |
52
81
  | 新功能(向下兼容) | MINOR | 2.3.5 → 2.4.0 |
@@ -54,24 +83,38 @@ description: |
54
83
 
55
84
  ## 使用方式
56
85
 
86
+ ### CI/CD 模式(默认)
57
87
  - `/release start 1.2.0` - 开始 v1.2.0 的发布流程
58
88
  - `/release changelog 1.2.0` - 更新 v1.2.0 的 CHANGELOG
59
- - `/release finish 1.2.0` - 完成并标签 v1.2.0
89
+ - `/release finish 1.2.0` - 完成并标记 v1.2.0
60
90
  - `/release check` - 执行发布前验证
61
91
 
92
+ ### 手动模式(RC 工作流程)
93
+ - `/release start 1.2.0-rc.1` - 创建 RC 版本
94
+ - `uds release manifest` - 生成 build-manifest.json
95
+ - `uds release deploy staging` - 记录 staging 部署
96
+ - `uds release deploy staging --result passed` - 记录测试结果
97
+ - `/release promote 1.2.0` - 将 RC 晋升为稳定版
98
+ - `uds release deploy production` - 记录 production 部署
99
+ - `uds release verify` - 验证清单一致性
100
+
62
101
  ## 下一步引导
63
102
 
64
103
  `/release` 完成后,AI 助手应建议:
65
104
 
66
105
  > **发布流程完成。建议下一步:**
67
- > - 验证 npm 发布状态 `npm view <pkg> dist-tags`
68
- > - 建立 GitHub Release 并撰写发布说明
106
+ > - 验证 npm 发布状态 `npm view <pkg> dist-tags` ⭐ **推荐**
107
+ > - 创建 GitHub Release 并撰写发布说明
69
108
  > - 通知利益相关者新版本已发布
70
109
 
71
110
  ## 参考
72
111
 
73
- - [变更日誌格式指南](./changelog-format.md) — 要撰写或审查变更日志时读它。
74
- - [發布流程指南](./release-workflow.md) — 真的要发一版、需要逐步流程时读它。
75
- - [語意化版本指南](./semantic-versioning.md) — 要判断一个变更算 major、minor 还是 patch 时读它。
112
+ - [变更日志格式指南](./changelog-format.md) — 要撰写或审查变更日志条目时读它。
113
+ - [发布流程指南](./release-workflow.md) — 真的要发一版、需要逐步流程时读它。
114
+ - [语义化版本指南](./semantic-versioning.md) — 要判断一个变更算 major、minor 还是 patch 时读它。
76
115
  - 详细指南:[guide.md](./guide.md)
77
116
  - 核心规范:[versioning.md](../../../../core/versioning.md)
117
+
118
+ ## AI 代理行为
119
+
120
+ > 完整的 AI 行为定义请参阅对应的命令文件:[`/release`](../../../../skills/commands/release.md#ai-agent-behavior--ai-代理行為)