universal-dev-standards 3.5.1-beta.1 → 3.5.1-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 (433) hide show
  1. package/bin/uds.js +2 -0
  2. package/bundled/core/ai-instruction-standards.md +205 -0
  3. package/bundled/core/anti-hallucination.md +684 -0
  4. package/bundled/core/changelog-standards.md +556 -0
  5. package/bundled/core/checkin-standards.md +935 -0
  6. package/bundled/core/code-review-checklist.md +684 -0
  7. package/bundled/core/commit-message-guide.md +915 -0
  8. package/bundled/core/documentation-structure.md +1117 -0
  9. package/bundled/core/documentation-writing-standards.md +487 -0
  10. package/bundled/core/error-code-standards.md +382 -0
  11. package/bundled/core/git-workflow.md +859 -0
  12. package/bundled/core/logging-standards.md +323 -0
  13. package/bundled/core/project-structure.md +354 -0
  14. package/bundled/core/refactoring-standards.md +636 -0
  15. package/bundled/core/spec-driven-development.md +207 -0
  16. package/bundled/core/test-completeness-dimensions.md +536 -0
  17. package/bundled/core/test-driven-development.md +995 -0
  18. package/bundled/core/testing-standards.md +3061 -0
  19. package/bundled/core/versioning.md +902 -0
  20. package/bundled/locales/README.md +88 -0
  21. package/bundled/locales/zh-CN/CHANGELOG.md +705 -0
  22. package/bundled/locales/zh-CN/CLAUDE.md +213 -0
  23. package/bundled/locales/zh-CN/MAINTENANCE.md +689 -0
  24. package/bundled/locales/zh-CN/README.md +707 -0
  25. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +177 -0
  26. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +392 -0
  27. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +302 -0
  28. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +332 -0
  29. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +141 -0
  30. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +272 -0
  31. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +739 -0
  32. package/bundled/locales/zh-CN/ai/options/changelog/auto-generated.ai.yaml +76 -0
  33. package/bundled/locales/zh-CN/ai/options/changelog/keep-a-changelog.ai.yaml +99 -0
  34. package/bundled/locales/zh-CN/ai/options/code-review/automated-review.ai.yaml +120 -0
  35. package/bundled/locales/zh-CN/ai/options/code-review/pair-programming.ai.yaml +109 -0
  36. package/bundled/locales/zh-CN/ai/options/code-review/pr-review.ai.yaml +104 -0
  37. package/bundled/locales/zh-CN/ai/options/commit-message/bilingual.ai.yaml +105 -0
  38. package/bundled/locales/zh-CN/ai/options/commit-message/english.ai.yaml +79 -0
  39. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +100 -0
  40. package/bundled/locales/zh-CN/ai/options/documentation/api-docs.ai.yaml +140 -0
  41. package/bundled/locales/zh-CN/ai/options/documentation/markdown-docs.ai.yaml +89 -0
  42. package/bundled/locales/zh-CN/ai/options/documentation/wiki-style.ai.yaml +119 -0
  43. package/bundled/locales/zh-CN/ai/options/git-workflow/gitflow.ai.yaml +133 -0
  44. package/bundled/locales/zh-CN/ai/options/git-workflow/github-flow.ai.yaml +73 -0
  45. package/bundled/locales/zh-CN/ai/options/git-workflow/merge-commit.ai.yaml +88 -0
  46. package/bundled/locales/zh-CN/ai/options/git-workflow/rebase-ff.ai.yaml +113 -0
  47. package/bundled/locales/zh-CN/ai/options/git-workflow/squash-merge.ai.yaml +85 -0
  48. package/bundled/locales/zh-CN/ai/options/git-workflow/trunk-based.ai.yaml +117 -0
  49. package/bundled/locales/zh-CN/ai/options/project-structure/dotnet.ai.yaml +108 -0
  50. package/bundled/locales/zh-CN/ai/options/project-structure/go.ai.yaml +115 -0
  51. package/bundled/locales/zh-CN/ai/options/project-structure/java.ai.yaml +113 -0
  52. package/bundled/locales/zh-CN/ai/options/project-structure/kotlin.ai.yaml +123 -0
  53. package/bundled/locales/zh-CN/ai/options/project-structure/nodejs.ai.yaml +101 -0
  54. package/bundled/locales/zh-CN/ai/options/project-structure/php.ai.yaml +147 -0
  55. package/bundled/locales/zh-CN/ai/options/project-structure/python.ai.yaml +116 -0
  56. package/bundled/locales/zh-CN/ai/options/project-structure/ruby.ai.yaml +140 -0
  57. package/bundled/locales/zh-CN/ai/options/project-structure/rust.ai.yaml +117 -0
  58. package/bundled/locales/zh-CN/ai/options/project-structure/swift.ai.yaml +143 -0
  59. package/bundled/locales/zh-CN/ai/options/testing/contract-testing.ai.yaml +254 -0
  60. package/bundled/locales/zh-CN/ai/options/testing/e2e-testing.ai.yaml +116 -0
  61. package/bundled/locales/zh-CN/ai/options/testing/industry-pyramid.ai.yaml +144 -0
  62. package/bundled/locales/zh-CN/ai/options/testing/integration-testing.ai.yaml +90 -0
  63. package/bundled/locales/zh-CN/ai/options/testing/istqb-framework.ai.yaml +108 -0
  64. package/bundled/locales/zh-CN/ai/options/testing/performance-testing.ai.yaml +272 -0
  65. package/bundled/locales/zh-CN/ai/options/testing/security-testing.ai.yaml +160 -0
  66. package/bundled/locales/zh-CN/ai/options/testing/system-testing.ai.yaml +101 -0
  67. package/bundled/locales/zh-CN/ai/options/testing/unit-testing.ai.yaml +82 -0
  68. package/bundled/locales/zh-CN/ai/standards/anti-hallucination.ai.yaml +145 -0
  69. package/bundled/locales/zh-CN/ai/standards/changelog.ai.yaml +146 -0
  70. package/bundled/locales/zh-CN/ai/standards/checkin-standards.ai.yaml +170 -0
  71. package/bundled/locales/zh-CN/ai/standards/code-review.ai.yaml +148 -0
  72. package/bundled/locales/zh-CN/ai/standards/commit-message.ai.yaml +175 -0
  73. package/bundled/locales/zh-CN/ai/standards/documentation-structure.ai.yaml +124 -0
  74. package/bundled/locales/zh-CN/ai/standards/documentation-writing-standards.ai.yaml +190 -0
  75. package/bundled/locales/zh-CN/ai/standards/error-codes.ai.yaml +139 -0
  76. package/bundled/locales/zh-CN/ai/standards/git-workflow.ai.yaml +95 -0
  77. package/bundled/locales/zh-CN/ai/standards/logging.ai.yaml +128 -0
  78. package/bundled/locales/zh-CN/ai/standards/project-structure.ai.yaml +134 -0
  79. package/bundled/locales/zh-CN/ai/standards/spec-driven-development.ai.yaml +169 -0
  80. package/bundled/locales/zh-CN/ai/standards/test-completeness-dimensions.ai.yaml +220 -0
  81. package/bundled/locales/zh-CN/ai/standards/testing.ai.yaml +137 -0
  82. package/bundled/locales/zh-CN/ai/standards/versioning.ai.yaml +211 -0
  83. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +213 -0
  84. package/bundled/locales/zh-CN/core/anti-hallucination.md +691 -0
  85. package/bundled/locales/zh-CN/core/changelog-standards.md +147 -0
  86. package/bundled/locales/zh-CN/core/checkin-standards.md +943 -0
  87. package/bundled/locales/zh-CN/core/code-review-guide.md +693 -0
  88. package/bundled/locales/zh-CN/core/commit-message-guide.md +129 -0
  89. package/bundled/locales/zh-CN/core/documentation-structure.md +173 -0
  90. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +495 -0
  91. package/bundled/locales/zh-CN/core/error-code-standards.md +180 -0
  92. package/bundled/locales/zh-CN/core/git-workflow.md +193 -0
  93. package/bundled/locales/zh-CN/core/logging-standards.md +174 -0
  94. package/bundled/locales/zh-CN/core/project-structure.md +184 -0
  95. package/bundled/locales/zh-CN/core/refactoring-standards.md +642 -0
  96. package/bundled/locales/zh-CN/core/spec-driven-development.md +215 -0
  97. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +544 -0
  98. package/bundled/locales/zh-CN/core/test-driven-development.md +1002 -0
  99. package/bundled/locales/zh-CN/core/testing-standards.md +170 -0
  100. package/bundled/locales/zh-CN/core/versioning.md +177 -0
  101. package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +303 -0
  102. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +990 -0
  103. package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +1064 -0
  104. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +333 -0
  105. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +215 -0
  106. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +115 -0
  107. package/bundled/locales/zh-CN/integrations/codex/README.md +67 -0
  108. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +102 -0
  109. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +140 -0
  110. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +269 -0
  111. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +167 -0
  112. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +263 -0
  113. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +192 -0
  114. package/bundled/locales/zh-CN/integrations/google-antigravity/INSTRUCTIONS.md +61 -0
  115. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +84 -0
  116. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +111 -0
  117. package/bundled/locales/zh-CN/integrations/opencode/README.md +176 -0
  118. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +396 -0
  119. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +301 -0
  120. package/bundled/locales/zh-CN/integrations/openspec/README.md +43 -0
  121. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +184 -0
  122. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +43 -0
  123. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +161 -0
  124. package/bundled/locales/zh-CN/options/commit-message/english.md +137 -0
  125. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +162 -0
  126. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +147 -0
  127. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +124 -0
  128. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +124 -0
  129. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +160 -0
  130. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +117 -0
  131. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +125 -0
  132. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +183 -0
  133. package/bundled/locales/zh-CN/options/project-structure/go.md +226 -0
  134. package/bundled/locales/zh-CN/options/project-structure/java.md +213 -0
  135. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +185 -0
  136. package/bundled/locales/zh-CN/options/project-structure/python.md +229 -0
  137. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +207 -0
  138. package/bundled/locales/zh-CN/options/testing/integration-testing.md +230 -0
  139. package/bundled/locales/zh-CN/options/testing/system-testing.md +183 -0
  140. package/bundled/locales/zh-CN/options/testing/unit-testing.md +165 -0
  141. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +218 -0
  142. package/bundled/locales/zh-CN/skills/README.md +134 -0
  143. package/bundled/locales/zh-CN/skills/_shared/README.md +68 -0
  144. package/bundled/locales/zh-CN/skills/claude-code/CONTRIBUTING.template.md +151 -0
  145. package/bundled/locales/zh-CN/skills/claude-code/README.md +174 -0
  146. package/bundled/locales/zh-CN/skills/claude-code/ai-collaboration-standards/SKILL.md +175 -0
  147. package/bundled/locales/zh-CN/skills/claude-code/ai-collaboration-standards/anti-hallucination.md +223 -0
  148. package/bundled/locales/zh-CN/skills/claude-code/ai-collaboration-standards/certainty-labels.md +132 -0
  149. package/bundled/locales/zh-CN/skills/claude-code/changelog-guide/SKILL.md +237 -0
  150. package/bundled/locales/zh-CN/skills/claude-code/checkin-assistant/SKILL.md +407 -0
  151. package/bundled/locales/zh-CN/skills/claude-code/code-review-assistant/SKILL.md +154 -0
  152. package/bundled/locales/zh-CN/skills/claude-code/code-review-assistant/checkin-checklist.md +257 -0
  153. package/bundled/locales/zh-CN/skills/claude-code/code-review-assistant/review-checklist.md +246 -0
  154. package/bundled/locales/zh-CN/skills/claude-code/commands/bdd.md +142 -0
  155. package/bundled/locales/zh-CN/skills/claude-code/commands/methodology.md +274 -0
  156. package/bundled/locales/zh-CN/skills/claude-code/commit-standards/SKILL.md +191 -0
  157. package/bundled/locales/zh-CN/skills/claude-code/commit-standards/conventional-commits.md +264 -0
  158. package/bundled/locales/zh-CN/skills/claude-code/commit-standards/language-options.md +172 -0
  159. package/bundled/locales/zh-CN/skills/claude-code/documentation-guide/SKILL.md +421 -0
  160. package/bundled/locales/zh-CN/skills/claude-code/documentation-guide/documentation-structure.md +357 -0
  161. package/bundled/locales/zh-CN/skills/claude-code/documentation-guide/readme-template.md +412 -0
  162. package/bundled/locales/zh-CN/skills/claude-code/error-code-guide/SKILL.md +269 -0
  163. package/bundled/locales/zh-CN/skills/claude-code/git-workflow-guide/SKILL.md +218 -0
  164. package/bundled/locales/zh-CN/skills/claude-code/git-workflow-guide/branch-naming.md +220 -0
  165. package/bundled/locales/zh-CN/skills/claude-code/git-workflow-guide/git-workflow.md +321 -0
  166. package/bundled/locales/zh-CN/skills/claude-code/logging-guide/SKILL.md +285 -0
  167. package/bundled/locales/zh-CN/skills/claude-code/methodology-system/SKILL.md +131 -0
  168. package/bundled/locales/zh-CN/skills/claude-code/methodology-system/create-methodology.md +350 -0
  169. package/bundled/locales/zh-CN/skills/claude-code/methodology-system/runtime.md +279 -0
  170. package/bundled/locales/zh-CN/skills/claude-code/project-structure-guide/SKILL.md +143 -0
  171. package/bundled/locales/zh-CN/skills/claude-code/project-structure-guide/language-patterns.md +271 -0
  172. package/bundled/locales/zh-CN/skills/claude-code/refactoring-assistant/SKILL.md +162 -0
  173. package/bundled/locales/zh-CN/skills/claude-code/release-standards/SKILL.md +191 -0
  174. package/bundled/locales/zh-CN/skills/claude-code/release-standards/changelog-format.md +247 -0
  175. package/bundled/locales/zh-CN/skills/claude-code/release-standards/release-workflow.md +345 -0
  176. package/bundled/locales/zh-CN/skills/claude-code/release-standards/semantic-versioning.md +250 -0
  177. package/bundled/locales/zh-CN/skills/claude-code/requirement-assistant/SKILL.md +227 -0
  178. package/bundled/locales/zh-CN/skills/claude-code/requirement-assistant/requirement-checklist.md +325 -0
  179. package/bundled/locales/zh-CN/skills/claude-code/requirement-assistant/requirement-writing.md +399 -0
  180. package/bundled/locales/zh-CN/skills/claude-code/spec-driven-dev/SKILL.md +243 -0
  181. package/bundled/locales/zh-CN/skills/claude-code/tdd-assistant/SKILL.md +332 -0
  182. package/bundled/locales/zh-CN/skills/claude-code/tdd-assistant/language-examples.md +639 -0
  183. package/bundled/locales/zh-CN/skills/claude-code/tdd-assistant/tdd-workflow.md +486 -0
  184. package/bundled/locales/zh-CN/skills/claude-code/test-coverage-assistant/SKILL.md +282 -0
  185. package/bundled/locales/zh-CN/skills/claude-code/testing-guide/SKILL.md +234 -0
  186. package/bundled/locales/zh-CN/skills/claude-code/testing-guide/testing-pyramid.md +448 -0
  187. package/bundled/locales/zh-CN/skills/cline/README.md +58 -0
  188. package/bundled/locales/zh-CN/skills/copilot/README.md +61 -0
  189. package/bundled/locales/zh-CN/skills/copilot/copilot-instructions.md +79 -0
  190. package/bundled/locales/zh-CN/skills/cursor/README.md +58 -0
  191. package/bundled/locales/zh-CN/skills/windsurf/README.md +59 -0
  192. package/bundled/locales/zh-TW/CHANGELOG.md +707 -0
  193. package/bundled/locales/zh-TW/CLAUDE.md +213 -0
  194. package/bundled/locales/zh-TW/MAINTENANCE.md +683 -0
  195. package/bundled/locales/zh-TW/README.md +687 -0
  196. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +177 -0
  197. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +392 -0
  198. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +299 -0
  199. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +332 -0
  200. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +141 -0
  201. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +272 -0
  202. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +754 -0
  203. package/bundled/locales/zh-TW/ai/options/changelog/auto-generated.ai.yaml +76 -0
  204. package/bundled/locales/zh-TW/ai/options/changelog/keep-a-changelog.ai.yaml +99 -0
  205. package/bundled/locales/zh-TW/ai/options/code-review/automated-review.ai.yaml +120 -0
  206. package/bundled/locales/zh-TW/ai/options/code-review/pair-programming.ai.yaml +109 -0
  207. package/bundled/locales/zh-TW/ai/options/code-review/pr-review.ai.yaml +104 -0
  208. package/bundled/locales/zh-TW/ai/options/commit-message/bilingual.ai.yaml +105 -0
  209. package/bundled/locales/zh-TW/ai/options/commit-message/english.ai.yaml +79 -0
  210. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +100 -0
  211. package/bundled/locales/zh-TW/ai/options/documentation/api-docs.ai.yaml +140 -0
  212. package/bundled/locales/zh-TW/ai/options/documentation/markdown-docs.ai.yaml +89 -0
  213. package/bundled/locales/zh-TW/ai/options/documentation/wiki-style.ai.yaml +119 -0
  214. package/bundled/locales/zh-TW/ai/options/git-workflow/gitflow.ai.yaml +133 -0
  215. package/bundled/locales/zh-TW/ai/options/git-workflow/github-flow.ai.yaml +73 -0
  216. package/bundled/locales/zh-TW/ai/options/git-workflow/merge-commit.ai.yaml +88 -0
  217. package/bundled/locales/zh-TW/ai/options/git-workflow/rebase-ff.ai.yaml +113 -0
  218. package/bundled/locales/zh-TW/ai/options/git-workflow/squash-merge.ai.yaml +85 -0
  219. package/bundled/locales/zh-TW/ai/options/git-workflow/trunk-based.ai.yaml +117 -0
  220. package/bundled/locales/zh-TW/ai/options/project-structure/dotnet.ai.yaml +108 -0
  221. package/bundled/locales/zh-TW/ai/options/project-structure/go.ai.yaml +115 -0
  222. package/bundled/locales/zh-TW/ai/options/project-structure/java.ai.yaml +113 -0
  223. package/bundled/locales/zh-TW/ai/options/project-structure/kotlin.ai.yaml +123 -0
  224. package/bundled/locales/zh-TW/ai/options/project-structure/nodejs.ai.yaml +101 -0
  225. package/bundled/locales/zh-TW/ai/options/project-structure/php.ai.yaml +147 -0
  226. package/bundled/locales/zh-TW/ai/options/project-structure/python.ai.yaml +116 -0
  227. package/bundled/locales/zh-TW/ai/options/project-structure/ruby.ai.yaml +140 -0
  228. package/bundled/locales/zh-TW/ai/options/project-structure/rust.ai.yaml +117 -0
  229. package/bundled/locales/zh-TW/ai/options/project-structure/swift.ai.yaml +143 -0
  230. package/bundled/locales/zh-TW/ai/options/testing/contract-testing.ai.yaml +254 -0
  231. package/bundled/locales/zh-TW/ai/options/testing/e2e-testing.ai.yaml +116 -0
  232. package/bundled/locales/zh-TW/ai/options/testing/industry-pyramid.ai.yaml +144 -0
  233. package/bundled/locales/zh-TW/ai/options/testing/integration-testing.ai.yaml +90 -0
  234. package/bundled/locales/zh-TW/ai/options/testing/istqb-framework.ai.yaml +108 -0
  235. package/bundled/locales/zh-TW/ai/options/testing/performance-testing.ai.yaml +272 -0
  236. package/bundled/locales/zh-TW/ai/options/testing/security-testing.ai.yaml +160 -0
  237. package/bundled/locales/zh-TW/ai/options/testing/system-testing.ai.yaml +101 -0
  238. package/bundled/locales/zh-TW/ai/options/testing/unit-testing.ai.yaml +82 -0
  239. package/bundled/locales/zh-TW/ai/standards/anti-hallucination.ai.yaml +145 -0
  240. package/bundled/locales/zh-TW/ai/standards/changelog.ai.yaml +146 -0
  241. package/bundled/locales/zh-TW/ai/standards/checkin-standards.ai.yaml +170 -0
  242. package/bundled/locales/zh-TW/ai/standards/code-review.ai.yaml +148 -0
  243. package/bundled/locales/zh-TW/ai/standards/commit-message.ai.yaml +175 -0
  244. package/bundled/locales/zh-TW/ai/standards/documentation-structure.ai.yaml +124 -0
  245. package/bundled/locales/zh-TW/ai/standards/documentation-writing-standards.ai.yaml +190 -0
  246. package/bundled/locales/zh-TW/ai/standards/error-codes.ai.yaml +139 -0
  247. package/bundled/locales/zh-TW/ai/standards/git-workflow.ai.yaml +95 -0
  248. package/bundled/locales/zh-TW/ai/standards/logging.ai.yaml +128 -0
  249. package/bundled/locales/zh-TW/ai/standards/project-structure.ai.yaml +134 -0
  250. package/bundled/locales/zh-TW/ai/standards/spec-driven-development.ai.yaml +169 -0
  251. package/bundled/locales/zh-TW/ai/standards/test-completeness-dimensions.ai.yaml +220 -0
  252. package/bundled/locales/zh-TW/ai/standards/testing.ai.yaml +137 -0
  253. package/bundled/locales/zh-TW/ai/standards/versioning.ai.yaml +211 -0
  254. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +213 -0
  255. package/bundled/locales/zh-TW/core/anti-hallucination.md +691 -0
  256. package/bundled/locales/zh-TW/core/changelog-standards.md +564 -0
  257. package/bundled/locales/zh-TW/core/checkin-standards.md +943 -0
  258. package/bundled/locales/zh-TW/core/code-review-checklist.md +693 -0
  259. package/bundled/locales/zh-TW/core/commit-message-guide.md +809 -0
  260. package/bundled/locales/zh-TW/core/documentation-structure.md +1125 -0
  261. package/bundled/locales/zh-TW/core/documentation-writing-standards.md +495 -0
  262. package/bundled/locales/zh-TW/core/error-code-standards.md +384 -0
  263. package/bundled/locales/zh-TW/core/git-workflow.md +860 -0
  264. package/bundled/locales/zh-TW/core/logging-standards.md +325 -0
  265. package/bundled/locales/zh-TW/core/project-structure.md +362 -0
  266. package/bundled/locales/zh-TW/core/refactoring-standards.md +642 -0
  267. package/bundled/locales/zh-TW/core/spec-driven-development.md +215 -0
  268. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +544 -0
  269. package/bundled/locales/zh-TW/core/test-driven-development.md +1004 -0
  270. package/bundled/locales/zh-TW/core/testing-standards.md +2158 -0
  271. package/bundled/locales/zh-TW/core/versioning.md +909 -0
  272. package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +303 -0
  273. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +990 -0
  274. package/bundled/locales/zh-TW/docs/OPERATION-WORKFLOW.md +1064 -0
  275. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +333 -0
  276. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +215 -0
  277. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +115 -0
  278. package/bundled/locales/zh-TW/integrations/codex/README.md +113 -0
  279. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +102 -0
  280. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +140 -0
  281. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +269 -0
  282. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +167 -0
  283. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +263 -0
  284. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +192 -0
  285. package/bundled/locales/zh-TW/integrations/google-antigravity/INSTRUCTIONS.md +61 -0
  286. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +84 -0
  287. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +111 -0
  288. package/bundled/locales/zh-TW/integrations/opencode/README.md +176 -0
  289. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +396 -0
  290. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +301 -0
  291. package/bundled/locales/zh-TW/integrations/openspec/README.md +43 -0
  292. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +184 -0
  293. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +43 -0
  294. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +161 -0
  295. package/bundled/locales/zh-TW/options/commit-message/english.md +137 -0
  296. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +162 -0
  297. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +147 -0
  298. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +124 -0
  299. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +124 -0
  300. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +160 -0
  301. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +117 -0
  302. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +125 -0
  303. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +183 -0
  304. package/bundled/locales/zh-TW/options/project-structure/go.md +226 -0
  305. package/bundled/locales/zh-TW/options/project-structure/java.md +213 -0
  306. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +185 -0
  307. package/bundled/locales/zh-TW/options/project-structure/python.md +229 -0
  308. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +207 -0
  309. package/bundled/locales/zh-TW/options/testing/integration-testing.md +230 -0
  310. package/bundled/locales/zh-TW/options/testing/system-testing.md +183 -0
  311. package/bundled/locales/zh-TW/options/testing/unit-testing.md +165 -0
  312. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +218 -0
  313. package/bundled/locales/zh-TW/skills/README.md +132 -0
  314. package/bundled/locales/zh-TW/skills/_shared/README.md +68 -0
  315. package/bundled/locales/zh-TW/skills/claude-code/CONTRIBUTING.template.md +151 -0
  316. package/bundled/locales/zh-TW/skills/claude-code/README.md +174 -0
  317. package/bundled/locales/zh-TW/skills/claude-code/ai-collaboration-standards/SKILL.md +175 -0
  318. package/bundled/locales/zh-TW/skills/claude-code/ai-collaboration-standards/anti-hallucination.md +223 -0
  319. package/bundled/locales/zh-TW/skills/claude-code/ai-collaboration-standards/certainty-labels.md +132 -0
  320. package/bundled/locales/zh-TW/skills/claude-code/changelog-guide/SKILL.md +237 -0
  321. package/bundled/locales/zh-TW/skills/claude-code/checkin-assistant/SKILL.md +407 -0
  322. package/bundled/locales/zh-TW/skills/claude-code/code-review-assistant/SKILL.md +154 -0
  323. package/bundled/locales/zh-TW/skills/claude-code/code-review-assistant/checkin-checklist.md +257 -0
  324. package/bundled/locales/zh-TW/skills/claude-code/code-review-assistant/review-checklist.md +246 -0
  325. package/bundled/locales/zh-TW/skills/claude-code/commands/bdd.md +142 -0
  326. package/bundled/locales/zh-TW/skills/claude-code/commands/methodology.md +274 -0
  327. package/bundled/locales/zh-TW/skills/claude-code/commit-standards/SKILL.md +191 -0
  328. package/bundled/locales/zh-TW/skills/claude-code/commit-standards/conventional-commits.md +264 -0
  329. package/bundled/locales/zh-TW/skills/claude-code/commit-standards/language-options.md +172 -0
  330. package/bundled/locales/zh-TW/skills/claude-code/documentation-guide/SKILL.md +421 -0
  331. package/bundled/locales/zh-TW/skills/claude-code/documentation-guide/documentation-structure.md +357 -0
  332. package/bundled/locales/zh-TW/skills/claude-code/documentation-guide/readme-template.md +412 -0
  333. package/bundled/locales/zh-TW/skills/claude-code/error-code-guide/SKILL.md +269 -0
  334. package/bundled/locales/zh-TW/skills/claude-code/git-workflow-guide/SKILL.md +218 -0
  335. package/bundled/locales/zh-TW/skills/claude-code/git-workflow-guide/branch-naming.md +220 -0
  336. package/bundled/locales/zh-TW/skills/claude-code/git-workflow-guide/git-workflow.md +321 -0
  337. package/bundled/locales/zh-TW/skills/claude-code/logging-guide/SKILL.md +285 -0
  338. package/bundled/locales/zh-TW/skills/claude-code/methodology-system/SKILL.md +131 -0
  339. package/bundled/locales/zh-TW/skills/claude-code/methodology-system/create-methodology.md +350 -0
  340. package/bundled/locales/zh-TW/skills/claude-code/methodology-system/runtime.md +279 -0
  341. package/bundled/locales/zh-TW/skills/claude-code/project-structure-guide/SKILL.md +143 -0
  342. package/bundled/locales/zh-TW/skills/claude-code/project-structure-guide/language-patterns.md +271 -0
  343. package/bundled/locales/zh-TW/skills/claude-code/refactoring-assistant/SKILL.md +162 -0
  344. package/bundled/locales/zh-TW/skills/claude-code/release-standards/SKILL.md +191 -0
  345. package/bundled/locales/zh-TW/skills/claude-code/release-standards/changelog-format.md +247 -0
  346. package/bundled/locales/zh-TW/skills/claude-code/release-standards/release-workflow.md +345 -0
  347. package/bundled/locales/zh-TW/skills/claude-code/release-standards/semantic-versioning.md +250 -0
  348. package/bundled/locales/zh-TW/skills/claude-code/requirement-assistant/SKILL.md +227 -0
  349. package/bundled/locales/zh-TW/skills/claude-code/requirement-assistant/requirement-checklist.md +325 -0
  350. package/bundled/locales/zh-TW/skills/claude-code/requirement-assistant/requirement-writing.md +399 -0
  351. package/bundled/locales/zh-TW/skills/claude-code/spec-driven-dev/SKILL.md +243 -0
  352. package/bundled/locales/zh-TW/skills/claude-code/tdd-assistant/SKILL.md +332 -0
  353. package/bundled/locales/zh-TW/skills/claude-code/tdd-assistant/language-examples.md +639 -0
  354. package/bundled/locales/zh-TW/skills/claude-code/tdd-assistant/tdd-workflow.md +486 -0
  355. package/bundled/locales/zh-TW/skills/claude-code/test-coverage-assistant/SKILL.md +282 -0
  356. package/bundled/locales/zh-TW/skills/claude-code/testing-guide/SKILL.md +234 -0
  357. package/bundled/locales/zh-TW/skills/claude-code/testing-guide/testing-pyramid.md +448 -0
  358. package/bundled/locales/zh-TW/skills/cline/README.md +58 -0
  359. package/bundled/locales/zh-TW/skills/copilot/README.md +61 -0
  360. package/bundled/locales/zh-TW/skills/copilot/copilot-instructions.md +79 -0
  361. package/bundled/locales/zh-TW/skills/cursor/README.md +58 -0
  362. package/bundled/locales/zh-TW/skills/windsurf/README.md +59 -0
  363. package/bundled/skills/claude-code/CONTRIBUTING.template.md +141 -0
  364. package/bundled/skills/claude-code/README.md +196 -0
  365. package/bundled/skills/claude-code/ai/standards/checkin.ai.yaml +21 -0
  366. package/bundled/skills/claude-code/ai/standards/commit.ai.yaml +20 -0
  367. package/bundled/skills/claude-code/ai/standards/refactoring.ai.yaml +34 -0
  368. package/bundled/skills/claude-code/ai/standards/testing.ai.yaml +41 -0
  369. package/bundled/skills/claude-code/ai-collaboration-standards/SKILL.md +175 -0
  370. package/bundled/skills/claude-code/ai-collaboration-standards/anti-hallucination.md +215 -0
  371. package/bundled/skills/claude-code/ai-collaboration-standards/certainty-labels.md +124 -0
  372. package/bundled/skills/claude-code/changelog-guide/SKILL.md +232 -0
  373. package/bundled/skills/claude-code/checkin-assistant/SKILL.md +402 -0
  374. package/bundled/skills/claude-code/code-review-assistant/SKILL.md +220 -0
  375. package/bundled/skills/claude-code/code-review-assistant/checkin-checklist.md +249 -0
  376. package/bundled/skills/claude-code/code-review-assistant/review-checklist.md +238 -0
  377. package/bundled/skills/claude-code/commands/README.md +78 -0
  378. package/bundled/skills/claude-code/commands/bdd.md +142 -0
  379. package/bundled/skills/claude-code/commands/changelog.md +57 -0
  380. package/bundled/skills/claude-code/commands/check.md +91 -0
  381. package/bundled/skills/claude-code/commands/commit.md +48 -0
  382. package/bundled/skills/claude-code/commands/config.md +97 -0
  383. package/bundled/skills/claude-code/commands/coverage.md +58 -0
  384. package/bundled/skills/claude-code/commands/docs.md +75 -0
  385. package/bundled/skills/claude-code/commands/init.md +88 -0
  386. package/bundled/skills/claude-code/commands/methodology.md +268 -0
  387. package/bundled/skills/claude-code/commands/release.md +50 -0
  388. package/bundled/skills/claude-code/commands/requirement.md +54 -0
  389. package/bundled/skills/claude-code/commands/review.md +50 -0
  390. package/bundled/skills/claude-code/commands/spec.md +69 -0
  391. package/bundled/skills/claude-code/commands/tdd.md +86 -0
  392. package/bundled/skills/claude-code/commands/update.md +122 -0
  393. package/bundled/skills/claude-code/commit-standards/SKILL.md +249 -0
  394. package/bundled/skills/claude-code/commit-standards/conventional-commits.md +256 -0
  395. package/bundled/skills/claude-code/commit-standards/language-options.md +164 -0
  396. package/bundled/skills/claude-code/documentation-guide/SKILL.md +416 -0
  397. package/bundled/skills/claude-code/documentation-guide/documentation-structure.md +349 -0
  398. package/bundled/skills/claude-code/documentation-guide/readme-template.md +404 -0
  399. package/bundled/skills/claude-code/error-code-guide/SKILL.md +264 -0
  400. package/bundled/skills/claude-code/git-workflow-guide/SKILL.md +226 -0
  401. package/bundled/skills/claude-code/git-workflow-guide/branch-naming.md +212 -0
  402. package/bundled/skills/claude-code/git-workflow-guide/git-workflow.md +313 -0
  403. package/bundled/skills/claude-code/logging-guide/SKILL.md +280 -0
  404. package/bundled/skills/claude-code/methodology-system/SKILL.md +215 -0
  405. package/bundled/skills/claude-code/methodology-system/create-methodology.md +450 -0
  406. package/bundled/skills/claude-code/methodology-system/runtime.md +271 -0
  407. package/bundled/skills/claude-code/project-structure-guide/SKILL.md +143 -0
  408. package/bundled/skills/claude-code/project-structure-guide/language-patterns.md +263 -0
  409. package/bundled/skills/claude-code/refactoring-assistant/SKILL.md +205 -0
  410. package/bundled/skills/claude-code/release-standards/SKILL.md +191 -0
  411. package/bundled/skills/claude-code/release-standards/changelog-format.md +239 -0
  412. package/bundled/skills/claude-code/release-standards/release-workflow.md +337 -0
  413. package/bundled/skills/claude-code/release-standards/semantic-versioning.md +242 -0
  414. package/bundled/skills/claude-code/requirement-assistant/SKILL.md +222 -0
  415. package/bundled/skills/claude-code/requirement-assistant/requirement-checklist.md +317 -0
  416. package/bundled/skills/claude-code/requirement-assistant/requirement-writing.md +391 -0
  417. package/bundled/skills/claude-code/spec-driven-dev/SKILL.md +238 -0
  418. package/bundled/skills/claude-code/tdd-assistant/SKILL.md +384 -0
  419. package/bundled/skills/claude-code/tdd-assistant/language-examples.md +1276 -0
  420. package/bundled/skills/claude-code/tdd-assistant/tdd-workflow.md +659 -0
  421. package/bundled/skills/claude-code/test-coverage-assistant/SKILL.md +277 -0
  422. package/bundled/skills/claude-code/testing-guide/SKILL.md +317 -0
  423. package/bundled/skills/claude-code/testing-guide/testing-pyramid.md +440 -0
  424. package/package.json +4 -2
  425. package/src/commands/check.js +38 -6
  426. package/src/commands/init.js +20 -6
  427. package/src/commands/list.js +7 -2
  428. package/src/commands/skills.js +0 -2
  429. package/src/commands/update.js +271 -0
  430. package/src/i18n/messages.js +161 -11
  431. package/src/utils/copier.js +63 -10
  432. package/src/utils/skills-installer.js +47 -11
  433. package/standards-registry.json +6 -3
