universal-dev-standards 6.14.0-beta.9 → 6.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/versioning.md +737 -73
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +2 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +2 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/.claude-plugin/plugin.json +71 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +72 -3
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec.js +4 -2
- package/src/commands/update.js +173 -20
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +106 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -1,521 +1,300 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
3
|
-
source_version: 1.
|
|
2
|
+
source: ../../../../core/guides/anti-hallucination-guide.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.4.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: 884f338dfc76
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
#
|
|
10
|
+
# 防幻覺指引
|
|
10
11
|
|
|
11
|
-
> **語言**: [English](../../../../core/anti-hallucination.md) | 繁體中文
|
|
12
|
+
> **語言**: [English](../../../../core/guides/anti-hallucination-guide.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-01-
|
|
15
|
-
|
|
14
|
+
**版本**: 1.0.0
|
|
15
|
+
**最後更新**: 2026-01-29
|
|
16
|
+
**相關標準**: [防幻覺標準](../anti-hallucination.md)
|
|
16
17
|
|
|
17
18
|
---
|
|
18
19
|
|
|
19
20
|
## 目的
|
|
20
21
|
|
|
21
|
-
|
|
22
|
+
本指引提供防止 AI 幻覺的詳細範例、對話模式與案例研究。關於核心規範、標籤系統與驗證檢查清單,請參見 [防幻覺標準](../anti-hallucination.md)。
|
|
22
23
|
|
|
23
24
|
---
|
|
24
25
|
|
|
25
|
-
##
|
|
26
|
+
## 目錄
|
|
26
27
|
|
|
27
|
-
|
|
28
|
+
1. [理解 AI 幻覺](#understanding-ai-hallucination)
|
|
29
|
+
2. [對話語言指引](#conversation-language-guidelines)
|
|
30
|
+
3. [建議的最佳實務](#recommendation-best-practices)
|
|
31
|
+
4. [依類別的詳細範例](#detailed-examples-by-category)
|
|
32
|
+
5. [審查情境](#review-scenarios)
|
|
33
|
+
6. [AI 助理工作流程](#ai-assistant-workflow)
|
|
34
|
+
7. [語言無關應用](#language-agnostic-application)
|
|
35
|
+
8. [與程式碼審查整合](#integration-with-code-review)
|
|
28
36
|
|
|
29
|
-
|
|
37
|
+
---
|
|
30
38
|
|
|
31
|
-
|
|
32
|
-
|------|------|------|
|
|
33
|
-
| 對話互動 | 使用專案指定語言 | 繁體中文、英文等 |
|
|
34
|
-
| 確定性標籤 | 使用專案指定語言 | `[已確認]` 或 `[Confirmed]` |
|
|
35
|
-
| 錯誤訊息解釋 | 使用專案指定語言 | 以使用者語言解釋編譯/執行錯誤 |
|
|
36
|
-
| 技術術語 | 保留原文 | JWT、BCrypt、API、Token |
|
|
37
|
-
| 程式碼註解 | 遵循專案慣例 | 通常為英文 |
|
|
38
|
-
| Commit 訊息 | 遵循專案慣例 | 如 `feat(auth): 新增登入功能` |
|
|
39
|
+
## 理解 AI 幻覺
|
|
39
40
|
|
|
40
|
-
|
|
41
|
+
AI 幻覺發生於 AI 助理生成看似具權威性但實際上卻是:
|
|
42
|
+
- **捏造**:毫無證據憑空編造
|
|
43
|
+
- **假設**:基於模式而非事實
|
|
44
|
+
- **過時**:來自訓練資料,而非當前現實
|
|
45
|
+
- **錯誤歸屬**:與相似但不同的系統混淆
|
|
41
46
|
|
|
42
|
-
|
|
47
|
+
### 為什麼這在軟體開發中很重要
|
|
43
48
|
|
|
44
|
-
|
|
|
49
|
+
| 風險 | 影響 | 範例 |
|
|
45
50
|
|------|------|------|
|
|
46
|
-
|
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
51
|
-
**範例**:
|
|
52
|
-
|
|
53
|
-
❌ **錯誤**:
|
|
54
|
-
```
|
|
55
|
-
有三個選項:
|
|
56
|
-
1. 使用 Redis 快取
|
|
57
|
-
2. 使用記憶體快取
|
|
58
|
-
3. 使用檔案快取
|
|
59
|
-
|
|
60
|
-
請選擇一個。
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
✅ **正確**:
|
|
64
|
-
```
|
|
65
|
-
有三個選項:
|
|
66
|
-
1. 使用 Redis 快取
|
|
67
|
-
2. 使用記憶體快取
|
|
68
|
-
3. 使用檔案快取
|
|
69
|
-
|
|
70
|
-
**推薦: 選項 1 (Redis)**: 考量專案已有 Redis 基礎設施且需要跨實例共享快取,Redis 是最適合的選擇。
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
### 下一步建議
|
|
74
|
-
|
|
75
|
-
**規則**: 當完成一項任務或子任務時,AI 助手**必須**建議合理的下一步工作,並明確標示**最推薦**的選項。
|
|
76
|
-
|
|
77
|
-
**指引**:
|
|
78
|
-
- **主動性**: 不要等待使用者問「接下來呢?」。
|
|
79
|
-
- **情境相關**: 建議應遵循專案的工作流程(如:提案 -> 實作 -> 測試)。
|
|
80
|
-
- **明確推薦**: 使用 `[推薦]` 或 `[Recommended]` 標示最佳路徑。
|
|
81
|
-
|
|
82
|
-
**範例**:
|
|
83
|
-
|
|
84
|
-
✅ **正確**:
|
|
85
|
-
```
|
|
86
|
-
任務完成: API 端點已實作。
|
|
87
|
-
|
|
88
|
-
**建議下一步**:
|
|
89
|
-
1. **[推薦]** 為新端點新增單元測試 (`src/tests/api/`)
|
|
90
|
-
2. 更新 API 文件 (`docs/api-reference.md`)
|
|
91
|
-
3. 開始前端整合
|
|
92
|
-
```
|
|
51
|
+
| **捏造的 API** | 執行期錯誤、浪費除錯時間 | 「呼叫 `user.authenticate()` 方法」(不存在) |
|
|
52
|
+
| **錯誤的設定** | 安全性弱點、系統故障 | 「在正式環境中設定 `DEBUG=true`」(錯誤的變數) |
|
|
53
|
+
| **假設的需求** | 建置錯誤的功能 | 「使用者需要 SSO」(從未被指定) |
|
|
54
|
+
| **過時的模式** | 技術債、安全性問題 | 「使用 `componentWillMount`」(在 React 17 中已棄用) |
|
|
93
55
|
|
|
94
56
|
---
|
|
95
57
|
|
|
96
|
-
##
|
|
97
|
-
|
|
98
|
-
### 1. 僅基於證據的分析
|
|
99
|
-
|
|
100
|
-
**規則**: 僅分析和引用已明確提供或讀取的內容。
|
|
101
|
-
|
|
102
|
-
**指引**:
|
|
103
|
-
- ✅ 分析已使用檔案讀取工具讀取的程式碼檔案
|
|
104
|
-
- ✅ 引用已擷取的文件
|
|
105
|
-
- ✅ 引用已檢查的設定檔
|
|
106
|
-
- ❌ 不要推測未見過的 API、函式或設定
|
|
107
|
-
- ❌ 不要在未驗證的情況下假設框架行為
|
|
108
|
-
- ❌ 不要捏造需求細節
|
|
58
|
+
## 對話語言指引
|
|
109
59
|
|
|
110
|
-
|
|
60
|
+
### 適應使用者偏好
|
|
111
61
|
|
|
112
|
-
|
|
113
|
-
```
|
|
114
|
-
[證據] 在 src/auth/service.ts:45,JWT 驗證邏輯使用 'jsonwebtoken' 函式庫
|
|
115
|
-
[證據] package.json 檔案(第 12-18 行)列出 Express 4.18.2 作為相依項目
|
|
116
|
-
```
|
|
62
|
+
AI 助理應適應使用者的偏好語言,同時保持技術準確性:
|
|
117
63
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
64
|
+
| 情境 | 準則 | 範例 |
|
|
65
|
+
|------|------|------|
|
|
66
|
+
| 對話 | 使用專案指定語言 | 繁體中文、英文等 |
|
|
67
|
+
| 確定性標籤 | 使用專案指定語言 | `[Confirmed]` 或 `[已確認]` |
|
|
68
|
+
| 錯誤解釋 | 使用專案指定語言 | 以使用者的語言解釋編譯/執行期錯誤 |
|
|
69
|
+
| 技術術語 | 保留原文 | JWT、BCrypt、API、Token |
|
|
70
|
+
| 程式碼註解 | 遵循專案慣例 | 通常為英文 |
|
|
71
|
+
| Commit 訊息 | 遵循專案慣例 | 例如 `feat(auth): add login feature` |
|
|
124
72
|
|
|
125
73
|
---
|
|
126
74
|
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
**規則**: 所有引用必須包含來源類型、位置與可驗證性資訊。
|
|
130
|
-
|
|
131
|
-
#### 2.1 來源類型
|
|
75
|
+
## 建議的最佳實務
|
|
132
76
|
|
|
133
|
-
|
|
134
|
-
|---------|------|------|--------|
|
|
135
|
-
| 專案程式碼 | `[來源: 程式碼]` | 直接從程式碼庫讀取 | ⭐⭐⭐⭐⭐ 最高 |
|
|
136
|
-
| 專案文件 | `[來源: 文件]` | README、Wiki、程式碼註解 | ⭐⭐⭐⭐ 高 |
|
|
137
|
-
| 外部文件 | `[來源: 外部]` | 官方文件(附 URL) | ⭐⭐⭐⭐ 高 |
|
|
138
|
-
| 網路搜尋 | `[來源: 搜尋]` | 搜尋結果(包含日期) | ⭐⭐⭐ 中 |
|
|
139
|
-
| AI 知識 | `[來源: 知識]` | AI 訓練資料(需驗證) | ⭐⭐ 低 |
|
|
140
|
-
| 使用者提供 | `[來源: 使用者]` | 使用者對話中的資訊 | ⭐⭐⭐ 中 |
|
|
141
|
-
|
|
142
|
-
#### 2.2 標註格式
|
|
143
|
-
|
|
144
|
-
**程式碼引用**:
|
|
145
|
-
```
|
|
146
|
-
[來源: 程式碼] 檔案路徑:行號 - 描述
|
|
147
|
-
```
|
|
77
|
+
### 永遠包含推薦的選項
|
|
148
78
|
|
|
149
|
-
|
|
150
|
-
```
|
|
151
|
-
[來源: 外部] URL - 描述(版本: x.x.x,存取: YYYY-MM-DD)
|
|
152
|
-
```
|
|
79
|
+
當提供多個選項時,永遠包含推薦的選項並說明理由:
|
|
153
80
|
|
|
154
|
-
|
|
155
|
-
```
|
|
156
|
-
[來源: 知識] 主題 - 描述(⚠️ 需要驗證)
|
|
81
|
+
**❌ 錯誤**:
|
|
157
82
|
```
|
|
83
|
+
There are three options:
|
|
84
|
+
1. Use Redis caching
|
|
85
|
+
2. Use in-memory caching
|
|
86
|
+
3. Use file-based caching
|
|
158
87
|
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
✅ **正確**:
|
|
162
|
-
```
|
|
163
|
-
[來源: 程式碼] UserService.cs:142 - 密碼雜湊使用 BCrypt
|
|
164
|
-
[來源: 程式碼] app.config:23-28 - 資料庫連線字串設定為 SQL Server
|
|
165
|
-
[來源: 文件] README.md:15 - 專案需要 .NET 8.0 SDK
|
|
166
|
-
[來源: 外部] https://react.dev/reference/react/useState - useState hook API(版本: React 18,存取: 2025-12-10)
|
|
167
|
-
[來源: 搜尋] "Express.js middleware order" - 中介軟體依註冊順序執行(搜尋: 2025-12-10)
|
|
168
|
-
[來源: 知識] HTTP 狀態碼 - 404 表示資源未找到(⚠️ 一般知識,請驗證您的 API)
|
|
169
|
-
[來源: 使用者] 使用者在對話中表示 - 驗證必須支援 OAuth2
|
|
88
|
+
Please choose one.
|
|
170
89
|
```
|
|
171
90
|
|
|
172
|
-
|
|
173
|
-
```
|
|
174
|
-
驗證服務使用 BCrypt(無來源類型,無檔案引用)
|
|
175
|
-
設定檔案中某處有資料庫連線(模糊引用)
|
|
176
|
-
我認為 README 提到 .NET 8(不確定語言,無來源)
|
|
177
|
-
React useState 的運作方式是...(無版本,無引用)
|
|
91
|
+
**✅ 正確**:
|
|
178
92
|
```
|
|
93
|
+
There are three options:
|
|
94
|
+
1. Use Redis caching
|
|
95
|
+
2. Use in-memory caching
|
|
96
|
+
3. Use file-based caching
|
|
179
97
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
**規則**: 引用函式庫、框架或 API 時,必須包含版本資訊(如有)。
|
|
183
|
-
|
|
184
|
-
**為何重要**:
|
|
185
|
-
- API 在不同版本間會改變
|
|
186
|
-
- 已棄用的功能可能仍出現在 AI 訓練資料中
|
|
187
|
-
- 安全性漏洞是版本特定的
|
|
188
|
-
|
|
189
|
-
**範例**:
|
|
98
|
+
**Recommended: Option 1 (Redis)**: Given the project already has Redis infrastructure
|
|
99
|
+
and needs cross-instance cache sharing, Redis is the most suitable choice.
|
|
190
100
|
```
|
|
191
|
-
✅ [來源: 外部] Next.js App Router (v14.x) - Server Components 是預設值
|
|
192
|
-
✅ [來源: 程式碼] package.json:12 - 使用 "express": "^4.18.2"
|
|
193
|
-
❌ "Next.js 使用 Server Components"(哪個版本?v12 和 v14 行為不同)
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
---
|
|
197
101
|
|
|
198
|
-
###
|
|
199
|
-
|
|
200
|
-
**規則**: 明確區分已確認事實、推測與未知事項。
|
|
201
|
-
|
|
202
|
-
**分類標籤**:
|
|
203
|
-
|
|
204
|
-
| 標籤 | 使用時機 |
|
|
205
|
-
|-----|---------|
|
|
206
|
-
| `[已確認]` | 直接來自程式碼/文件的證據 |
|
|
207
|
-
| `[推測]` | 基於現有證據的邏輯推論 |
|
|
208
|
-
| `[假設]` | 基於常見模式(需驗證)|
|
|
209
|
-
| `[未知]` | 資訊不可得 |
|
|
210
|
-
| `[需確認]` | 需要使用者澄清 |
|
|
102
|
+
### 下一步建議
|
|
211
103
|
|
|
212
|
-
|
|
104
|
+
當完成一項任務或子任務時,永遠建議合理的下一步:
|
|
213
105
|
|
|
214
|
-
|
|
215
|
-
```
|
|
216
|
-
[已確認] src/database/connection.ts:12 - 使用 PostgreSQL 驅動程式 'pg'
|
|
217
|
-
[推測] 基於 src/repositories/ 中的 repository 模式,可能使用依賴注入
|
|
218
|
-
[假設] 專案可能使用 OAuth2,但需要審查驗證設定
|
|
219
|
-
[未知] API 速率限制策略未記錄
|
|
220
|
-
[需確認] 新功能是否應支援多租戶?
|
|
106
|
+
**✅ 正確**:
|
|
221
107
|
```
|
|
108
|
+
Task completed: API endpoint implemented.
|
|
222
109
|
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
使用者需要 SSO 支援(假設以已確認需求呈現)
|
|
110
|
+
**Suggested Next Steps**:
|
|
111
|
+
1. **[Recommended]** Add unit tests for the new endpoint (`src/tests/api/`)
|
|
112
|
+
2. Update API documentation (`docs/api-reference.md`)
|
|
113
|
+
3. Start frontend integration
|
|
228
114
|
```
|
|
229
115
|
|
|
230
|
-
#### 統一標籤系統
|
|
231
|
-
|
|
232
|
-
本標準定義兩類互補的標籤類別,用於相關標準:
|
|
233
|
-
|
|
234
|
-
**類別 1:確定性標籤**(用於分析現有內容)
|
|
235
|
-
|
|
236
|
-
用於分析程式碼、審查文件或討論系統時。參見[反向工程標準](../reverse-engineering-standards.md)。
|
|
237
|
-
|
|
238
|
-
| 標籤 | 用途 | 範例情境 |
|
|
239
|
-
|-----|------|---------|
|
|
240
|
-
| `[已確認]` | 直接來自程式碼/文件的證據 | 程式碼分析、測試提取 |
|
|
241
|
-
| `[推測]` | 基於模式的邏輯推論 | 行為分析、架構審查 |
|
|
242
|
-
| `[假設]` | 需驗證的合理猜測 | 缺口識別、推測 |
|
|
243
|
-
| `[未知]` | 無法從現有資訊判斷 | 缺少文件 |
|
|
244
|
-
| `[需確認]` | 需要人類輸入 | 模糊的需求 |
|
|
245
|
-
|
|
246
|
-
**類別 2:推導標籤**(用於生成新內容)
|
|
247
|
-
|
|
248
|
-
用於從已核准來源生成測試、規格或文件時。參見[正向推演標準](../forward-derivation-standards.md)。
|
|
249
|
-
|
|
250
|
-
| 標籤 | 用途 | 範例情境 |
|
|
251
|
-
|-----|------|---------|
|
|
252
|
-
| `[來源]` | 直接來自規格/需求的內容 | SPEC 標題、AC 文字原文 |
|
|
253
|
-
| `[推導]` | 從來源內容轉換而來 | 從條列 AC 轉換的 GWT |
|
|
254
|
-
| `[生成]` | AI 生成的結構 | 測試骨架、TODO 註解 |
|
|
255
|
-
| `[待辦]` | 需要人類實作 | Step definitions、斷言 |
|
|
256
|
-
|
|
257
|
-
**何時使用哪種**:
|
|
258
|
-
|
|
259
|
-
| 工作流程 | 主要標籤 | 次要標籤 |
|
|
260
|
-
|----------|---------|---------|
|
|
261
|
-
| 程式碼分析 | 確定性標籤 | - |
|
|
262
|
-
| 反向工程 | 確定性標籤 | - |
|
|
263
|
-
| 正向推演 | 推導標籤 | 確定性標籤(用於缺口)|
|
|
264
|
-
| 規格生成 | 推導標籤 | 確定性標籤(用於未知)|
|
|
265
|
-
|
|
266
116
|
---
|
|
267
117
|
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
**AI 助手不得**:
|
|
271
|
-
|
|
272
|
-
1. **捏造 API 或函式簽名**
|
|
273
|
-
- ❌ 不要編造方法名稱、參數或回傳類型
|
|
274
|
-
- ✅ 要讀取實際原始碼或詢問使用者
|
|
275
|
-
|
|
276
|
-
2. **假設需求**
|
|
277
|
-
- ❌ 不要猜測使用者需求或業務規則
|
|
278
|
-
- ✅ 當需求模糊時要提出澄清問題
|
|
279
|
-
|
|
280
|
-
3. **推測未讀取的程式碼**
|
|
281
|
-
- ❌ 不要描述未審查檔案的功能
|
|
282
|
-
- ✅ 要明確表示「需要讀取 [檔案] 以確認」
|
|
118
|
+
## 各類別詳細範例
|
|
283
119
|
|
|
284
|
-
|
|
285
|
-
- ❌ 不要假設環境變數、設定鍵或資料庫結構
|
|
286
|
-
- ✅ 要審查實際設定檔
|
|
120
|
+
### 1. 捏造 API 或函式簽名
|
|
287
121
|
|
|
288
|
-
|
|
289
|
-
- ❌ 不要在無證據的情況下聲稱程式碼有問題
|
|
290
|
-
- ✅ 要分析實際程式碼並引用特定行號
|
|
291
|
-
|
|
292
|
-
6. **提出選項但不推薦**
|
|
293
|
-
- ❌ 不要列出選項後要求使用者選擇而不提供指引
|
|
294
|
-
- ✅ 要永遠包含推薦選項並附理由
|
|
295
|
-
|
|
296
|
-
7. **未分析副作用即實作**
|
|
297
|
-
- ❌ 不要在未識別潛在副作用的情況下開始寫程式碼
|
|
298
|
-
- ✅ 要在實作前列出至少 3 個潛在副作用
|
|
299
|
-
- ✅ 要考慮:狀態變更、相依性、連鎖效應
|
|
300
|
-
|
|
301
|
-
#### 詳細範例
|
|
302
|
-
|
|
303
|
-
##### 1. 捏造 API 或函式名稱
|
|
304
|
-
|
|
305
|
-
❌ **錯誤**:
|
|
122
|
+
**❌ 錯誤**:
|
|
306
123
|
```
|
|
307
|
-
|
|
124
|
+
Assistant: "You can call UserService.GetUserById(int id) to retrieve users"
|
|
308
125
|
```
|
|
309
126
|
**問題**: 方法不存在或簽名不同。
|
|
310
127
|
|
|
311
|
-
|
|
128
|
+
**✅ 正確**:
|
|
312
129
|
```
|
|
313
|
-
|
|
130
|
+
Assistant: "Let me read the UserService file to find the correct method signature."
|
|
314
131
|
|
|
315
|
-
[
|
|
132
|
+
[After reading src/services/UserService.cs]
|
|
316
133
|
|
|
317
|
-
[
|
|
318
|
-
|
|
134
|
+
[Source: Code] UserService.cs:45 - Found method: FindUser(Guid userId)
|
|
135
|
+
The actual method uses Guid instead of int for the user ID parameter.
|
|
319
136
|
```
|
|
320
137
|
|
|
321
138
|
---
|
|
322
139
|
|
|
323
|
-
|
|
140
|
+
### 2. 假設需求
|
|
324
141
|
|
|
325
|
-
|
|
142
|
+
**❌ 錯誤**:
|
|
326
143
|
```
|
|
327
|
-
|
|
144
|
+
Assistant: "The system needs to support OAuth and SAML for enterprise SSO."
|
|
328
145
|
```
|
|
329
|
-
**問題**:
|
|
146
|
+
**問題**: 使用者只詢問驗證,未指定協定。
|
|
330
147
|
|
|
331
|
-
|
|
148
|
+
**✅ 正確**:
|
|
332
149
|
```
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
1.
|
|
336
|
-
2.
|
|
337
|
-
3.
|
|
150
|
+
Assistant: "[Need Confirmation] You mentioned needing authentication.
|
|
151
|
+
Could you clarify:
|
|
152
|
+
1. Is this for internal users, external customers, or both?
|
|
153
|
+
2. Do you need enterprise SSO (OAuth/SAML) or simple username/password?
|
|
154
|
+
3. Any existing identity providers to integrate with?
|
|
338
155
|
|
|
339
|
-
|
|
156
|
+
This will help me recommend the most appropriate approach."
|
|
340
157
|
```
|
|
341
158
|
|
|
342
159
|
---
|
|
343
160
|
|
|
344
|
-
|
|
161
|
+
### 3. 推測未讀取的程式碼
|
|
345
162
|
|
|
346
|
-
|
|
163
|
+
**❌ 錯誤**:
|
|
347
164
|
```
|
|
348
|
-
|
|
165
|
+
Assistant: "The PaymentService handles credit card processing and integrates with Stripe."
|
|
349
166
|
```
|
|
350
167
|
**問題**: 檔案未讀取,功能僅從名稱假設。
|
|
351
168
|
|
|
352
|
-
|
|
169
|
+
**✅ 正確**:
|
|
353
170
|
```
|
|
354
|
-
|
|
171
|
+
Assistant: "I see a file named PaymentService.cs in your project structure.
|
|
355
172
|
|
|
356
|
-
[
|
|
173
|
+
[Unknown] I haven't read this file yet, so I cannot confirm its functionality.
|
|
357
174
|
|
|
358
|
-
|
|
359
|
-
-
|
|
360
|
-
-
|
|
361
|
-
-
|
|
175
|
+
Would you like me to read src/services/PaymentService.cs to understand:
|
|
176
|
+
- Which payment provider it uses?
|
|
177
|
+
- What payment methods are supported?
|
|
178
|
+
- How transactions are processed?"
|
|
362
179
|
```
|
|
363
180
|
|
|
364
181
|
---
|
|
365
182
|
|
|
366
|
-
|
|
183
|
+
### 4. 編造設定
|
|
367
184
|
|
|
368
|
-
|
|
185
|
+
**❌ 錯誤**:
|
|
369
186
|
```
|
|
370
|
-
|
|
371
|
-
|
|
187
|
+
Assistant: "Set the DATABASE_URL environment variable to connect to PostgreSQL.
|
|
188
|
+
Your connection string should be in appsettings.json under 'ConnectionStrings:DefaultConnection'."
|
|
372
189
|
```
|
|
373
|
-
**問題**:
|
|
190
|
+
**問題**: 設定結構與變數名稱未經驗證即假設。
|
|
374
191
|
|
|
375
|
-
|
|
192
|
+
**✅ 正確**:
|
|
376
193
|
```
|
|
377
|
-
|
|
194
|
+
Assistant: "Let me check your actual configuration files."
|
|
378
195
|
|
|
379
|
-
[
|
|
196
|
+
[After reading appsettings.json]
|
|
380
197
|
|
|
381
|
-
[
|
|
382
|
-
-
|
|
383
|
-
-
|
|
384
|
-
-
|
|
198
|
+
[Source: Code] appsettings.json:8-12 - Found database configuration:
|
|
199
|
+
- Connection string key: "ConnectionStrings:MainDb" (not "DefaultConnection")
|
|
200
|
+
- Using SQL Server, not PostgreSQL
|
|
201
|
+
- Additional setting "CommandTimeout": 30
|
|
385
202
|
|
|
386
|
-
|
|
203
|
+
Your project uses a different key name than the .NET default.
|
|
387
204
|
```
|
|
388
205
|
|
|
389
206
|
---
|
|
390
207
|
|
|
391
|
-
|
|
208
|
+
### 5. 憑空產生錯誤或 Bug
|
|
392
209
|
|
|
393
|
-
|
|
210
|
+
**❌ 錯誤**:
|
|
394
211
|
```
|
|
395
|
-
|
|
396
|
-
|
|
212
|
+
Assistant: "Your authentication code has a security vulnerability -
|
|
213
|
+
you're not hashing passwords properly."
|
|
397
214
|
```
|
|
398
215
|
**問題**: 未讀取實際程式碼即聲稱有 Bug。
|
|
399
216
|
|
|
400
|
-
|
|
217
|
+
**✅ 正確**:
|
|
401
218
|
```
|
|
402
|
-
|
|
219
|
+
Assistant: "Let me review your authentication implementation."
|
|
403
220
|
|
|
404
|
-
[
|
|
221
|
+
[After reading src/auth/AuthService.cs]
|
|
405
222
|
|
|
406
|
-
[
|
|
407
|
-
-
|
|
408
|
-
- Salt
|
|
409
|
-
-
|
|
223
|
+
[Confirmed] AuthService.cs:67 - Password hashing implementation found:
|
|
224
|
+
- Using BCrypt with work factor 12 ✅
|
|
225
|
+
- Salt is auto-generated ✅
|
|
226
|
+
- No timing attack vulnerabilities detected ✅
|
|
410
227
|
|
|
411
|
-
|
|
412
|
-
|
|
228
|
+
Your password hashing implementation follows security best practices.
|
|
229
|
+
No issues found in the reviewed code.
|
|
413
230
|
```
|
|
414
231
|
|
|
415
232
|
---
|
|
416
233
|
|
|
417
|
-
|
|
234
|
+
### 6. 提出選項但不推薦
|
|
418
235
|
|
|
419
|
-
|
|
236
|
+
**❌ 錯誤**:
|
|
420
237
|
```
|
|
421
|
-
|
|
238
|
+
Assistant: "You can use: 1) JWT 2) Session 3) OAuth. Which do you prefer?"
|
|
422
239
|
```
|
|
423
|
-
**問題**:
|
|
240
|
+
**問題**: 列出選項但未提供指引或考量情境。
|
|
424
241
|
|
|
425
|
-
|
|
242
|
+
**✅ 正確**:
|
|
426
243
|
```
|
|
427
|
-
|
|
244
|
+
Assistant: "Based on your requirements:
|
|
428
245
|
|
|
429
|
-
|
|
430
|
-
1. JWT -
|
|
431
|
-
2. Session -
|
|
432
|
-
3. OAuth -
|
|
246
|
+
**Options**:
|
|
247
|
+
1. JWT - Stateless, scalable, good for APIs
|
|
248
|
+
2. Session - Server-side state, traditional web apps
|
|
249
|
+
3. OAuth - Third-party identity providers
|
|
433
250
|
|
|
434
|
-
|
|
251
|
+
**Recommended: JWT**
|
|
435
252
|
|
|
436
|
-
[
|
|
437
|
-
JWT
|
|
438
|
-
-
|
|
439
|
-
-
|
|
440
|
-
-
|
|
253
|
+
[Inferred] Based on your microservices architecture (seen in docker-compose.yml),
|
|
254
|
+
JWT is the best fit because:
|
|
255
|
+
- Stateless: No session store needed across services
|
|
256
|
+
- Scalable: Each service can validate tokens independently
|
|
257
|
+
- Standard: Well-supported across your tech stack (.NET, React)
|
|
441
258
|
|
|
442
|
-
|
|
259
|
+
If you need social login later, you can add OAuth on top of JWT."
|
|
443
260
|
```
|
|
444
261
|
|
|
445
262
|
---
|
|
446
263
|
|
|
447
|
-
|
|
264
|
+
### 7. 未分析副作用即實作
|
|
448
265
|
|
|
449
|
-
|
|
266
|
+
**❌ 錯誤**:
|
|
450
267
|
```
|
|
451
|
-
|
|
452
|
-
|
|
268
|
+
User: "Add a function to delete user accounts"
|
|
269
|
+
Assistant: "Here's the implementation:
|
|
453
270
|
|
|
454
271
|
public async Task DeleteUser(Guid userId) {
|
|
455
272
|
await _dbContext.Users.Where(u => u.Id == userId).DeleteAsync();
|
|
456
273
|
}
|
|
457
|
-
|
|
274
|
+
"
|
|
458
275
|
```
|
|
459
|
-
**問題**:
|
|
276
|
+
**問題**: 未考量連鎖效應即直接實作。
|
|
460
277
|
|
|
461
|
-
|
|
278
|
+
**✅ 正確**:
|
|
462
279
|
```
|
|
463
|
-
|
|
464
|
-
|
|
280
|
+
User: "Add a function to delete user accounts"
|
|
281
|
+
Assistant: "Before implementing, let me identify potential side effects:
|
|
465
282
|
|
|
466
|
-
|
|
467
|
-
1.
|
|
468
|
-
2.
|
|
469
|
-
3.
|
|
283
|
+
**Potential Side Effects**:
|
|
284
|
+
1. **Data Integrity**: Related records (orders, comments, sessions) may become orphaned
|
|
285
|
+
2. **External Systems**: May need to notify third-party services (payment provider, email service)
|
|
286
|
+
3. **Audit Trail**: Deletion may violate compliance requirements (GDPR right to be forgotten vs. audit logs)
|
|
470
287
|
|
|
471
|
-
[
|
|
472
|
-
-
|
|
473
|
-
-
|
|
474
|
-
-
|
|
288
|
+
[Need Confirmation] How should we handle:
|
|
289
|
+
- Related user data (cascade delete vs. anonymize)?
|
|
290
|
+
- Active sessions?
|
|
291
|
+
- Historical records for reporting?
|
|
475
292
|
|
|
476
|
-
|
|
293
|
+
Once clarified, I'll provide the implementation."
|
|
477
294
|
```
|
|
478
295
|
|
|
479
296
|
---
|
|
480
297
|
|
|
481
|
-
## 實施檢查清單
|
|
482
|
-
|
|
483
|
-
在對程式碼、需求或架構做出任何陳述前,請驗證:
|
|
484
|
-
|
|
485
|
-
- [ ] **來源已驗證**
|
|
486
|
-
- 我是否已讀取實際的檔案/文件?
|
|
487
|
-
|
|
488
|
-
- [ ] **來源類型已標註**
|
|
489
|
-
- 我是否已指定來源類型?(`[來源: 程式碼]`、`[來源: 外部]`、`[來源: 知識]` 等)
|
|
490
|
-
|
|
491
|
-
- [ ] **引用已標註**
|
|
492
|
-
- 我是否已包含檔案路徑與行號(程式碼)?
|
|
493
|
-
- 我是否已包含 URL 與存取日期(外部文件)?
|
|
494
|
-
|
|
495
|
-
- [ ] **版本已標註**
|
|
496
|
-
- 我是否已包含適用的函式庫/框架版本?
|
|
497
|
-
|
|
498
|
-
- [ ] **確定性已分類**
|
|
499
|
-
- 我是否已標註為 [已確認]、[推測]、[假設]、[未知] 或 [需確認]?
|
|
500
|
-
|
|
501
|
-
- [ ] **AI 知識已標記**
|
|
502
|
-
- 我是否已對 `[來源: 知識]` 標記 ⚠️ 驗證警告?
|
|
503
|
-
|
|
504
|
-
- [ ] **無捏造**
|
|
505
|
-
- 我是否避免了捏造 API、設定或需求?
|
|
506
|
-
|
|
507
|
-
- [ ] **使用者澄清**
|
|
508
|
-
- 我是否對模糊點請求澄清?
|
|
509
|
-
|
|
510
|
-
- [ ] **包含推薦**
|
|
511
|
-
- 當提出選項時,我是否包含了推薦選項?
|
|
512
|
-
|
|
513
|
-
- [ ] **已識別副作用**
|
|
514
|
-
- 我是否在實作前列出至少 3 個潛在副作用?
|
|
515
|
-
- 我是否考慮了:狀態變更、相依性、外部系統、資料完整性?
|
|
516
|
-
|
|
517
|
-
---
|
|
518
|
-
|
|
519
298
|
## 審查情境
|
|
520
299
|
|
|
521
300
|
### 情境 1: 程式碼分析
|
|
@@ -524,23 +303,23 @@ public async Task DeleteUser(Guid userId) {
|
|
|
524
303
|
|
|
525
304
|
**❌ 不良回應**:
|
|
526
305
|
```
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
306
|
+
Your authentication system uses JWT with RS256 signing.
|
|
307
|
+
The tokens expire after 1 hour.
|
|
308
|
+
You should add refresh token support.
|
|
530
309
|
```
|
|
531
310
|
**問題**: 未讀取程式碼即做出聲明,假設實作細節。
|
|
532
311
|
|
|
533
312
|
**✅ 良好回應**:
|
|
534
313
|
```
|
|
535
|
-
[
|
|
536
|
-
|
|
314
|
+
[Need Confirmation] Which file contains the authentication logic?
|
|
315
|
+
Possible locations might be:
|
|
537
316
|
- src/auth/
|
|
538
317
|
- src/services/auth
|
|
539
318
|
- src/middleware/
|
|
540
319
|
|
|
541
|
-
|
|
320
|
+
Please direct me to the correct file so I can provide accurate analysis.
|
|
542
321
|
|
|
543
|
-
|
|
322
|
+
Alternatively, I can search the codebase for authentication-related files.
|
|
544
323
|
```
|
|
545
324
|
|
|
546
325
|
---
|
|
@@ -551,28 +330,28 @@ Token 在 1 小時後過期。
|
|
|
551
330
|
|
|
552
331
|
**❌ 不良回應**:
|
|
553
332
|
```
|
|
554
|
-
|
|
555
|
-
1.
|
|
556
|
-
2.
|
|
557
|
-
3.
|
|
333
|
+
Based on your existing architecture, you should:
|
|
334
|
+
1. Create PaymentService in src/services/
|
|
335
|
+
2. Use the Stripe API
|
|
336
|
+
3. Store transactions in the payments table
|
|
558
337
|
```
|
|
559
338
|
**問題**: 未經證據即假設架構、支付提供者和資料庫結構。
|
|
560
339
|
|
|
561
340
|
**✅ 良好回應**:
|
|
562
341
|
```
|
|
563
|
-
|
|
342
|
+
To provide an accurate recommendation, I need to understand your current architecture:
|
|
564
343
|
|
|
565
|
-
[
|
|
566
|
-
1.
|
|
567
|
-
2.
|
|
568
|
-
3.
|
|
344
|
+
[Need Confirmation]
|
|
345
|
+
1. What payment provider do you plan to use? (Stripe, PayPal, custom, etc.)
|
|
346
|
+
2. What is your existing service layer structure?
|
|
347
|
+
3. What database are you using?
|
|
569
348
|
|
|
570
|
-
|
|
571
|
-
-
|
|
572
|
-
-
|
|
573
|
-
-
|
|
349
|
+
Could you share:
|
|
350
|
+
- Project structure (ls -R src/ or similar)
|
|
351
|
+
- Existing service examples
|
|
352
|
+
- Database schema or ORM models
|
|
574
353
|
|
|
575
|
-
|
|
354
|
+
Once I review these, I can suggest a structure that aligns with your patterns.
|
|
576
355
|
```
|
|
577
356
|
|
|
578
357
|
---
|
|
@@ -583,26 +362,26 @@ Token 在 1 小時後過期。
|
|
|
583
362
|
|
|
584
363
|
**❌ 不良回應**:
|
|
585
364
|
```
|
|
586
|
-
|
|
587
|
-
|
|
365
|
+
The issue is likely in your validateCredentials() function.
|
|
366
|
+
You probably need to hash the password before comparison.
|
|
588
367
|
```
|
|
589
368
|
**問題**: 未看程式碼即猜測原因。
|
|
590
369
|
|
|
591
370
|
**✅ 良好回應**:
|
|
592
371
|
```
|
|
593
|
-
|
|
372
|
+
To investigate the login failure, I need more information:
|
|
594
373
|
|
|
595
|
-
[
|
|
596
|
-
1.
|
|
597
|
-
2.
|
|
598
|
-
3.
|
|
374
|
+
[Need Confirmation]
|
|
375
|
+
1. What error message are you seeing? (console logs, error responses)
|
|
376
|
+
2. Which file contains the login logic?
|
|
377
|
+
3. Can you share relevant code snippets or logs?
|
|
599
378
|
|
|
600
|
-
|
|
601
|
-
-
|
|
602
|
-
-
|
|
603
|
-
-
|
|
379
|
+
Suggested debugging steps:
|
|
380
|
+
- Share the login controller/service code
|
|
381
|
+
- Provide error logs from console/server
|
|
382
|
+
- Describe expected vs actual behavior
|
|
604
383
|
|
|
605
|
-
|
|
384
|
+
Once I review the actual code and errors, I can identify the root cause.
|
|
606
385
|
```
|
|
607
386
|
|
|
608
387
|
---
|
|
@@ -613,32 +392,32 @@ Token 在 1 小時後過期。
|
|
|
613
392
|
|
|
614
393
|
**❌ 不良回應**:
|
|
615
394
|
```
|
|
616
|
-
|
|
395
|
+
You have several options:
|
|
617
396
|
1. Redis
|
|
618
397
|
2. Memcached
|
|
619
|
-
3.
|
|
398
|
+
3. In-memory cache
|
|
620
399
|
|
|
621
|
-
|
|
400
|
+
Let me know which one you'd like to use.
|
|
622
401
|
```
|
|
623
|
-
**問題**:
|
|
402
|
+
**問題**: 列出選項但未提供推薦或考量情境。
|
|
624
403
|
|
|
625
404
|
**✅ 良好回應**:
|
|
626
405
|
```
|
|
627
|
-
|
|
628
|
-
1. Redis -
|
|
629
|
-
2. Memcached -
|
|
630
|
-
3.
|
|
406
|
+
Based on the options available:
|
|
407
|
+
1. Redis - Distributed, persistent, rich data structures
|
|
408
|
+
2. Memcached - Simple, fast, distributed
|
|
409
|
+
3. In-memory cache - Local only, no setup required
|
|
631
410
|
|
|
632
|
-
|
|
411
|
+
**Recommended: Redis**
|
|
633
412
|
|
|
634
|
-
[
|
|
635
|
-
-
|
|
636
|
-
-
|
|
637
|
-
-
|
|
413
|
+
[Need Confirmation] Before finalizing, I'd like to understand:
|
|
414
|
+
- Do you need cache sharing across multiple instances?
|
|
415
|
+
- Is data persistence required?
|
|
416
|
+
- What's your existing infrastructure?
|
|
638
417
|
|
|
639
|
-
|
|
640
|
-
Redis
|
|
641
|
-
|
|
418
|
+
If you already have Redis infrastructure or need cross-instance sharing,
|
|
419
|
+
Redis is the best choice. If this is a single-instance application with
|
|
420
|
+
simple caching needs, in-memory cache would suffice.
|
|
642
421
|
```
|
|
643
422
|
|
|
644
423
|
---
|
|
@@ -647,62 +426,62 @@ Redis 是最佳選擇。如果這是單實例應用程式且有
|
|
|
647
426
|
|
|
648
427
|
```
|
|
649
428
|
┌─────────────────────────────────┐
|
|
650
|
-
│
|
|
429
|
+
│ User Request Received │
|
|
651
430
|
└─────────────┬───────────────────┘
|
|
652
431
|
│
|
|
653
432
|
▼
|
|
654
433
|
┌─────────────────────────────────┐
|
|
655
|
-
│
|
|
656
|
-
│ -
|
|
657
|
-
│ -
|
|
658
|
-
│ -
|
|
434
|
+
│ Identify Information Needed │
|
|
435
|
+
│ - Code files? │
|
|
436
|
+
│ - Configuration? │
|
|
437
|
+
│ - Requirements? │
|
|
659
438
|
└─────────────┬───────────────────┘
|
|
660
439
|
│
|
|
661
440
|
▼
|
|
662
441
|
┌─────────────────────────────────┐
|
|
663
|
-
│
|
|
664
|
-
│ -
|
|
665
|
-
│ -
|
|
666
|
-
│ -
|
|
442
|
+
│ Identify Potential Side Effects│
|
|
443
|
+
│ - State changes? │
|
|
444
|
+
│ - Dependencies affected? │
|
|
445
|
+
│ - External system impacts? │
|
|
667
446
|
└─────────────┬───────────────────┘
|
|
668
447
|
│
|
|
669
448
|
▼
|
|
670
449
|
┌────┴────┐
|
|
671
|
-
│
|
|
450
|
+
│ Available? │
|
|
672
451
|
└────┬────┘
|
|
673
452
|
│
|
|
674
453
|
┌───────┴───────┐
|
|
675
454
|
│ │
|
|
676
|
-
|
|
455
|
+
YES NO
|
|
677
456
|
│ │
|
|
678
457
|
▼ ▼
|
|
679
458
|
┌──────────┐ ┌─────────────┐
|
|
680
|
-
│
|
|
681
|
-
│
|
|
459
|
+
│ Read/ │ │ Ask User │
|
|
460
|
+
│ Analyze │ │ for Info │
|
|
682
461
|
└────┬─────┘ └──────┬──────┘
|
|
683
462
|
│ │
|
|
684
463
|
▼ ▼
|
|
685
464
|
┌─────────────────────────────────┐
|
|
686
|
-
│
|
|
687
|
-
│ - [
|
|
688
|
-
│ - [
|
|
689
|
-
│ - [
|
|
465
|
+
│ Tag Response with: │
|
|
466
|
+
│ - [Confirmed] for facts │
|
|
467
|
+
│ - [Inferred] for deductions │
|
|
468
|
+
│ - [Need Confirmation] for gaps │
|
|
690
469
|
└─────────────┬───────────────────┘
|
|
691
470
|
│
|
|
692
471
|
▼
|
|
693
472
|
┌─────────────────────────────────┐
|
|
694
|
-
│
|
|
473
|
+
│ Cite Sources (file:line) │
|
|
695
474
|
└─────────────┬───────────────────┘
|
|
696
475
|
│
|
|
697
476
|
▼
|
|
698
477
|
┌─────────────────────────────────┐
|
|
699
|
-
│
|
|
700
|
-
│
|
|
478
|
+
│ Include Recommendation │
|
|
479
|
+
│ (if presenting options) │
|
|
701
480
|
└─────────────┬───────────────────┘
|
|
702
481
|
│
|
|
703
482
|
▼
|
|
704
483
|
┌─────────────────────────────────┐
|
|
705
|
-
│
|
|
484
|
+
│ Deliver Response │
|
|
706
485
|
└─────────────────────────────────┘
|
|
707
486
|
```
|
|
708
487
|
|
|
@@ -734,46 +513,14 @@ Redis 是最佳選擇。如果這是單實例應用程式且有
|
|
|
734
513
|
|
|
735
514
|
**審查評論範本**:
|
|
736
515
|
```
|
|
737
|
-
[
|
|
738
|
-
[
|
|
739
|
-
[
|
|
740
|
-
[
|
|
516
|
+
[file:line] - [Severity]
|
|
517
|
+
[Description of issue with code excerpt]
|
|
518
|
+
[Evidence or reasoning]
|
|
519
|
+
[Suggested fix or question for clarification]
|
|
741
520
|
```
|
|
742
521
|
|
|
743
522
|
---
|
|
744
523
|
|
|
745
|
-
##
|
|
746
|
-
|
|
747
|
-
- [測試標準](../testing-standards.md) - 確保驗證 AI 分析結果(或使用 `/testing-guide` 技能)
|
|
748
|
-
- [程式碼審查清單](../code-review-checklist.md) - 審查 AI 生成內容
|
|
749
|
-
- [程式碼簽入標準](../checkin-standards.md) - AI 協作簽入流程
|
|
750
|
-
|
|
751
|
-
---
|
|
752
|
-
|
|
753
|
-
## 版本歷史
|
|
754
|
-
|
|
755
|
-
| 版本 | 日期 | 變更 |
|
|
756
|
-
|------|------|------|
|
|
757
|
-
| 1.4.0 | 2026-01-19 | 新增: 副作用分析規則(第 7 條禁止行為)、工作流程步驟及檢查清單項目 |
|
|
758
|
-
| 1.3.1 | 2025-12-24 | 新增: 相關標準章節 |
|
|
759
|
-
| 1.3.0 | 2025-12-22 | 增強: 禁止行為章節,新增詳細對比範例 |
|
|
760
|
-
| 1.2.0 | 2025-12-15 | 新增: AI 助手互動規範章節(對話語言、推薦原則) |
|
|
761
|
-
| 1.1.0 | 2025-12-10 | 增強來源標註,新增來源類型、版本敏感性與可靠度評級 |
|
|
762
|
-
| 1.0.0 | 2025-11-12 | 初版發布 |
|
|
763
|
-
|
|
764
|
-
---
|
|
765
|
-
|
|
766
|
-
## 授權
|
|
767
|
-
|
|
768
|
-
本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
|
|
769
|
-
您可以自由調整用於您的專案,但需註明出處。
|
|
770
|
-
|
|
771
|
-
---
|
|
772
|
-
|
|
773
|
-
**專案特定化**
|
|
524
|
+
## 授權條款
|
|
774
525
|
|
|
775
|
-
|
|
776
|
-
- 領域特定驗證需求(如醫療領域的 HIPAA 合規檢查)
|
|
777
|
-
- 工具特定指引(如如何驗證 Terraform 設定)
|
|
778
|
-
- 團隊特定證據格式(如 JIRA ticket 引用)
|
|
779
|
-
- AI 助手對話的語言偏好
|
|
526
|
+
本指南以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
|