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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -2,13 +2,14 @@
2
2
  source: ../../../../options/git-workflow/trunk-based.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: 08f932654363
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # Trunk-Based 开发
10
11
 
11
- > **语言**: [English](../../../../options/git-workflow/trunk-based.md) | 繁体中文
12
+ > **语言**: [English](../../../../options/git-workflow/trunk-based.md) | 简体中文
12
13
 
13
14
  **上层标准**: [Git 工作流程](../../../../core/git-workflow.md)
14
15
 
@@ -16,110 +17,156 @@ status: current
16
17
 
17
18
  ## 概述
18
19
 
19
- Trunk-Based 开发是一种版本控制管理实践,所有开发者在单一分支(称为「trunk」或「main」)上进行小型、频繁的更新。它最大化持续整合,减少合并问题。
20
+ Trunk-Based Development(主干开发)是一种源代码控制分支模型:开发者在名为 "trunk"(main)的单一分支上协作开发,避免创建长期存在的分支,并使用功能开关(feature flag)来管理尚未完成的功能。
20
21
 
21
- ## 适用情境
22
+ ## 适用场景
22
23
 
23
- - 经验丰富的团队
24
- - 强大的 CI/CD 基础设施
25
- - 需要快速发布周期
26
- - 高度自动化测试环境
24
+ - 持续部署(每天多次)
25
+ - 成熟的 CI/CD 流水线
26
+ - 经验丰富的开发团队
27
+ - 微服务架构
28
+
29
+ ## 分支结构
30
+
31
+ | 分支 | 用途 | 生命周期 |
32
+ |------|------|----------|
33
+ | `main` (trunk) | 唯一可信来源,始终可部署 | 永久 |
34
+ | `feature/*` | 生命周期极短的功能分支(可选) | 最长 1-2 天 |
27
35
 
28
36
  ## 核心原则
29
37
 
30
- | 原则 | 说明 |
31
- |------|------|
32
- | 单一主分支 | 所有开发在 main/trunk 进行 |
33
- | 小型提交 | 频繁提交小变更 |
34
- | 功能标志 | 使用 feature flags 控制功能 |
35
- | 持续整合 | 频繁合并到主分支 |
38
+ 1. **小而频繁的提交** - 每天多次提交到 trunk
39
+ 2. **功能开关** - 将未完成的功能隐藏在开关之后
40
+ 3. **trunk 始终保持绿色** - 每次提交都必须通过所有测试
41
+ 4. **没有长期分支** - 分支最多存在 2 天
42
+ 5. **快速 CI** - 构建和测试以分钟计,而不是小时
36
43
 
37
- ## 工作流程
44
+ ## 工作流程:直接提交
38
45
 
39
- ### 直接在 trunk 工作
46
+ 对于小型变更,直接提交到 trunk:
40
47
 
41
48
  ```bash
42
- # 更新本地 main
49
+ # Start from latest trunk
43
50
  git checkout main
44
51
  git pull origin main
45
52
 
46
- # 进行小型变更
53
+ # Make small, focused changes
54
+ # ... edit files ...
55
+
56
+ # Commit and push
47
57
  git add .
48
- git commit -m "feat: add user avatar display"
58
+ git commit -m "feat: add email validation"
59
+ git pull --rebase origin main
49
60
  git push origin main
50
61
  ```
51
62
 
52
- ### 短期功能分支(可选)
63
+ ## 工作流程:短期分支
64
+
65
+ 对于稍大的变更(仍少于 2 天):
53
66
 
54
67
  ```bash
55
- # 建立短期分支(最长 1-2 天)
56
- git checkout -b feat/quick-change
57
- # 进行变更
68
+ # Create short-lived branch
58
69
  git checkout main
59
- git merge feat/quick-change
70
+ git pull origin main
71
+ git checkout -b feature/add-avatar
72
+
73
+ # Make changes (complete within 1-2 days)
74
+ git commit -m "feat: add avatar upload"
75
+ git commit -m "test: add avatar tests"
76
+
77
+ # Merge quickly
78
+ git checkout main
79
+ git pull origin main
80
+ git merge --ff-only feature/add-avatar
60
81
  git push origin main
61
- git branch -d feat/quick-change
82
+ git branch -d feature/add-avatar
62
83
  ```
63
84
 
64
- ## 功能标志
85
+ ## 功能开关
65
86
 
