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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +11 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +113 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/health-check-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: d8020bc66eac
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,135 +11,76 @@ status: current
10
11
 
11
12
  > **语言**: [English](../../../core/health-check-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-17
15
- **状态**: Trial(到期 2026-10-17)
16
- **适用范围**: universal
17
- **来源**: XSPEC-067(DEC-043 Wave 1 可靠性套件)
14
+ > **来源**: XSPEC-067 | **驱动来源**: DEC-043 Wave 1 Reliability Pack | **状态**: Trial(2026-04-17 ~ 2026-10-17)
18
15
 
19
- ---
20
-
21
- ## 目的
16
+ ## 概述
22
17
 
23
- 健康检查标准:liveness / readiness / startup 三种 probe、深度 health check、结构化 JSON 响应。
18
+ 健康检查标准 —— 业界常见错误是把 liveness 和 readiness 混用(健康检查检查外部依赖导致连锁重启)。本标准明确三种 probe 的语义分离、定义深度 health check 的检查范围(仅关键依赖),并规范结构化 JSON 响应以便下游自动化处理。与 observability 整合,作为 RED metric 的 Error 来源之一。
24
19
 
25
- 业界常见错误:把 liveness 和 readiness 混用(健康检查检查外部依赖导致连锁重启)。本标准明确三种 probe 语义分离,定义深度 health check 的检查范围(仅关键依赖),并规范结构化 JSON 响应以便下游自动化处理。
26
-
27
- ---
20
+ ## 关键原则
28
21
 
29
- ## 核心规范
30
-
31
- - Liveness probe 不得检查外部依赖(DB、下游 API),否则会造成连锁重启
32
- - Readiness probe 可检查关键外部依赖,但仅关键(非全部依赖)
33
- - 慢启动服务应使用 startup probe,启动完成后交棒给 liveness
34
- - Health check 端点必须回传结构化 JSON,包含 status / dependencies / timestamp
35
- - Health check 结果应作为 observability 的 Error signal 之一,连续 fail 触发 incident
36
-
37
- ---
22
+ - **Liveness 不碰外部依赖**:liveness 失败会造成 pod 重启;若依赖 DB,DB 故障时会造成所有 pod 连锁重启
23
+ - **Readiness 仅检查关键依赖**:非关键依赖不纳入,避免边缘故障导致服务被下线
24
+ - **慢启动用 startup probe**:启动完成后交棒给 liveness
25
+ - **结构化 JSON 响应**:包含 `status` / `dependencies` / `timestamp` / `version`
26
+ - **作为 observability signal**:连续失败(达到 probe threshold)时依 [alerting-standards](alerting-standards.md) 触发告警——由 alerting 定义触发时机、严重性映射与路由(`HC-001 HEALTH_CHECK_FAILED` 为告警来源之一),health-check 只负责发出 signal,不自行决定通知对象
38
27
 
39
- ## 三种 Probe 类型
28
+ ## Probe 类型
40
29
 
41
- ### Liveness Probe
30
+ | Probe | 端点 | 检查内容 | 失败时 | 阈值 |
31
+ |-------|------|---------|--------|------|
32
+ | **liveness** | `GET /health/live` | process 可响应 HTTP、内部 event loop | 重启 pod | 3 次失败 |
33
+ | **readiness** | `GET /health/ready` | 自身 API、DB ping(若必要)、关键下游 | 移出负载均衡(不重启)| 3 次失败 |
34
+ | **startup** | `GET /health/startup` | 启动过程所需资源就绪 | 重启 pod(启动超时)| 30 次失败 |
42
35
 
43
- - **目的**:服务是否还存活(process 是否卡死)
44
- - **建议端点**:`GET /health/live`
45
- - **允许检查**:process 是否能响应 HTTP、内部 event loop 是否可用
46
- - **禁止检查**:DB 连接、下游 API、消息队列(会造成连锁重启)
47
- - **失败行为**:重启 pod / process
48
- - **参数**:failureThreshold=3,periodSeconds=10
36
+ ### Liveness 禁止的检查
49
37
 
50
- ### Readiness Probe
51
-
52
- - **目的**:是否可接收流量
53
- - **建议端点**:`GET /health/ready`
54
- - **允许检查**:自身 API 可用、DB 连接(若服务必须依赖 DB)、关键下游依赖、必要配置已加载
55
- - **禁止检查**:非关键依赖(避免非关键故障造成服务被移出负载均衡)
56
- - **失败行为**:移出负载均衡,不重启
57
- - **参数**:failureThreshold=3,periodSeconds=5
58
-
59
- ### Startup Probe
60
-
61
- - **目的**:启动期专用,替代慢启动服务的 liveness
62
- - **建议端点**:`GET /health/startup`
63
- - **检查项目**:启动过程所需资源(如缓存预热、index 加载)已完成
64
- - **失败行为**:重启 pod(启动超时)
65
- - **完成后**:停用,改由 liveness 接手
66
- - **参数**:failureThreshold=30,periodSeconds=10
67
-
68
- ---
38
+ - DB 连接(DB 故障时 liveness 失败 → pod 重启 → 启动更多 client → DB 更糟)
39
+ - 下游 API(会造成连锁重启)
40
+ - 消息队列
69
41
 
70
42
  ## 深度规则
71
43
 
72
- | 层级 | 使用时机 | 检查范围 |
73
- |------|---------|---------|
74
- | Shallow | Liveness | process 是否可响应,不碰任何外部依赖 |
75
- | Deep | Readiness | 自身 API 路由、DB ping(若必须)、关键下游 API ping |
76
-
77
- **关键依赖的定义**:没有它服务就完全无法提供核心功能。
78
-
79
- ---
44
+ - **Shallow(liveness)**:process 是否可响应,不碰任何外部依赖
45
+ - **Deep(readiness)**:自身 API 路由、DB ping、关键下游 API ping(关键 = 没有它,服务就完全无法提供核心功能)
80
46
 
81
47
  ## 响应格式
82
48
 
83
- **Content-Type**:`application/json`
84
-
85
- | HTTP 状态码 | 含义 |
86
- |------------|------|
87
- | `200` | healthy — 所有关键依赖正常 |
88
- | `503` | unhealthy — 至少一个关键依赖失败 |
89
-
90
- **JSON Schema**:
91
-
92
49
  ```json
93
50
  {
94
51
  "status": "healthy | degraded | unhealthy",
95
- "timestamp": "<ISO-8601>",
96
- "uptime_seconds": 12345,
97
- "version": "1.0.0",
52
+ "timestamp": "2026-04-17T10:00:00Z",
53
+ "uptime_seconds": 3600,
98
54
  "dependencies": {
99
- "database": {
100
- "status": "healthy | unhealthy",
101
- "latency_ms": 5,
102
- "last_check": "<ISO-8601>"
103
- },
104
- "upstream_api": {
105
- "status": "healthy | unhealthy",
106
- "latency_ms": 20
107
- }
108
- }
55
+ "database": {"status": "healthy", "latency_ms": 5, "last_check": "..."},
56
+ "upstream_api": {"status": "healthy", "latency_ms": 42, "last_check": "..."}
57
+ },
58
+ "version": "1.2.3"
109
59
  }
110
60
  ```
111
61
 
112
- ---
113
-
114
- ## 与 Observability 整合
115
-
116
- - Health check 结果应作为 RED metric 的 Error 来源之一(Rate / Errors / Duration)
117
- - 连续 N 次 health check failed 应触发 incident(对齐 incident-response)
118
- - probe 延迟本身应被监控(异常缓慢可能是 resource_exhaustion 征兆)
62
+ - HTTP 200 → healthy
63
+ - HTTP 503 → unhealthy(至少一个关键依赖失败)
119
64
 
120
- ---
65
+ ## 使用示例
121
66
 
122
- ## 情境示例
67
+ - **场景 1 —— Liveness 不检查 DB**:DB 连接池耗尽,liveness 仍返回 200(liveness 不检查 DB),避免所有 pod 重启
68
+ - **场景 2 —— Readiness 失败**:关键下游 API 不可达,readiness 返回 503,pod 移出 LB;process 不重启
69
+ - **场景 3 —— Startup → Liveness 交棒**:服务需要 60s 预热缓存,startup probe 在前 60s 持续返回 503,预热完成后改由 liveness 接手
123
70
 
124
- **情境 1:liveness 不检查 DB**
125
- - 条件:DB 暂时无法连接
126
- - Liveness 回传 200 healthy(不检查 DB),避免连锁重启
71
+ ## 错误码
127
72
 
128
- **情境 2:readiness 因关键依赖失败**
129
- - 条件:关键下游 API 不可达
130
- - Readiness 回传 503,pod 移出负载均衡但不重启
73
+ - `HC-001` — `HEALTH_CHECK_FAILED`(关键依赖失败)
74
+ - `HC-002` — `HEALTH_CHECK_TIMEOUT`(probe 本身超时)
75
+ - `HC-003` — `INVALID_DEPENDENCY_SET`(readiness 检查了非关键依赖,设计违规)
131
76
 
132
- **情境 3:startup 后交棒 liveness**
133
- - 条件:服务需 60s 预热缓存
134
- - 前 60s startup probe 持续回 503,预热完成后交棒 liveness
77
+ ## 参考资料
135
78
 
136
- ---
79
+ - AI 优化版:[ai/standards/health-check-standards.ai.yaml](../../../ai/standards/health-check-standards.ai.yaml)
80
+ - XSPEC-067:DEC-043 Wave 1 Reliability Pack 跨项目规格
81
+ - DEC-043:UDS 覆盖完整性路线图(驱动来源)
82
+ - 相关:`deployment-standards`, `circuit-breaker`, `alerting-standards`(probe 连续失败 → 告警触发与路由), observability-standards(XSPEC-063 规划中)
83
+ - 业界:Kubernetes probes, Microsoft eShop health checks, Google SRE Book Ch.6
137
84
 
138
- ## 错误码
139
85
 
140
- | 代码 | 说明 |
141
- |------|------|
142
- | `HC-001` | `HEALTH_CHECK_FAILED` — 关键依赖失败 |
143
- | `HC-002` | `HEALTH_CHECK_TIMEOUT` — probe 本身超时 |
144
- | `HC-003` | `INVALID_DEPENDENCY_SET` — readiness 检查了非关键依赖(设计违规)|
86
+ **范围**: universal
@@ -2,95 +2,118 @@
2
2
  source: ../../../core/immutability-first.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 3678885d6b73
6
7
  status: current
7
8
  ---
8
9
 
9
- # 不可变性优先原则
10
+ # 不可变性优先架构标准
10
11
 
11
12
  > **语言**: [English](../../../core/immutability-first.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-17
15
- **状态**: Trial(到期 2026-10-17)
16
- **适用范围**: universal
17
- **来源**: XSPEC-068(DEC-043 Wave 1 可靠性套件)
14
+ > **来源**: XSPEC-044 | **适用于**: TypeScript、并发系统
18
15
 
19
- ---
16
+ ## 概述
20
17
 
21
- ## 目的
18
+ 不可变性优先(Immutability-First)是一项系统级设计原则,用于防止并发 Agent 环境中的竞态条件。所有数据流接口(DTO / Value Object)都必须以 `readonly` 声明字段,数组字段必须使用 `ReadonlyArray<T>`,对象的修改必须通过 spread 语法创建新对象,而不是原地修改。
22
19
 
23
- 不可变性优先原则:DTO 字段 readonly,防止并发 Agent 竞态条件。
20
+ 缺少这项纪律时,并发的 Agent 编排(例如 `Promise.all` 批量执行)就有意外共享状态的风险:一个 Agent 的修改会悄悄影响另一个 Agent 对同一对象的视图。
24
21
 
25
- 多个 Agent 并发执行时,共享状态的可变对象容易产生竞态条件(race condition)。本标准要求所有跨 Agent 边界传递的数据对象(DTO)默认使用 readonly 字段,并提供安全修改的替代模式(返回新实例而非原地修改)。
22
+ ## 规则
26
23
 
27
- ---
24
+ | 规则 | 严重性 | 说明 |
25
+ |------|--------|------|
26
+ | **IMM-001** | required | DTO/Value Object 字段必须为 `readonly` |
27
+ | **IMM-002** | required | 数组字段必须使用 `ReadonlyArray<T>`,而非 `T[]` |
28
+ | **IMM-003** | required | 修改时使用 spread 语法创建新对象 |
29
+ | **IMM-004** | required | 跨越并发边界的对象必须是深度不可变的 |
30
+ | **IMM-005** | recommended | 嵌套对象字段以 `Readonly<T>` 包装 |
28
31
 
29
- ## 核心规范
32
+ ## 示例
30
33
 
31
- - 所有 DTO(Data Transfer Object)字段默认必须声明为 `readonly`
32
- - 跨 Agent 边界传递的对象必须是不可变的(immutable)
33
- - 需要修改时,必须返回新实例(而非原地修改)
34
- - 深层嵌套对象的所有层级都必须是 readonly
35
- - 集合(数组/Map)使用 `ReadonlyArray` / `ReadonlyMap`
34
+ ### IMM-001:DTO 字段 readonly
36
35
 
37
- ---
36
+ ```typescript
37
+ // ❌ Bad
38
+ interface TaskResult {
39
+ status: TaskStatus
40
+ cost_usd?: number
41
+ }
42
+
43
+ // ✅ Good
44
+ interface TaskResult {
45
+ readonly status: TaskStatus
46
+ readonly cost_usd?: number
47
+ }
48
+ ```
38
49
 
39
- ## IMM 规则
50
+ ### IMM-002:数组字段使用 ReadonlyArray
40
51
 
41
- | 规则 | 说明 |
42
- |------|------|
43
- | `IMM-001` | DTO 所有字段声明为 `readonly` |
44
- | `IMM-002` | 嵌套对象使用 `Readonly<T>` 递归包装 |
45
- | `IMM-003` | 数组使用 `ReadonlyArray<T>` 而非 `T[]` |
46
- | `IMM-004` | 禁止对跨 Agent 边界的对象使用原地修改(`push`、`splice`、直接赋值)|
47
- | `IMM-005` | 需要修改时,使用展开运算符(spread)返回新实例 |
52
+ ```typescript
53
+ // ❌ Bad
54
+ interface MemoryContext {
55
+ recentHistory: IterationRecord[] // push/splice can corrupt shared state
56
+ }
48
57
 
49
- ---
58
+ // ✅ Good
59
+ interface MemoryContext {
60
+ readonly recentHistory: ReadonlyArray<IterationRecord>
61
+ }
62
+ ```
50
63
 
51
- ## TypeScript 示例
64
+ ### IMM-003:以 Spread 语法进行修改
52
65
 
53
66
  ```typescript
54
- // 正确:不可变 DTO
55
- interface TaskResult {
56
- readonly taskId: string;
57
- readonly status: 'succeeded' | 'failed';
58
- readonly outputs: ReadonlyArray<string>;
59
- readonly metadata: Readonly<Record<string, unknown>>;
60
- }
67
+ // ❌ Bad
68
+ options.sessionId = forkId // other holders see the change
69
+
70
+ // ✅ Good
71
+ const taskOptions = { ...options, sessionId: forkId }
72
+ ```
73
+
74
+ ### IMM-004:并发边界上的深度不可变
75
+
76
+ ```typescript
77
+ // ✅ Good — each parallel task holds its own options snapshot
78
+ const batchResults = await Promise.all(
79
+ batch.map(task => {
80
+ const taskOptions = { ...baseOptions, sessionId: forkId }
81
+ return executeOneTask(task, adapter, taskOptions, ...)
82
+ })
83
+ )
84
+ ```
61
85
 
62
- // 正确:通过展开运算符创建新实例
63
- function updateStatus(result: TaskResult, newStatus: TaskResult['status']): TaskResult {
64
- return { ...result, status: newStatus };
86
+ ### IMM-005:嵌套对象使用 Readonly<T>
87
+
88
+ ```typescript
89
+ // ❌ Bad — metadata.score can still be mutated
90
+ interface PipelineMemoryEntry {
91
+ readonly metadata: { score?: number }
65
92
  }
66
93
 
67
- // 错误:原地修改(违反 IMM-004)
68
- // result.status = 'succeeded'; // TypeScript 会报错
94
+ // ✅ Good
95
+ interface PipelineMemoryEntry {
96
+ readonly metadata: Readonly<{ score?: number; severity?: string }>
97
+ }
69
98
  ```
70
99
 
71
- ---
100
+ ## 何时适用
72
101
 
73
- ## 情境示例
102
+ - 设计新的 DTO / Value Object / Config 接口
103
+ - 跨并发边界传递对象
104
+ - 设计 Agent 之间的共享状态
105
+ - 代码审查:检查接口是否遗漏 `readonly`
74
106
 
75
- **情境 1:并发 Agent 读取同一 DTO**
76
- - 条件:两个 Agent 并发读取 `TaskResult` 对象
77
- - 结果:因为字段是 readonly,无需加锁,不存在竞态条件
107
+ ## 例外
78
108
 
79
- **情境 2:需要更新状态**
80
- - 条件:Agent A 需要将 `TaskResult.status` 从 `failed` 改为 `succeeded`
81
- - 结果:通过 `{ ...result, status: 'succeeded' }` 返回新对象,不修改原始对象
109
+ - Builder Pattern 的可变 builder(`build()` 之后返回不可变结果)
110
+ - 测试 fixture 的可变构建步骤(创建完成后视为不可变)
111
+ - 性能关键的热路径(需要明确的 benchmark 证据)
82
112
 
83
- **情境 3:集合操作**
84
- - 条件:需要向 `outputs` 数组添加新元素
85
- - 结果:`{ ...result, outputs: [...result.outputs, newOutput] }`
113
+ ## 参考资料
86
114
 
87
- ---
115
+ - AI 优化版:[ai/standards/immutability-first.ai.yaml](../../../ai/standards/immutability-first.ai.yaml)
116
+ - XSPEC-044:跨项目规格
88
117
 
89
- ## 错误码
90
118
 
91
- | 代码 | 说明 |
92
- |------|------|
93
- | `IMM-001` | `MUTABLE_DTO_FIELD` — DTO 字段缺少 readonly 声明 |
94
- | `IMM-002` | `MUTABLE_NESTED_OBJECT` — 嵌套对象未使用 Readonly 包装 |
95
- | `IMM-003` | `MUTABLE_ARRAY` — 使用可变数组而非 ReadonlyArray |
96
- | `IMM-004` | `IN_PLACE_MUTATION` — 对跨 Agent 边界对象执行原地修改 |
119
+ **范围**: universal
@@ -2,13 +2,22 @@
2
2
  source: ../../../core/knowledge-transfer-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-11
6
+ source_hash: 7d994f996240
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 知识传承标准
10
11
 
11
- > 版本: 1.0.0 | 最后更新: 2026-04-01
12
+ > **语言**: [English](../../../core/knowledge-transfer-standards.md) | [繁體中文](../../zh-TW/core/knowledge-transfer-standards.md) | 简体中文
13
+
14
+ **版本**: 1.0.0
15
+ **最后更新**: 2026-03-31
16
+ **适用范围**: 所有软件项目
17
+ **范围**: universal
18
+ **参考**: [Atlassian Knowledge Transfer](https://www.atlassian.com/work-management/knowledge-sharing)、[Google re:Work](https://rework.withgoogle.com/)
19
+
20
+ ---
12
21
 
13
22
  ## 概述
14
23
 
@@ -18,82 +27,136 @@ status: current
18
27
 
19
28
  ## Onboarding 路线图
20
29
 
30
+ 结构化的 30 天 Onboarding 流程能帮助新团队成员快速产出。
31
+
21
32
  ### 4 周计划
22
33
 
23
34
  | 周次 | 主题 | 目标 | 交付物 |
24
35
  |------|------|------|--------|
25
- | **第 1 周** | 环境与文化 | 完成开发环境设置;理解团队规范 | 成功构建并运行项目 |
36
+ | **第 1 周** | 环境与文化 | 完成开发环境设置;理解团队规范与惯例 | 成功构建并运行项目 |
26
37
  | **第 2 周** | 架构与代码 | 理解系统架构与关键路径 | 完成 Code Tour |
27
38
  | **第 3 周** | 流程与工具 | 理解 CI/CD、部署与监控流程 | 完成第一个 PR |
28
39
  | **第 4 周** | 独立贡献 | 独立完成一个小型任务 | 通过 Buddy 评估 |
29
40
 
30
41
  ### Onboarding 检查清单
31
42
 
43
+ 每位新团队成员应在第一天及第一周内完成以下检查清单:
44
+
32
45
  | 类别 | 项目 |
33
46
  |------|------|
34
- | **账号访问** | Git 仓库、CI/CD 平台、监控工具、云端控制台、通讯工具 |
35
- | **环境设置** | 开发环境、IDE 配置、VPN、数据库访问、本地构建验证 |
47
+ | **账号访问** | Git 仓库、CI/CD 平台、监控工具、云端控制台、通讯工具(Slack/Teams) |
48
+ | **环境设置** | 开发环境、IDE 配置、VPN 访问、数据库访问、本地构建验证 |
36
49
  | **文档** | README、架构文档、API 文档、CLAUDE.md 或等效 AI 上下文文件 |
37
- | **会议** | 与 Buddy 1:1、团队介绍、架构概览 |
38
- | **首要任务** | Good First Issue、Code Tour、第一个小型 PR |
50
+ | **会议** | 与 Buddy 1:1、团队介绍、架构概览会议 |
51
+ | **首要任务** | 分配 Good First Issue、完成 Code Tour、提交第一个小型 PR |
39
52
 
40
53
  ---
41
54
 
42
55
  ## Handoff 流程
43
56
 
57
+ 当团队成员即将离职或转换角色时,使用此结构化交接流程以防止知识流失。
58
+
59
+ ### 交接检查清单
60
+
44
61
  | 项目 | 说明 | 时程 |
45
62
  |------|------|------|
46
- | **负责清单** | 列出所有负责的模块、服务与流程 | 离职前 4 周 |
47
- | **隐性知识记录** | 记录所有「只有我知道」的操作与陷阱 | 离职前 3 周 |
48
- | **WIP 交接** | 移交进行中的任务、打开的 PR、事件追踪 | 离职前 2 周 |
49
- | **Buddy 配对** | 指定继任者并进行 Pair Programming | 离职前 2 周 |
50
- | **账号与权限** | 移交 owner 权限、轮换 API 密钥 | 离职前 1 周 |
51
- | **Runbook 更新** | 审查并更新所有相关 Runbook | 离职前 1 周 |
63
+ | **负责清单** | 列出此人负责的所有模块、服务与流程 | 离职前 4 周 |
64
+ | **隐性知识记录** | 使用下方的知识记录格式,记录所有「只有我知道」的操作、技巧与陷阱 | 离职前 3 周 |
65
+ | **WIP 交接** | 移交所有进行中的任务、打开的 PR 与事件追踪项目 | 离职前 2 周 |
66
+ | **Buddy 配对** | 指定继任者,并针对复杂领域进行 Pair Programming | 离职前 2 周 |
67
+ | **账号与权限移交** | 移交 owner 权限、轮换 API 密钥、更新访问控制 | 离职前 1 周 |
68
+ | **Runbook 更新** | 审查并更新所有相关 Runbook,确保其为最新且完整 | 离职前 1 周 |
52
69
 
53
70
  ### 知识记录格式
54
71
 
55
- | 字段 | 说明 |
56
- |------|------|
57
- | **主题** | 捕捉什么知识 |
58
- | **情境** | 何时需要此知识 |
59
- | **步骤** | 具体操作程序 |
60
- | **陷阱** | 常见错误与注意事项 |
61
- | **资源** | 代码、文档、Runbook 链接 |
72
+ 记录隐性知识时,每条记录应(SHOULD)包含以下 5 个字段:
73
+
74
+ | 字段 | 说明 | 示例 |
75
+ |------|------|------|
76
+ | **主题** | 捕捉什么知识 | 「支付网关重试逻辑」 |
77
+ | **情境** | 在什么情况下需要此知识 | 「支付因超时错误失败时」 |
78
+ | **步骤** | 应遵循的具体程序 | 「1. 检查网关状态页 2. 审查重试队列 3. ...」 |
79
+ | **陷阱** | 常见错误与注意事项 | 「绝不重试 4xx 错误;只对 5xx 或超时重试」 |
80
+ | **资源** | 代码、文档、Runbook 链接 | 「参见 `src/payment/retry.js`,Runbook:payment-recovery」 |
62
81
 
63
82
  ---
64
83
 
65
84
  ## Bus Factor 评估
66
85
 
86
+ Bus Factor 衡量需要多少团队成员「被公交车撞到」(意外离开)才会导致关键知识流失。Bus Factor 为 1 表示只要一人离开,就可能使某个系统领域瘫痪。
87
+
88
+ ### 评估指标
89
+
90
+ 针对每个关键领域或系统区域,评估以下 3 项指标:
91
+
67
92
  | 指标 | 定义 | 风险等级 |
68
93
  |------|------|---------|
69
- | **知识人数** | 可独立处理该领域的人数 | 1 人 = **高**、2 人 = **中**、3+ 人 = **低** |
70
- | **文档覆盖率** | 有书面文档覆盖的百分比 | < 30% = **高**、30-70% = **中**、> 70% = **低** |
71
- | **最近知识分享** | 最近一次有人学习该领域 | > 6 个月 = **高**、3-6 个月 = **中**、< 3 个月 = **低** |
94
+ | **知识人数** | 可独立处理该领域的人数 | 1 人 = **高**风险、2 人 = **中**、3+ 人 = **低** |
95
+ | **文档覆盖率** | 该领域有书面文档覆盖的百分比 | < 30% = **高**风险、30-70% = **中**、> 70% = **低** |
96
+ | **最近知识分享** | 最近一次有人学习该领域距今多久 | > 6 个月 = **高**风险、3-6 个月 = **中**、< 3 个月 = **低** |
72
97
 
73
98
  ### 知识扩散策略
74
99
 
75
- | 策略 | 适用场景 |
76
- |------|---------|
77
- | **Pair Programming** | 复杂逻辑、特殊技巧 |
78
- | **Tech Talk** | 架构决策、设计理由 |
79
- | **文档化** | 操作程序、部署步骤 |
80
- | **Code Review 轮调** | 代码理解、打破知识孤岛 |
81
- | **On-call 轮调** | 运维知识、事件响应 |
100
+ 识别出 Bus Factor = 1 的领域时,使用以下一种或多种策略扩散知识:
101
+
102
+ | 策略 | 说明 | 适用场景 |
103
+ |------|------|---------|
104
+ | **Pair Programming** | 专家与学习者一起处理实际任务 | 复杂逻辑、特殊技巧 |
105
+ | **Tech Talk** | 专家以结构化会议向团队讲解 | 架构决策、设计理由 |
106
+ | **文档化** | 将隐性知识转为书面文档或 Runbook | 操作程序、部署步骤 |
107
+ | **Code Review 轮调** | 轮换审查者,让不同的人审查不同领域 | 代码理解、发现知识孤岛 |
108
+ | **On-call 轮调** | 在不同服务之间轮换值班 | 运维知识、事件响应 |
82
109
 
83
110
  ---
84
111
 
85
112
  ## Code Tour
86
113
 
114
+ Code Tour 提供贯穿代码库的结构化导览路线,帮助新人无需阅读每个文件即可理解系统。
115
+
87
116
  ### 导览路线
88
117
 
118
+ 每个代码库应(SHOULD)至少定义以下导览路线:
119
+
89
120
  | 路线 | 涵盖内容 | 目标对象 |
90
121
  |------|---------|---------|
91
122
  | **Quick Start** | 入口点、主要配置、启动流程 | 所有新人 |
92
123
  | **Request Flow** | 请求从进入到响应的完整路径 | 后端开发者 |
93
124
  | **Data Flow** | 数据从创建到存储到检索的路径 | 数据相关开发者 |
94
- | **Deploy Flow** | 从 PR 到生产的完整路径 | 需要部署的人 |
125
+ | **Deploy Flow** | 从 PR 到生产环境的完整路径 | 需要部署的人 |
95
126
  | **Key Decisions** | 重要架构决策及其 ADR | 需要理解「为什么」的人 |
96
127
 
128
+ ### Code Tour 维护
129
+
130
+ 发生代码变更时,评估 Code Tour 是否需要更新:
131
+
132
+ | 变更类型 | 动作 | 理由 |
133
+ |---------|------|------|
134
+ | 入口点或路由变更 | **必须(MUST)** 更新导览 | 导览引用会失效或产生误导 |
135
+ | 内部重构(接口不变) | **无需更新** | 导览描述的是流程,而非实现细节 |
136
+ | 新增重大功能 | **应(SHOULD)** 新增导览路线 | 新功能可能值得拥有独立的导览路径 |
137
+
138
+ ---
139
+
140
+ ## 参考资料
141
+
142
+ - [Atlassian Knowledge Transfer Guide](https://www.atlassian.com/work-management/knowledge-sharing) — 知识分享最佳实践
143
+ - [Google re:Work — Onboarding](https://rework.withgoogle.com/guides/hiring-shape-the-candidate-experience/steps/make-onboarding-a-great-experience/) — 以证据为基础的 Onboarding 实践
144
+ - [Bus Factor on Wikipedia](https://en.wikipedia.org/wiki/Bus_factor) — 概念定义与缓解方式
145
+
146
+ ---
147
+
148
+ **相关标准:**
149
+ - [文档生命周期](documentation-lifecycle.md) — 文档维护与审查周期
150
+ - [Runbook 标准](runbook-standards.md) — 运维 Runbook 格式与要求
151
+
152
+ ---
153
+
154
+ ## 版本历史
155
+
156
+ | 版本 | 日期 | 变更 |
157
+ |------|------|------|
158
+ | 1.0.0 | 2026-03-31 | 初始发布:Onboarding 路线图、Handoff 流程、Bus Factor 评估、Code Tour |
159
+
97
160
  ---
98
161
 
99
162
  ## 许可
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/pipeline-integration-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-23
5
+ last_synced: 2026-10-11
6
+ source_hash: 425af5c3b0f3
6
7
  status: current
7
8
  ---
8
9
 
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/pipeline-security-gates.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-07-08
6
- source_hash: b234d1eb2344
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-07
6
+ source_hash: a1e0a4792a90
7
7
  status: current
8
8
  ---
9
9
 
@@ -22,6 +22,7 @@ status: current
22
22
  ## 核心原则
23
23
 
24
24
  - **密钥扫描在 pre-commit**:所有包含密钥的提交都必须被阻断,不得例外
25
+ - **密钥扫描器自身的行为也要写明**:输出不得打印被匹配到的密钥值;扫描器跑不起来视同闸门失败(见 1.1 节)
25
26
  - **SAST 在构建后**:Critical 和 High 等级发现阻断 pipeline
26
27
  - **SCA + SBOM 在打包阶段**:追踪依赖组件风险并生成物料清单
27
28
  - **Attestation 验证在发布前**:打包后、部署前 MUST 验证 artifact 的 checksum、签名与 SLSA provenance(消费 supply-chain-attestation 标准的产出,不得「生成 SBOM 却不验证」)
@@ -44,6 +45,65 @@ status: current
44
45
 
45
46
  **重要**:此闸门必须在代码进入版本控制前执行,一旦密钥进入 git 历史便需要完整的密钥轮换流程。
46
47
 
48
+ ### 1.1 扫描器自身的三个行为(1.1.0 新增)
49
+
50
+ 上表讲「扫描什么、何时阻断」;本节讲**扫描器本身**必须怎么表现。以下三条都以本标准既有的两条原则为前提:
51
+ 「安全闸门失败 = pipeline 失败」与「禁止静默跳过安全闸门」。
52
+
53
+ | 编号 | 强度 | 要求 |
54
+ |------|------|------|
55
+ | **PSG-1** | 必须(MUST) | 扫描的输出——终端、CI 日志、报告文件——**不得包含被匹配到的密钥值本身**,只能指出文件、行号与规则名称 |
56
+ | **PSG-2** | 必须(MUST) | 扫描器**无法执行**视同闸门失败,**必须阻断**提交/pipeline,不得放行 |
57
+ | **PSG-3** | 建议(SHOULD) | 团队**自己编写**的检测规则,每一条都有一个应被抓到(红)与一个不应被误报(绿)的测试样本,样本在测试中执行 |
58
+
59
+ #### PSG-1 输出不得打印被匹配到的密钥值
60
+
61
+ 理由:扫描日志会被贴进聊天室与工单。闸门把密钥值打印在输出里,等于把已被拦下的密钥再泄漏一次。
62
+
63
+ 工具注记(只写已查证的):
64
+
65
+ | 工具 | 注记 | 依据 |
66
+ |------|------|------|
67
+ | gitleaks | 官方 README 的示例输出(`gitleaks git -v`,未加 `--redact`)含 `Secret:` 一行,打印被匹配到的值全文;`--redact` 参数的说明为「redact secrets from logs and stdout」。README 未说明 `--redact` 是否也涵盖 `--report-path` 生成的报告文件,**采用者须自行确认** | gitleaks 官方 README,2026-10-07 读取 |
68
+ | detect-secrets | 默认输出行为**本标准未查证,采用者须自行确认** | — |
69
+ | trufflehog | 默认输出行为**本标准未查证,采用者须自行确认** | — |
70
+
71
+ 判定程序(示意,三行):
72
+
73
+ 1. 建一个含**假**密钥的文件(示意记法:`FAKE-SECRET-DO-NOT-USE-0000`;实际样本须是**你自己的闸门会匹配的格式**——例如自写一条 canary 规则,或工具文档列出的测试样式——且必须是假值,不得是任何真实服务的有效凭证),加入 staging 后执行闸门,**先确认闸门确实阻断**。
74
+ 2. 没阻断代表样本没被匹配,第 3 步不算数——此时输出里当然找不到它,结果是「绿得虚假」。
75
+ 3. 在终端、CI 日志、报告文件的**全部输出**搜索该假密钥字符串;找到任何一处即不合规。
76
+
77
+ #### PSG-2 扫描器跑不起来视为闸门失败
78
+
79
+ 「跑不起来」包含:可执行文件不存在、配置文件无法读取或无效、超时、非预期的退出。这些情况必须阻断,**不得**以 `|| true`、`2>/dev/null` 等方式吞掉,也不得让闸门输出「扫描通过」。
80
+
81
+ UDS 自己的先例:`uds init` 为非 Node 项目写的原生 `.git/hooks/pre-commit`,曾把每个检查接上 `2>/dev/null || true` 后打印「Pre-commit checks passed」——检查坏掉也照样放行,且藏起自己的错误。6.14.0-beta.4 修正(见 CHANGELOG 该版〈Fixed〉)。
82
+
83
+ 工具注记:gitleaks 官方 README 的〈Exit Codes〉一节写 `1 - leaks or error encountered`——发现泄漏与发生错误是**同一个退出码**,所以**区分原因要靠输出,不靠退出码**;对阻断与否,两者的结论相同。README 另说明 `--exit-code` 参数可改写「发现泄漏时」的退出码(2026-10-07 读取):把它设成 0 会让闸门在发现泄漏时放行,不得这样配置。detect-secrets、trufflehog 的退出码行为**本标准未查证,采用者须自行确认**。
84
+
85
+ 判定程序(示意,三行):
86
+
87
+ 1. 把扫描器可执行文件改名或移走,或把它的配置文件改成无效内容。
88
+ 2. 对一个**不含任何密钥**的提交执行闸门(此时若被阻断,原因只可能是扫描器跑不起来)。
89
+ 3. 提交被阻断(退出码非 0),且输出说明是扫描器无法执行;若提交被放行,或输出看起来像「扫描通过」,即不合规。
90
+
91
+ #### PSG-3 自己写的检测规则,每条要有红绿样本
92
+
93
+ 适用于团队**自己编写**的规则,包含 `secret-management-standards` 的 REQ-003 所列的最低四种:AWS access key、PEM 私钥头、通用 API token、含密码的连接字符串。只用工具内置规则、不自己写规则的团队不适用。
94
+
95
+ 道理与 `open-work-tracking` 的 OWT-015 相同:没见过失败的检查不算证据。一条从没被红样本匹配过的规则,无法证明它抓得到东西;一条没有绿样本的规则,无法证明它不会把正常代码全部拦下。
96
+
97
+ 判定程序(示意,三行):
98
+
99
+ 1. 列出团队自写的全部检测规则。
100
+ 2. 逐条找对应的一个红样本(必被匹配)与一个绿样本(不得匹配);样本须是假值。
101
+ 3. 确认样本在测试中真的执行;缺任一个即列为缺口(本条为建议,缺口不阻断)。
102
+
103
+ #### 范围的诚实注明
104
+
105
+ UDS **不发布扫描器**。上面三段是采用者在**自己的闸门**上自行验证的程序。UDS 自己的 repo 目前也没有密钥扫描(CI 与 hook 都没有用到上述三种工具)。
106
+
47
107
  ---
48
108
 
49
109
  ### 2. Post-Build — SAST(静态应用安全测试)