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/pipeline-integration-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-18
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(靜態應用安全測試)
@@ -1,97 +1,204 @@
1
1
  ---
2
2
  source: ../../../core/privacy-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
6
- status: stale
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 2f216c008c09
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 隱私標準
10
11
 
11
- > 版本: 1.0.0 | 最後更新: 2026-04-01
12
+ > **語言**: [English](../../../core/privacy-standards.md) | 繁體中文
13
+
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-06-18
16
+ **適用範圍**: 所有處理個人資料的軟體專案
17
+ **Scope**: universal
18
+ **業界標準**: GDPR、CCPA、Privacy by Design(Ann Cavoukian)
19
+ **參考資料**: [gdpr.eu](https://gdpr.eu/)、[ipc.on.ca](https://www.ipc.on.ca/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
25
  本文件定義在軟體生命週期中保護使用者資料的隱私標準,基於 Privacy by Design 原則與國際資料保護法規。
16
26
 
17
- ## Privacy by Design 七大原則
27
+ ---
28
+
29
+ ## Privacy by Design 原則
30
+
31
+ 七大基礎原則(Ann Cavoukian,2009):
18
32
 
19
33
  | # | 原則 | 說明 |
20
34
  |---|------|------|
21
- | 1 | **主動而非被動** | 在隱私問題發生前預防 |
22
- | 2 | **預設隱私保護** | 個人資料自動受到保護 |
23
- | 3 | **隱私嵌入設計** | 隱私是系統架構的一部分,非附加元件 |
24
- | 4 | **完整功能 — 正和** | 隱私與功能兼得,非二擇一 |
25
- | 5 | **端到端安全** | 資料在整個生命週期中受到保護 |
26
- | 6 | **可見性與透明度** | 所有實踐可文件化、可驗證 |
27
- | 7 | **尊重使用者隱私** | 使用者利益至上,提供強預設與明確選項 |
35
+ | 1 | **主動而非被動** | 在隱私問題發生前預見並預防 |
36
+ | 2 | **預設隱私保護** | 個人資料自動受到保護;使用者無須採取任何動作 |
37
+ | 3 | **隱私嵌入設計** | 隱私是系統架構不可或缺的一部分,而非附加元件 |
38
+ | 4 | **完整功能 — 正和** | 隱私「與」功能兼得,而非隱私「或」功能二擇一 |
39
+ | 5 | **端到端安全** | 資料在整個生命週期(從收集到刪除)中都受到保護 |
40
+ | 6 | **可見性與透明度** | 所有實踐皆有文件記錄、可驗證,並接受檢視 |
41
+ | 7 | **尊重使用者隱私 — 以使用者為中心** | 使用者利益至上;提供強預設值與明確選項 |
42
+
43
+ ---
28
44
 
29
45
  ## 資料分類
30
46
 
47
+ 依敏感程度為所有資料分類:
48
+
31
49
  | 等級 | 說明 | 處理要求 |
32
50
  |------|------|---------|
33
51
  | **公開** | 可自由分享(行銷內容、文件) | 無限制 |
34
- | **內部** | 僅供內部使用(內部報告) | 存取控制 |
35
- | **機密** | 敏感商業資料(財務、策略) | 加密、稽核日誌、需知原則 |
36
- | **受限** | 高度敏感 PII、健康、財務資料 | 最強加密、嚴格存取、資料遮罩 |
52
+ | **內部** | 僅供內部使用(內部報告、會議記錄) | 存取控制,不得公開分享 |
53
+ | **機密** | 敏感商業資料(財務、策略) | 靜態/傳輸加密、稽核日誌、需知原則存取 |
54
+ | **受限** | 高度敏感的 PII、健康、財務資料(身分證號、病歷) | 最強加密、嚴格存取、資料遮罩、法規合規 |
55
+
56
+ ---
37
57
 
38
58
  ## 資料保護影響評估(DPIA)
39
59
 
40
- DPIA 必須在以下情況執行:
41
- - 大規模處理個人資料
60
+ ### 觸發條件
61
+
62
+ 在以下情況必須執行 DPIA:
63
+ - **大規模**處理個人資料(見下方量化準則)
42
64
  - 系統性監控公共區域
43
- - 有法律效力的自動化決策
44
- - 處理特殊類別資料(健康、生物識別)
65
+ - 具法律效力的自動化決策
66
+ - 處理特殊類別資料(健康、生物識別、基因)
45
67
  - 合併不同來源的資料集
46
68
  - 處理弱勢族群資料(兒童、員工)
47
69
 
70
+ > **「大規模」— 量化準則** _(來源:GDPR 第 35 條;WP29 DPIA
71
+ > 指引 WP248rev.01)_。「大規模」沒有單一的硬性數字定義;請依四項因素評估:
72
+ > (1) 資料主體人數 — 絕對數量或佔相關母體的比例;(2) 資料項目的數量與範圍;
73
+ > (3) 處理的持續時間或永久性;(4) 地理範圍。當處理在**兩項以上**因素達顯著
74
+ > 程度時,即視為大規模。
75
+ > **例外**:一次性處理、單一個人的資料,或個別執業者的紀錄不屬於「大規模」,
76
+ > 不會僅因此一理由觸發 DPIA(但上方其他觸發條件仍可能適用)。
77
+
78
+ ### 簡化 DPIA 範本
79
+
80
+ ```markdown
81
+ ## DPIA: [Project/Feature Name]
82
+
83
+ ### 1. Data Processing Description
84
+ - What data is collected?
85
+ - Why is it collected?
86
+ - How is it processed?
87
+ - Who has access?
88
+
89
+ ### 2. Necessity Assessment
90
+ - Is all collected data necessary for the stated purpose?
91
+ - Can the purpose be achieved with less data?
92
+
93
+ ### 3. Risk Assessment
94
+ | Risk | Likelihood | Impact | Mitigation |
95
+ |------|-----------|--------|------------|
96
+ | [Risk description] | High/Med/Low | High/Med/Low | [Mitigation measure] |
97
+
98
+ ### 4. Decision
99
+ - [ ] Proceed as planned
100
+ - [ ] Proceed with mitigations
101
+ - [ ] Redesign required
102
+ - [ ] Do not proceed
103
+ ```
104
+
105
+ ---
106
+
48
107
  ## 資料最小化
49
108
 
109
+ ### 核心原則
110
+
50
111
  | 原則 | 說明 |
51
112
  |------|------|
52
113
  | **僅收集必要資料** | 每個資料欄位須有文件化的用途 |
53
- | **定義保留期限** | 每種資料類型須有明確保留期限 |
114
+ | **定義保留期限** | 每種資料類型須有明確的保留期限 |
54
115
  | **到期自動刪除** | 超過保留期限的資料須自動刪除或匿名化 |
55
- | **目的限制** | 為某目的收集的資料不得未經同意用於他途 |
116
+ | **目的限制** | 為某目的收集的資料,未經同意不得用於其他目的 |
117
+ | **儲存限制** | 資料保存時間不得超過其用途所需 |
56
118
 
57
119
  ### 保留期限指南
58
120
 
59
- | 資料類型 | 建議保留期限 |
60
- |---------|------------|
61
- | Session 資料 | Session 期間 |
62
- | 活動日誌 | 90 天 |
63
- | 帳號資料 | 帳號刪除 + 30 天 |
64
- | 交易記錄 | 7 年 |
65
- | 行銷偏好 | 直到撤回同意 |
121
+ | 資料類型 | 建議保留期限 | 理由 |
122
+ |---------|------------|------|
123
+ | Session 資料 | Session 期間 | 登出後即不再需要 |
124
+ | 活動日誌 | 90 天 | 除錯與支援 |
125
+ | 帳號資料 | 帳號刪除後 + 30 天 | 復原的寬限期 |
126
+ | 交易記錄 | 7 年 | 稅務/稽核合規 |
127
+ | 行銷偏好 | 直到撤回同意 | 以同意為基礎 |
128
+
129
+ ---
66
130
 
67
131
  ## 使用者權利
68
132
 
133
+ 支援以下 5 項基本使用者權利:
134
+
69
135
  | 權利 | 說明 | 實作方式 |
70
136
  |------|------|---------|
71
- | **存取** | 請求個人資料副本 | 匯出端點(JSON/CSV) |
72
- | **更正** | 修正不正確的資料 | 編輯個人檔案 |
73
- | **刪除** | 請求刪除資料 | 帳號刪除流程 |
74
- | **可攜** | 以可攜格式接收資料 | 標準格式匯出 |
75
- | **反對** | 反對特定處理活動 | Opt-out 機制 |
137
+ | **存取** | 使用者可請求取得其個人資料副本 | 匯出端點,機器可讀格式(JSON/CSV) |
138
+ | **更正** | 使用者可更正不正確的個人資料 | 編輯個人檔案;非自助欄位提供支援管道 |
139
+ | **刪除**(被遺忘權) | 使用者可請求刪除其資料 | 帳號刪除流程,30 天內連帶刪除備份 |
140
+ | **資料可攜** | 使用者可以可攜格式接收其資料 | 標準格式匯出(JSON、CSV),提供批次匯出 API |
141
+ | **反對** | 使用者可反對特定處理活動 | Opt-out 機制、細粒度的同意管理 |
142
+
143
+ ---
76
144
 
77
145
  ## 隱私檢查清單
78
146
 
79
- - [ ] 所有個人資料欄位已文件化用途與法律依據
80
- - [ ] 僅收集必要資料
81
- - [ ] 已取得使用者同意(opt-in)
82
- - [ ] 保留期限已定義且自動刪除已設定
83
- - [ ] 僅授權人員可存取
84
- - [ ] 資料於靜止與傳輸中加密
85
- - [ ] 使用者可存取、更正、刪除與匯出其資料
86
- - [ ] 與第三方的資料共享已文件化
87
- - [ ] DPIA 已完成(如符合觸發條件)
88
- - [ ] 資料外洩通知流程已就位
147
+ 在推出處理個人資料的新功能前,請確認:
148
+
149
+ - [ ] **資料盤點**:所有個人資料欄位皆已文件化用途與法律依據
150
+ - [ ] **最小化**:僅收集必要資料;不收集「有了也不錯」的欄位
151
+ - [ ] **同意**:在需要時取得使用者同意(opt-in,不可預先勾選)
152
+ - [ ] **保留**:已定義保留期限並設定自動刪除
153
+ - [ ] **存取控制**:僅授權人員可存取資料
154
+ - [ ] **加密**:資料於靜止與傳輸中皆已加密
155
+ - [ ] **使用者權利**:使用者可存取、更正、刪除與匯出其資料
156
+ - [ ] **第三方**:與第三方的資料共享已文件化且合法
157
+ - [ ] **DPIA**:已完成影響評估(如符合觸發條件)
158
+ - [ ] **外洩計畫**:資料外洩通知流程已就位
159
+
160
+ ---
161
+
162
+ ## Quick Reference Card
163
+
164
+ ### 資料處理決策
165
+ ```
166
+ Is it personal data?
167
+ ├─ No → Standard handling
168
+ └─ Yes
169
+ ├─ Is it special category (health, biometric)?
170
+ │ └─ Yes → Restricted + DPIA required
171
+ └─ No
172
+ ├─ Is it identifiable (name, email)?
173
+ │ └─ Yes → Confidential
174
+ └─ No (anonymized/aggregated) → Internal
175
+ ```
176
+
177
+ ---
178
+
179
+ ## 參考資料
180
+
181
+ - [GDPR 全文](https://gdpr.eu/) — 歐盟資料保護法規
182
+ - [Privacy by Design — 七大基礎原則](https://www.ipc.on.ca/) — Ann Cavoukian
183
+ - [CCPA](https://oag.ca.gov/privacy/ccpa) — 加州消費者隱私法
184
+ - [OWASP Privacy Risks](https://owasp.org/www-project-top-10-privacy-risks/) — 十大隱私風險
89
185
 
90
186
  ---
91
187
 
92
188
  **相關標準:**
93
- - [安全標準](security-standards.md) - 資料保護的安全控制
94
- - [日誌標準](logging-standards.md) - 日誌中的 PII 處理
189
+ - [安全標準](security-standards.md) — 資料保護的安全控制
190
+ - [日誌標準](logging-standards.md) — 日誌中的 PII 處理
191
+ - [環境標準](environment-standards.md) — 機密管理
192
+ - [測試資料標準](test-data-standards.md) — 測試用資料匿名化
193
+
194
+ ---
195
+
196
+ ## 版本歷史
197
+
198
+ | 版本 | 日期 | 變更內容 |
199
+ |------|------|---------|
200
+ | 1.1.0 | 2026-06-18 | 新增:量化的「大規模」DPIA 觸發準則(GDPR 第 35 條/WP29 WP248)+ 例外條款(XSPEC-292 T8) |
201
+ | 1.0.0 | 2026-04-01 | 初始版本 |
95
202
 
96
203
  ---
97
204
 
@@ -1,17 +1,18 @@
1
1
  ---
2
2
  source: ../../../core/project-context-memory.md
3
- source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-24
6
- status: stale
3
+ source_version: 1.2.1
4
+ translation_version: 1.2.1
5
+ last_synced: 2026-10-11
6
+ source_hash: a852f1970d37
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 專案情境記憶標準
10
11
 
11
12
  > **語言**: [English](../../../core/project-context-memory.md) | 繁體中文
12
13
 
13
- **版本**: 1.1.0
14
- **最後更新**: 2026-03-16
14
+ **版本**: 1.2.1
15
+ **最後更新**: 2026-10-07
15
16
  **適用性**: 所有使用 AI 助手的軟體專案
16
17
  **範圍**: uds-specific
17
18
 
@@ -31,7 +32,7 @@ status: stale
31
32
  |------|------|------|
32
33
  | `id` | string | 唯一識別碼(`PRJ-YYYY-NNNN`) |
33
34
  | `type` | enum | `decision` / `convention` / `structure` / `glossary` |
34
- | `summary` | string | 一句話摘要 |
35
+ | `summary` | string | 情境的一句話摘要 |
35
36
  | `status` | enum | `active` / `proposed` / `deprecated` |
36
37
  | `scope` | list | 適用的檔案或目錄 |
37
38
 
@@ -42,38 +43,221 @@ status: stale
42
43
  - **目錄**: `.project-context/`
43
44
  - **格式**: `.md` 檔案
44
45
 
45
- ## 記憶類型
46
+ ---
46
47
 
47
- | 類型 | 說明 | 範例 |
48
- |------|------|------|
49
- | `decision` | 架構或技術決策 | 「使用 PostgreSQL 而非 MongoDB」 |
50
- | `convention` | 程式碼慣例 | 「API 回應必須使用 camelCase」 |
51
- | `structure` | 專案結構規則 | 「測試檔案與原始碼平行放置」 |
52
- | `glossary` | 領域術語定義 | 「'tenant' 指多租戶的獨立實例」 |
48
+ ## 1. 記憶結構
49
+
50
+ ### 1.1 完整結構定義
51
+
52
+ ```markdown
53
+ ---
54
+ id: "PRJ-2026-0001" # Required: Unique ID
55
+ type: decision # Required: Category
56
+ status: active # Required: active | proposed | deprecated
57
+ created_at: "2026-02-09" # Required: ISO date
58
+ confidence: 1.0 # Required: 0.0–1.0 (Project facts usually start high)
59
+ authors: ["user-name", "ai-assistant"]
60
+
61
+ # Scope & Triggers (Context Awareness)
62
+ scope: # Where this rule applies
63
+ - "src/api/**"
64
+ - "src/services/**"
65
+ triggers: # Keywords/patterns to wake up this memory
66
+ - "error handling"
67
+ - "API response"
68
+ - "try-catch"
69
+
70
+ # Relationships
71
+ related: ["PRJ-2026-0004"] # Related project memories
72
+ supersedes: [] # IDs of decisions this replaces
73
+ ---
74
+
75
+ # Unified API Error Handling
53
76
 
54
- ## 記憶生命週期
77
+ ## Context
78
+ We previously handled errors inconsistently across controllers, leading to frontend parsing issues.
55
79
 
80
+ ## Decision
81
+ All API endpoints must return errors in the `StandardErrorResponse` format defined in `src/types/api.ts`.
82
+ Do not throw raw exceptions in controllers; wrap them in `ApiError` class.
83
+
84
+ ## Constraint
85
+ - Forbidden: `res.status(500).json({ error: err.message })`
86
+ - Required: `next(new ApiError(500, 'internal_error', err.message))`
56
87
  ```
57
- proposed → active → deprecated
88
+
89
+ ### 1.2 ID 格式
90
+
91
+ | 組成 | 格式 | 範例 |
92
+ |------|------|------|
93
+ | 前綴 | `PRJ` | `PRJ` |
94
+ | 年份 | `YYYY` | `2026` |
95
+ | 序號 | `NNNN` | `0001` |
96
+ | 完整 | `PRJ-YYYY-NNNN` | `PRJ-2026-0001` |
97
+
98
+ ---
99
+
100
+ ## 2. 記憶類別(分類法)
101
+
102
+ | 類別 | 說明 | 範例 |
103
+ |------|------|------|
104
+ | `decision` | 架構決策記錄(輕量 ADR) | 「核心領域採用六角架構(Hexagonal Architecture)」 |
105
+ | `convention` | 強制的程式碼風格或模式 | 「所有介面名稱必須以 'I' 開頭」 |
106
+ | `structure` | 目錄職責與邊界 | 「`src/shared` 不得從 `src/features` 匯入」 |
107
+ | `glossary` | 通用語言/領域術語 | 「'User' 指管理員;'Customer' 是終端使用者」 |
108
+ | `constraint` | 硬性技術限制或禁令 | 「禁止使用 `lodash`(改用原生 ES6+)」 |
109
+ | `workflow` | 流程特定規則 | 「Migration 必須透過 CLI 產生,不可手寫 SQL」 |
110
+ | `workflow-state` | 進行中工作流程的進度追蹤 | 「Release v5.1.0 — 目前處於 beta 測試階段」 |
111
+
112
+ ---
113
+
114
+ ## 3. 操作協定
115
+
116
+ ### 3.1 主動擷取(記錄)
117
+
118
+ AI 必須主動留意對話中的「共識時刻」。
119
+
120
+ **觸發條件:**
121
+ * 「我們就約定……」
122
+ * 「從現在開始,我們使用……」
123
+ * 「架構應該是……」
124
+ * 使用者針對同一條專案特定規則反覆糾正 AI。
125
+
126
+ **工作流程:**
127
+ 1. AI 偵測到共識或規則。
128
+ 2. AI 提議:「這看起來是專案層級的決策。要我把它存到專案情境嗎?」
129
+ 3. 使用者確認。
130
+ 4. AI 產生 `.project-context/topic-name.md` 檔案。
131
+
132
+ ### 3.2 情境注入(查詢)
133
+
134
+ **觸發條件:**
135
+ * **規劃階段**:當使用者要求「建立一個功能」時,掃描 `structure` 與 `decision` 記憶。
136
+ * **編碼階段**:編輯 `scope` 內的檔案時,掃描 `convention` 記憶。
137
+ * **審查階段**:檢查程式碼是否違反 `constraint` 記憶。
138
+
139
+ **行為:**
140
+ * AI 必須在產生程式碼*之前***讀取**相關情境檔案。
141
+ * AI 在強制執行規則時必須**引用**記憶 ID(例如:「依據 PRJ-2026-0012,我在這裡使用工廠模式」)。
142
+
143
+ ### 3.3 生命週期管理(審視)
144
+
145
+ **過時偵測:**
146
+ * `scope` 中提到的檔案路徑已不存在。
147
+ * `Constraint` 中提到的程式碼模式已完全找不到。
148
+ * AI 應主動詢問:「PRJ-2025-0045 是否仍然有效?」
149
+
150
+ **棄用:**
151
+ * 當新的 `decision` 與舊的矛盾時,舊項目的 `status` 改為 `deprecated`,並在新項目中更新 `supersedes` 欄位。
152
+
153
+ ---
154
+
155
+ ## 4. 工作流程狀態追蹤
156
+
157
+ ### 4.1 目的
158
+
159
+ `workflow-state` 類型擷取進行中工作流程的**目前狀態**,讓 AI 助手能跨工作階段接續中斷的工作。不同於 `workflow` 類型(儲存流程規則),`workflow-state` 追蹤特定進行中工作流程的進度、阻礙與後續步驟。
160
+
161
+ ### 4.2 額外結構欄位
162
+
163
+ | 欄位 | 類型 | 說明 |
164
+ |------|------|------|
165
+ | `workflow` | string | 工作流程名稱(例如 `release-v5.1.0`) |
166
+ | `phase` | string | 目前步驟(例如 `beta-testing`) |
167
+ | `progress` | object | `{ completed: [], current: string, remaining: [], percentage: int }` |
168
+ | `blockers` | list | 目前阻礙進度的事項 |
169
+ | `next_steps` | list | 依序排列的後續行動 |
170
+ | `updated_at` | date | 最後更新時間戳(用於過時偵測) |
171
+
172
+ ### 4.3 範例
173
+
174
+ ```markdown
175
+ ---
176
+ id: "PRJ-2026-0042"
177
+ type: workflow-state
178
+ status: active
179
+ workflow: "release-v5.1.0"
180
+ phase: "beta-testing"
181
+ progress:
182
+ completed: ["alpha-release", "internal-validation"]
183
+ current: "beta-testing"
184
+ remaining: ["stable-release", "changelog-finalize"]
185
+ percentage: 40
186
+ blockers:
187
+ - "Waiting for CI fix on Windows tests"
188
+ next_steps:
189
+ - "Fix Windows CI (#234)"
190
+ - "Collect beta feedback"
191
+ - "Prepare stable release notes"
192
+ created_at: "2026-03-10"
193
+ updated_at: "2026-03-16"
194
+ scope: ["cli/**", "scripts/**"]
195
+ triggers: ["release", "version", "publish"]
196
+ ---
197
+
198
+ # Release v5.1.0 Workflow State
199
+
200
+ ## Current Phase: Beta Testing
201
+ Beta v5.1.0-beta.1 published on 2026-03-14.
58
202
  ```
59
203
 
60
- | 狀態 | 說明 |
61
- |------|------|
62
- | `proposed` | 新提出但尚未團隊確認的項目 |
63
- | `active` | 已確認且必須遵守的項目 |
64
- | `deprecated` | 已過時但保留供歷史參考 |
204
+ ### 4.4 主動行為
205
+
206
+ | 觸發條件 | AI 行動 |
207
+ |----------|---------|
208
+ | 工作階段開始 | 掃描 active 的 `workflow-state` 項目,呈現摘要 |
209
+ | `updated_at` 超過 7 天 | 標記為過時,詢問要封存或繼續 |
210
+ | 所有 `remaining` 步驟皆已完成 | 建議封存該工作流程狀態 |
211
+
212
+ > 7 天過時門檻是 UDS 預設值,可依專案調整。依據:
213
+ > 在短週期開發中,超過一週未更新的工作流程狀態很可能已被放棄或取代;
214
+ > 此門檻與 developer-memory 的過時模型一致。長期或兼職專案可將其拉長。
215
+
216
+ ---
217
+
218
+ ## 5. 與開發者記憶的比較
219
+
220
+ | 特性 | 開發者記憶(`core/developer-memory.md`) | 專案情境記憶(`core/project-context-memory.md`) |
221
+ | :--- | :--- | :--- |
222
+ | **範圍** | 通用/跨專案 | **本地/專案特定** |
223
+ | **隱私** | 去識別化(嚴格) | **可識別**(允許特定路徑/名稱) |
224
+ | **內容** | 「如何使用 React useEffect」 | 「我們在**這個** app 中如何使用 React」 |
225
+ | **儲存** | `.memory/`(全域/使用者) | `.project-context/`(Repo) |
226
+ | **目標** | 技能習得 | **一致性與合規** |
227
+
228
+ ---
229
+
230
+ ## 6. 架構決策
231
+
232
+ ### 6.1 「常駐」協定
233
+ 如同開發者記憶,專案情境是一個**常駐協定(Always-On Protocol)**。AI 不需要明確指令就會使用它,它是 agent 環境「物理法則」的一部分。
234
+
235
+ ### 6.2 儲存策略
236
+ 我們採用**分檔儲存**(每個主題一個 Markdown 檔),而非單一龐大的 `GEMINI.md` 或 JSON 檔。
237
+ * **理由 1**:對 Git 友善的 diff。
238
+ * **理由 2**:較低的 token 用量(AI 只依 `scope/triggers` 讀取相關檔案)。
239
+ * **理由 3**:人類可讀的文件。
65
240
 
66
- ## AI 助手行為
241
+ ---
242
+
243
+ ## 邊界:本標準不放什麼
244
+
245
+ - **個人、跨專案、可識別的資訊**(誰負責什麼、怎麼連到某個環境)不是專案情境:這裡的條目放在 repo 裡,會被每個 clone 它的人看到。把它們放在使用者自己的 AI 工具記憶,不要放進 `.project-context/`。
246
+ - **專案之間的協調**(哪件工作在等哪件工作)是開放工作,不是情境:見 [Open Work Tracking](open-work-tracking.md)(OWT-027–OWT-029)。
247
+
248
+ ---
249
+
250
+ ## 版本歷史
67
251
 
68
- 當 AI 助手在專案中工作時:
252
+ | 版本 | 日期 | 變更 |
253
+ |------|------|------|
254
+ | 1.2.1 | 2026-10-07 | 新增:「邊界」章節——個人、跨專案、可識別的資訊以及專案之間的協調,不屬於 repo 的專案情境(XSPEC-460 R5;patch,無行為變更) |
255
+ | 1.2.0 | 2026-06-18 | 新增:7 天過時門檻的依據與可調整說明(XSPEC-292 T8) |
256
+ | 1.1.0 | 2026-03-16 | 新增 `workflow-state` 類型,用於跨工作階段狀態追蹤 |
257
+ | 1.0.0 | 2026-02-09 | 初始標準定義 |
69
258
 
70
- 1. **載入** — 在工作階段開始時讀取 `.project-context/` 中的所有 `active` 項目
71
- 2. **遵守** — 所有建議和程式碼生成必須符合活躍的記憶項目
72
- 3. **提議** — 發現新的隱含慣例時,建議建立新的記憶項目
73
- 4. **衝突** — 如果使用者請求與活躍記憶衝突,必須提醒使用者
259
+ ---
74
260
 
75
- ## 相關標準
261
+ ## 授權
76
262
 
77
- - [情境感知載入](context-aware-loading.md)
78
- - [反幻覺標準](anti-hallucination.md)
79
- - [AI 協議標準](ai-agreement-standards.md)
263
+ 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。