66
- 使用功能标志在生产环境控制未完成功能:
87
+ 功能开关对主干开发至关重要:
67
88
 
68
89
  ```javascript
69
- // 功能标志范例
90
+ // Example feature flag usage
70
91
  if (featureFlags.isEnabled('new-checkout-flow')) {
71
- return <NewCheckoutFlow />;
72
- } else {
73
- return <LegacyCheckoutFlow />;
92
+ return <NewCheckout />;
74
93
  }
94
+ return <OldCheckout />;
75
95
  ```
76
96
 
77
- ### 功能标志类型
97
+ ### 功能开关生命周期
78
98
 
79
- | 类型 | 用途 | 生命周期 |
80
- |------|------|----------|
81
- | 发布标志 | 隐藏未完成功能 | 短期 |
82
- | 实验标志 | A/B 测试 | 中期 |
83
- | 权限标志 | 功能存取控制 | 长期 |
84
- | 营运标志 | 系统行为控制 | 长期 |
99
+ 1. **创建开关** - 在开始功能开发之前
100
+ 2. **在开关后开发** - 所有新代码都由开关隐藏
101
+ 3. **开启开关进行测试** - QA 测试该功能
102
+ 4. **逐步发布** - 按用户百分比逐步启用
103
+ 5. **移除开关** - 功能稳定后
85
104
 
86
- ## 前提条件
105
+ ## 最佳实践
106
+
107
+ ### 结对编程
108
+ - 实时代码审查
109
+ - 更高质量的提交
110
+ - 知识共享
111
+
112
+ ### 测试驱动开发
113
+ - 先写测试
114
+ - 对 trunk 稳定性高度有信心
115
+ - 快速反馈
87
116
 
88
- 使用 Trunk-Based 开发需要:
117
+ ### 持续集成
118
+ - 每次提交都运行测试
119
+ - 自动化部署
120
+ - 快速构建(< 10 分钟)
89
121
 
90
- 1. **全面的自动化测试**
91
- 2. **快速的 CI/CD 管线**
92
- 3. **程式码审查文化**
93
- 4. **功能标志系统**
94
- 5. **即时监控能力**
122
+ ### 监控
123
+ - 实时错误追踪
124
+ - 快速回滚能力
125
+ - 功能开关分析
126
+
127
+ ## 提交指南
128
+
129
+ ```bash
130
+ # Good: Small, atomic commits
131
+ git commit -m "feat: add user avatar field to schema"
132
+ git commit -m "feat: add avatar upload endpoint"
133
+ git commit -m "feat: add avatar display component"
134
+
135
+ # Bad: Large, compound commits
136
+ git commit -m "feat: add complete avatar feature with upload, display, and tests"
137
+ ```
95
138
 
96
139
  ## 优点
97
140
 
98
- | 优点 | 说明 |
99
- |------|------|
100
- | 最少合并冲突 | 频繁整合减少冲突 |
101
- | 持续整合 | 真正的 CI 实践 |
102
- | 快速反馈 | 问题快速浮现 |
103
- | 简化分支管理 | 无复杂分支策略 |
141
+ - 变更集成速度最快
142
+ - 合并冲突极少
143
+ - 鼓励小型、易于审查的变更
144
+ - 支持持续部署
104
145
 
105
146
  ## 缺点
106
147
 
107
- | 缺点 | 说明 |
108
- |------|------|
109
- | 需要高度纪律 | 团队必须遵守规则 |
110
- | 需要强大的 CI | 测试和建置必须快速 |
111
- | 功能标志复杂性 | 需要管理标志生命周期 |
112
- | 不适合新手团队 | 需要经验和信任 |
148
+ - 需要成熟的 CI/CD
149
+ - 需要功能开关基础设施
150
+ - 对技能要求较高
151
+ - 并不适合所有规模的团队
152
+
153
+ ## 前提条件
154
+
155
+ - [ ] 快速、可靠的 CI 流水线(构建 < 10 分钟)
156
+ - [ ] 高测试覆盖率
157
+ - [ ] 功能开关系统
158
+ - [ ] 监控与回滚能力
159
+ - [ ] 团队具备 Git 使用经验
113
160
 
114
161
  ## 相关选项
115
162
 
116
- - [GitHub Flow](./github-flow.md) - 带有 PR 的简化流程
117
- - [GitFlow](./gitflow.md) - 适合有排程发布的专案
163
+ - [GitHub Flow](./github-flow.md) - 较宽松,允许较长的分支
164
+ - [GitFlow](./gitflow.md) - 适用于按计划发布
118
165
 
