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,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/release-standards/SKILL.md
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-02-10
|
|
6
|
+
status: current
|
|
7
|
+
description: |
|
|
8
|
+
引導遵循語義化版本和變更日誌最佳實踐的發布流程。
|
|
9
|
+
使用時機:版本發布、版本管理、變更日誌更新。
|
|
10
|
+
關鍵字:release, version, semver, changelog, 發布, 版本, 語義化。
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 發布助手
|
|
14
|
+
|
|
15
|
+
> **語言**: [English](../../../../skills/release-standards/SKILL.md) | 繁體中文
|
|
16
|
+
|
|
17
|
+
引導遵循語義化版本和變更日誌最佳實踐的發布流程。
|
|
18
|
+
|
|
19
|
+
## 子命令
|
|
20
|
+
|
|
21
|
+
| 子命令 | 說明 | Description |
|
|
22
|
+
|--------|------|-------------|
|
|
23
|
+
| `start` | 開始發布流程 | Start a release branch/process |
|
|
24
|
+
| `finish` | 完成發布(標籤、合併) | Finalize release (tag, merge) |
|
|
25
|
+
| `changelog` | 產生或更新變更日誌 | Generate or update CHANGELOG.md |
|
|
26
|
+
| `check` | 執行發布前檢查 | Run pre-release verification |
|
|
27
|
+
|
|
28
|
+
## 版本類型
|
|
29
|
+
|
|
30
|
+
| 類型 | 格式 | npm Tag | 用途 |
|
|
31
|
+
|------|------|---------|------|
|
|
32
|
+
| 正式版 | `X.Y.Z` | `@latest` | Stable |
|
|
33
|
+
| 公開測試 | `X.Y.Z-beta.N` | `@beta` | Beta |
|
|
34
|
+
| 內部測試 | `X.Y.Z-alpha.N` | `@alpha` | Alpha |
|
|
35
|
+
| 候選版本 | `X.Y.Z-rc.N` | `@rc` | RC |
|
|
36
|
+
|
|
37
|
+
## 工作流程
|
|
38
|
+
|
|
39
|
+
1. **決定版本** - 根據變更決定版本類型(MAJOR/MINOR/PATCH)
|
|
40
|
+
2. **更新版本檔案** - 更新 package.json 和相關版本參考
|
|
41
|
+
3. **更新 CHANGELOG** - 將 [Unreleased] 條目移至新版本區段
|
|
42
|
+
4. **執行發布前檢查** - 驗證測試、lint 和標準合規
|
|
43
|
+
5. **建立 git tag** - 使用 `vX.Y.Z` 格式標籤
|
|
44
|
+
6. **提交並推送** - 提交版本更新並推送標籤
|
|
45
|
+
|
|
46
|
+
### 版本遞增規則
|
|
47
|
+
|
|
48
|
+
| 變更類型 | 遞增 | 範例 |
|
|
49
|
+
|---------|------|------|
|
|
50
|
+
| 破壞性變更 | MAJOR | 1.9.5 → 2.0.0 |
|
|
51
|
+
| 新功能(向下相容) | MINOR | 2.3.5 → 2.4.0 |
|
|
52
|
+
| 錯誤修復(向下相容) | PATCH | 3.1.2 → 3.1.3 |
|
|
53
|
+
|
|
54
|
+
## 使用方式
|
|
55
|
+
|
|
56
|
+
- `/release start 1.2.0` - 開始 v1.2.0 的發布流程
|
|
57
|
+
- `/release changelog 1.2.0` - 更新 v1.2.0 的 CHANGELOG
|
|
58
|
+
- `/release finish 1.2.0` - 完成並標籤 v1.2.0
|
|
59
|
+
- `/release check` - 執行發布前驗證
|
|
60
|
+
|
|
61
|
+
## 參考
|
|
62
|
+
|
|
63
|
+
- 詳細指南:[guide.md](./guide.md)
|
|
64
|
+
- 核心規範:[versioning.md](../../../../core/versioning.md)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/release-standards/changelog-format.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/release-standards/changelog-format.md) | 繁體中文
|
|
12
12
|
|
|
13
13
|
**版本**: 1.0.0
|
|
14
14
|
**最後更新**: 2025-12-24
|
|
@@ -227,7 +227,7 @@ conventional-changelog -p angular -i CHANGELOG.md -s
|
|
|
227
227
|
|
|
228
228
|
## 相關標準
|
|
229
229
|
|
|
230
|
-
- [Changelog Standards](
|
|
230
|
+
- [Changelog Standards](../../../../core/changelog-standards.md)
|
|
231
231
|
- [Semantic Versioning Guide](./semantic-versioning.md)
|
|
232
232
|
|
|
233
233
|
---
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/release-standards/SKILL.md
|
|
3
3
|
source_version: 1.1.0
|
|
4
4
|
translation_version: 1.1.0
|
|
5
5
|
last_synced: 2026-01-02
|
|
6
6
|
status: current
|
|
7
|
-
name: release-standards
|
|
8
7
|
description: |
|
|
9
8
|
語意化版本控制和變更日誌格式化的軟體發布標準。
|
|
10
9
|
使用時機:準備發布、更新版本號、撰寫變更日誌。
|
|
@@ -13,7 +12,7 @@ description: |
|
|
|
13
12
|
|
|
14
13
|
# 發布標準
|
|
15
14
|
|
|
16
|
-
> **語言**: [English](
|
|
15
|
+
> **語言**: [English](../../../../skills/release-standards/SKILL.md) | 繁體中文
|
|
17
16
|
|
|
18
17
|
**版本**: 1.1.0
|
|
19
18
|
**最後更新**: 2026-01-02
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
3
|
-
source_version: 2.
|
|
4
|
-
translation_version: 2.
|
|
5
|
-
last_synced: 2026-01-
|
|
2
|
+
source: ../../../../skills/release-standards/release-workflow.md
|
|
3
|
+
source_version: 2.2.0
|
|
4
|
+
translation_version: 2.2.0
|
|
5
|
+
last_synced: 2026-01-26
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# 發布流程指南
|
|
10
10
|
|
|
11
|
-
> **Language**: [English](
|
|
11
|
+
> **Language**: [English](../../../../skills/release-standards/release-workflow.md) | 繁體中文
|
|
12
12
|
|
|
13
|
-
**版本**: 2.
|
|
14
|
-
**最後更新**: 2026-01-
|
|
13
|
+
**版本**: 2.2.0
|
|
14
|
+
**最後更新**: 2026-01-26
|
|
15
15
|
**適用範圍**: 所有使用語義化版本的軟體專案
|
|
16
16
|
|
|
17
17
|
---
|
|
@@ -78,31 +78,28 @@ status: current
|
|
|
78
78
|
|
|
79
79
|
## 標準發布流程
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
> **流程理念**:先給版號,再驗證。更新版本後再測試,確保驗證是針對確切的發布版本進行。
|
|
82
|
+
|
|
83
|
+
### 步驟 1:準備發布分支
|
|
82
84
|
|
|
83
85
|
```bash
|
|
84
86
|
# 確保在 main 分支並已更新
|
|
85
87
|
git checkout main
|
|
86
88
|
git pull origin main
|
|
87
89
|
|
|
88
|
-
#
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
# 執行程式碼檢查
|
|
92
|
-
npm run lint # 或專案的 lint 指令
|
|
93
|
-
|
|
94
|
-
# 檢查 git 狀態
|
|
95
|
-
git status # 應為乾淨狀態
|
|
90
|
+
# 檢查 git 狀態(應為乾淨狀態)
|
|
91
|
+
git status
|
|
96
92
|
```
|
|
97
93
|
|
|
98
94
|
### 步驟 2:更新版本
|
|
99
95
|
|
|
100
96
|
```bash
|
|
101
97
|
# npm 專案
|
|
102
|
-
npm version X.Y.Z # 穩定版
|
|
103
|
-
npm version X.Y.Z-beta.N # Beta 版
|
|
98
|
+
npm version X.Y.Z --no-git-tag-version # 穩定版
|
|
99
|
+
npm version X.Y.Z-beta.N --no-git-tag-version # Beta 版
|
|
104
100
|
|
|
105
101
|
# 其他專案,手動更新版本檔案
|
|
102
|
+
# 更新所有專案特定的版本檔案(請參考 CLAUDE.md)
|
|
106
103
|
```
|
|
107
104
|
|
|
108
105
|
### 步驟 3:更新 CHANGELOG
|
|
@@ -110,8 +107,6 @@ npm version X.Y.Z-beta.N # Beta 版
|
|
|
110
107
|
依照 [Keep a Changelog](https://keepachangelog.com/) 格式更新 `CHANGELOG.md`:
|
|
111
108
|
|
|
112
109
|
```markdown
|
|
113
|
-
## [Unreleased]
|
|
114
|
-
|
|
115
110
|
## [X.Y.Z] - YYYY-MM-DD
|
|
116
111
|
|
|
117
112
|
### Added
|
|
@@ -124,7 +119,39 @@ npm version X.Y.Z-beta.N # Beta 版
|
|
|
124
119
|
- 錯誤修正描述
|
|
125
120
|
```
|
|
126
121
|
|
|
127
|
-
|
|
122
|
+
Beta 發布時加入警告:
|
|
123
|
+
|
|
124
|
+
```markdown
|
|
125
|
+
## [X.Y.Z-beta.N] - YYYY-MM-DD
|
|
126
|
+
|
|
127
|
+
> ⚠️ **Beta 發布**:用於測試。使用 `npm install <package>@beta` 安裝
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
### 步驟 4:執行所有測試
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
# 執行自動化測試
|
|
134
|
+
npm test # 或專案的測試指令
|
|
135
|
+
|
|
136
|
+
# 執行程式碼檢查
|
|
137
|
+
npm run lint # 或專案的 lint 指令
|
|
138
|
+
|
|
139
|
+
# 執行預發布檢查(如有)
|
|
140
|
+
./scripts/pre-release-check.sh # 或 .\scripts\pre-release-check.ps1
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
### 步驟 5:手動驗證
|
|
144
|
+
|
|
145
|
+
繼續前請手動驗證:
|
|
146
|
+
|
|
147
|
+
- [ ] **建置驗證**:應用程式成功建置
|
|
148
|
+
- [ ] **冒煙測試**:核心功能如預期運作
|
|
149
|
+
- [ ] **版本顯示**:版本號正確顯示
|
|
150
|
+
- [ ] **Beta 版**:已知問題記錄於 CHANGELOG
|
|
151
|
+
|
|
152
|
+
> ⚠️ **若任何驗證失敗,請在此停止。** 先修復問題再繼續。
|
|
153
|
+
|
|
154
|
+
### 步驟 6:提交與標籤
|
|
128
155
|
|
|
129
156
|
```bash
|
|
130
157
|
# 提交變更
|
|
@@ -136,7 +163,7 @@ git tag vX.Y.Z
|
|
|
136
163
|
git push origin main --tags
|
|
137
164
|
```
|
|
138
165
|
|
|
139
|
-
### 步驟
|
|
166
|
+
### 步驟 7:建立 Release
|
|
140
167
|
|
|
141
168
|
建立 GitHub/GitLab Release:
|
|
142
169
|
- Tag:`vX.Y.Z`
|
|
@@ -144,7 +171,7 @@ git push origin main --tags
|
|
|
144
171
|
- 若為 beta/alpha/rc,標記為 pre-release
|
|
145
172
|
- 從 CHANGELOG 加入發布說明
|
|
146
173
|
|
|
147
|
-
### 步驟
|
|
174
|
+
### 步驟 8:驗證發布
|
|
148
175
|
|
|
149
176
|
```bash
|
|
150
177
|
# npm 套件
|
|
@@ -260,18 +287,21 @@ npm version patch
|
|
|
260
287
|
|
|
261
288
|
## 預發布檢查清單
|
|
262
289
|
|
|
263
|
-
###
|
|
290
|
+
### 通用檢查(所有發布)
|
|
264
291
|
|
|
292
|
+
- [ ] 在正確的分支(穩定版用 main)
|
|
293
|
+
- [ ] Git 工作目錄乾淨
|
|
294
|
+
- [ ] 所有必要檔案的版本已更新
|
|
295
|
+
- [ ] CHANGELOG 已更新發布說明
|
|
265
296
|
- [ ] 所有測試通過
|
|
266
297
|
- [ ] Linting 通過
|
|
267
|
-
- [ ]
|
|
268
|
-
- [ ]
|
|
269
|
-
- [ ] 在正確的分支(穩定版用 main)
|
|
298
|
+
- [ ] 建置成功
|
|
299
|
+
- [ ] 核心功能運作正常(冒煙測試)
|
|
270
300
|
|
|
271
301
|
### Beta 發布前
|
|
272
302
|
|
|
273
303
|
- [ ] 通用檢查完成
|
|
274
|
-
- [ ]
|
|
304
|
+
- [ ] 已知問題記錄於 CHANGELOG
|
|
275
305
|
|
|
276
306
|
### 穩定發布前
|
|
277
307
|
|
|
@@ -335,6 +365,8 @@ npm version patch
|
|
|
335
365
|
|
|
336
366
|
| 版本 | 日期 | 變更 |
|
|
337
367
|
|------|------|------|
|
|
368
|
+
| 2.2.0 | 2026-01-26 | 簡化為通用 Beta→Stable 流程;Alpha→Beta→Stable 移至專案特定配置 |
|
|
369
|
+
| 2.1.0 | 2026-01-26 | 採用「版號優先」流程:更新版號 → 測試 → 驗證 → 發布 |
|
|
338
370
|
| 2.0.0 | 2026-01-14 | 重構為通用指南,專案特有內容移至 CLAUDE.md |
|
|
339
371
|
| 1.0.0 | 2026-01-02 | 初始發布流程指南 |
|
|
340
372
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/release-standards/semantic-versioning.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/release-standards/semantic-versioning.md) | 繁體中文
|
|
12
12
|
|
|
13
13
|
**版本**: 1.0.0
|
|
14
14
|
**最後更新**: 2025-12-24
|
|
@@ -230,7 +230,7 @@ version-1.0.0 ❌ 避免(太冗長)
|
|
|
230
230
|
|
|
231
231
|
## 相關標準
|
|
232
232
|
|
|
233
|
-
- [版本控制標準](
|
|
233
|
+
- [版本控制標準](../../../../core/versioning.md)
|
|
234
234
|
- [變更日誌格式指南](./changelog-format.md)
|
|
235
235
|
|
|
236
236
|
---
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/requirement-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
|
+
撰寫結構良好的使用者故事和需求文件,遵循 INVEST 準則。
|
|
9
|
+
使用時機:撰寫需求、定義使用者故事、驗收條件。
|
|
10
|
+
關鍵字:requirement, user story, INVEST, acceptance criteria, 需求, 使用者故事, 驗收條件。
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 需求助手
|
|
14
|
+
|
|
15
|
+
> **語言**: [English](../../../../skills/requirement-assistant/SKILL.md) | 繁體中文
|
|
16
|
+
|
|
17
|
+
撰寫結構良好的使用者故事和需求文件,遵循 INVEST 準則。
|
|
18
|
+
|
|
19
|
+
## 工作流程
|
|
20
|
+
|
|
21
|
+
1. **理解情境** - 收集功能資訊
|
|
22
|
+
2. **識別利害關係人** - 誰從這個功能受益?
|
|
23
|
+
3. **撰寫使用者故事** - 遵循標準格式
|
|
24
|
+
4. **定義驗收條件** - 具體、可測試的條件
|
|
25
|
+
5. **以 INVEST 驗證** - 檢查品質準則
|
|
26
|
+
|
|
27
|
+
## 使用者故事格式
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
As a [role],
|
|
31
|
+
I want [feature],
|
|
32
|
+
So that [benefit].
|
|
33
|
+
|
|
34
|
+
### Acceptance Criteria
|
|
35
|
+
- [ ] Given [context], when [action], then [result]
|
|
36
|
+
- [ ] Given [context], when [action], then [result]
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## INVEST 準則
|
|
40
|
+
|
|
41
|
+
| 準則 | 說明 | Criterion | Description |
|
|
42
|
+
|------|------|-----------|-------------|
|
|
43
|
+
| **I**ndependent | 可獨立開發 | Independent | Can be developed separately |
|
|
44
|
+
| **N**egotiable | 可協商細節 | Negotiable | Details can be discussed |
|
|
45
|
+
| **V**aluable | 提供使用者價值 | Valuable | Delivers value to user |
|
|
46
|
+
| **E**stimable | 可估算工作量 | Estimable | Can estimate effort |
|
|
47
|
+
| **S**mall | 適合單一迭代 | Small | Fits in one sprint |
|
|
48
|
+
| **T**estable | 有明確測試標準 | Testable | Has clear test criteria |
|
|
49
|
+
|
|
50
|
+
## 品質檢查清單
|
|
51
|
+
|
|
52
|
+
- [ ] 使用者故事遵循「As a / I want / So that」格式
|
|
53
|
+
- [ ] 至少定義 2 個驗收條件
|
|
54
|
+
- [ ] 滿足全部 6 個 INVEST 準則
|
|
55
|
+
- [ ] 已考慮邊界案例和錯誤情境
|
|
56
|
+
- [ ] 已記錄範圍外項目
|
|
57
|
+
|
|
58
|
+
## 使用方式
|
|
59
|
+
|
|
60
|
+
- `/requirement` - 互動式需求撰寫精靈
|
|
61
|
+
- `/requirement user login` - 為功能撰寫需求
|
|
62
|
+
- `/requirement "users can export data"` - 根據描述撰寫需求
|
|
63
|
+
|
|
64
|
+
## 參考
|
|
65
|
+
|
|
66
|
+
- 詳細指南:[guide.md](./guide.md)
|
|
67
|
+
- 核心規範:[requirement-engineering.md](../../../../core/requirement-engineering.md)
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/requirement-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: requirement-assistant
|
|
8
7
|
description: |
|
|
9
8
|
引導需求撰寫、使用者故事建立與功能規格制定。
|
|
10
9
|
使用時機:撰寫需求、使用者故事、問題單、功能規劃。
|
|
@@ -13,7 +12,7 @@ description: |
|
|
|
13
12
|
|
|
14
13
|
# 需求助手
|
|
15
14
|
|
|
16
|
-
> **語言**: [English](
|
|
15
|
+
> **語言**: [English](../../../../skills/requirement-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/requirement-assistant/requirement-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/requirement-assistant/requirement-checklist.md) | 繁體中文
|
|
12
12
|
|
|
13
13
|
**版本**: 1.0.0
|
|
14
14
|
**最後更新**: 2025-12-24
|
|
@@ -306,7 +306,7 @@ status: current
|
|
|
306
306
|
## 相關標準
|
|
307
307
|
|
|
308
308
|
- [需求撰寫指南](./requirement-writing.md)
|
|
309
|
-
- [規格驅動開發](
|
|
309
|
+
- [規格驅動開發](../../core/spec-driven-development.md)
|
|
310
310
|
|
|
311
311
|
---
|
|
312
312
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/requirement-assistant/requirement-writing.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/requirement-assistant/requirement-writing.md) | 繁體中文
|
|
12
12
|
|
|
13
13
|
**版本**: 1.0.0
|
|
14
14
|
**最後更新**: 2025-12-24
|
|
@@ -380,7 +380,7 @@ Epic:電子商務平台
|
|
|
380
380
|
## 相關標準
|
|
381
381
|
|
|
382
382
|
- [需求完整性檢查清單](./requirement-checklist.md)
|
|
383
|
-
- [規格驅動開發](
|
|
383
|
+
- [規格驅動開發](../../core/spec-driven-development.md)
|
|
384
384
|
|
|
385
385
|
---
|
|
386
386
|
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/reverse-engineer/SKILL.md
|
|
3
|
+
source_version: 1.2.0
|
|
4
|
+
translation_version: 1.2.0
|
|
5
|
+
last_synced: 2026-02-10
|
|
6
|
+
status: current
|
|
7
|
+
description: |
|
|
8
|
+
將現有程式碼反向工程為規格文件、BDD 場景或 TDD 覆蓋率報告。
|
|
9
|
+
使用時機:從程式碼提取規格、產生 Gherkin 場景、分析測試覆蓋率。
|
|
10
|
+
關鍵字:reverse engineering, spec, bdd, tdd, 反向工程, 規格, 覆蓋率。
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 反向工程助手
|
|
14
|
+
|
|
15
|
+
> **語言**: [English](../../../../skills/reverse-engineer/SKILL.md) | 繁體中文
|
|
16
|
+
|
|
17
|
+
將現有程式碼反向工程為規格文件、BDD 場景或 TDD 覆蓋率報告。
|
|
18
|
+
|
|
19
|
+
## 子命令
|
|
20
|
+
|
|
21
|
+
| 子命令 | 輸入 | 輸出 | 說明 |
|
|
22
|
+
|--------|------|------|------|
|
|
23
|
+
| `spec` | 程式碼檔案/目錄 | `SPEC-XXX.md` | 從程式碼提取規格 |
|
|
24
|
+
| `bdd` | `SPEC-XXX.md` | `.feature` | 將 AC 轉為 Gherkin |
|
|
25
|
+
| `tdd` | `.feature` | 覆蓋率報告 | 分析測試覆蓋率 |
|
|
26
|
+
|
|
27
|
+
## 工作流程
|
|
28
|
+
|
|
29
|
+
### spec:程式碼轉規格
|
|
30
|
+
|
|
31
|
+
1. **掃描** - 讀取原始碼檔案,識別公開 API、資料流和業務邏輯
|
|
32
|
+
2. **分類** - 將每個發現標記為 `[Confirmed]`、`[Inferred]` 或 `[Unknown]`
|
|
33
|
+
3. **結構化** - 整理為 SDD 規格格式,包含驗收條件
|
|
34
|
+
4. **引用來源** - 每個反向結果皆引用 `file:line` 來源參考
|
|
35
|
+
|
|
36
|
+
### bdd:規格轉 Gherkin
|
|
37
|
+
|
|
38
|
+
1. **解析** - 讀取 SPEC-XXX.md 並提取驗收條件
|
|
39
|
+
2. **轉換** - 將每個 AC 對應為一個 Gherkin Scenario(1:1 對應)
|
|
40
|
+
3. **標記** - 加入 `@SPEC-XXX` 和 `@AC-N` 標籤以確保可追溯性
|
|
41
|
+
4. **輸出** - 產生 `.feature` 檔案,包含 `# [Source: path:AC-N]` 註解
|
|
42
|
+
|
|
43
|
+
### tdd:Feature 轉覆蓋率報告
|
|
44
|
+
|
|
45
|
+
1. **解析** - 讀取 `.feature` 檔案中的場景
|
|
46
|
+
2. **搜尋** - 使用 Grep/Glob 尋找對應的測試檔案
|
|
47
|
+
3. **對應** - 將場景與現有單元測試進行配對
|
|
48
|
+
4. **報告** - 輸出覆蓋率矩陣(已覆蓋 / 缺失 / 部分覆蓋)
|
|
49
|
+
|
|
50
|
+
## 防幻覺規則
|
|
51
|
+
|
|
52
|
+
| 規則 | 要求 |
|
|
53
|
+
|------|------|
|
|
54
|
+
| **確定性標籤** | 所有發現須使用 `[Confirmed]`、`[Inferred]`、`[Unknown]` 標注 |
|
|
55
|
+
| **來源引用** | 每項反向結果須引用 `file:line` 來源 |
|
|
56
|
+
| **禁止捏造** | 不得捏造程式碼中不存在的 API 或行為 |
|
|
57
|
+
|
|
58
|
+
## 使用方式
|
|
59
|
+
|
|
60
|
+
- `/reverse spec src/auth/` - 從 auth 模組提取規格
|
|
61
|
+
- `/reverse bdd specs/SPEC-AUTH.md` - 將規格 AC 轉為 Gherkin 場景
|
|
62
|
+
- `/reverse tdd features/auth.feature` - 分析 feature 檔案的測試覆蓋率
|
|
63
|
+
|
|
64
|
+
## 參考
|
|
65
|
+
|
|
66
|
+
- 詳細指南:[guide.md](./guide.md)
|
|
67
|
+
- 核心規範:[reverse-engineering-standards.md](../../../../core/reverse-engineering-standards.md)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
2
|
+
source: ../../../../skills/reverse-engineer/bdd-extraction.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2026-01-19
|
|
@@ -11,7 +11,7 @@ status: current
|
|
|
11
11
|
**版本**: 1.0.0
|
|
12
12
|
**最後更新**: 2026-01-19
|
|
13
13
|
|
|
14
|
-
> **語言**: [English](
|
|
14
|
+
> **語言**: [English](../../../../skills/reverse-engineer/bdd-extraction.md) | 繁體中文
|
|
15
15
|
|
|
16
16
|
本指南提供從 SDD 規格中提取 BDD(行為驅動開發)場景的詳細工作流程。
|
|
17
17
|
|
|
@@ -1,25 +1,24 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: reverse-engineer
|
|
3
2
|
description: |
|
|
4
3
|
將現有程式碼反向工程成 SDD 規格文件。
|
|
5
4
|
使用時機:分析舊有程式碼、為未文件化的系統撰寫文件、從現有實作提取規格。
|
|
6
5
|
關鍵字:reverse engineering, legacy code, documentation, spec extraction, code archaeology, 反向工程, 舊有程式碼, 規格提取。
|
|
7
|
-
source:
|
|
8
|
-
source_version: 1.
|
|
9
|
-
translation_version: 1.
|
|
10
|
-
last_synced: 2026-01-
|
|
6
|
+
source: ../../../../skills/reverse-engineer/SKILL.md
|
|
7
|
+
source_version: 1.2.0
|
|
8
|
+
translation_version: 1.2.0
|
|
9
|
+
last_synced: 2026-01-25
|
|
11
10
|
status: current
|
|
12
11
|
---
|
|
13
12
|
|
|
14
13
|
# 反向工程成 SDD 規格指南
|
|
15
14
|
|
|
16
|
-
> **語言**: [English](
|
|
15
|
+
> **語言**: [English](../../../../skills/reverse-engineer/SKILL.md) | 繁體中文
|
|
17
16
|
|
|
18
17
|
**版本**: 1.1.0
|
|
19
18
|
**最後更新**: 2026-01-19
|
|
20
19
|
**適用範圍**: Claude Code Skills
|
|
21
20
|
|
|
22
|
-
> **核心規範**:此技能實作[反向工程標準](
|
|
21
|
+
> **核心規範**:此技能實作[反向工程標準](../../core/reverse-engineering-standards.md)。任何 AI 工具皆可參考核心規範取得完整方法論文件。
|
|
23
22
|
|
|
24
23
|
---
|
|
25
24
|
|
|
@@ -72,7 +71,7 @@ status: current
|
|
|
72
71
|
|
|
73
72
|
### 1. 反幻覺合規
|
|
74
73
|
|
|
75
|
-
**關鍵**:此技能必須嚴格遵循[反幻覺標準](
|
|
74
|
+
**關鍵**:此技能必須嚴格遵循[反幻覺標準](../../core/anti-hallucination.md)。
|
|
76
75
|
|
|
77
76
|
#### 確定性標籤
|
|
78
77
|
|
|
@@ -173,7 +172,7 @@ describe('認證', () => {
|
|
|
173
172
|
**輸入**:所有分析結果
|
|
174
173
|
**輸出**:初稿規格文件
|
|
175
174
|
|
|
176
|
-
**範本**:使用 [reverse-spec-template.md](
|
|
175
|
+
**範本**:使用 [reverse-spec-template.md](../../templates/reverse-spec-template.md)
|
|
177
176
|
|
|
178
177
|
### 階段 5:人類審查
|
|
179
178
|
|
|
@@ -250,11 +249,11 @@ describe('購物車', () => {
|
|
|
250
249
|
|
|
251
250
|
## 與其他技能的整合
|
|
252
251
|
|
|
253
|
-
### 與 /
|
|
252
|
+
### 與 /sdd(規格驅動開發)
|
|
254
253
|
|
|
255
|
-
1. 使用 `/reverse-
|
|
254
|
+
1. 使用 `/reverse-sdd` 生成反向工程規格
|
|
256
255
|
2. 審查並填寫 `[未知]` 區塊
|
|
257
|
-
3. 使用 `/
|
|
256
|
+
3. 使用 `/sdd review` 驗證完整性
|
|
258
257
|
4. 繼續正常 SDD 工作流程進行增強
|
|
259
258
|
|
|
260
259
|
### 與 /tdd(測試驅動開發)
|
|
@@ -282,7 +281,7 @@ describe('購物車', () => {
|
|
|
282
281
|
│ 程式碼 + 測試 │
|
|
283
282
|
│ │ │
|
|
284
283
|
│ ▼ │
|
|
285
|
-
│ /reverse-
|
|
284
|
+
│ /reverse-sdd │
|
|
286
285
|
│ │ │
|
|
287
286
|
│ └─→ 生成 SPEC-XXX 含驗收標準 │
|
|
288
287
|
│ │ │
|
|
@@ -306,7 +305,7 @@ describe('購物車', () => {
|
|
|
306
305
|
|
|
307
306
|
| 命令 | 輸入 | 輸出 | 目的 |
|
|
308
307
|
|------|------|------|------|
|
|
309
|
-
| `/reverse-
|
|
308
|
+
| `/reverse-sdd` | 程式碼目錄 | SPEC-XXX.md | 從程式碼提取需求 |
|
|
310
309
|
| `/reverse-bdd` | SPEC 檔案 | .feature 檔案 | 將 AC 轉換為 Gherkin 場景 |
|
|
311
310
|
| `/reverse-tdd` | .feature 檔案 | 覆蓋率報告 | 映射場景到單元測試 |
|
|
312
311
|
|
|
@@ -314,7 +313,7 @@ describe('購物車', () => {
|
|
|
314
313
|
|
|
315
314
|
```bash
|
|
316
315
|
# 步驟 1:將程式碼反向工程成 SDD 規格
|
|
317
|
-
/reverse-
|
|
316
|
+
/reverse-sdd src/auth/
|
|
318
317
|
|
|
319
318
|
# 步驟 2:將驗收標準轉換為 BDD 場景
|
|
320
319
|
/reverse-bdd specs/SPEC-AUTH.md
|
|
@@ -381,9 +380,9 @@ describe('購物車', () => {
|
|
|
381
380
|
|
|
382
381
|
## 相關標準
|
|
383
382
|
|
|
384
|
-
- [規格驅動開發](
|
|
385
|
-
- [反幻覺指南](
|
|
386
|
-
- [程式碼審查檢查清單](
|
|
383
|
+
- [規格驅動開發](../../core/spec-driven-development.md)
|
|
384
|
+
- [反幻覺指南](../../core/anti-hallucination.md)
|
|
385
|
+
- [程式碼審查檢查清單](../../core/code-review-checklist.md)
|
|
387
386
|
|
|
388
387
|
---
|
|
389
388
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
2
|
+
source: ../../../../skills/reverse-engineer/tdd-analysis.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2026-01-19
|
|
@@ -11,7 +11,7 @@ status: current
|
|
|
11
11
|
**版本**: 1.0.0
|
|
12
12
|
**最後更新**: 2026-01-19
|
|
13
13
|
|
|
14
|
-
> **語言**: [English](
|
|
14
|
+
> **語言**: [English](../../../../skills/reverse-engineer/tdd-analysis.md) | 繁體中文
|
|
15
15
|
|
|
16
16
|
本指南提供針對 BDD 場景分析測試覆蓋率並識別缺口的詳細工作流程。
|
|
17
17
|
|
package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md
RENAMED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
2
|
+
source: ../../../../skills/reverse-engineer/workflow.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2026-01-19
|
|
@@ -11,7 +11,7 @@ status: current
|
|
|
11
11
|
**版本**: 1.0.0
|
|
12
12
|
**最後更新**: 2026-01-19
|
|
13
13
|
|
|
14
|
-
> **語言**: [English](
|
|
14
|
+
> **語言**: [English](../../../../skills/reverse-engineer/workflow.md) | 繁體中文
|
|
15
15
|
|
|
16
16
|
本指南提供將程式碼反向工程成 SDD 規格的詳細工作流程。
|
|
17
17
|
|
|
@@ -268,7 +268,7 @@ describe('UserService', () => {
|
|
|
268
268
|
|
|
269
269
|
### 4.1 使用範本
|
|
270
270
|
|
|
271
|
-
套用 [reverse-spec-template.md](
|
|
271
|
+
套用 [reverse-spec-template.md](../../templates/reverse-spec-template.md):
|
|
272
272
|
|
|
273
273
|
```markdown
|
|
274
274
|
# [SPEC-XXX] 功能名稱(反向工程)
|