universal-dev-standards 4.2.0 → 5.0.0-beta.10
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/README.md +3 -3
- package/bin/uds.js +165 -5
- package/bundled/core/acceptance-test-driven-development.md +19 -721
- package/bundled/core/accessibility-standards.md +862 -0
- package/bundled/core/ai-agreement-standards.md +95 -0
- package/bundled/core/ai-friendly-architecture.md +2 -0
- package/bundled/core/ai-instruction-standards.md +2 -0
- package/bundled/core/anti-hallucination.md +90 -637
- package/bundled/core/behavior-driven-development.md +20 -735
- package/bundled/core/changelog-standards.md +4 -0
- package/bundled/core/checkin-standards.md +21 -4
- package/bundled/core/code-review-checklist.md +3 -0
- package/bundled/core/commit-message-guide.md +14 -3
- package/bundled/core/deployment-standards.md +296 -0
- package/bundled/core/developer-memory.md +568 -0
- package/bundled/core/documentation-structure.md +114 -18
- package/bundled/core/documentation-writing-standards.md +272 -2
- package/bundled/core/error-code-standards.md +3 -0
- package/bundled/core/forward-derivation-standards.md +134 -8
- package/bundled/core/git-workflow.md +72 -686
- package/bundled/core/guides/anti-hallucination-guide.md +517 -0
- package/bundled/core/guides/git-workflow-guide.md +954 -0
- package/bundled/core/guides/performance-guide.md +508 -0
- package/bundled/core/guides/refactoring-guide.md +608 -0
- package/bundled/core/guides/security-guide.md +485 -0
- package/bundled/core/logging-standards.md +337 -2
- package/bundled/core/performance-standards.md +231 -0
- package/bundled/core/project-context-memory.md +180 -0
- package/bundled/core/project-structure.md +315 -2
- package/bundled/core/refactoring-standards.md +81 -761
- package/bundled/core/requirement-engineering.md +39 -0
- package/bundled/core/reverse-engineering-standards.md +6 -4
- package/bundled/core/security-standards.md +244 -0
- package/bundled/core/spec-driven-development.md +20 -319
- package/bundled/core/test-completeness-dimensions.md +213 -11
- package/bundled/core/test-driven-development.md +22 -978
- package/bundled/core/testing-standards.md +222 -2903
- package/bundled/core/versioning.md +16 -55
- package/bundled/core/virtual-organization-standards.md +85 -0
- package/bundled/locales/README.md +4 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +18 -18
- package/bundled/locales/zh-CN/CLAUDE.md +3 -3
- package/bundled/locales/zh-CN/MAINTENANCE.md +7 -7
- package/bundled/locales/zh-CN/README.md +2 -2
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +1 -1
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +3 -3
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +66 -7
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +22 -22
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +5 -5
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +4 -4
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +5 -5
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +13 -13
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +1 -1
- package/bundled/locales/zh-CN/core/anti-hallucination.md +39 -3
- package/bundled/locales/zh-CN/core/checkin-standards.md +18 -5
- package/bundled/locales/zh-CN/core/commit-message-guide.md +1 -1
- package/bundled/locales/zh-CN/core/developer-memory.md +576 -0
- package/bundled/locales/zh-CN/core/documentation-structure.md +43 -5
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +146 -5
- package/bundled/locales/zh-CN/core/git-workflow.md +179 -4
- package/bundled/locales/zh-CN/core/logging-standards.md +177 -4
- package/bundled/locales/zh-CN/core/project-structure.md +117 -5
- package/bundled/locales/zh-CN/core/refactoring-standards.md +3 -3
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +6 -6
- package/bundled/locales/zh-CN/core/spec-driven-development.md +516 -14
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +155 -24
- package/bundled/locales/zh-CN/core/test-driven-development.md +71 -20
- package/bundled/locales/zh-CN/core/testing-standards.md +4 -4
- package/bundled/locales/zh-CN/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +90 -51
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +184 -0
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +239 -0
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +320 -0
- package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +43 -43
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +440 -0
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +1 -1
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +1 -1
- package/bundled/locales/zh-CN/integrations/codex/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +5 -5
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +9 -9
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +18 -6
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +2 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +22 -10
- package/bundled/locales/zh-CN/integrations/openspec/README.md +1 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +3 -3
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/english.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/go.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/java.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/python.md +1 -1
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +1 -1
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +1 -1
- package/bundled/locales/zh-CN/options/testing/system-testing.md +1 -1
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +1 -1
- package/bundled/locales/zh-CN/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +2 -2
- package/bundled/locales/zh-CN/skills/README.md +131 -81
- package/bundled/locales/zh-CN/skills/agents/README.md +281 -0
- package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +10 -10
- package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +8 -8
- package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +8 -8
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +221 -0
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +214 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +71 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +428 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +484 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +368 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +68 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +406 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +454 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +324 -0
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +64 -0
- package/bundled/locales/zh-CN/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +6 -7
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-CN/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -7
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +5 -6
- package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/bdd.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/methodology.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/refactor.md +3 -3
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +61 -0
- package/bundled/locales/zh-CN/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +5 -6
- package/bundled/locales/zh-CN/skills/{claude-code/commit-standards → commit-standards}/language-options.md +3 -3
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +59 -0
- package/bundled/locales/zh-CN/skills/docs-generator/guide.md +262 -0
- package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -8
- package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/forward-derivation/SKILL.md +62 -0
- package/bundled/locales/zh-CN/skills/forward-derivation/guide.md +130 -0
- package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/methodology-system/SKILL.md +78 -0
- package/bundled/locales/zh-CN/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/methodology-system → methodology-system}/runtime.md +3 -3
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +66 -0
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +371 -0
- package/bundled/locales/zh-CN/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +1 -1
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-CN/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -8
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +64 -0
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/changelog-format.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +5 -6
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/release-workflow.md +7 -7
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +3 -3
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +4 -5
- package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +3 -3
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +67 -0
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +17 -18
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +3 -3
- package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +75 -0
- package/bundled/locales/zh-CN/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +10 -11
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +66 -0
- package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +12 -16
- package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +3 -3
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +65 -0
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +284 -0
- package/bundled/locales/zh-CN/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +8 -8
- package/bundled/locales/zh-CN/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +4 -4
- package/bundled/locales/zh-CN/skills/{cline → tools/cline}/README.md +1 -1
- package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/README.md +1 -1
- package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/copilot-instructions.md +1 -1
- package/bundled/locales/zh-CN/skills/{cursor → tools/cursor}/README.md +1 -1
- package/bundled/locales/zh-CN/skills/{windsurf → tools/windsurf}/README.md +1 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +16 -16
- package/bundled/locales/zh-TW/CLAUDE.md +3 -3
- package/bundled/locales/zh-TW/MAINTENANCE.md +7 -7
- package/bundled/locales/zh-TW/README.md +13 -7
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +1 -1
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +4 -4
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +66 -7
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +22 -22
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +5 -5
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +4 -4
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +5 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +13 -13
- package/bundled/locales/zh-TW/ai/standards/anti-hallucination.ai.yaml +3 -2
- package/bundled/locales/zh-TW/ai/standards/git-workflow.ai.yaml +4 -3
- package/bundled/locales/zh-TW/ai/standards/spec-driven-development.ai.yaml +3 -3
- package/bundled/locales/zh-TW/ai/standards/testing.ai.yaml +1 -0
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +1 -1
- package/bundled/locales/zh-TW/core/anti-hallucination.md +38 -701
- package/bundled/locales/zh-TW/core/changelog-standards.md +1 -1
- package/bundled/locales/zh-TW/core/checkin-standards.md +18 -5
- package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-TW/core/commit-message-guide.md +1 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +576 -0
- package/bundled/locales/zh-TW/core/documentation-structure.md +115 -22
- package/bundled/locales/zh-TW/core/documentation-writing-standards.md +126 -5
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +2 -2
- package/bundled/locales/zh-TW/core/git-workflow.md +38 -812
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +779 -0
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +1016 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +864 -0
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +2280 -0
- package/bundled/locales/zh-TW/core/logging-standards.md +159 -4
- package/bundled/locales/zh-TW/core/project-structure.md +102 -9
- package/bundled/locales/zh-TW/core/refactoring-standards.md +37 -823
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +6 -6
- package/bundled/locales/zh-TW/core/spec-driven-development.md +17 -268
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +128 -14
- package/bundled/locales/zh-TW/core/test-driven-development.md +20 -983
- package/bundled/locales/zh-TW/core/testing-standards.md +120 -2105
- package/bundled/locales/zh-TW/core/versioning.md +13 -55
- package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +90 -51
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +184 -0
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +239 -0
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +320 -0
- package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +71 -0
- package/bundled/locales/zh-TW/docs/OPERATION-WORKFLOW.md +42 -42
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +440 -0
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +1 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +1 -1
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +44 -0
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +3 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +18 -6
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +22 -10
- package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +338 -0
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +1055 -0
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +1 -1
- package/bundled/locales/zh-TW/options/commit-message/english.md +1 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/go.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/java.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/python.md +1 -1
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +1 -1
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +1 -1
- package/bundled/locales/zh-TW/options/testing/system-testing.md +1 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +1 -1
- package/bundled/locales/zh-TW/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +2 -2
- package/bundled/locales/zh-TW/skills/README.md +131 -79
- package/bundled/locales/zh-TW/skills/agents/README.md +281 -0
- package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +7 -7
- package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +8 -8
- package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +8 -8
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +221 -0
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +214 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +71 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +428 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +484 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +368 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +68 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +406 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +454 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +324 -0
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +64 -0
- package/bundled/locales/zh-TW/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +6 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-TW/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -7
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +2 -3
- package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/bdd.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/methodology.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/refactor.md +3 -3
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +61 -0
- package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +5 -6
- package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/language-options.md +3 -3
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +59 -0
- package/bundled/locales/zh-TW/skills/docs-generator/guide.md +262 -0
- package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -8
- package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-TW/skills/forward-derivation/SKILL.md +62 -0
- package/bundled/locales/zh-TW/skills/{claude-code/forward-derivation/SKILL.md → forward-derivation/guide.md} +24 -19
- package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md +78 -0
- package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/runtime.md +3 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +66 -0
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +371 -0
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +574 -0
- package/bundled/locales/zh-TW/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +1 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-TW/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -8
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +64 -0
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/changelog-format.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +2 -3
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/release-workflow.md +60 -28
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +3 -3
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +2 -3
- package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +3 -3
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +67 -0
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +17 -18
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +3 -3
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +75 -0
- package/bundled/locales/zh-TW/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +9 -10
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +66 -0
- package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +9 -10
- package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +3 -3
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +65 -0
- package/bundled/locales/zh-TW/skills/{claude-code/test-coverage-assistant/SKILL.md → test-coverage-assistant/guide.md} +27 -24
- package/bundled/locales/zh-TW/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-TW/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +4 -4
- package/bundled/locales/zh-TW/skills/{cline → tools/cline}/README.md +1 -1
- package/bundled/locales/zh-TW/skills/{copilot → tools/copilot}/README.md +1 -1
- package/bundled/locales/zh-TW/skills/{copilot → tools/copilot}/copilot-instructions.md +1 -1
- package/bundled/locales/zh-TW/skills/{cursor → tools/cursor}/README.md +1 -1
- package/bundled/locales/zh-TW/skills/{windsurf → tools/windsurf}/README.md +1 -1
- package/bundled/skills/INTEGRATION-GUIDE.md +210 -0
- package/bundled/skills/README.md +95 -0
- package/bundled/skills/_shared/README.md +60 -0
- package/bundled/skills/{claude-code/agents → agents}/README.md +2 -2
- package/bundled/skills/{claude-code/agents → agents}/code-architect.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/doc-writer.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/reviewer.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/spec-analyst.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/test-specialist.md +1 -1
- package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +28 -5
- package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +24 -5
- package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +31 -6
- package/bundled/skills/ai-friendly-architecture/SKILL.md +216 -0
- package/bundled/skills/ai-instruction-standards/SKILL.md +209 -0
- package/bundled/skills/atdd-assistant/SKILL.md +74 -0
- package/bundled/skills/{claude-code/atdd-assistant → atdd-assistant}/acceptance-criteria-guide.md +1 -1
- package/bundled/skills/{claude-code/atdd-assistant → atdd-assistant}/atdd-workflow.md +1 -1
- package/bundled/skills/{claude-code/atdd-assistant/SKILL.md → atdd-assistant/guide.md} +11 -11
- package/bundled/skills/bdd-assistant/SKILL.md +70 -0
- package/bundled/skills/{claude-code/bdd-assistant → bdd-assistant}/bdd-workflow.md +1 -1
- package/bundled/skills/{claude-code/bdd-assistant → bdd-assistant}/gherkin-guide.md +1 -1
- package/bundled/skills/{claude-code/bdd-assistant/SKILL.md → bdd-assistant/guide.md} +11 -11
- package/bundled/skills/changelog-guide/SKILL.md +66 -0
- package/bundled/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +8 -6
- package/bundled/skills/checkin-assistant/SKILL.md +52 -0
- package/bundled/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -6
- package/bundled/skills/code-review-assistant/SKILL.md +53 -0
- package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +3 -3
- package/bundled/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +7 -5
- package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +3 -3
- package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +290 -0
- package/bundled/skills/{claude-code/commands → commands}/README.md +13 -3
- package/bundled/skills/{claude-code/commands → commands}/atdd.md +3 -3
- package/bundled/skills/{claude-code/commands → commands}/bdd.md +2 -2
- package/bundled/skills/commands/changelog.md +58 -0
- package/bundled/skills/{claude-code/commands → commands}/check.md +1 -1
- package/bundled/skills/commands/checkin.md +53 -0
- package/bundled/skills/{claude-code/commands → commands}/commit.md +3 -3
- package/bundled/skills/{claude-code/commands → commands}/config.md +1 -1
- package/bundled/skills/{claude-code/commands → commands}/coverage.md +5 -4
- package/bundled/skills/commands/derive-all.md +53 -0
- package/bundled/skills/commands/derive-atdd.md +49 -0
- package/bundled/skills/commands/derive-bdd.md +47 -0
- package/bundled/skills/commands/derive-tdd.md +48 -0
- package/bundled/skills/commands/derive.md +72 -0
- package/bundled/skills/commands/discover.md +80 -0
- package/bundled/skills/commands/docgen.md +61 -0
- package/bundled/skills/commands/docs.md +59 -0
- package/bundled/skills/commands/guide.md +44 -0
- package/bundled/skills/{claude-code/commands → commands}/init.md +2 -2
- package/bundled/skills/{claude-code/commands → commands}/methodology.md +32 -16
- package/bundled/skills/{claude-code/commands → commands}/refactor.md +2 -2
- package/bundled/skills/commands/release.md +56 -0
- package/bundled/skills/{claude-code/commands → commands}/requirement.md +3 -3
- package/bundled/skills/commands/reverse-bdd.md +47 -0
- package/bundled/skills/commands/reverse-sdd.md +51 -0
- package/bundled/skills/commands/reverse-tdd.md +51 -0
- package/bundled/skills/commands/reverse.md +63 -0
- package/bundled/skills/{claude-code/commands → commands}/review.md +3 -3
- package/bundled/skills/commands/sdd.md +135 -0
- package/bundled/skills/{claude-code/commands → commands}/tdd.md +3 -3
- package/bundled/skills/{claude-code/commands → commands}/update.md +2 -2
- package/bundled/skills/commit-standards/SKILL.md +60 -0
- package/bundled/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +3 -3
- package/bundled/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +17 -5
- package/bundled/skills/{claude-code/commit-standards → commit-standards}/language-options.md +2 -2
- package/bundled/skills/docs-generator/SKILL.md +69 -0
- package/bundled/skills/docs-generator/guide.md +258 -0
- package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -7
- package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +3 -3
- package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +2 -2
- package/bundled/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +7 -5
- package/bundled/skills/forward-derivation/SKILL.md +61 -0
- package/bundled/skills/{claude-code/forward-derivation/SKILL.md → forward-derivation/guide.md} +44 -29
- package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +7 -5
- package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +2 -2
- package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +3 -3
- package/bundled/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +7 -5
- package/bundled/skills/methodology-system/SKILL.md +75 -0
- package/bundled/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +1 -1
- package/bundled/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +51 -16
- package/bundled/skills/methodology-system/integrated-flow.md +454 -0
- package/bundled/skills/{claude-code/methodology-system → methodology-system}/runtime.md +2 -2
- package/bundled/skills/project-discovery/SKILL.md +63 -0
- package/bundled/skills/project-discovery/guide.md +367 -0
- package/bundled/skills/project-discovery/workflow.md +566 -0
- package/bundled/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +14 -4
- package/bundled/skills/refactoring-assistant/SKILL.md +78 -0
- package/bundled/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -7
- package/bundled/skills/release-standards/SKILL.md +61 -0
- package/bundled/skills/{claude-code/release-standards → release-standards}/changelog-format.md +2 -2
- package/bundled/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +7 -5
- package/bundled/skills/{claude-code/release-standards → release-standards}/release-workflow.md +59 -24
- package/bundled/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +2 -2
- package/bundled/skills/requirement-assistant/SKILL.md +66 -0
- package/bundled/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +14 -6
- package/bundled/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +2 -2
- package/bundled/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +2 -2
- package/bundled/skills/reverse-engineer/SKILL.md +64 -0
- package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +1 -1
- package/bundled/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +21 -18
- package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +1 -1
- package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +2 -2
- package/bundled/skills/spec-driven-dev/SKILL.md +80 -0
- package/bundled/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +50 -8
- package/bundled/skills/tdd-assistant/SKILL.md +65 -0
- package/bundled/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +10 -10
- package/bundled/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
- package/bundled/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +2 -2
- package/bundled/skills/test-coverage-assistant/SKILL.md +63 -0
- package/bundled/skills/{claude-code/test-coverage-assistant/SKILL.md → test-coverage-assistant/guide.md} +39 -24
- package/bundled/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +12 -7
- package/bundled/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +3 -3
- package/bundled/skills/testing-guide/testing-theory.md +2291 -0
- package/bundled/skills/tools/cline/.clinerules +79 -0
- package/bundled/skills/tools/cline/README.md +50 -0
- package/bundled/skills/tools/copilot/README.md +99 -0
- package/bundled/skills/tools/copilot/copilot-instructions.md +71 -0
- package/bundled/skills/tools/cursor/.cursorrules +101 -0
- package/bundled/skills/tools/cursor/README.md +50 -0
- package/bundled/skills/tools/windsurf/.windsurfrules +76 -0
- package/bundled/skills/tools/windsurf/README.md +51 -0
- package/bundled/skills/{claude-code/workflows → workflows}/README.md +1 -1
- package/bundled/skills/workflows/release.workflow.yaml +893 -0
- package/package.json +4 -1
- package/src/commands/check.js +195 -130
- package/src/commands/config.js +1262 -0
- package/src/commands/configure.js +3 -950
- package/src/commands/fix.js +53 -0
- package/src/commands/hitl.js +19 -0
- package/src/commands/init.js +320 -1030
- package/src/commands/list.js +1 -1
- package/src/commands/simulate.js +61 -0
- package/src/commands/spec.js +288 -0
- package/src/commands/start.js +373 -0
- package/src/commands/sweep.js +142 -0
- package/src/commands/update.js +136 -19
- package/src/commands/workflow.js +265 -1
- package/src/config/ai-agent-paths.js +89 -29
- package/src/core/constants.js +7 -1
- package/src/core/manifest.js +1 -0
- package/src/flows/init-flow.js +243 -0
- package/src/hitl/checkpoint.js +80 -0
- package/src/hitl/classifier.js +54 -0
- package/src/hitl/manager.js +88 -0
- package/src/i18n/messages.js +907 -99
- package/src/index.js +1 -0
- package/src/installers/integration-installer.js +237 -0
- package/src/installers/manifest-installer.js +131 -0
- package/src/installers/skills-installer.js +286 -0
- package/src/installers/standards-installer.js +193 -0
- package/src/missions/MissionManager.js +501 -0
- package/src/prompts/init.js +228 -130
- package/src/prompts/integrations.js +13 -1
- package/src/schemas/standard.schema.json +117 -0
- package/src/utils/agents-installer.js +2 -2
- package/src/utils/config-loader.js +47 -0
- package/src/utils/config-manager.js +108 -0
- package/src/utils/config-merger.js +47 -0
- package/src/utils/github.js +22 -18
- package/src/utils/inquirer-patch.js +98 -0
- package/src/utils/integration-generator.js +392 -58
- package/src/utils/reference-sync.js +69 -19
- package/src/utils/skills-installer.js +6 -3
- package/src/utils/standard-fixer.js +141 -0
- package/src/utils/standard-validator.js +329 -0
- package/src/utils/workflow-executor.js +886 -0
- package/src/utils/workflow-state.js +404 -0
- package/src/utils/workflows-installer.js +2 -2
- package/src/vibe/auto-sweep.js +349 -0
- package/src/vibe/micro-spec.js +428 -0
- package/standards-registry.json +278 -102
- package/bundled/locales/zh-CN/skills/claude-code/README.md +0 -174
- package/bundled/locales/zh-CN/skills/claude-code/test-coverage-assistant/SKILL.md +0 -282
- package/bundled/locales/zh-TW/skills/claude-code/README.md +0 -174
- package/bundled/skills/claude-code/README.md +0 -215
- package/bundled/skills/claude-code/commands/changelog.md +0 -57
- package/bundled/skills/claude-code/commands/derive-all.md +0 -214
- package/bundled/skills/claude-code/commands/derive-atdd.md +0 -177
- package/bundled/skills/claude-code/commands/derive-bdd.md +0 -158
- package/bundled/skills/claude-code/commands/derive-tdd.md +0 -259
- package/bundled/skills/claude-code/commands/docs.md +0 -75
- package/bundled/skills/claude-code/commands/release.md +0 -50
- package/bundled/skills/claude-code/commands/reverse-bdd.md +0 -264
- package/bundled/skills/claude-code/commands/reverse-spec.md +0 -185
- package/bundled/skills/claude-code/commands/reverse-tdd.md +0 -351
- package/bundled/skills/claude-code/commands/spec.md +0 -69
- package/bundled/skills/claude-code/methodology-system/integrated-flow.md +0 -322
- /package/bundled/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/checkin.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/commit.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/refactoring.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/testing.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/code-review.workflow.yaml +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/feature-dev.workflow.yaml +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/integrated-flow.workflow.yaml +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/large-codebase-analysis.workflow.yaml +0 -0
|
@@ -0,0 +1,324 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/bdd-assistant/SKILL.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-02-05
|
|
6
|
+
status: current
|
|
7
|
+
scope: partial
|
|
8
|
+
description: |
|
|
9
|
+
引導開發者完成行為驅動開發工作流程。
|
|
10
|
+
使用時機:撰寫 BDD 場景、使用 Gherkin 語法、Given-When-Then 格式、Feature 檔案、三方協作。
|
|
11
|
+
關鍵字:BDD, behavior-driven, Given When Then, Gherkin, Cucumber, scenario, feature file, step definition, 行為驅動開發.
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# BDD 助手
|
|
15
|
+
|
|
16
|
+
> **語言**: [English](../../../../skills/bdd-assistant/SKILL.md) | 繁體中文
|
|
17
|
+
|
|
18
|
+
**版本**: 1.0.0
|
|
19
|
+
**最後更新**: 2026-01-19
|
|
20
|
+
**適用範圍**: Claude Code Skills
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 目的
|
|
25
|
+
|
|
26
|
+
本技能引導開發者完成行為驅動開發工作流程,協助:
|
|
27
|
+
- 進行 Discovery 會議探索需求
|
|
28
|
+
- 以 Given-When-Then 格式撰寫有效的 Gherkin 場景
|
|
29
|
+
- 建立可重用的步驟定義
|
|
30
|
+
- 整合 BDD 與 TDD 進行實作
|
|
31
|
+
- 維護活文件
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 快速參考
|
|
36
|
+
|
|
37
|
+
### BDD 工作流程檢查清單
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
41
|
+
│ 🔍 探索階段 │
|
|
42
|
+
│ □ 利害關係人已識別(商業、Dev、QA) │
|
|
43
|
+
│ □ 用戶故事已討論並理解 │
|
|
44
|
+
│ □ 具體範例已收集(Example Mapping) │
|
|
45
|
+
│ □ 邊界案例已識別 │
|
|
46
|
+
│ □ 問題已回答或記錄待追蹤 │
|
|
47
|
+
├─────────────────────────────────────────────────────────────────┤
|
|
48
|
+
│ 📝 制定階段 │
|
|
49
|
+
│ □ 場景使用正確的 Gherkin 語法 │
|
|
50
|
+
│ □ 場景是宣告式的(WHAT,不是 HOW) │
|
|
51
|
+
│ □ 使用商業語言(無技術術語) │
|
|
52
|
+
│ □ 每個場景獨立且自包含 │
|
|
53
|
+
│ □ 場景最多 5-10 個步驟 │
|
|
54
|
+
│ □ 場景已由利害關係人審查 │
|
|
55
|
+
├─────────────────────────────────────────────────────────────────┤
|
|
56
|
+
│ ⚙️ 自動化階段 │
|
|
57
|
+
│ □ 所有步驟已建立步驟定義 │
|
|
58
|
+
│ □ 步驟定義可重用 │
|
|
59
|
+
│ □ 場景初始失敗(RED) │
|
|
60
|
+
│ □ TDD 用於單元層級實作 │
|
|
61
|
+
│ □ 所有場景通過(GREEN) │
|
|
62
|
+
│ □ 程式碼重構且整潔 │
|
|
63
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Gherkin 快速參考
|
|
67
|
+
|
|
68
|
+
| 關鍵字 | 用途 | 範例 |
|
|
69
|
+
|--------|------|------|
|
|
70
|
+
| `Feature` | 場景容器 | `Feature: 用戶登入` |
|
|
71
|
+
| `Scenario` | 單一測試案例 | `Scenario: 成功登入` |
|
|
72
|
+
| `Given` | 設定初始情境 | `Given 我在登入頁面` |
|
|
73
|
+
| `When` | 觸發動作 | `When 我輸入有效憑證` |
|
|
74
|
+
| `Then` | 斷言結果 | `Then 我應該看到我的儀表板` |
|
|
75
|
+
| `And`/`But` | 延續前一個 | `And 我應該看到歡迎訊息` |
|
|
76
|
+
| `Background` | 共同設定 | 每個場景前執行 |
|
|
77
|
+
| `Scenario Outline` | 資料驅動 | 帶 Examples 表格的範本 |
|
|
78
|
+
|
|
79
|
+
### 宣告式 vs 命令式
|
|
80
|
+
|
|
81
|
+
```gherkin
|
|
82
|
+
# ❌ 壞 - 命令式(太詳細,UI 導向)
|
|
83
|
+
Scenario: 登入
|
|
84
|
+
Given 我導航到 "http://example.com/login"
|
|
85
|
+
And 我點擊使用者名稱欄位
|
|
86
|
+
And 我輸入 "john@example.com"
|
|
87
|
+
And 我點擊密碼欄位
|
|
88
|
+
And 我輸入 "secret123"
|
|
89
|
+
And 我點擊提交按鈕
|
|
90
|
+
Then 我應該在頁面標題看到 "Dashboard"
|
|
91
|
+
|
|
92
|
+
# ✅ 好 - 宣告式(行為導向)
|
|
93
|
+
Scenario: 使用有效憑證成功登入
|
|
94
|
+
Given 我是註冊使用者
|
|
95
|
+
When 我使用有效憑證登入
|
|
96
|
+
Then 我應該看到我的儀表板
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## 三方協作快速參考
|
|
102
|
+
|
|
103
|
+
| 角色 | 焦點 | 要問的問題 |
|
|
104
|
+
|------|------|----------|
|
|
105
|
+
| **商業** (PO/BA) | What & Why | 「價值是什麼?」「使用者是誰?」 |
|
|
106
|
+
| **開發** | How | 「技術影響是什麼?」「依賴?」 |
|
|
107
|
+
| **測試** (QA) | What if | 「可能出什麼錯?」「邊界案例?」 |
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## 工作流程協助
|
|
112
|
+
|
|
113
|
+
### 探索階段指引
|
|
114
|
+
|
|
115
|
+
探索需求時:
|
|
116
|
+
|
|
117
|
+
1. **Example Mapping**
|
|
118
|
+
```
|
|
119
|
+
🟡 用戶故事: "使用者可以登入"
|
|
120
|
+
│
|
|
121
|
+
├─ 🔵 規則: "使用者必須通過驗證"
|
|
122
|
+
│ ├─ 🟢 範例: 有效憑證 → 登入成功
|
|
123
|
+
│ └─ 🟢 範例: 無效憑證 → 錯誤訊息
|
|
124
|
+
│
|
|
125
|
+
├─ 🔵 規則: "失敗後帳號鎖定"
|
|
126
|
+
│ ├─ 🟢 範例: 3 次失敗 → 帳號鎖定
|
|
127
|
+
│ └─ 🟢 範例: 鎖定帳號 → 無法登入
|
|
128
|
+
│
|
|
129
|
+
└─ 🔴 問題: 密碼過期政策?
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
2. **要問的問題**
|
|
133
|
+
- Happy path 是什麼?
|
|
134
|
+
- 可能出什麼錯?
|
|
135
|
+
- 邊界條件是什麼?
|
|
136
|
+
- 明確的範圍外是什麼?
|
|
137
|
+
|
|
138
|
+
### 制定階段指引
|
|
139
|
+
|
|
140
|
+
撰寫場景時:
|
|
141
|
+
|
|
142
|
+
1. **Feature 檔案結構**
|
|
143
|
+
```gherkin
|
|
144
|
+
Feature: 功能名稱
|
|
145
|
+
As a [角色]
|
|
146
|
+
I want [功能]
|
|
147
|
+
So that [好處]
|
|
148
|
+
|
|
149
|
+
Background:
|
|
150
|
+
Given 共同前置條件
|
|
151
|
+
|
|
152
|
+
Scenario: 描述性場景名稱
|
|
153
|
+
Given [初始情境]
|
|
154
|
+
When [動作]
|
|
155
|
+
Then [預期結果]
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
2. **場景風格指南**
|
|
159
|
+
- 每個場景一個行為
|
|
160
|
+
- 使用商業語言
|
|
161
|
+
- 保持步驟宣告式
|
|
162
|
+
- 最多 5-10 個步驟
|
|
163
|
+
- 使場景獨立
|
|
164
|
+
|
|
165
|
+
### 自動化階段指引
|
|
166
|
+
|
|
167
|
+
實作時:
|
|
168
|
+
|
|
169
|
+
1. **步驟定義最佳實踐**
|
|
170
|
+
```typescript
|
|
171
|
+
// ✅ 好: 可重用、參數化
|
|
172
|
+
Given('我的購物車有 {int} 個商品', (count) => { ... });
|
|
173
|
+
|
|
174
|
+
// ❌ 壞: 特定於一個場景
|
|
175
|
+
Given('我的購物車有 3 個 Widget', () => { ... });
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
2. **BDD + TDD 整合**
|
|
179
|
+
```
|
|
180
|
+
BDD 場景(功能層級)
|
|
181
|
+
│
|
|
182
|
+
└──▶ 步驟定義
|
|
183
|
+
│
|
|
184
|
+
└──▶ TDD 循環(單元層級)
|
|
185
|
+
🔴 撰寫失敗的單元測試
|
|
186
|
+
🟢 實作最小程式碼
|
|
187
|
+
🔵 重構
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
## 與其他工作流程整合
|
|
193
|
+
|
|
194
|
+
### BDD + SDD
|
|
195
|
+
|
|
196
|
+
與規格驅動開發一起工作時:
|
|
197
|
+
|
|
198
|
+
```gherkin
|
|
199
|
+
# 在 feature 檔案中引用規格
|
|
200
|
+
# @spec SPEC-001
|
|
201
|
+
@SPEC-001
|
|
202
|
+
Feature: 用戶認證
|
|
203
|
+
實作 SPEC-001 用戶認證需求。
|
|
204
|
+
|
|
205
|
+
@AC-1
|
|
206
|
+
Scenario: 成功登入
|
|
207
|
+
# SPEC-001 的驗收標準 1
|
|
208
|
+
...
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### BDD + TDD
|
|
212
|
+
|
|
213
|
+
```
|
|
214
|
+
場景層級(BDD) 單元層級(TDD)
|
|
215
|
+
───────────────────── ─────────────────
|
|
216
|
+
Scenario: 結帳 ──────▶ test_calculate_total()
|
|
217
|
+
Given 購物車商品 test_apply_discount()
|
|
218
|
+
When 結帳 test_create_order()
|
|
219
|
+
Then 訂單建立 test_send_email()
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
### BDD + ATDD
|
|
223
|
+
|
|
224
|
+
```
|
|
225
|
+
ATDD: 驗收標準(商業簽核)
|
|
226
|
+
│
|
|
227
|
+
└──▶ BDD: Feature 檔案(Gherkin 場景)
|
|
228
|
+
│
|
|
229
|
+
└──▶ TDD: 單元測試(實作)
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
## 配置偵測
|
|
235
|
+
|
|
236
|
+
本技能支援專案特定配置。
|
|
237
|
+
|
|
238
|
+
### 偵測順序
|
|
239
|
+
|
|
240
|
+
1. 檢查 `CONTRIBUTING.md` 的「Disabled Skills」區段
|
|
241
|
+
- 若此技能被列出,則在此專案中禁用
|
|
242
|
+
2. 檢查 `CONTRIBUTING.md` 的「BDD Standards」區段
|
|
243
|
+
3. 檢查程式碼庫中現有的 `.feature` 檔案
|
|
244
|
+
4. 若未找到,**預設使用標準 BDD 實務**
|
|
245
|
+
|
|
246
|
+
### 首次設定
|
|
247
|
+
|
|
248
|
+
若未找到配置且情境不明確:
|
|
249
|
+
|
|
250
|
+
1. 詢問:「此專案尚未配置 BDD 偏好。您使用哪個 BDD 工具?」
|
|
251
|
+
- Cucumber (JavaScript/TypeScript)
|
|
252
|
+
- Behave (Python)
|
|
253
|
+
- SpecFlow (C#)
|
|
254
|
+
- 其他
|
|
255
|
+
|
|
256
|
+
2. 選擇後,建議記錄在 `CONTRIBUTING.md`:
|
|
257
|
+
|
|
258
|
+
```markdown
|
|
259
|
+
## BDD 標準
|
|
260
|
+
|
|
261
|
+
### BDD 工具
|
|
262
|
+
- Cucumber.js
|
|
263
|
+
|
|
264
|
+
### Feature 檔案位置
|
|
265
|
+
- `features/` 目錄
|
|
266
|
+
|
|
267
|
+
### 場景風格
|
|
268
|
+
- 宣告式(行為導向)
|
|
269
|
+
- 需要商業語言
|
|
270
|
+
- 每個場景最多 10 個步驟
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
## 詳細指南
|
|
276
|
+
|
|
277
|
+
完整標準請參閱:
|
|
278
|
+
- [BDD 核心標準](../../../../core/behavior-driven-development.md)
|
|
279
|
+
- [BDD 工作流程指南](./bdd-workflow.md)
|
|
280
|
+
- [Gherkin 快速參考](./gherkin-guide.md)
|
|
281
|
+
|
|
282
|
+
相關標準:
|
|
283
|
+
- [TDD 標準](../../core/test-driven-development.md)
|
|
284
|
+
- [ATDD 標準](../../../../core/acceptance-test-driven-development.md)
|
|
285
|
+
- [測試標準](../../core/testing-standards.md)
|
|
286
|
+
|
|
287
|
+
---
|
|
288
|
+
|
|
289
|
+
## 反模式快速偵測
|
|
290
|
+
|
|
291
|
+
| 症狀 | 可能問題 | 快速修復 |
|
|
292
|
+
|------|---------|---------|
|
|
293
|
+
| 場景因 UI 變更而失敗 | 命令式風格 | 使用宣告式語言 |
|
|
294
|
+
| 商業無法閱讀場景 | 技術術語 | 使用商業語言 |
|
|
295
|
+
| 場景通過但功能不工作 | 缺少場景 | 更好的 Discovery 會議 |
|
|
296
|
+
| 太多場景 | 場景爆炸 | 使用 Scenario Outline |
|
|
297
|
+
| 步驟定義重複 | 不可重用 | 抽取到輔助函數 |
|
|
298
|
+
|
|
299
|
+
---
|
|
300
|
+
|
|
301
|
+
## 相關標準
|
|
302
|
+
|
|
303
|
+
- [行為驅動開發](../../../../core/behavior-driven-development.md) - 核心 BDD 標準
|
|
304
|
+
- [驗收測試驅動開發](../../../../core/acceptance-test-driven-development.md) - ATDD 標準
|
|
305
|
+
- [測試驅動開發](../../core/test-driven-development.md) - TDD 標準
|
|
306
|
+
- [規格驅動開發](../../core/spec-driven-development.md) - SDD 工作流程
|
|
307
|
+
- [測試標準](../../core/testing-standards.md) - 測試框架
|
|
308
|
+
- [TDD 助手](../tdd-assistant/SKILL.md) - TDD 技能
|
|
309
|
+
|
|
310
|
+
---
|
|
311
|
+
|
|
312
|
+
## 版本歷史
|
|
313
|
+
|
|
314
|
+
| 版本 | 日期 | 變更 |
|
|
315
|
+
|------|------|------|
|
|
316
|
+
| 1.0.0 | 2026-01-19 | 初始發布 |
|
|
317
|
+
|
|
318
|
+
---
|
|
319
|
+
|
|
320
|
+
## 授權
|
|
321
|
+
|
|
322
|
+
本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
|
|
323
|
+
|
|
324
|
+
**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/changelog-guide/SKILL.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-02-10
|
|
6
|
+
status: current
|
|
7
|
+
description: |
|
|
8
|
+
根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目。
|
|
9
|
+
使用時機:更新變更日誌、版本發布、記錄變更。
|
|
10
|
+
關鍵字:changelog, CHANGELOG.md, keep a changelog, 變更日誌, 版本紀錄。
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 變更日誌助手
|
|
14
|
+
|
|
15
|
+
> **語言**: [English](../../../../skills/changelog-guide/SKILL.md) | 繁體中文
|
|
16
|
+
|
|
17
|
+
根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目。
|
|
18
|
+
|
|
19
|
+
## 工作流程
|
|
20
|
+
|
|
21
|
+
1. **分析 git log** - 使用 `git log` 讀取上次發布以來的提交歷史
|
|
22
|
+
2. **分類變更** - 將提交對應到變更日誌分類
|
|
23
|
+
3. **產生條目** - 為每個變更撰寫使用者友善的描述
|
|
24
|
+
4. **更新 CHANGELOG.md** - 將條目插入 [Unreleased] 或版本區段
|
|
25
|
+
|
|
26
|
+
## 變更分類
|
|
27
|
+
|
|
28
|
+
| 分類 | 使用時機 | When to Use | 對應提交類型 |
|
|
29
|
+
|------|---------|-------------|-------------|
|
|
30
|
+
| **Added** | 新功能 | New features | `feat` |
|
|
31
|
+
| **Changed** | 修改既有功能 | Modifications to existing features | `perf`, `BREAKING CHANGE` |
|
|
32
|
+
| **Deprecated** | 即將移除的功能 | Features to be removed | -- |
|
|
33
|
+
| **Removed** | 已移除的功能 | Removed features | `BREAKING CHANGE` |
|
|
34
|
+
| **Fixed** | 錯誤修復 | Bug fixes | `fix` |
|
|
35
|
+
| **Security** | 安全性修補 | Security patches | `security` |
|
|
36
|
+
|
|
37
|
+
## 條目格式
|
|
38
|
+
|
|
39
|
+
```markdown
|
|
40
|
+
## [Unreleased]
|
|
41
|
+
### Added
|
|
42
|
+
- Add user dashboard with customizable widgets (#123)
|
|
43
|
+
### Changed
|
|
44
|
+
- **BREAKING**: Change API response format from XML to JSON (#789)
|
|
45
|
+
### Fixed
|
|
46
|
+
- Fix memory leak when processing large files (#456)
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 撰寫指南
|
|
50
|
+
|
|
51
|
+
- 為**使用者**而非開發者撰寫 | Write for users, not developers
|
|
52
|
+
- 聚焦**影響**而非實作 | Focus on impact, not implementation
|
|
53
|
+
- 附上 issue/PR 編號 | Include issue/PR references
|
|
54
|
+
- 用 **BREAKING** 標記破壞性變更 | Mark breaking changes with BREAKING prefix
|
|
55
|
+
|
|
56
|
+
## 使用方式
|
|
57
|
+
|
|
58
|
+
- `/changelog` - 分析近期提交並產生變更日誌條目
|
|
59
|
+
- 也可透過 `/release changelog [version]` 使用
|
|
60
|
+
|
|
61
|
+
## 參考
|
|
62
|
+
|
|
63
|
+
- 詳細指南:[guide.md](./guide.md)
|
|
64
|
+
- 核心規範:[changelog-standards.md](../../../../core/changelog-standards.md)
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: changelog-guide
|
|
3
2
|
description: |
|
|
4
3
|
依照 Keep a Changelog 格式撰寫與維護 CHANGELOG.md。
|
|
5
4
|
使用時機:建立變更日誌條目、準備發布、記錄變更。
|
|
6
5
|
關鍵字:changelog, release notes, CHANGELOG.md, keep a changelog, 變更日誌, 發布說明。
|
|
7
|
-
source:
|
|
6
|
+
source: ../../../../skills/changelog-guide/SKILL.md
|
|
8
7
|
source_version: 1.0.0
|
|
9
8
|
translation_version: 1.0.0
|
|
10
9
|
last_synced: 2026-01-08
|
|
@@ -13,7 +12,7 @@ status: current
|
|
|
13
12
|
|
|
14
13
|
# 變更日誌指南
|
|
15
14
|
|
|
16
|
-
> **語言**: [English](
|
|
15
|
+
> **語言**: [English](../../../../skills/changelog-guide/SKILL.md) | 繁體中文
|
|
17
16
|
|
|
18
17
|
**版本**: 1.0.0
|
|
19
18
|
**最後更新**: 2025-12-30
|
|
@@ -106,7 +105,7 @@ status: current
|
|
|
106
105
|
## 詳細指南
|
|
107
106
|
|
|
108
107
|
完整標準請參考:
|
|
109
|
-
- [變更日誌標準](
|
|
108
|
+
- [變更日誌標準](../../core/changelog-standards.md)
|
|
110
109
|
|
|
111
110
|
### AI 優化格式(節省 Token)
|
|
112
111
|
|
|
@@ -215,9 +214,9 @@ AI 助手可使用 YAML 格式檔案以減少 Token 使用量:
|
|
|
215
214
|
|
|
216
215
|
## 相關標準
|
|
217
216
|
|
|
218
|
-
- [變更日誌標準](
|
|
219
|
-
- [版本控制標準](
|
|
220
|
-
- [提交訊息指南](
|
|
217
|
+
- [變更日誌標準](../../core/changelog-standards.md)
|
|
218
|
+
- [版本控制標準](../../core/versioning.md)
|
|
219
|
+
- [提交訊息指南](../../core/commit-message-guide.md)
|
|
221
220
|
- [發布標準技能](../release-standards/SKILL.md)
|
|
222
221
|
|
|
223
222
|
---
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/checkin-assistant/SKILL.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-02-10
|
|
6
|
+
status: current
|
|
7
|
+
description: |
|
|
8
|
+
在提交程式碼前驗證品質關卡,確保程式碼庫穩定性。
|
|
9
|
+
使用時機:提交前檢查、品質驗證、pre-commit 檢查。
|
|
10
|
+
關鍵字:checkin, pre-commit, quality gate, 簽入, 品質關卡, 驗證。
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 簽入助手
|
|
14
|
+
|
|
15
|
+
> **語言**: [English](../../../../skills/checkin-assistant/SKILL.md) | 繁體中文
|
|
16
|
+
|
|
17
|
+
在提交程式碼前驗證品質關卡,確保程式碼庫的穩定性。
|
|
18
|
+
|
|
19
|
+
## 工作流程
|
|
20
|
+
|
|
21
|
+
1. **檢查 git 狀態** - 執行 `git status` 和 `git diff` 了解待提交的變更
|
|
22
|
+
2. **執行測試** - 執行 `npm test`(或專案測試指令)驗證所有測試通過
|
|
23
|
+
3. **執行程式碼檢查** - 執行 `npm run lint` 檢查程式碼風格合規
|
|
24
|
+
4. **驗證品質關卡** - 根據以下清單逐項檢查
|
|
25
|
+
5. **報告結果** - 呈現通過/失敗摘要並建議後續步驟
|
|
26
|
+
|
|
27
|
+
## 品質關卡
|
|
28
|
+
|
|
29
|
+
| 關卡 | 檢查項目 | Check |
|
|
30
|
+
|------|---------|-------|
|
|
31
|
+
| **建置** | 編譯零錯誤 | Code compiles with zero errors |
|
|
32
|
+
| **測試** | 所有測試通過(100%) | All existing tests pass |
|
|
33
|
+
| **覆蓋率** | 覆蓋率未下降 | Test coverage not decreased |
|
|
34
|
+
| **程式碼品質** | 符合編碼規範、無程式碼異味 | Follows coding standards |
|
|
35
|
+
| **安全性** | 無硬編碼密鑰或漏洞 | No hardcoded secrets |
|
|
36
|
+
| **文件** | API 文件和 CHANGELOG 已更新 | Documentation updated |
|
|
37
|
+
| **工作流程** | 分支命名和提交訊息格式正確 | Branch naming and commit correct |
|
|
38
|
+
|
|
39
|
+
## 禁止提交的情況
|
|
40
|
+
|
|
41
|
+
- 建置有錯誤 | Build has errors
|
|
42
|
+
- 測試失敗 | Tests are failing
|
|
43
|
+
- 功能不完整會破壞現有功能 | Feature is incomplete and would break functionality
|
|
44
|
+
- 關鍵邏輯中有 WIP/TODO | Contains WIP/TODO in critical logic
|
|
45
|
+
- 包含除錯程式碼(console.log、print) | Contains debugging code
|
|
46
|
+
- 包含被註解的程式碼區塊 | Contains commented-out code blocks
|
|
47
|
+
|
|
48
|
+
## 使用方式
|
|
49
|
+
|
|
50
|
+
- `/checkin` - 對目前變更執行完整品質關卡驗證
|
|
51
|
+
- 驗證通過後,使用 `/commit` 建立 commit message
|
|
52
|
+
|
|
53
|
+
## 參考
|
|
54
|
+
|
|
55
|
+
- 詳細指南:[guide.md](./guide.md)
|
|
56
|
+
- 核心規範:[checkin-standards.md](../../../../core/checkin-standards.md)
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/checkin-assistant/SKILL.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2026-01-12
|
|
6
6
|
status: current
|
|
7
|
-
name: checkin-assistant
|
|
8
7
|
description: |
|
|
9
8
|
引導提交前品質關卡和簽入工作流程。
|
|
10
9
|
使用時機:提交程式碼、準備提交、品質關卡驗證。
|
|
@@ -13,7 +12,7 @@ description: |
|
|
|
13
12
|
|
|
14
13
|
# 簽入助手
|
|
15
14
|
|
|
16
|
-
> **語言**:[English](
|
|
15
|
+
> **語言**:[English](../../../../skills/checkin-assistant/SKILL.md) | 繁體中文
|
|
17
16
|
|
|
18
17
|
**版本**:1.0.0
|
|
19
18
|
**最後更新**:2026-01-12
|
|
@@ -378,15 +377,15 @@ npm run lint
|
|
|
378
377
|
## 詳細指南
|
|
379
378
|
|
|
380
379
|
完整標準請參見:
|
|
381
|
-
- [簽入標準](
|
|
380
|
+
- [簽入標準](../../core/checkin-standards.md)
|
|
382
381
|
|
|
383
382
|
---
|
|
384
383
|
|
|
385
384
|
## 相關標準
|
|
386
385
|
|
|
387
|
-
- [簽入標準](
|
|
388
|
-
- [提交訊息指南](
|
|
389
|
-
- [程式碼審查檢查清單](
|
|
386
|
+
- [簽入標準](../../core/checkin-standards.md) - 核心標準
|
|
387
|
+
- [提交訊息指南](../../core/commit-message-guide.md) - 訊息格式
|
|
388
|
+
- [程式碼審查檢查清單](../../core/code-review-checklist.md) - PR 審查
|
|
390
389
|
- [程式碼審查助手](../code-review-assistant/SKILL.md) - 審查技能
|
|
391
390
|
- [提交標準技能](../commit-standards/SKILL.md) - 提交訊息技能
|
|
392
391
|
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/code-review-assistant/SKILL.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-02-10
|
|
6
|
+
status: current
|
|
7
|
+
description: |
|
|
8
|
+
使用標準化檢查清單執行系統性程式碼審查。
|
|
9
|
+
使用時機:審查程式碼、PR 審查、程式碼品質檢查。
|
|
10
|
+
關鍵字:review, code review, PR, checklist, 審查, 程式碼, 品質。
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 程式碼審查助手
|
|
14
|
+
|
|
15
|
+
> **語言**: [English](../../../../skills/code-review-assistant/SKILL.md) | 繁體中文
|
|
16
|
+
|
|
17
|
+
使用標準化的檢查清單和評論前綴,執行系統性的程式碼審查。
|
|
18
|
+
|
|
19
|
+
## 工作流程
|
|
20
|
+
|
|
21
|
+
1. **識別變更** - 透過 `git diff` 或 `git show` 取得待審查檔案的差異
|
|
22
|
+
2. **套用檢查清單** - 系統性地檢查每個審查類別
|
|
23
|
+
3. **產生報告** - 使用標準評論前綴輸出發現
|
|
24
|
+
4. **總結** - 提供整體評估和建議的後續行動
|
|
25
|
+
|
|
26
|
+
## 審查類別
|
|
27
|
+
|
|
28
|
+
1. **功能性** - 功能是否正確? | Does it work correctly?
|
|
29
|
+
2. **設計** - 架構是否合適? | Is the architecture appropriate?
|
|
30
|
+
3. **品質** - 程式碼是否乾淨可維護? | Is the code clean and maintainable?
|
|
31
|
+
4. **可讀性** - 是否容易理解? | Is it easy to understand?
|
|
32
|
+
5. **測試** - 測試覆蓋是否足夠? | Is there adequate test coverage?
|
|
33
|
+
6. **安全性** - 是否有安全漏洞? | Are there any vulnerabilities?
|
|
34
|
+
7. **效能** - 是否有效率? | Is it efficient?
|
|
35
|
+
8. **錯誤處理** - 錯誤處理是否妥當? | Are errors handled properly?
|
|
36
|
+
|
|
37
|
+
## 評論前綴
|
|
38
|
+
|
|
39
|
+
| 前綴 | 意義 | 動作 | Action |
|
|
40
|
+
|------|------|------|--------|
|
|
41
|
+
| **BLOCKING** | 必須在合併前修復 | 必須修復 | Required |
|
|
42
|
+
| **IMPORTANT** | 應該修復 | 建議修復 | Recommended |
|
|
43
|
+
| **SUGGESTION** | 錦上添花 | 可選改善 | Optional |
|
|
44
|
+
| **QUESTION** | 需要說明 | 需要討論 | Discuss |
|
|
45
|
+
| **NOTE** | 資訊性 | 僅供參考 | FYI |
|
|
46
|
+
|
|
47
|
+
## 使用方式
|
|
48
|
+
|
|
49
|
+
- `/review` - 審查目前分支的所有變更
|
|
50
|
+
- `/review src/auth.js` - 審查特定檔案
|
|
51
|
+
- `/review feature/login` - 審查特定分支
|
|
52
|
+
|
|
53
|
+
## 參考
|
|
54
|
+
|
|
55
|
+
- 詳細指南:[guide.md](./guide.md)
|
|
56
|
+
- 核心規範:[code-review-checklist.md](../../../../core/code-review-checklist.md)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
2
|
+
source: ../../../../skills/code-review-assistant/checkin-checklist.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2025-12-25
|
|
@@ -8,7 +8,7 @@ status: current
|
|
|
8
8
|
|
|
9
9
|
# Pre-Commit Checklist(提交前檢查清單)
|
|
10
10
|
|
|
11
|
-
> **語言**: [English](
|
|
11
|
+
> **語言**: [English](../../../../skills/code-review-assistant/checkin-checklist.md) | 繁體中文
|
|
12
12
|
|
|
13
13
|
**版本**: 1.0.0
|
|
14
14
|
**最後更新**: 2025-12-24
|
|
@@ -236,9 +236,9 @@ git commit -m "feat(module-c): add export feature"
|
|
|
236
236
|
|
|
237
237
|
## 相關標準
|
|
238
238
|
|
|
239
|
-
- [Checkin Standards](
|
|
239
|
+
- [Checkin Standards](../../../../core/checkin-standards.md)
|
|
240
240
|
- [Code Review Checklist](./review-checklist.md)
|
|
241
|
-
- [Commit Message Guide](
|
|
241
|
+
- [Commit Message Guide](../../../../core/commit-message-guide.md)
|
|
242
242
|
|
|
243
243
|
---
|
|
244
244
|
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/code-review-assistant/SKILL.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2025-12-25
|
|
6
6
|
status: current
|
|
7
|
-
name: code-review-assistant
|
|
8
7
|
description: |
|
|
9
8
|
系統化的程式碼審查檢查清單和提交前品質關卡。
|
|
10
9
|
使用時機:審查 pull request、檢查程式碼品質、提交程式碼前。
|
|
@@ -13,7 +12,7 @@ description: |
|
|
|
13
12
|
|
|
14
13
|
# 程式碼審查助理
|
|
15
14
|
|
|
16
|
-
> **語言**: [English](
|
|
15
|
+
> **語言**: [English](../../../../skills/code-review-assistant/SKILL.md) | 繁體中文
|
|
17
16
|
|
|
18
17
|
**版本**: 1.0.0
|
|
19
18
|
**最後更新**: 2025-12-24
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/code-review-assistant/review-checklist.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2025-12-25
|
|
@@ -8,7 +8,7 @@ status: current
|
|
|
8
8
|
|
|
9
9
|
# 程式碼審查檢查清單
|
|
10
10
|
|
|
11
|
-
> **語言**: [English](
|
|
11
|
+
> **語言**: [English](../../../../skills/code-review-assistant/review-checklist.md) | 繁體中文
|
|
12
12
|
|
|
13
13
|
**版本**: 1.0.0
|
|
14
14
|
**最後更新**: 2025-12-24
|
|
@@ -225,8 +225,8 @@ status: current
|
|
|
225
225
|
|
|
226
226
|
## 相關標準
|
|
227
227
|
|
|
228
|
-
- [Code Review Checklist](
|
|
229
|
-
- [Checkin Standards](
|
|
228
|
+
- [Code Review Checklist](../../../../core/code-review-checklist.md)
|
|
229
|
+
- [Checkin Standards](../../../../core/checkin-standards.md)
|
|
230
230
|
- [Pre-Commit Checklist](./checkin-checklist.md)
|
|
231
231
|
|
|
232
232
|
---
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
2
|
+
source: ../../../../skills/commands/bdd.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2026-01-12
|
|
@@ -138,5 +138,5 @@ BDD 最適合協作:
|
|
|
138
138
|
|
|
139
139
|
## 參考
|
|
140
140
|
|
|
141
|
-
- 方法論: [bdd.methodology.yaml](
|
|
141
|
+
- 方法論: [bdd.methodology.yaml](../../../../methodologies/bdd.methodology.yaml)
|
|
142
142
|
- 方法論系統: [methodology-system](../methodology-system/SKILL.md)
|