119
166
  ---
120
167
 
121
- ## 授权条款
168
+ ## 许可
122
169
 
123
- 本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
170
+ 本文档采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
124
171
 
125
172
  **来源**:[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -2,53 +2,57 @@
2
2
  source: ../../../../options/project-structure/dotnet.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: 43ba40fa1b75
6
7
  status: current
7
8
  ---
8
9
 
9
- # .NET 专案结构
10
+ # .NET 项目结构
10
11
 
11
- > **语言**: [English](../../../../options/project-structure/dotnet.md) | 繁体中文
12
+ > **语言**: [English](../../../../options/project-structure/dotnet.md) | 简体中文
12
13
 
13
- **上层标准**: [专案结构](../../../../core/project-structure.md)
14
+ **上层标准**: [项目结构](../../../../core/project-structure.md)
14
15
 
15
16
  ---
16
17
 
17
- ## 概述
18
+ ## 概览
18
19
 
19
- 本文件定义遵循 Clean Architecture 原则的 .NET/C# 专案标准目录结构。它促进关注点分离,相依性指向核心领域。
20
+ 本文档定义遵循 Clean Architecture 原则的 .NET/C# 项目标准目录结构。它促进关注点分离,依赖关系向内指向核心领域。
20
21
 
21
- ## 适用情境
22
+ ## 适用场景
22
23
 
23
24
  - ASP.NET Core Web API
24
- - 企业级应用程式
25
+ - 企业级应用
25
26
  - 微服务
26
- - 领域驱动设计专案
27
- - 大型应用程式
27
+ - 领域驱动设计(DDD)项目
28
+ - 大型应用
28
29
 
29
30
  ## 目录结构
30
31
 
31
32
  ```
32
33
  SolutionName/
33
34
  ├── src/
34
- │ ├── SolutionName.Api/ # Web API 专案
35
+ │ ├── SolutionName.Api/ # Web API project
35
36
  │ │ ├── Controllers/
36
37
  │ │ ├── Middleware/
37
38
  │ │ ├── Filters/
38
39
  │ │ ├── Program.cs
39
- │ │ └── appsettings.json
40
- │ ├── SolutionName.Core/ # 核心业务逻辑
40
+ │ │ ├── appsettings.json
41
+ │ │ └── appsettings.Development.json
42
+ │ ├── SolutionName.Core/ # Core business logic
41
43
  │ │ ├── Entities/
42
44
  │ │ ├── Interfaces/
43
45
  │ │ ├── Services/
46
+ │ │ ├── Specifications/
44
47
  │ │ └── Exceptions/
45
- │ ├── SolutionName.Infrastructure/ # 外部服务实作
48
+ │ ├── SolutionName.Infrastructure/ # External service implementations
46
49
  │ │ ├── Data/
47
50
  │ │ │ ├── ApplicationDbContext.cs
48
51
  │ │ │ └── Migrations/
49
52
  │ │ ├── Repositories/
50
- │ │ └── ExternalServices/
51
- │ └── SolutionName.Shared/ # 共用程式码
53
+ │ │ ├── ExternalServices/
54
+ │ │ └── Identity/
55
+ │ └── SolutionName.Shared/ # Shared code
52
56
  │ ├── DTOs/
53
57
  │ ├── Extensions/
54
58
  │ └── Utils/
@@ -57,38 +61,42 @@ SolutionName/
57
61
  │ ├── SolutionName.IntegrationTests/
58
62
  │ └── SolutionName.FunctionalTests/
59
63
  ├── docs/
64
+ ├── scripts/
60
65
  ├── SolutionName.sln
66
+ ├── .editorconfig
67
+ ├── Directory.Build.props
61
68
  └── README.md
62
69
  ```
63
70
 
64
- ## Clean Architecture 层次
71
+ ## Clean Architecture 分层
65
72
 
66
73
  ```
67
74
  ┌─────────────────────────────────────────┐
68
- │ API 层 │
75
+ │ API Layer │
69
76
  │ Controllers, Middleware, Filters │
70
77
  ├─────────────────────────────────────────┤
71
- │ Infrastructure 层 │
78
+ │ Infrastructure Layer │
72
79
  │ DbContext, Repositories, External APIs │
73
80
  ├─────────────────────────────────────────┤
74
- │ Core 层 │
81
+ │ Core Layer │
75
82
  │ Entities, Services, Interfaces │
76
83
  └─────────────────────────────────────────┘
77
- 相依性指向内部 ↓
84
+ Dependencies point inward ↓
78
85
  ```
79
86
 
80
- ## 命名惯例
87
+ ## 命名约定
81
88
 
82
- | 类型 | 惯例 | 范例 |
89
+ | 类型 | 约定 | 示例 |
83
90
  |------|------|------|
84
- | 档案 | PascalCase.cs | `UserService.cs` |
91
+ | 文件 | PascalCase.cs | `UserService.cs` |
85
92
  | 目录 | PascalCase | `Controllers/` |
86
- | 类别 | PascalCase | `UserService` |
87
- | 介面 | IPascalCase | `IUserService` |
93
+ | 类 | PascalCase | `UserService` |
94
+ | 接口 | IPascalCase | `IUserService` |
88
95
  | 方法 | PascalCase | `CreateUser()` |
89
- | 私有栏位 | _camelCase | `_userRepository` |
96
+ | 私有字段 | _camelCase | `_userRepository` |
97
+ | 常量 | PascalCase | `MaxRetryCount` |
90
98
 
91
- ## 层次结构
99
+ ## 分层结构
92
100
 
93
101
  ### Core 层(领域)
94
102
 
@@ -101,6 +109,9 @@ public class User
101
109
  public Guid Id { get; private set; }
102
110
  public string Email { get; private set; } = string.Empty;
103
111
  public string Name { get; private set; } = string.Empty;
112
+ public DateTime CreatedAt { get; private set; }
113
+
114
+ private User() { } // For EF Core
104
115
 
105
116
  public static User Create(string email, string name)
106
117
  {
@@ -108,18 +119,119 @@ public class User
108
119
  {
109
120
  Id = Guid.NewGuid(),
110
121
  Email = email,
111
- Name = name
122
+ Name = name,
123
+ CreatedAt = DateTime.UtcNow
112
124
  };
113
125
  }
126
+
127
+ public void UpdateName(string name)
128
+ {
129
+ Name = name;
130
+ }
114
131
  }
