universal-dev-standards 6.14.0-beta.9 → 6.14.0
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.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/versioning.md +737 -73
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +2 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +2 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/.claude-plugin/plugin.json +71 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +72 -3
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec.js +4 -2
- package/src/commands/update.js +173 -20
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +106 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -1,20 +1,21 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/frontend-design-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: c9dc85d8ce95
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 前端设计标准
|
|
10
11
|
|
|
11
|
-
> **语言**: [English](../../../core/frontend-design-standards.md) | 简体中文
|
|
12
|
+
> **语言**: [English](../../../core/frontend-design-standards.md) | [繁體中文](../../zh-TW/core/frontend-design-standards.md) | 简体中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最后更新**: 2026-
|
|
15
|
-
**状态**: Active
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最后更新**: 2026-07-10
|
|
16
16
|
**适用范围**: 所有具备前端用户界面的项目
|
|
17
|
-
|
|
17
|
+
**范围**: universal
|
|
18
|
+
**参考**: [DEC-029](https://github.com/VoltAgent/awesome-design-md) (awesome-design-md, MIT), DEC-030 (OpenAI Frontend Guide)
|
|
18
19
|
|
|
19
20
|
---
|
|
20
21
|
|
|
@@ -22,19 +23,42 @@ status: stale
|
|
|
22
23
|
|
|
23
24
|
本标准定义一套机器可读的前端设计规格格式(DESIGN.md),用于 AI 辅助开发。建立 9 段式 DESIGN.md 结构、强制设计 token 词汇、UI 硬性约束,以及反模式拒绝规则。
|
|
24
25
|
|
|
25
|
-
|
|
26
|
+
目标是通过提供结构化设计约束——而非自由形式的风格描述——来确保 AI Agent 在不同运行中产生一致、高质量的 UI。
|
|
26
27
|
|
|
27
28
|
**核心原则**:
|
|
28
|
-
- DESIGN.md
|
|
29
|
+
- DESIGN.md 作为设计规格的唯一真实来源
|
|
29
30
|
- 语义化 token 命名(框架无关)
|
|
30
|
-
-
|
|
31
|
-
-
|
|
31
|
+
- 基于约束的提示:自由度越少 = UI 质量越高
|
|
32
|
+
- 与源代码一同进行版本控制
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 目录
|
|
37
|
+
|
|
38
|
+
1. [DESIGN.md 结构](#designmd-structure)
|
|
39
|
+
2. [第 1 段:视觉主题与氛围](#section-1-visual-theme--mood)
|
|
40
|
+
3. [第 2 段:色彩系统](#section-2-color-palette)
|
|
41
|
+
4. [第 3 段:字体系统](#section-3-typography)
|
|
42
|
+
5. [第 4 段:组件样式](#section-4-component-styling)
|
|
43
|
+
6. [第 5 段:版面与间距](#section-5-layout--spacing)
|
|
44
|
+
7. [第 6 段:层次感与阴影系统](#section-6-depth--shadow-system)
|
|
45
|
+
8. [第 7 段:设计准则与反模式](#section-7-design-guidelines--anti-patterns)
|
|
46
|
+
9. [第 8 段:响应式行为](#section-8-responsive-behavior)
|
|
47
|
+
10. [第 9 段:Agent 提示参考](#section-9-agent-prompt-references)
|
|
48
|
+
11. [语义色彩 Token](#semantic-color-tokens)
|
|
49
|
+
12. [字体角色](#typography-roles)
|
|
50
|
+
13. [间距尺度](#spacing-scale)
|
|
51
|
+
14. [UI 硬性约束](#ui-hard-constraints)
|
|
52
|
+
15. [反模式](#anti-patterns)
|
|
53
|
+
16. [可选扩展:Token 插值与结构化组件](#optional-extension-token-interpolation--structured-components)
|
|
54
|
+
17. [DESIGN.md 文件位置](#designmd-file-placement)
|
|
55
|
+
18. [验证清单](#validation-checklist)
|
|
32
56
|
|
|
33
57
|
---
|
|
34
58
|
|
|
35
59
|
## DESIGN.md 结构
|
|
36
60
|
|
|
37
|
-
DESIGN.md 是放在项目根目录的 Markdown
|
|
61
|
+
DESIGN.md 是放在项目根目录的 Markdown 文件,作为机器可读的设计规格书。使用人类与 AI Agent 皆可读取的结构化 Markdown。
|
|
38
62
|
|
|
39
63
|
```
|
|
40
64
|
传统方式:Figma 设计稿 → 人类开发者 → 代码
|
|
@@ -70,30 +94,73 @@ DESIGN.md = 给 AI 读的设计规格书
|
|
|
70
94
|
**目的**:定义产品的整体美学意图。AI Agent 在生成 UI 时以此作为高层次约束。
|
|
71
95
|
|
|
72
96
|
**必填字段**:
|
|
73
|
-
- `theme`:
|
|
74
|
-
- `mood`:
|
|
75
|
-
- `inspiration`:
|
|
97
|
+
- `theme`: 单行风格描述(例如“极简、专业、数据密集”)
|
|
98
|
+
- `mood`: 情感品质(例如“沉稳、专注、可信赖”)
|
|
99
|
+
- `inspiration`: 参考产品或设计流派(例如“Linear、Stripe dashboard”)
|
|
76
100
|
- `dark-mode`: 深色模式是 primary / secondary / 不支持
|
|
77
101
|
|
|
102
|
+
**示例**:
|
|
103
|
+
```markdown
|
|
104
|
+
## Visual Theme & Mood
|
|
105
|
+
|
|
106
|
+
- **Theme**: Minimal, professional, data-dense
|
|
107
|
+
- **Mood**: Calm, focused, trustworthy
|
|
108
|
+
- **Inspiration**: Linear app, Stripe dashboard
|
|
109
|
+
- **Dark Mode**: Primary (dark-first design)
|
|
110
|
+
```
|
|
111
|
+
|
|
78
112
|
---
|
|
79
113
|
|
|
80
114
|
## 第 2 段:色彩系统
|
|
81
115
|
|
|
82
|
-
|
|
116
|
+
**目的**:定义完整的语义色彩系统。所有颜色均表示为具名的语义 token——不直接在代码中使用原始 hex 值。
|
|
83
117
|
|
|
84
|
-
**必填**:全部 5 个语义 token
|
|
118
|
+
**必填**:全部 5 个语义 token(参见[语义色彩 Token](#semantic-color-tokens))
|
|
85
119
|
|
|
86
120
|
**选填**:状态扩展 token(error、warning、success、info)、border、overlay。
|
|
87
121
|
|
|
122
|
+
**示例**:
|
|
123
|
+
```markdown
|
|
124
|
+
## Color Palette
|
|
125
|
+
|
|
126
|
+
### Semantic Tokens (Required)
|
|
127
|
+
- **background**: `#0A0A0A` — Page background
|
|
128
|
+
- **surface**: `#1A1A1A` — Cards, panels, modals
|
|
129
|
+
- **primary-text**: `#F5F5F5` — Main body text
|
|
130
|
+
- **muted-text**: `#888888` — Secondary text, placeholders
|
|
131
|
+
- **accent**: `#6366F1` — CTA buttons, links, highlights
|
|
132
|
+
|
|
133
|
+
### Extended Tokens (Optional)
|
|
134
|
+
- **error**: `#EF4444`
|
|
135
|
+
- **warning**: `#F59E0B`
|
|
136
|
+
- **success**: `#10B981`
|
|
137
|
+
- **border**: `#2A2A2A`
|
|
138
|
+
```
|
|
139
|
+
|
|
88
140
|
---
|
|
89
141
|
|
|
90
142
|
## 第 3 段:字体系统
|
|
91
143
|
|
|
92
144
|
**目的**:定义字体家族与字体层级角色。约束 AI 最多使用 2 个字体家族。
|
|
93
145
|
|
|
94
|
-
**必填**:全部 4
|
|
146
|
+
**必填**:全部 4 个字体角色定义(参见[字体角色](#typography-roles))
|
|
95
147
|
|
|
96
|
-
**约束**:最多 2 个字体家族(display + body)。使用 3
|
|
148
|
+
**约束**:最多 2 个字体家族(display + body)。使用 3 个以上属于反模式。
|
|
149
|
+
|
|
150
|
+
**示例**:
|
|
151
|
+
```markdown
|
|
152
|
+
## Typography
|
|
153
|
+
|
|
154
|
+
### Font Families (max 2)
|
|
155
|
+
- **Display font**: Inter (headings, display text)
|
|
156
|
+
- **Body font**: Inter (same family, different weights acceptable)
|
|
157
|
+
|
|
158
|
+
### Typographic Scale
|
|
159
|
+
- **display**: 48px+, weight 700, line-height 1.1 — Hero titles
|
|
160
|
+
- **headline**: 24–32px, weight 600, line-height 1.3 — Section headings
|
|
161
|
+
- **body**: 16px, weight 400, line-height 1.6 — Main content
|
|
162
|
+
- **caption**: 12–14px, weight 400, line-height 1.4 — Labels, metadata
|
|
163
|
+
```
|
|
97
164
|
|
|
98
165
|
---
|
|
99
166
|
|
|
@@ -107,122 +174,237 @@ DESIGN.md = 给 AI 读的设计规格书
|
|
|
107
174
|
- 输入框样式
|
|
108
175
|
- 卡片 / surface 样式
|
|
109
176
|
|
|
177
|
+
**示例**:
|
|
178
|
+
```markdown
|
|
179
|
+
## Component Styling
|
|
180
|
+
|
|
181
|
+
### Border Radius
|
|
182
|
+
- **sm**: 4px (small elements, badges)
|
|
183
|
+
- **md**: 8px (buttons, inputs)
|
|
184
|
+
- **lg**: 12px (cards, modals)
|
|
185
|
+
- **full**: 9999px (pill badges, avatars)
|
|
186
|
+
|
|
187
|
+
### Buttons
|
|
188
|
+
- **Primary**: `accent` background, `#FFFFFF` text, `md` radius
|
|
189
|
+
- **Secondary**: `surface` background, `primary-text` text, `md` radius, 1px border
|
|
190
|
+
- **Ghost**: Transparent background, `accent` text, no border
|
|
191
|
+
|
|
192
|
+
### Inputs
|
|
193
|
+
- Background: `surface`
|
|
194
|
+
- Border: 1px solid `border`
|
|
195
|
+
- Focus: 2px ring in `accent`
|
|
196
|
+
- Radius: `md`
|
|
197
|
+
```
|
|
198
|
+
|
|
110
199
|
---
|
|
111
200
|
|
|
112
201
|
## 第 5 段:版面与间距
|
|
113
202
|
|
|
114
|
-
|
|
203
|
+
**目的**:定义间距尺度与网格系统。基于 8px 基础网格,定义 7 个间距步骤。
|
|
204
|
+
|
|
205
|
+
**必填**:标准尺度的全部 7 个间距步骤(参见[间距尺度](#spacing-scale))
|
|
206
|
+
|
|
207
|
+
**示例**:
|
|
208
|
+
```markdown
|
|
209
|
+
## Layout & Spacing
|
|
115
210
|
|
|
116
|
-
|
|
211
|
+
### Spacing Scale (8px base)
|
|
212
|
+
- **space-1**: 4px
|
|
213
|
+
- **space-2**: 8px
|
|
214
|
+
- **space-3**: 16px
|
|
215
|
+
- **space-4**: 24px
|
|
216
|
+
- **space-5**: 32px
|
|
217
|
+
- **space-6**: 48px
|
|
218
|
+
- **space-8**: 64px
|
|
219
|
+
|
|
220
|
+
### Grid
|
|
221
|
+
- **Columns**: 12-column grid
|
|
222
|
+
- **Gutter**: space-4 (24px)
|
|
223
|
+
- **Max content width**: 1280px
|
|
224
|
+
- **Page padding**: space-4 (24px) on mobile, space-6 (48px) on desktop
|
|
225
|
+
```
|
|
117
226
|
|
|
118
227
|
---
|
|
119
228
|
|
|
120
229
|
## 第 6 段:层次感与阴影系统
|
|
121
230
|
|
|
122
|
-
|
|
231
|
+
**目的**:以阴影定义高度层级。在不依赖颜色的情况下建立视觉层级。
|
|
232
|
+
|
|
233
|
+
**必填字段**:至少 3 个高度层级。
|
|
234
|
+
|
|
235
|
+
**示例**:
|
|
236
|
+
```markdown
|
|
237
|
+
## Depth & Shadow System
|
|
123
238
|
|
|
124
|
-
|
|
239
|
+
- **elevation-0**: No shadow (flat, on-surface elements)
|
|
240
|
+
- **elevation-1**: `0 1px 2px rgba(0,0,0,0.4)` (subtle, cards at rest)
|
|
241
|
+
- **elevation-2**: `0 4px 8px rgba(0,0,0,0.3)` (dropdowns, tooltips)
|
|
242
|
+
- **elevation-3**: `0 8px 24px rgba(0,0,0,0.5)` (modals, dialogs)
|
|
243
|
+
- **elevation-4**: `0 16px 48px rgba(0,0,0,0.6)` (full-screen overlays)
|
|
244
|
+
```
|
|
125
245
|
|
|
126
246
|
---
|
|
127
247
|
|
|
128
248
|
## 第 7 段:设计准则与反模式
|
|
129
249
|
|
|
130
|
-
|
|
250
|
+
**目的**:为 AI Agent 制定明确的规则和禁止的 UI 模式。此段落是约束式提示的主要机制。
|
|
131
251
|
|
|
132
252
|
**必填子段落**:
|
|
133
253
|
1. UI 硬性约束(≥4 条规则)
|
|
134
254
|
2. 反模式清单(≥5 个禁止模式)
|
|
135
255
|
|
|
256
|
+
标准清单参见 [UI 硬性约束](#ui-hard-constraints) 与 [反模式](#anti-patterns)。
|
|
257
|
+
|
|
258
|
+
**示例**:
|
|
259
|
+
```markdown
|
|
260
|
+
## Design Guidelines & Anti-patterns
|
|
261
|
+
|
|
262
|
+
### UI Hard Constraints
|
|
263
|
+
- Maximum 1 H1 per page
|
|
264
|
+
- Maximum 6 sections per page
|
|
265
|
+
- Maximum 2 font families
|
|
266
|
+
- Maximum 1 accent color (never mix multiple accent colors)
|
|
267
|
+
- Information hierarchy: Hero → Support → Detail → CTA
|
|
268
|
+
|
|
269
|
+
### Anti-patterns (Forbidden)
|
|
270
|
+
- No floating badges (浮動徽章)
|
|
271
|
+
- No generic card layout as primary content structure
|
|
272
|
+
- No dashboard grid as homepage
|
|
273
|
+
- No more than 3 levels of visual nesting
|
|
274
|
+
- No color-only differentiation (always pair with icon or label)
|
|
275
|
+
- No decorative illustrations that don't serve information
|
|
276
|
+
- No competing CTAs of equal visual weight on the same screen
|
|
277
|
+
```
|
|
278
|
+
|
|
136
279
|
---
|
|
137
280
|
|
|
138
281
|
## 第 8 段:响应式行为
|
|
139
282
|
|
|
140
|
-
**目的**:定义断点与响应式规则。必须采用 Mobile-first
|
|
283
|
+
**目的**:定义断点与响应式规则。必须采用 Mobile-first 方法。
|
|
284
|
+
|
|
285
|
+
**必填字段**:至少 3 个断点(移动端、平板、桌面端)。
|
|
141
286
|
|
|
142
|
-
|
|
287
|
+
**示例**:
|
|
288
|
+
```markdown
|
|
289
|
+
## Responsive Behavior
|
|
290
|
+
|
|
291
|
+
### Breakpoints (Mobile-first)
|
|
292
|
+
- **xs**: < 480px (small phones)
|
|
293
|
+
- **sm**: ≥ 768px (tablets)
|
|
294
|
+
- **md**: ≥ 1024px (laptops)
|
|
295
|
+
- **lg**: ≥ 1280px (desktops)
|
|
296
|
+
- **xl**: ≥ 1536px (wide screens)
|
|
297
|
+
|
|
298
|
+
### Rules
|
|
299
|
+
- Mobile-first CSS (min-width media queries)
|
|
300
|
+
- Single column on xs/sm, multi-column on md+
|
|
301
|
+
- Touch targets ≥ 44×44px on mobile
|
|
302
|
+
- Navigation collapses to hamburger/bottom bar on sm and below
|
|
303
|
+
```
|
|
143
304
|
|
|
144
305
|
---
|
|
145
306
|
|
|
146
307
|
## 第 9 段:Agent 提示参考
|
|
147
308
|
|
|
148
|
-
|
|
309
|
+
**目的**:设计意图的精炼、AI 优化摘要。AI Agent 在查阅其他段落之前,应先阅读此段落作为快速定向。
|
|
149
310
|
|
|
150
311
|
**必填字段**:
|
|
151
|
-
- `style-summary
|
|
152
|
-
- `key-constraints
|
|
153
|
-
- `tone
|
|
312
|
+
- `style-summary`:1–2 句设计意图
|
|
313
|
+
- `key-constraints`:最关键规则的项目符号列表
|
|
314
|
+
- `tone`:设计带给用户的“感受”
|
|
315
|
+
|
|
316
|
+
**示例**:
|
|
317
|
+
```markdown
|
|
318
|
+
## Agent Prompt References
|
|
319
|
+
|
|
320
|
+
### Style Summary
|
|
321
|
+
Dark, minimal, data-focused interface. Professional aesthetic prioritizing clarity over decoration.
|
|
322
|
+
|
|
323
|
+
### Key Constraints for AI Generation
|
|
324
|
+
- Always use semantic token names (background, surface, accent) — never raw hex in components
|
|
325
|
+
- Every page has exactly 1 H1; sections ≤ 6
|
|
326
|
+
- accent (#6366F1) is the only allowed emphasis color
|
|
327
|
+
- Prefer text over decorative components; restraint over complexity
|
|
328
|
+
|
|
329
|
+
### Tone
|
|
330
|
+
Calm, confident, technical. Similar to Linear or Vercel's dashboard aesthetic.
|
|
331
|
+
```
|
|
154
332
|
|
|
155
333
|
---
|
|
156
334
|
|
|
157
335
|
## 语义色彩 Token
|
|
158
336
|
|
|
159
|
-
|
|
337
|
+
以下 5 个语义色彩 token 在每个 DESIGN.md 中都是**必填**的。它们与框架无关,且必须使用这些完全相同的名称。
|
|
160
338
|
|
|
161
|
-
| Token | 角色 |
|
|
162
|
-
|
|
163
|
-
| `background` |
|
|
164
|
-
| `surface` |
|
|
165
|
-
| `primary-text` |
|
|
166
|
-
| `muted-text` |
|
|
167
|
-
| `accent` | CTA
|
|
339
|
+
| Token | 角色 | 映射至(示例) |
|
|
340
|
+
|-------|------|-------------------|
|
|
341
|
+
| `background` | 页面/应用背景 | `#0A0A0A`(深色)/ `#FFFFFF`(浅色) |
|
|
342
|
+
| `surface` | 卡片、面板、模态框 | `#1A1A1A`(深色)/ `#F9FAFB`(浅色) |
|
|
343
|
+
| `primary-text` | 主要正文文本 | `#F5F5F5`(深色)/ `#111827`(浅色) |
|
|
344
|
+
| `muted-text` | 次要文本、占位符 | `#888888`(深色)/ `#6B7280`(浅色) |
|
|
345
|
+
| `accent` | CTA 按钮、链接、高亮 | `#6366F1`(靛蓝示例) |
|
|
168
346
|
|
|
169
347
|
**规则**:
|
|
170
|
-
- Token 名称为 kebab-case
|
|
348
|
+
- Token 名称为 kebab-case,且必须完全匹配
|
|
171
349
|
- 每个 token 必须定义 hex 值
|
|
172
|
-
- `accent`
|
|
173
|
-
- 扩展 token(error、warning、success
|
|
350
|
+
- `accent` 必须是单一颜色——严禁使用多个强调色
|
|
351
|
+
- 扩展 token(error、warning、success)为选填,但必须遵循相同的命名模式
|
|
174
352
|
|
|
175
353
|
---
|
|
176
354
|
|
|
177
355
|
## 字体角色
|
|
178
356
|
|
|
179
|
-
|
|
357
|
+
以下 4 个字体层级角色在每个 DESIGN.md 中都是**必填**的:
|
|
180
358
|
|
|
181
359
|
| 角色 | 大小 | 字重 | 行高 | 用途 |
|
|
182
|
-
|
|
183
|
-
| `display` | 48px+ | 700 | 1.1 |
|
|
184
|
-
| `headline` | 24–32px | 600 | 1.3 |
|
|
185
|
-
| `body` | 16px | 400 | 1.6 |
|
|
186
|
-
| `caption` | 12–14px | 400 | 1.4 |
|
|
360
|
+
|------|------|--------|-------------|-------|
|
|
361
|
+
| `display` | 48px+ | 700 | 1.1 | Hero 标题、展示文字 |
|
|
362
|
+
| `headline` | 24–32px | 600 | 1.3 | 小节标题、卡片标题 |
|
|
363
|
+
| `body` | 16px | 400 | 1.6 | 段落、主要内容 |
|
|
364
|
+
| `caption` | 12–14px | 400 | 1.4 | 标签、元数据、辅助文本 |
|
|
187
365
|
|
|
188
366
|
**规则**:
|
|
189
|
-
-
|
|
190
|
-
- 4
|
|
191
|
-
-
|
|
367
|
+
- 角色名称为小写,且必须完全匹配
|
|
368
|
+
- 全部 4 个角色中最多使用 2 个字体家族
|
|
369
|
+
- 字体大小为最小值;允许响应式缩放
|
|
370
|
+
- `display` 和 `headline` 可共用一个字体家族;`body` 和 `caption` 共用另一个(或相同)
|
|
192
371
|
|
|
193
372
|
---
|
|
194
373
|
|
|
195
374
|
## 间距尺度
|
|
196
375
|
|
|
197
|
-
|
|
376
|
+
标准间距尺度采用 8px 基础网格,包含 7 个命名步骤:
|
|
198
377
|
|
|
199
378
|
| Token | 值 | 用途 |
|
|
200
|
-
|
|
201
|
-
| `space-1` | 4px |
|
|
202
|
-
| `space-2` | 8px |
|
|
379
|
+
|-------|-------|-------|
|
|
380
|
+
| `space-1` | 4px | 图标内边距、紧凑元素 |
|
|
381
|
+
| `space-2` | 8px | 默认元素内边距 |
|
|
203
382
|
| `space-3` | 16px | 组件内部间距 |
|
|
204
|
-
| `space-4` | 24px |
|
|
383
|
+
| `space-4` | 24px | 小节内边距、槽道(gutters) |
|
|
205
384
|
| `space-5` | 32px | 组件之间 |
|
|
206
|
-
| `space-6` | 48px |
|
|
207
|
-
| `space-8` | 64px |
|
|
385
|
+
| `space-6` | 48px | 主要小节之间 |
|
|
386
|
+
| `space-8` | 64px | 页面级分隔 |
|
|
208
387
|
|
|
209
388
|
**规则**:
|
|
210
|
-
-
|
|
211
|
-
- `space-7`
|
|
389
|
+
- 代码中的所有间距必须使用这些步骤 token,不得使用任意像素值
|
|
390
|
+
- `space-7` 为刻意跳过(直接跳至 space-8 = 64px 以保持视觉节奏)
|
|
391
|
+
- 响应式调整仍必须使用尺度步骤(例如移动端使用 space-4,桌面端使用 space-6)
|
|
212
392
|
|
|
213
393
|
---
|
|
214
394
|
|
|
215
395
|
## UI 硬性约束
|
|
216
396
|
|
|
397
|
+
这些约束适用于本标准下生成的每个 UI。它们践行了约束式提示:限制自由度可产生质量更高、更一致的 UI。
|
|
398
|
+
|
|
217
399
|
| 约束 | 规则 | 理由 |
|
|
218
|
-
|
|
219
|
-
| H1 数量 | 每页最多 1 个 H1 |
|
|
220
|
-
|
|
|
221
|
-
| 字体家族 | 最多 2 个字体家族 |
|
|
222
|
-
| 强调色 | 最多 1 个强调色 |
|
|
400
|
+
|-----------|------|-----------|
|
|
401
|
+
| H1 数量 | 每页最多 1 个 H1 | 清晰的内容层级 |
|
|
402
|
+
| 小节数量 | 每页最多 6 个小节 | 防止认知过载 |
|
|
403
|
+
| 字体家族 | 最多 2 个字体家族 | 视觉连贯性 |
|
|
404
|
+
| 强调色 | 最多 1 个强调色 | 防止视觉噪点 |
|
|
223
405
|
| 嵌套深度 | 最多 3 层视觉嵌套 | 可读性 |
|
|
224
406
|
| 信息层级 | Hero → Support → Detail → CTA | 叙事结构 |
|
|
225
|
-
|
|
|
407
|
+
| 触摸目标 | 移动端最小 44×44px | 无障碍设计 |
|
|
226
408
|
|
|
227
409
|
---
|
|
228
410
|
|
|
@@ -230,18 +412,100 @@ DESIGN.md = 给 AI 读的设计规格书
|
|
|
230
412
|
|
|
231
413
|
以下 UI 模式为**禁止**。AI Agent 在生成前端代码或设计规格时必须拒绝这些模式。
|
|
232
414
|
|
|
233
|
-
| 反模式 | 说明 |
|
|
234
|
-
|
|
235
|
-
| `floating-badge` |
|
|
236
|
-
| `generic-card-layout` |
|
|
237
|
-
| `dashboard-grid-as-homepage` |
|
|
238
|
-
| `competing-ctas` |
|
|
239
|
-
| `color-only-differentiation` |
|
|
240
|
-
| `decorative-overload` |
|
|
241
|
-
| `triple-nesting` | 视觉层级超过 3 层 |
|
|
242
|
-
| `rainbow-accents` |
|
|
415
|
+
| 反模式 | 说明 | 推荐替代方案 |
|
|
416
|
+
|-------------|-------------|----------------------|
|
|
417
|
+
| `floating-badge` | 脱离内容独立浮动的徽章 | 行内标签或状态指示器 |
|
|
418
|
+
| `generic-card-layout` | 以完全相同且无差异化的卡片堆叠作为主要内容 | 具有清晰层级的多样化内容结构 |
|
|
419
|
+
| `dashboard-grid-as-homepage` | 营销首页看起来像数据仪表盘 | 采用 Hero → Support → CTA 结构的叙事型首页 |
|
|
420
|
+
| `competing-ctas` | 同一屏幕上出现视觉权重相同的多个 CTA | 一个主要 CTA,零个或一个次要 CTA |
|
|
421
|
+
| `color-only-differentiation` | 仅使用颜色来传达状态或类别 | 将颜色与图标、图案或文本标签搭配使用 |
|
|
422
|
+
| `decorative-overload` | 不传达信息的插图或动画 | 移除装饰性元素;优先采用功能性视觉元素 |
|
|
423
|
+
| `triple-nesting` | 视觉层级超过 3 层 | 扁平化结构;使用留白进行分隔 |
|
|
424
|
+
| `rainbow-accents` | 多种强调/高亮颜色(紫色 CTA、橙色徽章、绿色标签) | 单一强调色系统 |
|
|
425
|
+
|
|
426
|
+
最低要求:每个 DESIGN.md 的第 7 段中必须明确列出至少 5 个反模式。
|
|
427
|
+
|
|
428
|
+
---
|
|
429
|
+
|
|
430
|
+
## 可选扩展:Token 插值与结构化组件
|
|
431
|
+
|
|
432
|
+
> **状态**:可选、试验性(新增于 v1.1.0,2026-07-10)。**不**替代上述必填的 9 段式结构或经治理收敛的 5-token / 4-角色 / 7-步骤尺度——这是针对希望 DESIGN.md 本身承载结构化 token 引用而不仅是散文叙述的项目所提供的附加机器可解析层。省略此扩展的 DESIGN.md 依然完全合规。
|
|
433
|
+
>
|
|
434
|
+
> **来源**:2026-07-10 对 [DEC-029](https://github.com/VoltAgent/awesome-design-md) 上游(从 4,385★ 增长到 99,219★,现已正式成为 Google Stitch DESIGN.md 格式)的重新对齐审查发现,上游格式发展出了 YAML frontmatter token 字典和 `{category.token}` 插值语法,以及结构化的 `components:` 绑定块——这些是本标准原有的仅散文段落所不具备的功能。作为选用扩展而非破坏性变更被采纳,与本标准深思熟虑的 5-token 治理收敛保持一致(增加更多 token *不是*目标;让这 5 个 token *可被引用*才是)。
|
|
435
|
+
|
|
436
|
+
### Token 注册表(YAML Frontmatter)
|
|
437
|
+
|
|
438
|
+
DESIGN.md 可以选择以一个 YAML frontmatter 块开头,以机器可解析的键值形式声明来自第 2/3/5 段的语义 token(以及第 4 段的圆角尺度),以便工具能够在无需重新解析散文叙述的情况下解析 `{category.token}` 引用。
|
|
439
|
+
|
|
440
|
+
```yaml
|
|
441
|
+
---
|
|
442
|
+
colors:
|
|
443
|
+
background: "#0A0A0A"
|
|
444
|
+
surface: "#1A1A1A"
|
|
445
|
+
primary-text: "#F5F5F5"
|
|
446
|
+
muted-text: "#888888"
|
|
447
|
+
accent: "#6366F1"
|
|
448
|
+
typography:
|
|
449
|
+
display: { size: "48px", weight: 700, line-height: 1.1 }
|
|
450
|
+
headline: { size: "24px", weight: 600, line-height: 1.3 }
|
|
451
|
+
body: { size: "16px", weight: 400, line-height: 1.6 }
|
|
452
|
+
caption: { size: "13px", weight: 400, line-height: 1.4 }
|
|
453
|
+
rounded:
|
|
454
|
+
sm: "4px"
|
|
455
|
+
md: "8px"
|
|
456
|
+
lg: "12px"
|
|
457
|
+
pill: "9999px"
|
|
458
|
+
spacing:
|
|
459
|
+
sm: "8px"
|
|
460
|
+
md: "24px"
|
|
461
|
+
lg: "48px"
|
|
462
|
+
---
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
**规则**:
|
|
466
|
+
- frontmatter 键(`colors`、`typography`、`rounded`、`spacing`)与第 2/3/5 段中已定义的 token 词汇 1:1 映射——此区块以可解析的形式**重申**这些 token,它不会引入新的 token。`colors` 的值必须匹配 5 个必填的语义 token(加上已在使用的任何可选扩展 token)。
|
|
467
|
+
- Frontmatter 是可选的。没有它的 DESIGN.md 依然有效;需要插值支持的工具则需要它。
|
|
468
|
+
|
|
469
|
+
### 插值语法
|
|
470
|
+
|
|
471
|
+
在散文叙述段落中(特别是第 4 段:组件样式),`{category.token}` 引用 frontmatter 注册表,而不是重申原始值:
|
|
472
|
+
|
|
473
|
+
```markdown
|
|
474
|
+
### Buttons
|
|
475
|
+
- **Primary**: `{colors.accent}` background, `{colors.background}` text, `{rounded.md}` radius, `{spacing.sm}` padding
|
|
476
|
+
```
|
|
477
|
+
|
|
478
|
+
**规则**:
|
|
479
|
+
- 语法为 `{category.token}`——category 匹配 frontmatter 的顶层键,token 匹配其内部的键。
|
|
480
|
+
- 引用 frontmatter 中不存在的 category/token 属于验证错误,而不是静默回退。
|
|
481
|
+
- 插值是为了**文档/工具清晰度**,而非运行时模板引擎——DESIGN.md 依然是静态规格文件。
|
|
482
|
+
|
|
483
|
+
### 结构化组件块(可选)
|
|
484
|
+
|
|
485
|
+
第 4 段(组件样式)可以选择包含一个 `components:` 块,显式地将组件绑定到其 token 引用,以替代(或并存于)第 4 段示例中已有的散文叙述格式:
|
|
486
|
+
|
|
487
|
+
```yaml
|
|
488
|
+
components:
|
|
489
|
+
button-primary:
|
|
490
|
+
backgroundColor: "{colors.accent}"
|
|
491
|
+
textColor: "{colors.background}"
|
|
492
|
+
rounded: "{rounded.md}"
|
|
493
|
+
padding: "{spacing.sm}"
|
|
494
|
+
card:
|
|
495
|
+
backgroundColor: "{colors.surface}"
|
|
496
|
+
rounded: "{rounded.lg}"
|
|
497
|
+
padding: "{spacing.md}"
|
|
498
|
+
```
|
|
243
499
|
|
|
244
|
-
|
|
500
|
+
**规则**:
|
|
501
|
+
- 每个值都必须是 `{category.token}` 引用——`components:` 内部的原始 hex/px 值属于反模式(违背了集中管理 token 的初衷)。
|
|
502
|
+
- 此区块是对第 4 段散文描述的补充,而非替代——使用此扩展的项目仍应为人类读者填写第 4 段的散文叙述字段。
|
|
503
|
+
|
|
504
|
+
### 非目标(明确未从上游采纳)
|
|
505
|
+
|
|
506
|
+
- **本标准不捆绑 lint CLI**——上游生态系统有一个独立的 `@google/design.md` npm 包用于验证;本标准不强制或捆绑特定的验证器。项目可独立采纳。
|
|
507
|
+
- **无特定于框架的导出格式**(React/Vue/CSS-in-JS 生成器)——根据本标准的核心原则(语义化 token 命名,框架无关)保持框架无关。
|
|
508
|
+
- **不扩展 5/4/7 token 数量**——插值语法使现有 token 可被引用;它不是添加更多 token 的许可。治理收敛(更少的 token = 更一致的 AI 输出)始终优先于粒度。
|
|
245
509
|
|
|
246
510
|
---
|
|
247
511
|
|
|
@@ -249,6 +513,16 @@ DESIGN.md = 给 AI 读的设计规格书
|
|
|
249
513
|
|
|
250
514
|
DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
|
|
251
515
|
|
|
516
|
+
```
|
|
517
|
+
my-project/
|
|
518
|
+
├── README.md ← project overview (for humans)
|
|
519
|
+
├── DESIGN.md ← design specification (for humans + AI agents)
|
|
520
|
+
├── CLAUDE.md ← AI assistant config (if applicable)
|
|
521
|
+
├── src/
|
|
522
|
+
│ └── ...
|
|
523
|
+
└── package.json
|
|
524
|
+
```
|
|
525
|
+
|
|
252
526
|
**规则**:
|
|
253
527
|
- 文件名:`DESIGN.md`(大小写必须完全相符)
|
|
254
528
|
- 位置:仅在项目根目录(不在 `docs/`、`src/` 或子目录)
|
|
@@ -260,6 +534,8 @@ DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
|
|
|
260
534
|
|
|
261
535
|
## 验证清单
|
|
262
536
|
|
|
537
|
+
使用此清单验证 DESIGN.md 是否符合本标准:
|
|
538
|
+
|
|
263
539
|
### 结构
|
|
264
540
|
- [ ] 全部 9 个段落依序存在
|
|
265
541
|
- [ ] 文件位于项目根目录(与 README.md 同层)
|
|
@@ -273,6 +549,7 @@ DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
|
|
|
273
549
|
### 字体系统(第 3 段)
|
|
274
550
|
- [ ] 定义了全部 4 个角色:`display`、`headline`、`body`、`caption`
|
|
275
551
|
- [ ] 最多使用 2 个字体家族
|
|
552
|
+
- [ ] 字体大小在指定范围内
|
|
276
553
|
|
|
277
554
|
### 间距(第 5 段)
|
|
278
555
|
- [ ] 定义了全部 7 个间距步骤:space-1 到 space-8(无 space-7)
|
|
@@ -287,3 +564,9 @@ DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
|
|
|
287
564
|
- [ ] 风格摘要存在(1–2 句)
|
|
288
565
|
- [ ] 关键约束列表存在
|
|
289
566
|
- [ ] 氛围(tone)已定义
|
|
567
|
+
|
|
568
|
+
### Token 插值扩展(可选——v1.1.0)
|
|
569
|
+
- [ ] 如果使用了 frontmatter token 注册表,所有 `colors` 键均匹配 5 个必填语义 token
|
|
570
|
+
- [ ] 如果使用了 `{category.token}` 插值,每个引用都能解析到一个 frontmatter 条目(无悬空引用)
|
|
571
|
+
- [ ] 如果使用了 `components:` 块,每个值都为 `{category.token}` 引用(无原始 hex/px 值)
|
|
572
|
+
- [ ] 缺少此扩展**不**属于合规失败——它是可选的
|