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
|
@@ -1,24 +1,28 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/checkin-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.8.0
|
|
4
|
+
translation_version: 1.8.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: cba0d018453b
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
#
|
|
10
|
+
# 代码签入检查点标准
|
|
10
11
|
|
|
11
|
-
> **语言**: [English](../../../core/checkin-standards.md) |
|
|
12
|
+
> **语言**: [English](../../../core/checkin-standards.md) | 简体中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最后更新**: 2026-
|
|
15
|
-
**适用范围**:
|
|
14
|
+
**版本**: 1.8.0
|
|
15
|
+
**最后更新**: 2026-07-09
|
|
16
|
+
**适用范围**: 所有使用版本控制的软件项目
|
|
17
|
+
**范围**: partial
|
|
18
|
+
**行业标准**: SWEBOK v4.0 第 6 章
|
|
19
|
+
**参考**: [computer.org](https://www.computer.org/education/bodies-of-knowledge/software-engineering/v4)
|
|
16
20
|
|
|
17
21
|
---
|
|
18
22
|
|
|
19
23
|
## 目的
|
|
20
24
|
|
|
21
|
-
|
|
25
|
+
本标准定义提交代码到版本控制前必须通过的质量关卡。确保每次提交都维持代码库的稳定性与质量。
|
|
22
26
|
|
|
23
27
|
---
|
|
24
28
|
|
|
@@ -26,7 +30,7 @@ status: stale
|
|
|
26
30
|
|
|
27
31
|
**每次提交应该**:
|
|
28
32
|
- ✅ 是完整的逻辑工作单元
|
|
29
|
-
- ✅
|
|
33
|
+
- ✅ 让代码库处于可运作状态
|
|
30
34
|
- ✅ 可回退而不破坏功能
|
|
31
35
|
- ✅ 包含自己的测试(新功能)
|
|
32
36
|
- ✅ 让未来开发者能理解
|
|
@@ -35,9 +39,9 @@ status: stale
|
|
|
35
39
|
|
|
36
40
|
## 必检清单
|
|
37
41
|
|
|
38
|
-
### 1.
|
|
42
|
+
### 1. 构建验证
|
|
39
43
|
|
|
40
|
-
- [ ]
|
|
44
|
+
- [ ] **代码成功编译**
|
|
41
45
|
- Zero build errors
|
|
42
46
|
- Zero build warnings (or documented exceptions)
|
|
43
47
|
|
|
@@ -46,7 +50,7 @@ status: stale
|
|
|
46
50
|
- Dependency versions locked/documented
|
|
47
51
|
- No missing imports or modules
|
|
48
52
|
|
|
49
|
-
|
|
53
|
+
**项目特定构建命令**:
|
|
50
54
|
```bash
|
|
51
55
|
# Example: .NET project
|
|
52
56
|
dotnet build --configuration Release --warnaserror
|
|
@@ -68,13 +72,13 @@ pip install -r requirements.txt && python -m py_compile src/**/*.py
|
|
|
68
72
|
### 2. 测试验证
|
|
69
73
|
|
|
70
74
|
- [ ] **所有相关测试通过**
|
|
71
|
-
-
|
|
72
|
-
-
|
|
75
|
+
- 单元测试:已修改模块的所有测试通过
|
|
76
|
+
- 集成测试:与已变更组件相关的所有测试通过
|
|
73
77
|
- 端对端测试(如适用):所有关键路径测试通过
|
|
74
78
|
|
|
75
|
-
>
|
|
79
|
+
> **注意**:「相关测试」指直接执行已变更代码的测试,以及可能受变更影响的测试。如有可用的测试影响分析工具,请使用。
|
|
76
80
|
|
|
77
|
-
- [ ]
|
|
81
|
+
- [ ] **新代码已测试**
|
|
78
82
|
- New features have corresponding tests
|
|
79
83
|
- Bug fixes include regression tests
|
|
80
84
|
- Edge cases are covered
|
|
@@ -85,10 +89,10 @@ pip install -r requirements.txt && python -m py_compile src/**/*.py
|
|
|
85
89
|
|
|
86
90
|
- [ ] **AC 覆盖率已验证**(如使用规格驱动工作流)
|
|
87
91
|
- 所有验收条件有对应测试(参见[验收条件追溯标准](acceptance-criteria-traceability.md))
|
|
88
|
-
- AC
|
|
92
|
+
- AC 覆盖率达到项目阈值(默认:签入时 80%)
|
|
89
93
|
- 已覆盖的 AC 未退化为未覆盖
|
|
90
94
|
|
|
91
|
-
|
|
95
|
+
**项目特定测试命令**:
|
|
92
96
|
```bash
|
|
93
97
|
# Example: .NET project
|
|
94
98
|
dotnet test --no-build --verbosity normal
|
|
@@ -101,7 +105,7 @@ pytest --cov=src tests/
|
|
|
101
105
|
```
|
|
102
106
|
|
|
103
107
|
**验证**:
|
|
104
|
-
-
|
|
108
|
+
- 在本地运行所有相关测试(参见上方“所有相关测试通过”——即直接执行已变更代码的测试,加上受变更影响的测试;若项目有测试影响分析工具则借助其确定);当范围不明确,或变更涉及共享/核心路径时,改为运行完整测试套件
|
|
105
109
|
- Review test coverage report
|
|
106
110
|
- Ensure new code paths are tested
|
|
107
111
|
|
|
@@ -124,10 +128,10 @@ pytest --cov=src tests/
|
|
|
124
128
|
| 单纯的 typo 修正 | 再发风险低 |
|
|
125
129
|
| 显而易见的逻辑错误(如 `>` 写成 `<`) | 审查时容易发现 |
|
|
126
130
|
| 已被现有测试覆盖 | 避免重复测试 |
|
|
127
|
-
| 一次性的配置错误 |
|
|
131
|
+
| 一次性的配置错误 | 不会在代码中再发生 |
|
|
128
132
|
|
|
129
133
|
**快速决策问题**:
|
|
130
|
-
1. 这个 bug
|
|
134
|
+
1. 这个 bug 是否可能因未来的代码变更而重现? → 是 = 加测试
|
|
131
135
|
2. 现有的测试是否能捕捉到这个 bug? → 否 = 加测试
|
|
132
136
|
3. 这是否影响核心功能或关键路径? → 是 = 加测试
|
|
133
137
|
4. 这个 bug 曾经出现过吗? → 是 = 加测试
|
|
@@ -143,26 +147,32 @@ describe('Regression: [BUG-ID or description]', () => {
|
|
|
143
147
|
|
|
144
148
|
---
|
|
145
149
|
|
|
146
|
-
### 3.
|
|
150
|
+
### 3. 代码质量
|
|
147
151
|
|
|
148
152
|
- [ ] **遵循编码标准**
|
|
149
153
|
- Naming conventions adhered to
|
|
150
154
|
- Code formatting consistent
|
|
151
155
|
- Comments/documentation present
|
|
152
156
|
|
|
153
|
-
- [ ]
|
|
157
|
+
- [ ] **无代码异味**
|
|
154
158
|
- Methods ≤50 lines (or project standard)
|
|
155
159
|
- Nesting depth ≤3 levels
|
|
156
160
|
- Cyclomatic complexity ≤10
|
|
157
161
|
- No duplicated code blocks
|
|
158
162
|
|
|
163
|
+
> 以上阈值为 UDS 默认值,可按项目配置。圈复杂度
|
|
164
|
+
> ≤10 遵循 McCabe 的原始建议(McCabe, 1976)——这也是多数
|
|
165
|
+
> linter(ESLint `complexity`、SonarQube)的默认值;方法长度与
|
|
166
|
+
> 嵌套深度限制是以可读性为目标的常见风格指南默认值,而非
|
|
167
|
+
> 硬性规则。请依你的语言/团队调整。
|
|
168
|
+
|
|
159
169
|
- [ ] **安全性已检查**
|
|
160
170
|
- No hardcoded secrets (passwords, API keys)
|
|
161
171
|
- No SQL injection vulnerabilities
|
|
162
172
|
- No XSS vulnerabilities
|
|
163
173
|
- No insecure dependencies
|
|
164
174
|
|
|
165
|
-
|
|
175
|
+
**项目特定质量工具**:
|
|
166
176
|
```bash
|
|
167
177
|
# Example: ESLint for JavaScript
|
|
168
178
|
npx eslint src/
|
|
@@ -199,11 +209,11 @@ dotnet list package --vulnerable
|
|
|
199
209
|
- Breaking changes noted
|
|
200
210
|
- Setup instructions current
|
|
201
211
|
|
|
202
|
-
- [ ] **CHANGELOG
|
|
203
|
-
-
|
|
212
|
+
- [ ] **CHANGELOG 已更新(仅发布前)**
|
|
213
|
+
- CHANGELOG 在发布准备阶段更新,而非每次提交时更新
|
|
214
|
+
- 对于用户可感知的变更:在发布前将条目添加到 `[Unreleased]` 区段
|
|
204
215
|
- Breaking changes marked with **BREAKING** prefix
|
|
205
|
-
-
|
|
206
|
-
- 注意:内部重构、仅测试、仅文件的变更通常不需要 CHANGELOG 条目
|
|
216
|
+
- 各工作流的更新时机参见 [changelog-standards.md](changelog-standards.md)
|
|
207
217
|
|
|
208
218
|
**文件格式**:
|
|
209
219
|
```
|
|
@@ -240,10 +250,10 @@ def authenticate(username: str, password: str) -> Optional[str]:
|
|
|
240
250
|
|
|
241
251
|
| 项目 | 何时适用 | 何时不适用 |
|
|
242
252
|
|------|---------|-----------|
|
|
243
|
-
| **README 更新** |
|
|
244
|
-
| **CHANGELOG 条目** |
|
|
245
|
-
| **端对端测试** |
|
|
246
|
-
| **API 文档** | 公开 API 变更、新增端点、参数含义变更 |
|
|
253
|
+
| **README 更新** | 新增功能、配置变更、API 行为变更 | 内部重构、仅测试变更、依赖更新 |
|
|
254
|
+
| **CHANGELOG 条目** | 用户可见的变更、影响用户的错误修复、重大变更 | 内部重构、仅测试变更、仅文件变更、开发依赖更新 |
|
|
255
|
+
| **端对端测试** | 用户流程变更、关键路径受影响、集成点修改 | 纯后端变更且无 UI 影响、独立的工具函数 |
|
|
256
|
+
| **API 文档** | 公开 API 变更、新增端点、参数含义变更 | 私有方法、内部工具、测试代码 |
|
|
247
257
|
|
|
248
258
|
---
|
|
249
259
|
|
|
@@ -253,7 +263,7 @@ def authenticate(username: str, password: str) -> Optional[str]:
|
|
|
253
263
|
- Follows project convention (e.g., `feature/`, `fix/`)
|
|
254
264
|
- Descriptive name used
|
|
255
265
|
|
|
256
|
-
- [ ] **Commit
|
|
266
|
+
- [ ] **Commit 消息已格式化**
|
|
257
267
|
- Follows conventional commits or project standard
|
|
258
268
|
- Clear and descriptive
|
|
259
269
|
|
|
@@ -303,7 +313,7 @@ git status
|
|
|
303
313
|
- Application can run/start
|
|
304
314
|
- Core functionality not broken
|
|
305
315
|
|
|
306
|
-
|
|
316
|
+
**示例情境**:
|
|
307
317
|
```
|
|
308
318
|
✅ GOOD: "feat(auth): add OAuth2 Google login support"
|
|
309
319
|
- OAuth flow implemented
|
|
@@ -330,7 +340,7 @@ git status
|
|
|
330
340
|
|
|
331
341
|
| 指标 | 建议值 | 说明 |
|
|
332
342
|
|------|--------|------|
|
|
333
|
-
|
|
|
343
|
+
| 文件数量 | 1-10 个 | 超过 10 个文件应考虑拆分 |
|
|
334
344
|
| 变更行数 | 50-300 行 | 过大难以 review,过小缺乏意义 |
|
|
335
345
|
| 功能范围 | 单一关注点 | 一个 commit 只做一件事 |
|
|
336
346
|
|
|
@@ -405,7 +415,7 @@ git status
|
|
|
405
415
|
|--------|------|---------|
|
|
406
416
|
| Phase 完成 | 完成一个开发阶段 | 建议 |
|
|
407
417
|
| Checkpoint | 到达定义的检查点 | 建议 |
|
|
408
|
-
| 变更累积 |
|
|
418
|
+
| 变更累积 | 文件 ≥5 个 或 行数 ≥200 行 | 建议 |
|
|
409
419
|
| 连续跳过 | 连续跳过签入 3 次 | 警告 |
|
|
410
420
|
| 工作完成 | 结束前有未 commit 变更 | 强烈建议 |
|
|
411
421
|
| 批次阈值 | 待处理变更达到配置阈值 | 建议 |
|
|
@@ -420,11 +430,11 @@ git status
|
|
|
420
430
|
|
|
421
431
|
```
|
|
422
432
|
┌────────────────────────────────────────────────┐
|
|
423
|
-
│ 🔔
|
|
433
|
+
│ 🔔 Check-in Checkpoint │
|
|
424
434
|
├────────────────────────────────────────────────┤
|
|
425
|
-
│ Phase 1
|
|
435
|
+
│ Phase 1 completed │
|
|
426
436
|
│ │
|
|
427
|
-
│
|
|
437
|
+
│ Change Statistics: │
|
|
428
438
|
│ - Files: 5 │
|
|
429
439
|
│ - Added: 180 lines │
|
|
430
440
|
│ - Deleted: 12 lines │
|
|
@@ -441,19 +451,6 @@ git status
|
|
|
441
451
|
└────────────────────────────────────────────────┘
|
|
442
452
|
```
|
|
443
453
|
|
|
444
|
-
### 跳过后的追踪
|
|
445
|
-
|
|
446
|
-
当用户选择「稍后再 commit」时:
|
|
447
|
-
|
|
448
|
-
1. **记录跳过次数**
|
|
449
|
-
2. **连续跳过 3 次** → Display warning:
|
|
450
|
-
```
|
|
451
|
-
⚠️ Warning: You have skipped check-in 3 times consecutively
|
|
452
|
-
Current accumulated changes: 15 files, +520 lines
|
|
453
|
-
Recommend committing soon to avoid changes becoming too large to review
|
|
454
|
-
```
|
|
455
|
-
3. **工作结束前** → If uncommitted changes exist, strongly recommend check-in
|
|
456
|
-
|
|
457
454
|
### 批次阈值触发
|
|
458
455
|
|
|
459
456
|
当使用自动化 Pipeline 与变更批次处理时(参见[变更批次合并标准](change-batching-standards.md)):
|
|
@@ -465,27 +462,40 @@ git status
|
|
|
465
462
|
|
|
466
463
|
### 自动签入
|
|
467
464
|
|
|
468
|
-
当 Pipeline 配置中启用 `autoCheckin` 时(参见 [Pipeline
|
|
465
|
+
当 Pipeline 配置中启用 `autoCheckin` 时(参见 [Pipeline 集成标准](pipeline-integration-standards.md)):
|
|
469
466
|
|
|
470
467
|
| 前提条件 | 必须 | 说明 |
|
|
471
468
|
|---------|------|------|
|
|
472
469
|
| 所有测试通过 | 是 | 完整测试套件通过,包括新测试 |
|
|
473
|
-
| Lint 通过 | 是 |
|
|
474
|
-
| AC 覆盖率达标 | 是 | AC
|
|
470
|
+
| Lint 通过 | 是 | 变更文件无 lint 错误 |
|
|
471
|
+
| AC 覆盖率达标 | 是 | AC 覆盖率达到项目阈值 |
|
|
475
472
|
| 无冲突 | 是 | 与目标分支可干净合并 |
|
|
476
473
|
| 批次已验证 | 是(如启用批次) | 批次中所有变更已一并验证 |
|
|
477
474
|
|
|
478
475
|
**安全规则**:
|
|
479
476
|
- 自动签入**不得**推送到受保护的分支
|
|
480
|
-
- 自动签入**必须**创建正式的 commit
|
|
481
|
-
-
|
|
477
|
+
- 自动签入**必须**创建正式的 commit 消息(非「auto-commit」)
|
|
478
|
+
- 自动签入**必须**可审计(记录 who/what/when)
|
|
482
479
|
- 用户可随时以手动 commit 覆盖
|
|
483
480
|
|
|
481
|
+
### 跳过后的追踪
|
|
482
|
+
|
|
483
|
+
当用户选择「稍后再 commit」时:
|
|
484
|
+
|
|
485
|
+
1. **记录跳过次数**
|
|
486
|
+
2. **连续跳过 3 次** → Display warning:
|
|
487
|
+
```
|
|
488
|
+
⚠️ Warning: You have skipped check-in 3 times consecutively
|
|
489
|
+
Current accumulated changes: 15 files, +520 lines
|
|
490
|
+
Recommend committing soon to avoid changes becoming too large to review
|
|
491
|
+
```
|
|
492
|
+
3. **工作结束前** → If uncommitted changes exist, strongly recommend check-in
|
|
493
|
+
|
|
484
494
|
---
|
|
485
495
|
|
|
486
496
|
## 特殊情境处理
|
|
487
497
|
|
|
488
|
-
###
|
|
498
|
+
### 紧急离开(下班时)
|
|
489
499
|
|
|
490
500
|
当需要暂时离开但工作未完成时:
|
|
491
501
|
|
|
@@ -516,7 +526,7 @@ git cherry-pick <wip-commit>
|
|
|
516
526
|
|
|
517
527
|
进行技术探索或 POC 时:
|
|
518
528
|
|
|
519
|
-
1.
|
|
529
|
+
1. **创建实验分支**
|
|
520
530
|
```bash
|
|
521
531
|
git checkout -b experiment/redis-stream-poc
|
|
522
532
|
```
|
|
@@ -536,7 +546,7 @@ git cherry-pick <wip-commit>
|
|
|
536
546
|
|
|
537
547
|
生产环境紧急问题:
|
|
538
548
|
|
|
539
|
-
1. **从 main
|
|
549
|
+
1. **从 main 创建 hotfix 分支**
|
|
540
550
|
```bash
|
|
541
551
|
git checkout main
|
|
542
552
|
git checkout -b hotfix/critical-null-pointer
|
|
@@ -546,7 +556,7 @@ git cherry-pick <wip-commit>
|
|
|
546
556
|
|
|
547
557
|
3. **快速验证**: Ensure tests pass
|
|
548
558
|
|
|
549
|
-
4. **Commit
|
|
559
|
+
4. **Commit 消息标注紧急性**:
|
|
550
560
|
```
|
|
551
561
|
fix(matching): [URGENT] fix null pointer causing match failures
|
|
552
562
|
|
|
@@ -561,7 +571,7 @@ git cherry-pick <wip-commit>
|
|
|
561
571
|
|
|
562
572
|
### ❌ 不适合提交的时机
|
|
563
573
|
|
|
564
|
-
1.
|
|
574
|
+
1. **构建失败**
|
|
565
575
|
- Compilation errors present
|
|
566
576
|
- Unresolved dependencies
|
|
567
577
|
|
|
@@ -574,12 +584,12 @@ git cherry-pick <wip-commit>
|
|
|
574
584
|
- Would break existing functionality
|
|
575
585
|
- Missing critical components
|
|
576
586
|
|
|
577
|
-
4.
|
|
587
|
+
4. **实验性代码**
|
|
578
588
|
- TODO comments scattered
|
|
579
589
|
- Debugging code left in
|
|
580
590
|
- Commented-out code blocks
|
|
581
591
|
|
|
582
|
-
|
|
592
|
+
**示例情境**:
|
|
583
593
|
```
|
|
584
594
|
❌ BAD: "WIP: trying to fix login"
|
|
585
595
|
- Build has errors
|
|
@@ -601,7 +611,7 @@ git cherry-pick <wip-commit>
|
|
|
601
611
|
|
|
602
612
|
## AI 助理集成
|
|
603
613
|
|
|
604
|
-
当 AI
|
|
614
|
+
当 AI 助理完成代码变更时,必须遵循此工作流程:
|
|
605
615
|
|
|
606
616
|
### Step 1: 评估签入时机
|
|
607
617
|
|
|
@@ -610,7 +620,7 @@ git cherry-pick <wip-commit>
|
|
|
610
620
|
- Is the codebase in a working state?
|
|
611
621
|
- Are there incomplete TODOs?
|
|
612
622
|
|
|
613
|
-
|
|
623
|
+
**评估示例**:
|
|
614
624
|
```
|
|
615
625
|
✅ Complete: "Implemented user registration with validation, tests, and docs"
|
|
616
626
|
⚠️ Incomplete: "Added registration form but backend validation pending"
|
|
@@ -630,7 +640,7 @@ git cherry-pick <wip-commit>
|
|
|
630
640
|
|
|
631
641
|
**检查清单输出格式**:
|
|
632
642
|
```
|
|
633
|
-
###
|
|
643
|
+
### Checklist Results
|
|
634
644
|
|
|
635
645
|
✅ Build: dotnet build --no-warnings succeeded
|
|
636
646
|
✅ Code Quality: Follows project C# standards
|
|
@@ -641,22 +651,22 @@ git cherry-pick <wip-commit>
|
|
|
641
651
|
|
|
642
652
|
---
|
|
643
653
|
|
|
644
|
-
### Step 3:
|
|
654
|
+
### Step 3: 提示用户确认
|
|
645
655
|
|
|
646
656
|
**AI MUST use this mandatory prompt format**:
|
|
647
657
|
|
|
648
658
|
```
|
|
649
|
-
##
|
|
659
|
+
## Please Confirm Check-in
|
|
650
660
|
|
|
651
|
-
|
|
661
|
+
Completed: [Brief description of work completed]
|
|
652
662
|
|
|
653
|
-
###
|
|
663
|
+
### Checklist Results
|
|
654
664
|
✅ Item 1
|
|
655
665
|
✅ Item 2
|
|
656
666
|
⚠️ Item 3 (needs user verification)
|
|
657
667
|
✅ Item 4
|
|
658
668
|
|
|
659
|
-
|
|
669
|
+
Suggested commit message:
|
|
660
670
|
```
|
|
661
671
|
<type>(<scope>): <description>
|
|
662
672
|
|
|
@@ -665,7 +675,7 @@ git cherry-pick <wip-commit>
|
|
|
665
675
|
<footer>
|
|
666
676
|
```
|
|
667
677
|
|
|
668
|
-
|
|
678
|
+
Proceed with commit now?
|
|
669
679
|
```
|
|
670
680
|
|
|
671
681
|
---
|
|
@@ -684,11 +694,11 @@ git cherry-pick <wip-commit>
|
|
|
684
694
|
|
|
685
695
|
---
|
|
686
696
|
|
|
687
|
-
##
|
|
697
|
+
## 项目特定化
|
|
688
698
|
|
|
689
|
-
|
|
699
|
+
每个项目应通过以下方式自定义此标准:
|
|
690
700
|
|
|
691
|
-
### 1.
|
|
701
|
+
### 1. 定义构建命令
|
|
692
702
|
|
|
693
703
|
Create a `BUILD.md` or add to `CONTRIBUTING.md`:
|
|
694
704
|
```markdown
|
|
@@ -712,7 +722,7 @@ npm run build:strict
|
|
|
712
722
|
|
|
713
723
|
---
|
|
714
724
|
|
|
715
|
-
### 2.
|
|
725
|
+
### 2. 定义测试命令
|
|
716
726
|
|
|
717
727
|
```markdown
|
|
718
728
|
## Test Commands
|
|
@@ -739,7 +749,7 @@ npm run test:coverage
|
|
|
739
749
|
|
|
740
750
|
---
|
|
741
751
|
|
|
742
|
-
### 3.
|
|
752
|
+
### 3. 定义质量工具
|
|
743
753
|
|
|
744
754
|
```markdown
|
|
745
755
|
## Code Quality Tools
|
|
@@ -769,22 +779,22 @@ npm audit
|
|
|
769
779
|
### 4. 定义「完成定义」
|
|
770
780
|
|
|
771
781
|
```markdown
|
|
772
|
-
##
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
1. ✅
|
|
776
|
-
2. ✅ 2
|
|
777
|
-
3. ✅
|
|
778
|
-
4. ✅
|
|
779
|
-
5. ✅
|
|
780
|
-
6. ✅
|
|
782
|
+
## Definition of Done
|
|
783
|
+
|
|
784
|
+
A feature is considered "done" when:
|
|
785
|
+
1. ✅ All acceptance criteria met
|
|
786
|
+
2. ✅ Code reviewed by 2 team members
|
|
787
|
+
3. ✅ Tests written (min 80% coverage)
|
|
788
|
+
4. ✅ Documentation updated
|
|
789
|
+
5. ✅ Deployed to staging environment
|
|
790
|
+
6. ✅ Product owner approved
|
|
781
791
|
```
|
|
782
792
|
|
|
783
793
|
---
|
|
784
794
|
|
|
785
795
|
## 执行机制
|
|
786
796
|
|
|
787
|
-
###
|
|
797
|
+
### 提交前钩子
|
|
788
798
|
|
|
789
799
|
Use Git hooks to automate checks:
|
|
790
800
|
|
|
@@ -854,11 +864,11 @@ jobs:
|
|
|
854
864
|
|
|
855
865
|
## 提交前目录卫生
|
|
856
866
|
|
|
857
|
-
### IDE
|
|
867
|
+
### IDE 与工具生成文件
|
|
858
868
|
|
|
859
|
-
|
|
869
|
+
提交前,验证没有不需要的文件被加入暂存区:
|
|
860
870
|
|
|
861
|
-
|
|
871
|
+
**常见需检查的文件**:
|
|
862
872
|
|
|
863
873
|
| Pattern | Source | Action |
|
|
864
874
|
|---------|--------|--------|
|
|
@@ -870,7 +880,7 @@ jobs:
|
|
|
870
880
|
| `.DS_Store` | macOS | Should be gitignored |
|
|
871
881
|
| `Thumbs.db` | Windows | Should be gitignored |
|
|
872
882
|
|
|
873
|
-
###
|
|
883
|
+
### 验证命令
|
|
874
884
|
|
|
875
885
|
```bash
|
|
876
886
|
# Check for common unwanted files in staging area
|
|
@@ -915,14 +925,14 @@ node_modules/
|
|
|
915
925
|
|
|
916
926
|
> **适用范围**:.NET Framework、MSBuild `.csproj` 及任何需要显式登记文件的旧版格式。
|
|
917
927
|
|
|
918
|
-
旧版项目格式(如 `.NET Framework .csproj`)不会自动包含磁盘上的源码文件——每个文件都必须在项目 manifest
|
|
928
|
+
旧版项目格式(如 `.NET Framework .csproj`)不会自动包含磁盘上的源码文件——每个文件都必须在项目 manifest 中显式列出。未登记的文件在**编译时被静默排除,不会生成任何错误或警告**。
|
|
919
929
|
|
|
920
930
|
**风险**:新增 `.cs`/`.aspx.cs` 文件后重建 DLL,该文件被排除。测试通过(测试的是旧 DLL),正式环境崩溃并显示"无法加载类型"。
|
|
921
931
|
|
|
922
932
|
**预提交检查**:
|
|
923
933
|
|
|
924
934
|
```bash
|
|
925
|
-
#
|
|
935
|
+
# Find .cs files on disk not registered in .csproj
|
|
926
936
|
comm -23 \
|
|
927
937
|
<(find . -name "*.cs" | sort) \
|
|
928
938
|
<(grep -oP '(?<=Include=")[^"]+\.cs' MyProject.csproj | sort)
|
|
@@ -955,7 +965,7 @@ git commit -m "trying stuff"
|
|
|
955
965
|
|
|
956
966
|
---
|
|
957
967
|
|
|
958
|
-
### 违规 2:
|
|
968
|
+
### 违规 2: 提交注释代码
|
|
959
969
|
|
|
960
970
|
**问题**:
|
|
961
971
|
```javascript
|
|
@@ -1010,9 +1020,10 @@ git commit -m "feat(module-c): add export to CSV feature"
|
|
|
1010
1020
|
|
|
1011
1021
|
| 版本 | 日期 | 变更 |
|
|
1012
1022
|
|---------|------|---------|
|
|
1023
|
+
| 1.7.0 | 2026-06-18 | 新增:代码异味阈值的出处与可配置说明(McCabe 1976 圈复杂度;linter 默认值)(XSPEC-292 T8) |
|
|
1013
1024
|
| 1.5.0 | 2026-03-18 | 新增:AC 覆盖率验证、批次阈值触发、自动签入规则 |
|
|
1014
1025
|
| 1.4.0 | 2026-01-16 | 新增:Bug 修复测试评估章节与决策矩阵 |
|
|
1015
|
-
| 1.3.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 6
|
|
1026
|
+
| 1.3.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 6 章(软件配置管理)至参考资料 |
|
|
1016
1027
|
| 1.2.5 | 2025-12-16 | Clarified: CHANGELOG update is for user-facing changes only, added to [Unreleased] section |
|
|
1017
1028
|
| 1.2.4 | 2025-12-11 | Added: Pre-commit directory hygiene section (IDE artifacts, verification commands) |
|
|
1018
1029
|
| 1.2.3 | 2025-12-05 | Added: Reference to testing-standards.md |
|
|
@@ -1027,57 +1038,106 @@ git commit -m "feat(module-c): add export to CSV feature"
|
|
|
1027
1038
|
|
|
1028
1039
|
### 规则严重性分类
|
|
1029
1040
|
|
|
1041
|
+
将 lint 规则分为三个严重性层级,并明确对应的 CI 行为:
|
|
1042
|
+
|
|
1030
1043
|
| 层级 | CI 行为 | 适用场景 | 示例 |
|
|
1031
1044
|
|------|---------|----------|------|
|
|
1032
1045
|
| **Error** | 阻断 CI(build 失败) | 可能的 Bug、安全问题 | 未使用变量、未处理 Promise、`eval` 使用 |
|
|
1033
|
-
| **Warning** | 通过但报告 |
|
|
1034
|
-
| **Info** | 静默通过 |
|
|
1046
|
+
| **Warning** | 通过但报告 | 质量建议、应修复 | 函数过长、嵌套过深、TODO 标记 |
|
|
1047
|
+
| **Info** | 静默通过 | 风格偏好、信息性 | 行尾空白、import 排序 |
|
|
1048
|
+
|
|
1049
|
+
**规则分类决策树:**
|
|
1050
|
+
|
|
1051
|
+
```
|
|
1052
|
+
Could this rule violation cause a bug?
|
|
1053
|
+
├─ Yes → Error
|
|
1054
|
+
└─ No
|
|
1055
|
+
├─ Could it degrade maintainability?
|
|
1056
|
+
│ ├─ Yes → Warning
|
|
1057
|
+
│ └─ No → Info
|
|
1058
|
+
└─ Does it involve security?
|
|
1059
|
+
└─ Yes → Error
|
|
1060
|
+
```
|
|
1035
1061
|
|
|
1036
1062
|
### Auto-fix 策略
|
|
1037
1063
|
|
|
1038
|
-
|
|
1039
|
-
|
|
1040
|
-
|
|
|
1041
|
-
|
|
1042
|
-
|
|
|
1064
|
+
并非所有 lint 规则都应自动修复。按安全性分类:
|
|
1065
|
+
|
|
1066
|
+
| 类别 | 条件 | 示例 | 允许自动修复 |
|
|
1067
|
+
|------|------|------|-------------|
|
|
1068
|
+
| **✅ 可安全自动修复** | 修复结果确定,不改变语义 | 缩进、分号、import 排序、尾随逗号 | 是 |
|
|
1069
|
+
| **⚠️ 需确认** | 修复可能改变语义 | 变量重命名、类型推断 | 确认后再应用 |
|
|
1070
|
+
| **❌ 禁止自动修复** | 修复需要理解上下文 | 移除未使用变量、重构复杂逻辑 | 绝不——需要人工判断 |
|
|
1043
1071
|
|
|
1044
1072
|
**Auto-fix 时机:**
|
|
1045
1073
|
|
|
1046
1074
|
| 时机 | 行为 | 理由 |
|
|
1047
1075
|
|------|------|------|
|
|
1048
|
-
| **Pre-commit hook** |
|
|
1076
|
+
| **Pre-commit hook** | 自动修复安全规则(格式化) | 快速反馈、干净提交 |
|
|
1049
1077
|
| **CI pipeline** | 仅检查,不修复 | 确保开发者了解问题 |
|
|
1050
1078
|
| **PR review** | 以 PR 评论建议 | 不阻断、具教育意义 |
|
|
1051
1079
|
|
|
1052
1080
|
### 团队一致性原则
|
|
1053
1081
|
|
|
1082
|
+
目标不是统一的通用风格,而是**团队内部的一致性**:
|
|
1083
|
+
|
|
1054
1084
|
| 原则 | 说明 |
|
|
1055
1085
|
|------|------|
|
|
1056
1086
|
| **团队决定** | 风格选择由团队投票,非个人偏好 |
|
|
1057
1087
|
| **配置纳入版控** | Lint 配置文件必须提交至 Git |
|
|
1058
|
-
|
|
|
1088
|
+
| **决定后不辩论(no bikeshedding)** | 一经采用,全员遵循;尽量减少风格争论 |
|
|
1059
1089
|
| **自动化优先** | 能由工具强制的规则不依赖人工审查 |
|
|
1060
1090
|
| **新项目严格** | 新项目使用严格规则集;既有项目渐进采用 |
|
|
1061
1091
|
|
|
1062
1092
|
### 渐进采用
|
|
1063
1093
|
|
|
1094
|
+
既有项目引入 linting 时:
|
|
1095
|
+
|
|
1064
1096
|
1. **仅对新增/修改文件应用严格规则** — 不要求一次修复整个 codebase
|
|
1065
|
-
2. **允许 `// eslint-disable-next-line` 但设上限** —
|
|
1066
|
-
3. **每季减少 disable 数量** —
|
|
1067
|
-
4. **全面强制** —
|
|
1097
|
+
2. **允许 `// eslint-disable-next-line` 但设上限** — 允许对既有违规使用 disable 标记,但设置最大数量(例如每项目 < 100 个)
|
|
1098
|
+
3. **每季减少 disable 数量** — 每季度将允许的 disable 数量减少 25%
|
|
1099
|
+
4. **全面强制** — 最终在所有文件上启用全面强制
|
|
1100
|
+
|
|
1101
|
+
### 语言无关的配置模板
|
|
1102
|
+
|
|
1103
|
+
为任何语言配置 linting 时,可参考以下语言无关的 YAML 模板:
|
|
1104
|
+
|
|
1105
|
+
```yaml
|
|
1106
|
+
# Lint Configuration Strategy (language-agnostic)
|
|
1107
|
+
rules:
|
|
1108
|
+
# Error-level: Block CI
|
|
1109
|
+
security: error # Security-related checks (e.g., eval, SQL injection patterns)
|
|
1110
|
+
possible-bugs: error # Likely bug patterns (e.g., unused vars, unreachable code)
|
|
1111
|
+
type-safety: error # Type-related issues (if applicable)
|
|
1112
|
+
|
|
1113
|
+
# Warning-level: Report but pass CI
|
|
1114
|
+
maintainability: warning # Complexity, duplication, long functions
|
|
1115
|
+
naming: warning # Naming conventions
|
|
1116
|
+
documentation: warning # Missing docs for public APIs
|
|
1117
|
+
|
|
1118
|
+
# Info-level: Silent
|
|
1119
|
+
style: info # Formatting preferences
|
|
1120
|
+
import-order: info # Import organization
|
|
1121
|
+
|
|
1122
|
+
auto_fix:
|
|
1123
|
+
on_save: true # Format on save in editor
|
|
1124
|
+
on_commit: true # Fix safe rules in pre-commit hook
|
|
1125
|
+
on_ci: false # CI only checks, never fixes
|
|
1126
|
+
```
|
|
1068
1127
|
|
|
1069
1128
|
---
|
|
1070
1129
|
|
|
1071
1130
|
## 相关标准
|
|
1072
1131
|
|
|
1073
|
-
- [
|
|
1132
|
+
- [项目结构标准](project-structure.md)
|
|
1074
1133
|
- [测试标准](testing-standards.md)(或使用 `/testing-guide` 技能)
|
|
1075
|
-
- [Commit
|
|
1076
|
-
- [
|
|
1077
|
-
- [部署标准](deployment-standards.md) -
|
|
1134
|
+
- [Commit 消息规范](commit-message-guide.md)
|
|
1135
|
+
- [代码审查清单](code-review-checklist.md)
|
|
1136
|
+
- [部署标准](deployment-standards.md) - 质量关卡与部署就绪性
|
|
1078
1137
|
- [验收条件追溯标准](acceptance-criteria-traceability.md) - AC 覆盖率验证
|
|
1079
1138
|
- [变更批次合并标准](change-batching-standards.md) - 批次阈值触发
|
|
1080
|
-
- [Pipeline
|
|
1139
|
+
- [Pipeline 集成标准](pipeline-integration-standards.md) - 自动签入
|
|
1140
|
+
- [发布就绪关卡](release-readiness-gate.md) - **签入 ≠ 发布就绪**:通过每次提交的关卡是投入生产的必要条件但非充分条件;发布时“完成”的含义请参见 16 维度发布关卡
|
|
1081
1141
|
|
|
1082
1142
|
---
|
|
1083
1143
|
|
|
@@ -1086,7 +1146,7 @@ git commit -m "feat(module-c): add export to CSV feature"
|
|
|
1086
1146
|
- [Conventional Commits](https://www.conventionalcommits.org/)
|
|
1087
1147
|
- [The Art of the Commit](https://alistapart.com/article/the-art-of-the-commit/)
|
|
1088
1148
|
- [Git Best Practices](https://sethrobertson.github.io/GitBestPractices/)
|
|
1089
|
-
- [SWEBOK v4.0 - 第 6
|
|
1149
|
+
- [SWEBOK v4.0 - 第 6 章:软件配置管理](https://www.computer.org/education/bodies-of-knowledge/software-engineering) - IEEE Computer Society
|
|
1090
1150
|
|
|
1091
1151
|
---
|
|
1092
1152
|
|