115
132
  ```
116
133
 
117
134
  ```csharp
118
135
  // src/SolutionName.Core/Interfaces/IUserRepository.cs
136
+ namespace SolutionName.Core.Interfaces;
137
+
119
138
  public interface IUserRepository
120
139
  {
121
140
  Task<User?> GetByIdAsync(Guid id, CancellationToken ct = default);
141
+ Task<User?> GetByEmailAsync(string email, CancellationToken ct = default);
122
142
  Task<User> AddAsync(User user, CancellationToken ct = default);
143
+ Task UpdateAsync(User user, CancellationToken ct = default);
144
+ }
145
+ ```
146
+
147
+ ```csharp
148
+ // src/SolutionName.Core/Services/UserService.cs
149
+ namespace SolutionName.Core.Services;
150
+
151
+ public class UserService : IUserService
152
+ {
153
+ private readonly IUserRepository _userRepository;
154
+ private readonly ILogger<UserService> _logger;
155
+
156
+ public UserService(IUserRepository userRepository, ILogger<UserService> logger)
157
+ {
158
+ _userRepository = userRepository;
159
+ _logger = logger;
160
+ }
161
+
162
+ public async Task<User> CreateUserAsync(CreateUserRequest request, CancellationToken ct)
163
+ {
164
+ var existingUser = await _userRepository.GetByEmailAsync(request.Email, ct);
165
+ if (existingUser is not null)
166
+ {
167
+ throw new DuplicateEmailException(request.Email);
168
+ }
169
+
170
+ var user = User.Create(request.Email, request.Name);
171
+ await _userRepository.AddAsync(user, ct);
172
+
173
+ _logger.LogInformation("User created: {UserId}", user.Id);
174
+ return user;
175
+ }
176
+ }
177
+ ```
178
+
179
+ ### Infrastructure 层
180
+
181
+ ```csharp
182
+ // src/SolutionName.Infrastructure/Data/ApplicationDbContext.cs
183
+ namespace SolutionName.Infrastructure.Data;
184
+
185
+ public class ApplicationDbContext : DbContext
186
+ {
187
+ public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
188
+ : base(options) { }
189
+
190
+ public DbSet<User> Users => Set<User>();
191
+
192
+ protected override void OnModelCreating(ModelBuilder modelBuilder)
193
+ {
194
+ modelBuilder.ApplyConfigurationsFromAssembly(typeof(ApplicationDbContext).Assembly);
195
+ }
196
+ }
197
+ ```
198
+
199
+ ```csharp
200
+ // src/SolutionName.Infrastructure/Repositories/UserRepository.cs
201
+ namespace SolutionName.Infrastructure.Repositories;
202
+
203
+ public class UserRepository : IUserRepository
204
+ {
205
+ private readonly ApplicationDbContext _context;
206
+
207
+ public UserRepository(ApplicationDbContext context)
208
+ {
209
+ _context = context;
210
+ }
211
+
212
+ public async Task<User?> GetByIdAsync(Guid id, CancellationToken ct = default)
213
+ {
214
+ return await _context.Users.FindAsync(new object[] { id }, ct);
215
+ }
216
+
217
+ public async Task<User?> GetByEmailAsync(string email, CancellationToken ct = default)
218
+ {
219
+ return await _context.Users
220
+ .FirstOrDefaultAsync(u => u.Email == email, ct);
221
+ }
222
+
223
+ public async Task<User> AddAsync(User user, CancellationToken ct = default)
224
+ {
225
+ await _context.Users.AddAsync(user, ct);
226
+ await _context.SaveChangesAsync(ct);
227
+ return user;
228
+ }
229
+
230
+ public async Task UpdateAsync(User user, CancellationToken ct = default)
231
+ {
232
+ _context.Users.Update(user);
233
+ await _context.SaveChangesAsync(ct);
234
+ }
123
235
  }
