universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1
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/mock-boundary.ai.yaml +138 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/mock-boundary.md +70 -2
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/core/turn-completion-integrity.md +8 -2
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
- package/bundled/hooks/check-logging-standard.mjs +35 -6
- package/bundled/hooks/validate-commit-msg.mjs +317 -28
- package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +2323 -1128
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +227 -47
- 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
|
@@ -2,143 +2,565 @@
|
|
|
2
2
|
source: ../../../core/changelog-standards.md
|
|
3
3
|
source_version: 1.0.2
|
|
4
4
|
translation_version: 1.0.2
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: bb36e2ce7d8f
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
> **语言**: [English](../../../core/changelog-standards.md) | [简体中文](../../zh-TW/core/changelog-standards.md) | 简体中文
|
|
10
|
-
|
|
11
10
|
# 变更日志标准
|
|
12
11
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
12
|
+
> **语言**: [English](../../../core/changelog-standards.md) | [繁體中文](../../zh-TW/core/changelog-standards.md) | 简体中文
|
|
13
|
+
|
|
14
|
+
**版本**: 1.0.2
|
|
15
|
+
**最后更新**: 2025-12-24
|
|
16
|
+
**适用范围**: 所有具有版本化发布周期的软件项目
|
|
17
|
+
**范畴**: universal
|
|
18
|
+
**行业标准**: Keep a Changelog 1.1.0
|
|
19
|
+
**参考**: [keepachangelog.com](https://keepachangelog.com/)
|
|
16
20
|
|
|
17
21
|
---
|
|
18
22
|
|
|
19
23
|
## 目的
|
|
20
24
|
|
|
21
|
-
|
|
25
|
+
本标准定义如何编写与维护 CHANGELOG.md 文件,以便向用户、维护者以及引用此代码仓库的项目清晰传达变更。
|
|
26
|
+
|
|
27
|
+
**核心收益**:
|
|
28
|
+
- 用户可以快速了解版本之间的变更
|
|
29
|
+
- 依赖项目可以评估升级影响
|
|
30
|
+
- 团队可以系统化跟踪发布历史
|
|
31
|
+
|
|
32
|
+
**与其他标准的关系**:
|
|
33
|
+
- 补充定义版本编号的 [versioning.md](versioning.md)
|
|
34
|
+
- 与 [git-workflow.md](git-workflow.md) 发布流程整合
|
|
35
|
+
- 映射自 [commit-message-guide.md](commit-message-guide.md) 中的提交类型
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 核心原则
|
|
40
|
+
|
|
41
|
+
| 原则 | 说明 |
|
|
42
|
+
|------|------|
|
|
43
|
+
| **以用户为中心** | 面向用户编写,而非面向开发者 |
|
|
44
|
+
| **一致** | 使用标准分类与格式 |
|
|
45
|
+
| **完整** | 记录所有值得注意的变更 |
|
|
46
|
+
| **及时** | 在每次发布前更新 |
|
|
47
|
+
| **可追溯** | 链接到 issue、PR 或 commit |
|
|
22
48
|
|
|
23
49
|
---
|
|
24
50
|
|
|
25
|
-
##
|
|
51
|
+
## 格式标准
|
|
52
|
+
|
|
53
|
+
本标准遵循 [Keep a Changelog](https://keepachangelog.com/) 格式。
|
|
26
54
|
|
|
27
55
|
### 文件结构
|
|
28
56
|
|
|
29
57
|
```markdown
|
|
30
58
|
# Changelog
|
|
31
59
|
|
|
32
|
-
|
|
60
|
+
All notable changes to this project will be documented in this file.
|
|
33
61
|
|
|
34
|
-
|
|
35
|
-
|
|
62
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/),
|
|
63
|
+
and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
36
64
|
|
|
37
65
|
## [Unreleased]
|
|
38
66
|
|
|
39
67
|
### Added
|
|
40
|
-
-
|
|
68
|
+
- New features not yet released
|
|
69
|
+
|
|
70
|
+
## [1.2.0] - 2025-12-15
|
|
71
|
+
|
|
72
|
+
### Added
|
|
73
|
+
- Feature description
|
|
41
74
|
|
|
42
75
|
### Changed
|
|
43
|
-
-
|
|
76
|
+
- Change description
|
|
44
77
|
|
|
45
|
-
|
|
78
|
+
### Fixed
|
|
79
|
+
- Bug fix description
|
|
46
80
|
|
|
47
|
-
|
|
48
|
-
|
|
81
|
+
## [1.1.0] - 2025-11-01
|
|
82
|
+
|
|
83
|
+
...
|
|
84
|
+
|
|
85
|
+
[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
|
|
86
|
+
[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
|
|
87
|
+
[1.1.0]: https://github.com/user/repo/releases/tag/v1.1.0
|
|
49
88
|
```
|
|
50
89
|
|
|
51
|
-
|
|
90
|
+
### 变更分类
|
|
52
91
|
|
|
53
|
-
|
|
92
|
+
| 分类 | 用途 | 何时使用 |
|
|
93
|
+
|------|------|----------|
|
|
94
|
+
| **Added** | 新功能 | 针对用户的新功能 |
|
|
95
|
+
| **Changed** | 修改 | 现有功能的变更 |
|
|
96
|
+
| **Deprecated** | 即将移除 | 未来将被移除的功能 |
|
|
97
|
+
| **Removed** | 移除功能 | 在此版本中移除的功能 |
|
|
98
|
+
| **Fixed** | 缺陷修复 | 任何 bug 修复 |
|
|
99
|
+
| **Security** | 安全补丁 | 漏洞修复 |
|
|
54
100
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
101
|
+
### 版本标题格式
|
|
102
|
+
|
|
103
|
+
```markdown
|
|
104
|
+
## [VERSION] - YYYY-MM-DD
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
**示例**:
|
|
108
|
+
```markdown
|
|
109
|
+
## [2.0.0] - 2025-12-15
|
|
110
|
+
## [1.5.0-beta.1] - 2025-12-01
|
|
111
|
+
## [Unreleased]
|
|
112
|
+
```
|
|
63
113
|
|
|
64
114
|
---
|
|
65
115
|
|
|
66
116
|
## 编写指南
|
|
67
117
|
|
|
68
|
-
###
|
|
118
|
+
### 面向用户编写,而非面向开发者
|
|
119
|
+
|
|
120
|
+
聚焦于**改变了什么**以及**对用户有何影响**,而非实现细节。
|
|
121
|
+
|
|
122
|
+
| ✅ 好 | ❌ 差 | 原因 |
|
|
123
|
+
|-------|-------|------|
|
|
124
|
+
| Add dark mode theme option | Implement ThemeProvider with context | 面向用户的收益 |
|
|
125
|
+
| Fix login timeout on slow networks | Fix race condition in AuthService | 影响描述 |
|
|
126
|
+
| Support CSV export for reports | Add CSVExporter class | 功能描述 |
|
|
127
|
+
| Improve page load speed by 40% | Optimize SQL queries with indexes | 可衡量的成果 |
|
|
128
|
+
|
|
129
|
+
### 条目格式
|
|
130
|
+
|
|
131
|
+
每个条目应遵循此模式:
|
|
69
132
|
|
|
133
|
+
```markdown
|
|
134
|
+
- [Action verb] [what changed] ([reference])
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
**示例**:
|
|
70
138
|
```markdown
|
|
71
139
|
### Added
|
|
72
|
-
-
|
|
73
|
-
-
|
|
140
|
+
- Add user dashboard with customizable widgets (#123)
|
|
141
|
+
- Add support for PostgreSQL 15 (PR #456)
|
|
142
|
+
|
|
143
|
+
### Changed
|
|
144
|
+
- **BREAKING**: Change API response format from XML to JSON (#789)
|
|
145
|
+
- Update minimum Node.js version to 18.0 (#101)
|
|
74
146
|
|
|
75
147
|
### Fixed
|
|
76
|
-
-
|
|
148
|
+
- Fix memory leak when processing large files (#112)
|
|
149
|
+
- Fix incorrect date formatting in reports (#134)
|
|
77
150
|
```
|
|
78
151
|
|
|
79
|
-
###
|
|
152
|
+
### 破坏性变更
|
|
153
|
+
|
|
154
|
+
使用 **BREAKING** 前缀清晰标注破坏性变更:
|
|
80
155
|
|
|
81
156
|
```markdown
|
|
82
157
|
### Changed
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
|
|
158
|
+
- **BREAKING**: Remove deprecated `getUserById()` method, use `getUser()` instead
|
|
159
|
+
- **BREAKING**: Change configuration file format from YAML to TOML
|
|
160
|
+
|
|
161
|
+
### Removed
|
|
162
|
+
- **BREAKING**: Remove support for Node.js 14
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### 安全通告
|
|
166
|
+
|
|
167
|
+
对于安全修复,请在可用时包含严重程度和 CVE:
|
|
168
|
+
|
|
169
|
+
```markdown
|
|
170
|
+
### Security
|
|
171
|
+
- Fix SQL injection vulnerability in search endpoint (HIGH, CVE-2025-12345)
|
|
172
|
+
- Fix XSS vulnerability in comment rendering (MEDIUM)
|
|
173
|
+
- Update dependency `lodash` to patch prototype pollution (LOW)
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## Commit 到 Changelog 的映射
|
|
179
|
+
|
|
180
|
+
将 Conventional Commits 类型映射到 CHANGELOG 分类:
|
|
181
|
+
|
|
182
|
+
| Commit 类型 | CHANGELOG 分类 | 备注 |
|
|
183
|
+
|-------------|----------------|------|
|
|
184
|
+
| `feat` | **Added** | 新功能 |
|
|
185
|
+
| `fix` | **Fixed** | 缺陷修复 |
|
|
186
|
+
| `perf` | **Changed** | 性能改进 |
|
|
187
|
+
| `refactor` | *(通常忽略)* | 内部变更,对用户无影响 |
|
|
188
|
+
| `docs` | *(通常忽略)* | 仅文档 |
|
|
189
|
+
| `style` | *(通常忽略)* | 仅代码样式 |
|
|
190
|
+
| `test` | *(通常忽略)* | 仅测试 |
|
|
191
|
+
| `chore` | *(通常忽略)* | 日常维护 |
|
|
192
|
+
| `BREAKING CHANGE` | **Changed** 或 **Removed** | 带 **BREAKING** 前缀 |
|
|
193
|
+
| `security` | **Security** | 安全补丁 |
|
|
194
|
+
| `deprecate` | **Deprecated** | 弃用通知 |
|
|
195
|
+
|
|
196
|
+
**注意**: 并非所有 commit 都需要 CHANGELOG 条目。聚焦于面向用户的变更。
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## Git 工作流集成
|
|
201
|
+
|
|
202
|
+
### 何时更新 CHANGELOG
|
|
203
|
+
|
|
204
|
+
| 工作流 | 何时更新 | 分支 |
|
|
205
|
+
|----------|----------------|--------|
|
|
206
|
+
| **GitFlow** | 发布准备期间 | `release/*` |
|
|
207
|
+
| **GitHub Flow** | 合并到 main 之前 | 特性分支 |
|
|
208
|
+
| **Trunk-Based** | 打发布标签之前 | `main` |
|
|
209
|
+
|
|
210
|
+
### GitFlow 发布流程
|
|
211
|
+
|
|
212
|
+
```bash
|
|
213
|
+
# 1. Create release branch
|
|
214
|
+
git checkout -b release/v1.2.0 develop
|
|
215
|
+
|
|
216
|
+
# 2. Update CHANGELOG.md
|
|
217
|
+
# - Move [Unreleased] items to new version section
|
|
218
|
+
# - Add release date
|
|
219
|
+
# - Update comparison links
|
|
220
|
+
|
|
221
|
+
# 3. Commit changes
|
|
222
|
+
git add CHANGELOG.md
|
|
223
|
+
git commit -m "docs(changelog): update for v1.2.0"
|
|
224
|
+
|
|
225
|
+
# 4. Continue with release process
|
|
226
|
+
# See git-workflow.md for full details
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
### 未发布区段管理
|
|
230
|
+
|
|
231
|
+
在开发期间,将条目添加到 `[Unreleased]`:
|
|
232
|
+
|
|
233
|
+
```markdown
|
|
234
|
+
## [Unreleased]
|
|
235
|
+
|
|
236
|
+
### Added
|
|
237
|
+
- Add feature X (#123)
|
|
238
|
+
|
|
239
|
+
### Fixed
|
|
240
|
+
- Fix bug Y (#456)
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
在发布时,移动到版本化区段:
|
|
244
|
+
|
|
245
|
+
```markdown
|
|
246
|
+
## [1.2.0] - 2025-12-15
|
|
247
|
+
|
|
248
|
+
### Added
|
|
249
|
+
- Add feature X (#123)
|
|
250
|
+
|
|
251
|
+
### Fixed
|
|
252
|
+
- Fix bug Y (#456)
|
|
253
|
+
|
|
254
|
+
## [1.1.0] - 2025-11-01
|
|
255
|
+
...
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
## CHANGELOG 与发布说明对比
|
|
261
|
+
|
|
262
|
+
| 方面 | CHANGELOG | 发布说明 |
|
|
263
|
+
|--------|-----------|---------------|
|
|
264
|
+
| **受众** | 开发者、技术用户 | 所有用户、利益相关者 |
|
|
265
|
+
| **详细程度** | 全面、技术性 | 亮点、摘要 |
|
|
266
|
+
| **格式** | 结构化 markdown 文件 | GitHub Release、博客文章 |
|
|
267
|
+
| **更新频率** | 每次 commit/PR | 每次发布 |
|
|
268
|
+
| **位置** | 仓库中的 `CHANGELOG.md` | GitHub Releases、网站 |
|
|
269
|
+
|
|
270
|
+
### 何时两者兼用
|
|
271
|
+
|
|
272
|
+
- **库/软件包**:CHANGELOG 通常已足够
|
|
273
|
+
- **应用程序**:针对不同受众考虑两者兼用
|
|
274
|
+
- **企业产品**:针对客户提供发布说明,针对开发者提供 CHANGELOG
|
|
275
|
+
|
|
276
|
+
---
|
|
277
|
+
|
|
278
|
+
## 自动化
|
|
279
|
+
|
|
280
|
+
### conventional-changelog
|
|
281
|
+
|
|
282
|
+
从 Conventional Commits 生成 CHANGELOG:
|
|
283
|
+
|
|
284
|
+
```bash
|
|
285
|
+
# Install
|
|
286
|
+
npm install -g conventional-changelog-cli
|
|
287
|
+
|
|
288
|
+
# Generate (append to existing)
|
|
289
|
+
conventional-changelog -p angular -i CHANGELOG.md -s
|
|
290
|
+
|
|
291
|
+
# Generate (overwrite)
|
|
292
|
+
conventional-changelog -p angular -i CHANGELOG.md -s -r 0
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
### semantic-release
|
|
296
|
+
|
|
297
|
+
全自动版本控制与 CHANGELOG:
|
|
298
|
+
|
|
299
|
+
```json
|
|
300
|
+
// .releaserc.json
|
|
301
|
+
{
|
|
302
|
+
"branches": ["main"],
|
|
303
|
+
"plugins": [
|
|
304
|
+
"@semantic-release/commit-analyzer",
|
|
305
|
+
"@semantic-release/release-notes-generator",
|
|
306
|
+
"@semantic-release/changelog",
|
|
307
|
+
"@semantic-release/git"
|
|
308
|
+
]
|
|
309
|
+
}
|
|
310
|
+
```
|
|
311
|
+
|
|
312
|
+
### GitHub Actions 示例
|
|
313
|
+
|
|
314
|
+
```yaml
|
|
315
|
+
# .github/workflows/release.yml
|
|
316
|
+
name: Release
|
|
317
|
+
on:
|
|
318
|
+
push:
|
|
319
|
+
branches: [main]
|
|
320
|
+
jobs:
|
|
321
|
+
release:
|
|
322
|
+
runs-on: ubuntu-latest
|
|
323
|
+
steps:
|
|
324
|
+
- uses: actions/checkout@v4
|
|
325
|
+
- uses: actions/setup-node@v4
|
|
326
|
+
- run: npm ci
|
|
327
|
+
- run: npx semantic-release
|
|
328
|
+
env:
|
|
329
|
+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
---
|
|
333
|
+
|
|
334
|
+
## 多语言支持
|
|
335
|
+
|
|
336
|
+
对于需要双语变更日志的项目:
|
|
337
|
+
|
|
338
|
+
### 选项 A:包含双语条目的单个文件
|
|
339
|
+
|
|
340
|
+
```markdown
|
|
341
|
+
## [1.2.0] - 2025-12-15
|
|
342
|
+
|
|
343
|
+
### Added | 新增
|
|
344
|
+
- Add dark mode support
|
|
345
|
+
新增深色模式支援
|
|
346
|
+
- Add CSV export feature
|
|
347
|
+
新增 CSV 匯出功能
|
|
348
|
+
|
|
349
|
+
### Fixed | 修復
|
|
350
|
+
- Fix login timeout issue
|
|
351
|
+
修復登入逾時問題
|
|
352
|
+
```
|
|
353
|
+
|
|
354
|
+
### 选项 B:分开的文件
|
|
355
|
+
|
|
356
|
+
```
|
|
357
|
+
CHANGELOG.md # English (primary)
|
|
358
|
+
CHANGELOG.zh-TW.md # Traditional Chinese
|
|
359
|
+
```
|
|
360
|
+
|
|
361
|
+
**建议**:小型项目使用选项 A,大型国际化项目使用选项 B。
|
|
362
|
+
|
|
363
|
+
---
|
|
364
|
+
|
|
365
|
+
## AI 友好格式
|
|
366
|
+
|
|
367
|
+
为帮助 AI 助手解析并生成 CHANGELOG 条目:
|
|
368
|
+
|
|
369
|
+
1. **使用一致的结构** - 每个条目使用相同格式
|
|
370
|
+
2. **包含引用** - 提供 Issue/PR 编号作为上下文
|
|
371
|
+
3. **使用标准分类** - Keep a Changelog 分类
|
|
372
|
+
4. **明确的破坏性变更标记** - **BREAKING** 前缀
|
|
373
|
+
5. **日期格式** - ISO 8601 (YYYY-MM-DD)
|
|
374
|
+
|
|
375
|
+
---
|
|
376
|
+
|
|
377
|
+
## 模板
|
|
378
|
+
|
|
379
|
+
### 基础 CHANGELOG.md 模板
|
|
380
|
+
|
|
381
|
+
```markdown
|
|
382
|
+
# Changelog
|
|
383
|
+
|
|
384
|
+
All notable changes to this project will be documented in this file.
|
|
385
|
+
|
|
386
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/),
|
|
387
|
+
and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
388
|
+
|
|
389
|
+
## [Unreleased]
|
|
390
|
+
|
|
391
|
+
## [1.0.0] - YYYY-MM-DD
|
|
392
|
+
|
|
393
|
+
### Added
|
|
394
|
+
- Initial release
|
|
395
|
+
|
|
396
|
+
[Unreleased]: https://github.com/USER/REPO/compare/v1.0.0...HEAD
|
|
397
|
+
[1.0.0]: https://github.com/USER/REPO/releases/tag/v1.0.0
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
### 双语模板
|
|
401
|
+
|
|
402
|
+
```markdown
|
|
403
|
+
# Changelog | 變更日誌
|
|
404
|
+
|
|
405
|
+
All notable changes to this project will be documented in this file.
|
|
406
|
+
本專案的所有重要變更都將記錄在此檔案中。
|
|
407
|
+
|
|
408
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/),
|
|
409
|
+
and this project adheres to [Semantic Versioning](https://semver.org/).
|
|
410
|
+
格式基於 [Keep a Changelog](https://keepachangelog.com/),
|
|
411
|
+
並遵循[語義化版本](https://semver.org/)。
|
|
412
|
+
|
|
413
|
+
## [Unreleased] | 未發布
|
|
414
|
+
|
|
415
|
+
## [1.0.0] - YYYY-MM-DD
|
|
416
|
+
|
|
417
|
+
### Added | 新增
|
|
418
|
+
- Initial release
|
|
419
|
+
初始發布
|
|
420
|
+
|
|
421
|
+
[Unreleased]: https://github.com/USER/REPO/compare/v1.0.0...HEAD
|
|
422
|
+
[1.0.0]: https://github.com/USER/REPO/releases/tag/v1.0.0
|
|
86
423
|
```
|
|
87
424
|
|
|
88
425
|
---
|
|
89
426
|
|
|
90
427
|
## 排除规则
|
|
91
428
|
|
|
92
|
-
|
|
429
|
+
> **另请参阅**:有关完整的排除规则,请参阅 [versioning.md](versioning.md#exclusion-rules)。
|
|
430
|
+
|
|
431
|
+
### 核心原则
|
|
432
|
+
|
|
433
|
+
**项目的 `.gitignore` 中列出的任何文件或目录均不得记录在 CHANGELOG 中。**
|
|
434
|
+
|
|
435
|
+
### 类别
|
|
436
|
+
|
|
437
|
+
以下变更**不得**记录在 CHANGELOG 中:
|
|
93
438
|
|
|
94
439
|
| 类别 | 示例 | 原因 |
|
|
95
|
-
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
99
|
-
|
|
|
100
|
-
| AI
|
|
440
|
+
|----------|----------|--------|
|
|
441
|
+
| **构建输出** | `dist/`, `build/`, `bin/`, `obj/` | 生成的文件 |
|
|
442
|
+
| **依赖项** | `node_modules/`, `packages/`, lock files | 自动管理 |
|
|
443
|
+
| **本地配置** | `.env`, `*.local.json`, `appsettings.*.local.json` | 特定于环境 |
|
|
444
|
+
| **IDE 设置** | `.vscode/`, `.idea/`, `.cursor/` | 开发者偏好 |
|
|
445
|
+
| **AI 工作区** | `.claude/`, `.ai/` | 本地开发辅助工具 |
|
|
446
|
+
| **机密信息** | `*.pem`, `*.key`, `credentials.*` | 安全敏感 |
|
|
447
|
+
| **内部重构** | 代码风格、变量名 | 对用户无影响 |
|
|
448
|
+
|
|
449
|
+
### 验证
|
|
450
|
+
|
|
451
|
+
```bash
|
|
452
|
+
# Check .gitignore exclusions before generating CHANGELOG
|
|
453
|
+
cat .gitignore | grep -E "^[^#*]" | head -20
|
|
454
|
+
|
|
455
|
+
# Verify recorded paths exist in version control
|
|
456
|
+
git ls-files | grep -E "path/to/file"
|
|
457
|
+
```
|
|
458
|
+
|
|
459
|
+
**注意**:每个项目都应根据自身的 `.gitignore` 来确定排除项。上表仅提供常见示例。
|
|
101
460
|
|
|
102
461
|
---
|
|
103
462
|
|
|
104
|
-
##
|
|
463
|
+
## 示例
|
|
464
|
+
|
|
465
|
+
### 库项目
|
|
466
|
+
|
|
467
|
+
```markdown
|
|
468
|
+
## [2.3.0] - 2025-12-15
|
|
469
|
+
|
|
470
|
+
### Added
|
|
471
|
+
- Add `parseAsync()` method for non-blocking parsing (#234)
|
|
472
|
+
- Add TypeScript type definitions (#245)
|
|
473
|
+
|
|
474
|
+
### Changed
|
|
475
|
+
- **BREAKING**: Rename `parse()` to `parseSync()` (#234)
|
|
476
|
+
- Improve error messages with line numbers (#256)
|
|
477
|
+
|
|
478
|
+
### Deprecated
|
|
479
|
+
- Deprecate `legacyParse()`, use `parseSync()` instead (#234)
|
|
480
|
+
|
|
481
|
+
### Fixed
|
|
482
|
+
- Fix memory leak in large file processing (#267)
|
|
483
|
+
```
|
|
105
484
|
|
|
106
|
-
|
|
485
|
+
### 应用程序项目
|
|
107
486
|
|
|
108
487
|
```markdown
|
|
109
|
-
[
|
|
110
|
-
|
|
488
|
+
## [1.5.0] - 2025-12-15
|
|
489
|
+
|
|
490
|
+
### Added
|
|
491
|
+
- Add user dashboard with activity summary
|
|
492
|
+
- Add email notification preferences
|
|
493
|
+
- Add dark mode theme option
|
|
494
|
+
|
|
495
|
+
### Changed
|
|
496
|
+
- Redesign settings page for better navigation
|
|
497
|
+
- Improve search performance by 50%
|
|
498
|
+
|
|
499
|
+
### Fixed
|
|
500
|
+
- Fix incorrect date display in reports
|
|
501
|
+
- Fix logout not clearing session properly
|
|
502
|
+
|
|
503
|
+
### Security
|
|
504
|
+
- Fix XSS vulnerability in comment section (CVE-2025-1234)
|
|
111
505
|
```
|
|
112
506
|
|
|
113
507
|
---
|
|
114
508
|
|
|
115
|
-
##
|
|
509
|
+
## 常见错误
|
|
510
|
+
|
|
511
|
+
| ❌ 错误 | ✅ 正确 | 问题 |
|
|
512
|
+
|-----------|-----------|-------|
|
|
513
|
+
| 没有日期 | 包含日期 | 无法追踪时间线 |
|
|
514
|
+
| 缺少链接 | 添加版本链接 | 无法查看差异(diff) |
|
|
515
|
+
| 内部术语 | 用户友好的语言 | 用户无法理解 |
|
|
516
|
+
| 技术性过强 | 关注影响 | 缺少“那又如何”(实际价值) |
|
|
517
|
+
| 不完整 | 列出所有重要变更 | 用户会遗漏重要信息 |
|
|
518
|
+
| 未分类 | 使用标准类别 | 难以快速浏览 |
|
|
519
|
+
|
|
520
|
+
---
|
|
116
521
|
|
|
117
|
-
|
|
522
|
+
## 项目配置
|
|
118
523
|
|
|
119
|
-
|
|
120
|
-
|-----------|-----|
|
|
121
|
-
| 添加新功能 | Added |
|
|
122
|
-
| 修改现有功能 | Changed |
|
|
123
|
-
| 计划移除功能 | Deprecated |
|
|
124
|
-
| 已移除功能 | Removed |
|
|
125
|
-
| 修复错误 | Fixed |
|
|
126
|
-
| 安全修复 | Security |
|
|
524
|
+
在 `CONTRIBUTING.md` 中记录您的 CHANGELOG 实践规范:
|
|
127
525
|
|
|
128
|
-
|
|
526
|
+
```markdown
|
|
527
|
+
## Changelog Guidelines
|
|
129
528
|
|
|
130
|
-
-
|
|
131
|
-
- [
|
|
132
|
-
-
|
|
133
|
-
-
|
|
134
|
-
-
|
|
529
|
+
- Update CHANGELOG.md for all user-facing changes
|
|
530
|
+
- Add entries to [Unreleased] section during development
|
|
531
|
+
- Use standard categories: Added, Changed, Deprecated, Removed, Fixed, Security
|
|
532
|
+
- Reference issue/PR numbers: `Fix bug (#123)`
|
|
533
|
+
- Mark breaking changes with **BREAKING** prefix
|
|
534
|
+
```
|
|
135
535
|
|
|
136
536
|
---
|
|
137
537
|
|
|
138
538
|
## 相关标准
|
|
139
539
|
|
|
140
|
-
- [版本标准](versioning.md)
|
|
141
|
-
- [提交消息指南](commit-message-guide.md)
|
|
540
|
+
- [版本标准](versioning.md) - 语义化版本标准
|
|
541
|
+
- [提交消息指南](commit-message-guide.md) - 提交消息规范
|
|
542
|
+
- [Git 工作流标准](git-workflow.md) - Git 工作流标准
|
|
543
|
+
- [部署标准](deployment-standards.md) - 记录已部署的变更
|
|
544
|
+
|
|
545
|
+
---
|
|
546
|
+
|
|
547
|
+
## 版本历史
|
|
548
|
+
|
|
549
|
+
| 版本 | 日期 | 变更 |
|
|
550
|
+
|---------|------|---------|
|
|
551
|
+
| 1.0.2 | 2025-12-24 | 新增:相关标准章节 |
|
|
552
|
+
| 1.0.1 | 2025-12-16 | 将排除规则与 versioning.md 对齐,添加交叉引用 |
|
|
553
|
+
| 1.0.0 | 2025-12-15 | 初始变更日志标准 |
|
|
554
|
+
|
|
555
|
+
---
|
|
556
|
+
|
|
557
|
+
## 参考资料
|
|
558
|
+
|
|
559
|
+
- [Keep a Changelog](https://keepachangelog.com/)
|
|
560
|
+
- [Semantic Versioning](https://semver.org/)
|
|
561
|
+
- [Conventional Commits](https://www.conventionalcommits.org/)
|
|
562
|
+
- [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog)
|
|
563
|
+
- [semantic-release](https://github.com/semantic-release/semantic-release)
|
|
142
564
|
|
|
143
565
|
---
|
|
144
566
|
|