@@ -0,0 +1,739 @@
1
+ ---
2
+ source: ../../../ai/MAINTENANCE.md
3
+ source_version: 1.0.0
4
+ translation_version: 1.0.0
5
+ last_synced: 2026-01-08
6
+ status: current
7
+ ---
8
+
9
+ # AI 标准维护指南
10
+
11
+ > **Language**: [English](../../../ai/MAINTENANCE.md) | 繁体中文
12
+
13
+ **版本**: 1.0.0
14
+ **最后更新**: 2025-12-30
15
+
16
+ ---
17
+
18
+ ## 目的
19
+
20
+ 本文件定义 AI 优化标准(`.ai.yaml` 档案)的维护工作流程,确保来源文件与其 AI 优化版本之间的一致性。
21
+
22
+ ---
23
+
24
+ ## 架构概览
25
+
26
+ ```
27
+ core/ ← 一级来源(人类可读 Markdown)
28
+ ├── anti-hallucination.md
29
+ ├── changelog-standards.md
30
+ ├── checkin-standards.md
31
+ ├── ...
32
+ └── versioning.md
33
+
34
+ ai/ ← AI 优化版(机器可读 YAML)
35
+ ├── standards/ ← Core 标准 → AI 格式
36
+ │ ├── anti-hallucination.ai.yaml
37
+ │ ├── changelog.ai.yaml
38
+ │ └── ...
39
+ └── options/ ← 可配置选项
40
+ ├── changelog/
41
+ ├── code-review/
42
+ ├── commit-message/
43
+ ├── documentation/
44
+ ├── git-workflow/
45
+ ├── project-structure/
46
+ └── testing/
47
+
48
+ locales/zh-TW/ ← 繁体中文翻译
49
+ ├── core/ ← 翻译的 Markdown
50
+ └── ai/
51
+ ├── standards/ ← 翻译的 AI 标准
52
+ └── options/ ← 翻译的选项
53
+ ```
54
+
55
+ ---
56
+
57
+ ## 同步层级
58
+
59
+ ```
60
+ core/*.md (Level 1 - 一级来源)
61
+
62
+ ai/standards/*.ai.yaml (Level 2 - AI 优化版)
63
+
64
+ ai/options/*/*.ai.yaml (Level 3 - 选项,如适用)
65
+
66
+ locales/zh-TW/ai/standards/ (Level 4 - 翻译)
67
+ locales/zh-TW/ai/options/
68
+ ```
69
+
70
+ **规则**:永远从上往下更新。不要在未更新来源的情况下修改下层档案。
71
+
72
+ ---
73
+
74
+ ## 何时更新
75
+
76
+ ### 触发事件
77
+
78
+ | 事件 | 所需动作 |
79
+ |------|----------|
80
+ | `core/*.md` 档案修改 | 更新对应的 `ai/standards/*.ai.yaml` |
81
+ | `ai/standards/*.ai.yaml` 引用新选项 | 建立新的 `ai/options/*/*.ai.yaml` |
82
+ | 英文 AI 档案更新 | 更新 `locales/zh-TW/ai/` 翻译 |
83
+ | 新增 `core/*.md` 档案 | 建立新的 AI 标准 + 翻译 |
84
+
85
+ ---
86
+
87
+ ## 更新工作流程
88
+
89
+ ### 步骤 1:检查目前同步状态
90
+
91
+ ```bash
92
+ # 执行翻译同步检查
93
+ ./scripts/check-translation-sync.sh zh-TW
94
+ ```
95
+
96
+ ### 步骤 2:识别 core/ 的变更
97
+
98
+ ```bash
99
+ # 检查最近变更
100
+ git log --oneline core/ -10
101
+
102
+ # 比较版本
103
+ grep -E "^\*\*Version\*\*:|^version:" core/*.md | head -20
104
+ ```
105
+
106
+ ### 步骤 3:更新 ai/standards/
107
+
108
+ 对于每个修改的 `core/*.md`:
109
+
110
+ 1. **读取来源档案** 以了解变更
111
+ 2. **更新对应的 `ai/standards/*.ai.yaml`**:
112
+ - 更新 `meta.version` 以符合来源
113
+ - 更新 `meta.updated` 为当前日期
114
+ - 同步内容变更(rules、examples、quick_reference 等)
115
+ 3. **检查是否引用新选项**:
116
+ - 如果 `options:` 区段引用不存在的档案,建立它们
117
+
118
+ ### 步骤 4:更新 ai/options/(如需要)
119
+
120
+ 当标准引用新选项时:
121
+
122
+ ```yaml
123
+ # 范例:ai/standards/testing.ai.yaml 引用新选项
124
+ options:
125
+ testing_type:
126
+ choices:
127
+ - id: new-testing-type
128
+ file: options/testing/new-testing-type.ai.yaml # ← 建立此档案
129
+ ```
130
+
131
+ 依照现有模式建立新的选项档案。
132
+
133
+ ### 步骤 5:更新翻译
134
+
135
+ 对于每个更新的英文档案:
136
+
137
+ 1. **更新 `locales/zh-TW/ai/standards/*.ai.yaml`**
138
+ 2. **更新 `locales/zh-TW/ai/options/*/*.ai.yaml`**(如适用)
139
+ 3. **确保 `meta.version` 符合英文来源**
140
+
141
+ ### 步骤 6:验证同步
142
+
143
+ ```bash
144
+ # 再次执行同步检查
145
+ ./scripts/check-translation-sync.sh zh-TW
146
+
147
+ # 预期:所有档案 [CURRENT]
148
+ ```
149
+
150
+ ---
151
+
152
+ ## 档案命名规范
153
+
154
+ ### 标准
155
+
156
+ | 来源 | AI 标准 |
157
+ |------|---------|
158
+ | `core/changelog-standards.md` | `ai/standards/changelog.ai.yaml` |
159
+ | `core/code-review-checklist.md` | `ai/standards/code-review.ai.yaml` |
160
+ | `core/commit-message-guide.md` | `ai/standards/commit-message.ai.yaml` |
161
+ | `core/anti-hallucination.md` | `ai/standards/anti-hallucination.ai.yaml` |
162
+
163
+ **模式**:移除 `-standards`、`-guide`、`-checklist` 等后缀以获得更简洁的名称。
164
+
165
+ ### 选项
166
+
167
+ ```
168
+ ai/options/{category}/{option-name}.ai.yaml
169
+ ```
170
+
171
+ 范例:
172
+ - `ai/options/testing/unit-testing.ai.yaml`
173
+ - `ai/options/git-workflow/github-flow.ai.yaml`
174
+ - `ai/options/project-structure/nodejs.ai.yaml`
175
+
176
+ ---
177
+
178
+ ## AI 标准档案结构
179
+
180
+ ```yaml
181
+ # {标准名称} - AI 优化版
182
+ # 来源: core/{source-file}.md
183
+
184
+ id: {standard-id}
185
+ meta:
186
+ version: "{x.y.z}" # 必须符合来源版本
187
+ updated: "{YYYY-MM-DD}" # 最后更新日期
188
+ source: core/{source}.md # 来源档案路径
189
+ description: {简短描述}
190
+ language: zh-CN # 翻译档案需要此栏位
191
+
192
+ # 选用:如标准有可配置选项
193
+ options:
194
+ {option_name}:
195
+ description: {描述}
196
+ multiSelect: {true|false}
197
+ choices:
198
+ - id: {choice-id}
199
+ file: options/{category}/{choice}.ai.yaml
200
+ best_for: {使用场景}
201
+
202
+ # 主要内容区段(因标准而异)
203
+ rules:
204
+ - id: {rule-id}
205
+ trigger: {何时套用}
206
+ instruction: {该做什么}
207
+ priority: {required|recommended}
208
+
209
+ # 快速参考表格
210
+ quick_reference:
211
+ {table_name}:
212
+ columns: [{col1}, {col2}, ...]
213
+ rows:
214
+ - [{val1}, {val2}, ...]
215
+ ```
216
+
217
+ ---
218
+
219
+ ## 无选项的标准
220
+
221
+ 这些标准是通用规则,不需要可配置选项:
222
+
223
+ | 标准 | 原因 |
224
+ |------|------|
225
+ | anti-hallucination | 通用 AI 行为规则 |
226
+ | checkin-standards | 通用程式码签入规则 |
227
+ | documentation-writing-standards | 通用文件撰写规则 |
228
+ | spec-driven-development | 通用 SDD 工作流程 |
229
+ | test-completeness-dimensions | 通用测试维度 |
230
+ | versioning | 通用版本控制规则 |
231
+ | error-codes | 通用错误码格式 |
232
+ | logging | 通用日志规则 |
233
+
234
+ ---
235
+
236
+ ## 有选项的标准
237
+
238
+ | 标准 | 选项类别 | 选项数量 |
239
+ |------|----------|----------|
240
+ | changelog | changelog/ | 2 |
241
+ | code-review | code-review/ | 3 |
242
+ | commit-message | commit-message/ | 3 |
243
+ | documentation-structure | documentation/ | 3 |
244
+ | git-workflow | git-workflow/ | 6 |
245
+ | project-structure | project-structure/ | 10 |
246
+ | testing | testing/ | 9 |
247
+
248
+ ---
249
+
250
+ ## 更新检查清单
251
+
252
+ ### 更新单一标准时
253
+
254
+ - [ ] 读取 `core/*.md` 来源以了解变更
255
+ - [ ] 更新 `ai/standards/*.ai.yaml` 版本和内容
256
+ - [ ] 检查是否引用新选项 → 如需要则建立
257
+ - [ ] 更新 `locales/zh-TW/ai/standards/*.ai.yaml`
258
+ - [ ] 如适用更新 `locales/zh-TW/ai/options/`
259
+ - [ ] 执行 `./scripts/check-translation-sync.sh zh-TW`
260
+ - [ ] 验证所有档案显示 `[CURRENT]`
261
+
262
+ ### 新增标准时
263
+
264
+ - [ ] 建立 `core/{new-standard}.md`
265
+ - [ ] 建立 `ai/standards/{new-standard}.ai.yaml`
266
+ - [ ] 如需要建立 `ai/options/{category}/` 档案
267
+ - [ ] 建立 `locales/zh-TW/core/{new-standard}.md`
268
+ - [ ] 建立 `locales/zh-TW/ai/standards/{new-standard}.ai.yaml`
269
+ - [ ] 如需要建立 `locales/zh-TW/ai/options/` 翻译
270
+ - [ ] 执行同步检查
271
+
272
+ ---
273
+
274
+ ## 常用命令
275
+
276
+ ### macOS / Linux
277
+
278
+ ```bash
279
+ # 检查同步状态
280
+ ./scripts/check-translation-sync.sh zh-TW
281
+
282
+ # 列出所有 AI 标准
283
+ ls ai/standards/*.yaml
284
+
285
+ # 列出所有选项
286
+ find ai/options -name "*.yaml" | sort
287
+
288
+ # 比较档案数量
289
+ echo "EN standards: $(ls ai/standards/*.yaml | wc -l)"
290
+ echo "ZH standards: $(ls locales/zh-TW/ai/standards/*.yaml | wc -l)"
291
+ echo "EN options: $(find ai/options -name '*.yaml' | wc -l)"
292
+ echo "ZH options: $(find locales/zh-TW/ai/options -name '*.yaml' | wc -l)"
293
+
294
+ # 寻找被引用但不存在的选项
295
+ grep -rh "file:.*options/" ai/standards/*.yaml | \
296
+ sed 's/.*file: //' | sort -u | \
297
+ while read f; do [ ! -f "ai/$f" ] && echo "Missing: $f"; done
298
+ ```
299
+
300
+ ### Windows PowerShell
301
+
302
+ ```powershell
303
+ # 检查同步状态
304
+ .\scripts\check-translation-sync.ps1 zh-TW
305
+
306
+ # 列出所有 AI 标准
307
+ Get-ChildItem ai\standards\*.yaml
308
+
309
+ # 列出所有选项
310
+ Get-ChildItem -Recurse ai\options -Filter "*.yaml" | Sort-Object FullName
311
+
312
+ # 比较档案数量
313
+ Write-Host "EN standards: $((Get-ChildItem ai\standards\*.yaml).Count)"
314
+ Write-Host "ZH standards: $((Get-ChildItem locales\zh-TW\ai\standards\*.yaml).Count)"
315
+ Write-Host "EN options: $((Get-ChildItem -Recurse ai\options -Filter '*.yaml').Count)"
316
+ Write-Host "ZH options: $((Get-ChildItem -Recurse locales\zh-TW\ai\options -Filter '*.yaml').Count)"
317
+ ```
318
+
319
+ ---
320
+
321
+ ## 完整同步对照表(按 Core 档案分类)
322
+
323
+ 以下是修改各 `core/*.md` 时需要更新的完整档案列表。
324
+
325
+ ---
326
+
327
+ ### 1. anti-hallucination.md
328
+
329
+ **复杂度**: 简单(无选项)
330
+
331
+ ```
332
+ core/anti-hallucination.md ← 来源
333
+ ├── locales/zh-TW/core/anti-hallucination.md
334
+ ├── ai/standards/anti-hallucination.ai.yaml
335
+ ├── locales/zh-TW/ai/standards/anti-hallucination.ai.yaml
336
+ └── skills/claude-code/ai-collaboration-standards/
337
+ ├── SKILL.md
338
+ ├── anti-hallucination.md
339
+ └── locales/zh-TW/.../
340
+ ```
341
+
342
+ **需更新档案**: ~6 个
343
+
344
+ ---
345
+
346
+ ### 2. changelog-standards.md
347
+
348
+ **复杂度**: 中等(2 个 YAML 选项)
349
+
350
+ ```
351
+ core/changelog-standards.md ← 来源
352
+ ├── locales/zh-TW/core/changelog-standards.md
353
+ ├── ai/standards/changelog.ai.yaml
354
+ ├── locales/zh-TW/ai/standards/changelog.ai.yaml
355
+ ├── ai/options/changelog/
356
+ │ ├── keep-a-changelog.ai.yaml
357
+ │ └── auto-generated.ai.yaml
358
+ ├── locales/zh-TW/ai/options/changelog/
359
+ │ ├── keep-a-changelog.ai.yaml
360
+ │ └── auto-generated.ai.yaml
361
+ └── skills/claude-code/release-standards/
362
+ ├── SKILL.md
363
+ ├── changelog-format.md
364
+ └── locales/zh-TW/.../
365
+ ```
366
+
367
+ **需更新档案**: ~12 个
368
+
369
+ ---
370
+
371
+ ### 3. checkin-standards.md
372
+
373
+ **复杂度**: 简单(无选项)
374
+
375
+ ```
376
+ core/checkin-standards.md ← 来源
377
+ ├── locales/zh-TW/core/checkin-standards.md
378
+ ├── ai/standards/checkin-standards.ai.yaml
379
+ ├── locales/zh-TW/ai/standards/checkin-standards.ai.yaml
380
+ └── skills/claude-code/commit-standards/
381
+ ├── SKILL.md
382
+ └── locales/zh-TW/.../
383
+ ```
384
+
385
+ **需更新档案**: ~6 个
386
+
387
+ ---
388
+
389
+ ### 4. code-review-checklist.md
390
+
391
+ **复杂度**: 中等(3 个 YAML 选项)
392
+
393
+ ```
394
+ core/code-review-checklist.md ← 来源
395
+ ├── locales/zh-TW/core/code-review-checklist.md
396
+ ├── ai/standards/code-review.ai.yaml
397
+ ├── locales/zh-TW/ai/standards/code-review.ai.yaml
398
+ ├── ai/options/code-review/
399
+ │ ├── pr-review.ai.yaml
400
+ │ ├── pair-programming.ai.yaml
401
+ │ └── automated-review.ai.yaml
402
+ ├── locales/zh-TW/ai/options/code-review/
403
+ │ ├── pr-review.ai.yaml
404
+ │ ├── pair-programming.ai.yaml
405
+ │ └── automated-review.ai.yaml
406
+ └── skills/claude-code/code-review-assistant/
407
+ ├── SKILL.md
408
+ └── locales/zh-TW/.../
409
+ ```
410
+
411
+ **需更新档案**: ~14 个
412
+
413
+ ---
414
+
415
+ ### 5. commit-message-guide.md
416
+
417
+ **复杂度**: 高(3 个 MD 选项 + 3 个 YAML 选项)
418
+
419
+ ```
420
+ core/commit-message-guide.md ← 来源
421
+ ├── locales/zh-TW/core/commit-message-guide.md
422
+ ├── ai/standards/commit-message.ai.yaml
423
+ ├── locales/zh-TW/ai/standards/commit-message.ai.yaml
424
+ ├── options/commit-message/
425
+ │ ├── english.md
426
+ │ ├── traditional-chinese.md
427
+ │ └── bilingual.md
428
+ ├── locales/zh-TW/options/commit-message/
429
+ │ ├── english.md
430
+ │ ├── traditional-chinese.md
431
+ │ └── bilingual.md
432
+ ├── ai/options/commit-message/
433
+ │ ├── english.ai.yaml
434
+ │ ├── traditional-chinese.ai.yaml
435
+ │ └── bilingual.ai.yaml
436
+ ├── locales/zh-TW/ai/options/commit-message/
437
+ │ ├── english.ai.yaml
438
+ │ ├── traditional-chinese.ai.yaml
439
+ │ └── bilingual.ai.yaml
440
+ └── skills/claude-code/commit-standards/
441
+ ├── SKILL.md
442
+ └── locales/zh-TW/.../
443
+ ```
444
+
445
+ **需更新档案**: ~20 个
446
+
447
+ ---
448
+
449
+ ### 6. documentation-structure.md
450
+
451
+ **复杂度**: 中等(3 个 YAML 选项)
452
+
453
+ ```
454
+ core/documentation-structure.md ← 来源
455
+ ├── locales/zh-TW/core/documentation-structure.md
456
+ ├── ai/standards/documentation-structure.ai.yaml
457
+ ├── locales/zh-TW/ai/standards/documentation-structure.ai.yaml
458
+ ├── ai/options/documentation/
459
+ │ ├── markdown-docs.ai.yaml
460
+ │ ├── api-docs.ai.yaml
461
+ │ └── wiki-style.ai.yaml
462
+ ├── locales/zh-TW/ai/options/documentation/
463
+ │ ├── markdown-docs.ai.yaml
464
+ │ ├── api-docs.ai.yaml
465
+ │ └── wiki-style.ai.yaml
466
+ └── skills/claude-code/documentation-guide/
467
+ ├── SKILL.md
468
+ └── locales/zh-TW/.../
469
+ ```
470
+
471
+ **需更新档案**: ~14 个
472
+
473
+ ---
474
+
475
+ ### 7. documentation-writing-standards.md
476
+
477
+ **复杂度**: 简单(无选项)
478
+
479
+ ```
480
+ core/documentation-writing-standards.md ← 来源
481
+ ├── locales/zh-TW/core/documentation-writing-standards.md
482
+ ├── ai/standards/documentation-writing-standards.ai.yaml
483
+ ├── locales/zh-TW/ai/standards/documentation-writing-standards.ai.yaml
484
+ └── skills/claude-code/documentation-guide/
485
+ ├── SKILL.md
486
+ └── locales/zh-TW/.../
487
+ ```
488
+
489
+ **需更新档案**: ~6 个
490
+
491
+ ---
492
+
493
+ ### 8. error-code-standards.md
494
+
495
+ **复杂度**: 简单(无选项、无技能)
496
+
497
+ ```
498
+ core/error-code-standards.md ← 来源
499
+ ├── locales/zh-TW/core/error-code-standards.md
500
+ ├── ai/standards/error-codes.ai.yaml
501
+ └── locales/zh-TW/ai/standards/error-codes.ai.yaml
502
+ ```
503
+
504
+ **需更新档案**: ~4 个
505
+
506
+ ---
507
+
508
+ ### 9. git-workflow.md
509
+
510
+ **复杂度**: 高(6 个 MD 选项 + 6 个 YAML 选项)
511
+
512
+ ```
513
+ core/git-workflow.md ← 来源
514
+ ├── locales/zh-TW/core/git-workflow.md
515
+ ├── ai/standards/git-workflow.ai.yaml
516
+ ├── locales/zh-TW/ai/standards/git-workflow.ai.yaml
517
+ ├── options/git-workflow/
518
+ │ ├── gitflow.md
519
+ │ ├── github-flow.md
520
+ │ ├── trunk-based.md
521
+ │ ├── merge-commit.md
522
+ │ ├── squash-merge.md
523
+ │ └── rebase-ff.md
524
+ ├── locales/zh-TW/options/git-workflow/
525
+ │ └── (6 个翻译的 .md 档案)
526
+ ├── ai/options/git-workflow/
527
+ │ └── (6 个 .ai.yaml 档案)
528
+ ├── locales/zh-TW/ai/options/git-workflow/
529
+ │ └── (6 个翻译的 .ai.yaml 档案)
530
+ └── skills/claude-code/git-workflow-guide/
531
+ ├── SKILL.md
532
+ └── locales/zh-TW/.../
533
+ ```
534
+
535
+ **需更新档案**: ~32 个
536
+
537
+ ---
538
+
539
+ ### 10. logging-standards.md
540
+
541
+ **复杂度**: 简单(无选项、无技能)
542
+
543
+ ```
544
+ core/logging-standards.md ← 来源
545
+ ├── locales/zh-TW/core/logging-standards.md
546
+ ├── ai/standards/logging.ai.yaml
547
+ └── locales/zh-TW/ai/standards/logging.ai.yaml
548
+ ```
549
+
550
+ **需更新档案**: ~4 个
551
+
552
+ ---
553
+
554
+ ### 11. project-structure.md
555
+
556
+ **复杂度**: 非常高(5 个 MD 选项 + 10 个 YAML 选项)
557
+
558
+ ```
559
+ core/project-structure.md ← 来源
560
+ ├── locales/zh-TW/core/project-structure.md
561
+ ├── ai/standards/project-structure.ai.yaml
562
+ ├── locales/zh-TW/ai/standards/project-structure.ai.yaml
563
+ ├── options/project-structure/
564
+ │ ├── dotnet.md
565
+ │ ├── nodejs.md
566
+ │ ├── python.md
567
+ │ ├── java.md
568
+ │ └── go.md
569
+ ├── locales/zh-TW/options/project-structure/
570
+ │ └── (5 个翻译的 .md 档案)
571
+ ├── ai/options/project-structure/
572
+ │ ├── dotnet.ai.yaml
573
+ │ ├── nodejs.ai.yaml
574
+ │ ├── python.ai.yaml
575
+ │ ├── java.ai.yaml
576
+ │ ├── go.ai.yaml
577
+ │ ├── rust.ai.yaml ← 仅 YAML(无 MD)
578
+ │ ├── kotlin.ai.yaml ← 仅 YAML(无 MD)
579
+ │ ├── php.ai.yaml ← 仅 YAML(无 MD)
580
+ │ ├── ruby.ai.yaml ← 仅 YAML(无 MD)
581
+ │ └── swift.ai.yaml ← 仅 YAML(无 MD)
582
+ ├── locales/zh-TW/ai/options/project-structure/
583
+ │ └── (10 个翻译的 .ai.yaml 档案)
584
+ └── skills/claude-code/project-structure-guide/(如存在)
585
+ ```
586
+
587
+ **需更新档案**: ~38 个
588
+
589
+ **备注**: 5 种语言同时有 MD 和 YAML,5 种语言仅有 YAML。
590
+
591
+ ---
592
+
593
+ ### 12. spec-driven-development.md
594
+
595
+ **复杂度**: 简单(无选项)
596
+
597
+ ```
598
+ core/spec-driven-development.md ← 来源
599
+ ├── locales/zh-TW/core/spec-driven-development.md
600
+ ├── ai/standards/spec-driven-development.ai.yaml
601
+ └── locales/zh-TW/ai/standards/spec-driven-development.ai.yaml
602
+ ```
603
+
604
+ **需更新档案**: ~4 个
605
+
606
+ ---
607
+
608
+ ### 13. test-completeness-dimensions.md
609
+
610
+ **复杂度**: 简单(无选项)
611
+
612
+ ```
613
+ core/test-completeness-dimensions.md ← 来源
614
+ ├── locales/zh-TW/core/test-completeness-dimensions.md
615
+ ├── ai/standards/test-completeness-dimensions.ai.yaml
616
+ ├── locales/zh-TW/ai/standards/test-completeness-dimensions.ai.yaml
617
+ └── skills/claude-code/testing-guide/
618
+ ├── SKILL.md
619
+ └── locales/zh-TW/.../
620
+ ```
621
+
622
+ **需更新档案**: ~6 个
623
+
624
+ ---
625
+
626
+ ### 14. testing-standards.md
627
+
628
+ **复杂度**: 非常高(4 个 MD 选项 + 9 个 YAML 选项)
629
+
630
+ ```
631
+ core/testing-standards.md ← 来源
632
+ ├── locales/zh-TW/core/testing-standards.md
633
+ ├── ai/standards/testing.ai.yaml
634
+ ├── locales/zh-TW/ai/standards/testing.ai.yaml
635
+ ├── options/testing/
636
+ │ ├── unit-testing.md
637
+ │ ├── integration-testing.md
638
+ │ ├── system-testing.md
639
+ │ └── e2e-testing.md
640
+ ├── locales/zh-TW/options/testing/
641
+ │ └── (4 个翻译的 .md 档案)
642
+ ├── ai/options/testing/
643
+ │ ├── unit-testing.ai.yaml
644
+ │ ├── integration-testing.ai.yaml
645
+ │ ├── system-testing.ai.yaml
646
+ │ ├── e2e-testing.ai.yaml
647
+ │ ├── istqb-framework.ai.yaml ← 仅 YAML
648
+ │ ├── industry-pyramid.ai.yaml ← 仅 YAML
649
+ │ ├── security-testing.ai.yaml ← 仅 YAML
650
+ │ ├── performance-testing.ai.yaml← 仅 YAML
651
+ │ └── contract-testing.ai.yaml ← 仅 YAML
652
+ ├── locales/zh-TW/ai/options/testing/
653
+ │ └── (9 个翻译的 .ai.yaml 档案)
654
+ └── skills/claude-code/testing-guide/
655
+ ├── SKILL.md
656
+ ├── testing-pyramid.md
657
+ └── locales/zh-TW/.../
658
+ ```
659
+
660
+ **需更新档案**: ~34 个
661
+
662
+ **备注**: 4 种测试类型同时有 MD 和 YAML,5 种仅有 YAML。
663
+
664
+ ---
665
+
666
+ ### 15. versioning.md
667
+
668
+ **复杂度**: 简单(无选项)
669
+
670
+ ```
671
+ core/versioning.md ← 来源
672
+ ├── locales/zh-TW/core/versioning.md
673
+ ├── ai/standards/versioning.ai.yaml
674
+ ├── locales/zh-TW/ai/standards/versioning.ai.yaml
675
+ └── skills/claude-code/release-standards/
676
+ ├── SKILL.md
677
+ ├── semantic-versioning.md
678
+ └── locales/zh-TW/.../
679
+ ```
680
+
681
+ **需更新档案**: ~8 个
682
+
683
+ ---
684
+
685
+ ## 摘要:各标准更新复杂度
686
+
687
+ | 标准 | 复杂度 | 预估档案数 | 有选项 | 有技能 |
688
+ |------|--------|------------|--------|--------|
689
+ | anti-hallucination | 简单 | ~6 | ❌ | ✅ |
690
+ | changelog-standards | 中等 | ~12 | ✅ 2 YAML | ✅ |
691
+ | checkin-standards | 简单 | ~6 | ❌ | ✅ |
692
+ | code-review-checklist | 中等 | ~14 | ✅ 3 YAML | ✅ |
693
+ | commit-message-guide | 高 | ~20 | ✅ 3 MD + 3 YAML | ✅ |
694
+ | documentation-structure | 中等 | ~14 | ✅ 3 YAML | ✅ |
695
+ | documentation-writing-standards | 简单 | ~6 | ❌ | ✅ |
696
+ | error-code-standards | 简单 | ~4 | ❌ | ❌ |
697
+ | git-workflow | 高 | ~32 | ✅ 6 MD + 6 YAML | ✅ |
698
+ | logging-standards | 简单 | ~4 | ❌ | ❌ |
699
+ | project-structure | 非常高 | ~38 | ✅ 5 MD + 10 YAML | ❌ |
700
+ | spec-driven-development | 简单 | ~4 | ❌ | ❌ |
701
+ | test-completeness-dimensions | 简单 | ~6 | ❌ | ✅ |
702
+ | testing-standards | 非常高 | ~34 | ✅ 4 MD + 9 YAML | ✅ |
703
+ | versioning | 简单 | ~8 | ❌ | ✅ |
704
+
705
+ **总计**: 所有标准约 ~208 个档案
706
+
707
+ ---
708
+
709
+ ## 更新顺序(建议)
710
+
711
+ 更新单一 `core/*.md` 档案时,请依照以下顺序:
712
+
713
+ ```
714
+ 1. core/{standard}.md ← 先编辑来源
715
+ 2. locales/zh-TW/core/{standard}.md ← 翻译 core
716
+ 3. ai/standards/{standard}.ai.yaml ← 更新 AI 版本
717
+ 4. locales/zh-TW/ai/standards/... ← 翻译 AI 版本
718
+ 5. options/{category}/*.md ← 如有 MD 选项
719
+ 6. locales/zh-TW/options/{category}/ ← 翻译 MD 选项
720
+ 7. ai/options/{category}/*.ai.yaml ← 如有 YAML 选项
721
+ 8. locales/zh-TW/ai/options/{category}/ ← 翻译 YAML 选项
722
+ 9. skills/claude-code/{skill}/ ← 更新相关技能
723
+ 10. locales/zh-TW/skills/... ← 翻译技能
724
+ ```
725
+
726
+ ---
727
+
728
+ ## 版本历史
729
+
730
+ | 版本 | 日期 | 变更 |
731
+ |------|------|------|
732
+ | 1.1.0 | 2025-12-30 | 新增 15 个标准的完整同步对照表 |
733
+ | 1.0.0 | 2025-12-30 | 初始维护指南 |
734
+
735
+ ---
736
+
737
+ ## 授权
738
+
739
+ 本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权释出。