124
236
  ```
125
237
 
@@ -127,6 +239,8 @@ public interface IUserRepository
127
239
 
128
240
  ```csharp
129
241
  // src/SolutionName.Api/Controllers/UsersController.cs
242
+ namespace SolutionName.Api.Controllers;
243
+
130
244
  [ApiController]
131
245
  [Route("api/[controller]")]
132
246
  public class UsersController : ControllerBase
@@ -140,44 +254,149 @@ public class UsersController : ControllerBase
140
254
 
141
255
  [HttpPost]
142
256
  [ProducesResponseType(typeof(UserDto), StatusCodes.Status201Created)]
257
+ [ProducesResponseType(StatusCodes.Status400BadRequest)]
143
258
  public async Task<IActionResult> CreateUser(
144
259
  [FromBody] CreateUserRequest request,
145
260
  CancellationToken ct)
146
261
  {
147
262
  var user = await _userService.CreateUserAsync(request, ct);
148
- return CreatedAtAction(nameof(GetUser), new { id = user.Id }, user.ToDto());
263
+ var dto = user.ToDto();
264
+ return CreatedAtAction(nameof(GetUser), new { id = user.Id }, dto);
265
+ }
266
+
267
+ [HttpGet("{id:guid}")]
268
+ [ProducesResponseType(typeof(UserDto), StatusCodes.Status200OK)]
269
+ [ProducesResponseType(StatusCodes.Status404NotFound)]
270
+ public async Task<IActionResult> GetUser(Guid id, CancellationToken ct)
271
+ {
272
+ var user = await _userService.GetUserByIdAsync(id, ct);
273
+ if (user is null)
274
+ {
275
+ return NotFound();
276
+ }
277
+ return Ok(user.ToDto());
149
278
  }
150
279
  }
151
280
  ```
152
281
 
153
- ## 专案参考
282
+ ## 配置
154
283
 
155
- | 专案 | 可参考 |
284
+ ### Directory.Build.props
285
+
286
+ ```xml
287
+ <Project>
288
+ <PropertyGroup>
289
+ <TargetFramework>net8.0</TargetFramework>
290
+ <ImplicitUsings>enable</ImplicitUsings>
291
+ <Nullable>enable</Nullable>
292
+ <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
293
+ </PropertyGroup>
294
+ </Project>
295
+ ```
296
+
297
+ ### Program.cs
298
+
299
+ ```csharp
300
+ // src/SolutionName.Api/Program.cs
301
+ var builder = WebApplication.CreateBuilder(args);
302
+
303
+ // Add services
304
+ builder.Services.AddControllers();
305
+ builder.Services.AddEndpointsApiExplorer();
306
+ builder.Services.AddSwaggerGen();
307
+
308
+ // Core services
309
+ builder.Services.AddScoped<IUserService, UserService>();
310
+
311
+ // Infrastructure services
312
+ builder.Services.AddDbContext<ApplicationDbContext>(options =>
313
+ options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
314
+ builder.Services.AddScoped<IUserRepository, UserRepository>();
315
+
316
+ var app = builder.Build();
317
+
318
+ // Configure pipeline
319
+ if (app.Environment.IsDevelopment())
320
+ {
321
+ app.UseSwagger();
322
+ app.UseSwaggerUI();
323
+ }
324
+
325
+ app.UseHttpsRedirection();
326
+ app.UseAuthorization();
327
+ app.MapControllers();
328
+
329
+ app.Run();
330
+ ```
331
+
332
+ ## 项目引用
333
+
334
+ ```
335
+ Api → Infrastructure → Core
336
+ Api → Shared
337
+ Infrastructure → Shared
338
+ Core → Shared (optional)
339
+ ```
340
+
341
+ | 项目 | 可引用 |
156
342
  |------|--------|
157
- | Api | Infrastructure, Core, Shared |
158
- | Infrastructure | Core, Shared |
159
- | Core | 仅 Shared(无外部相依)|
343
+ | Api | Infrastructure、Core、Shared |
344
+ | Infrastructure | Core、Shared |
345
+ | Core | 仅 Shared(无外部依赖) |
160
346
  | Shared | 无 |
161
347
 
348
+ ## 测试结构
349
+
350
+ ```csharp
351
+ // tests/SolutionName.UnitTests/Services/UserServiceTests.cs
352
+ namespace SolutionName.UnitTests.Services;
353
+
354
+ public class UserServiceTests
355
+ {
356
+ private readonly Mock<IUserRepository> _mockRepository;
357
+ private readonly UserService _sut;
358
+
359
+ public UserServiceTests()
360
+ {
361
+ _mockRepository = new Mock<IUserRepository>();
362
+ _sut = new UserService(_mockRepository.Object, Mock.Of<ILogger<UserService>>());
363
+ }
364
+
365
+ [Fact]
366
+ public async Task CreateUserAsync_WhenEmailExists_ThrowsDuplicateEmailException()
367
+ {
368
+ // Arrange
369
+ var request = new CreateUserRequest("test@example.com", "Test");
370
+ _mockRepository
371
+ .Setup(r => r.GetByEmailAsync(request.Email, It.IsAny<CancellationToken>()))
372
+ .ReturnsAsync(User.Create("test@example.com", "Existing"));
373
+
374
+ // Act & Assert
375
+ await Assert.ThrowsAsync<DuplicateEmailException>(
376
+ () => _sut.CreateUserAsync(request, CancellationToken.None));
377
+ }
378
+ }
379
+ ```
380
+
162
381
  ## 最佳实践
163
382
 
164
- 1. **相依性指向内部** - Core 无外部相依
165
- 2. **使用介面** - 在 Core 定义,在 Infrastructure 实作
166
- 3. **建构子注入** - 永远使用 DI
167
- 4. **可为空参考类型** - 启用并强制执行
168
- 5. **全程非同步** - 使用 CancellationToken
383
+ 1. **依赖向内指向** - Core 没有外部依赖
384
+ 2. **使用接口** - 在 Core 中定义,在 Infrastructure 中实现
385
+ 3. **构造函数注入** - 始终使用依赖注入(DI)
386
+ 4. **可空引用类型** - 启用并强制执行
387
+ 5. **全程异步** - 使用 CancellationToken
169
388
 
170
389
  ## 相关选项
171
390
 
172
- - [Node.js](./nodejs.md) - Node.js 专案结构
173
- - [Python](./python.md) - Python 专案结构
174
- - [Java](./java.md) - Java/Spring 专案结构
175
- - [Go](./go.md) - Go 专案结构
391
+ - [Node.js](./nodejs.md) - Node.js 项目结构
392
+ - [Python](./python.md) - Python 项目结构
393
+ - [Java](./java.md) - Java/Spring 项目结构
394
+ - [Go](./go.md) - Go 项目结构
176
395
 
177
396
  ---
178
397
 
179
- ## 授权条款
398
+ ## 许可
180
399
 
181
- 本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
400
+ 本文档以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
182
401
 
183
- **来源**:[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
402
+ **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)