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,371 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: |
|
|
3
|
+
在新增功能前评估项目健康度、架构与风险。
|
|
4
|
+
使用时机:接手旧项目、在现有代码上新增功能、评估技术债。
|
|
5
|
+
关键字:discovery, assessment, audit, legacy, health check, technical debt, 现况评估, 风险分析, 技术债, 项目盘点。
|
|
6
|
+
source: ../../../../skills/project-discovery/SKILL.md
|
|
7
|
+
source_version: 1.0.0
|
|
8
|
+
translation_version: 1.0.0
|
|
9
|
+
last_synced: 2026-02-10
|
|
10
|
+
status: current
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 项目现况评估指南
|
|
14
|
+
|
|
15
|
+
> **语言**: [English](../../../../skills/project-discovery/SKILL.md) | 简体中文
|
|
16
|
+
|
|
17
|
+
**版本**: 1.0.0
|
|
18
|
+
**最后更新**: 2026-02-10
|
|
19
|
+
**适用范围**: 所有 AI 编码助手
|
|
20
|
+
|
|
21
|
+
> **工具型技能**:此技能组合既有的 UDS 核心规范,构建结构化的现况评估流程。无需专属的核心规范。
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 目的
|
|
26
|
+
|
|
27
|
+
在现有代码上新增功能前,你需要清楚了解其目前的状态。Phase 0 -- 现况评估 -- 提供系统化的代码健康度、架构、文档、依赖和风险评估,让你能有信心地规划变更。
|
|
28
|
+
|
|
29
|
+
此技能引导你完成 6 个评估步骤,每个步骤均引用既有的 UDS 规范作为方法论和质量闸门。
|
|
30
|
+
|
|
31
|
+
## 快速参考
|
|
32
|
+
|
|
33
|
+
### Phase 0 现况评估工作流程
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
+-------------------------------------------------------------------+
|
|
37
|
+
| Phase 0:项目现况评估 |
|
|
38
|
+
+-------------------------------------------------------------------+
|
|
39
|
+
| |
|
|
40
|
+
| 0.1 代码健康度检查 |
|
|
41
|
+
| -- 测试覆盖率、lint 问题、代码异味 |
|
|
42
|
+
| |
|
|
43
|
+
| 0.2 架构理解 |
|
|
44
|
+
| -- 入口点、模块地图、架构模式 |
|
|
45
|
+
| |
|
|
46
|
+
| 0.3 文档盘点 |
|
|
47
|
+
| -- README、ADR、变更日志、内嵌文档 |
|
|
48
|
+
| |
|
|
49
|
+
| 0.4 代码审查快照 |
|
|
50
|
+
| -- 关键路径的抽样审计 |
|
|
51
|
+
| |
|
|
52
|
+
| 0.5 依赖与安全检查 |
|
|
53
|
+
| -- 过期套件、已知漏洞 |
|
|
54
|
+
| |
|
|
55
|
+
| 0.6 影响范围分析 |
|
|
56
|
+
| -- 变更传播、风险矩阵 |
|
|
57
|
+
| |
|
|
58
|
+
| ------------------------------------------------------------------ |
|
|
59
|
+
| 输出:现况评估报告(通过 / 不通过 / 有条件通过) |
|
|
60
|
+
| 下一步:/reverse -> /sdd -> 实现 |
|
|
61
|
+
+-------------------------------------------------------------------+
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### 步骤总览
|
|
65
|
+
|
|
66
|
+
| 步骤 | 重点 | 主要产出 | 引用的 UDS 规范 |
|
|
67
|
+
|------|------|----------|----------------|
|
|
68
|
+
| 0.1 | 代码健康度 | 测试覆盖率 %、lint 分数、代码异味数 | 测试标准、反向工程 |
|
|
69
|
+
| 0.2 | 架构 | 模块依赖图、架构模式识别 | AI 友善架构、反向工程 |
|
|
70
|
+
| 0.3 | 文档 | 文档覆盖矩阵、过期指标 | 文档结构、变更日志 |
|
|
71
|
+
| 0.4 | 代码审查 | 关键路径审计、质量快照 | 反幻觉、代码审查清单 |
|
|
72
|
+
| 0.5 | 依赖 | 漏洞报告、过期套件清单 | 安全标准、签入标准 |
|
|
73
|
+
| 0.6 | 影响范围 | 风险矩阵、变更传播地图 | 需求工程 |
|
|
74
|
+
|
|
75
|
+
## 工作流程步骤
|
|
76
|
+
|
|
77
|
+
### 步骤 0.1:代码健康度检查
|
|
78
|
+
|
|
79
|
+
**目标**:建立代码质量的基准量测。
|
|
80
|
+
|
|
81
|
+
**操作**:
|
|
82
|
+
1. 执行现有测试套件并记录通过率和覆盖率
|
|
83
|
+
2. 执行 linter 并统计警告/错误数
|
|
84
|
+
3. 识别代码异味(过长函数、深层嵌套、重复逻辑)
|
|
85
|
+
4. 检查死代码和未使用的导出
|
|
86
|
+
|
|
87
|
+
**输出格式**:
|
|
88
|
+
```markdown
|
|
89
|
+
## 代码健康度摘要
|
|
90
|
+
|
|
91
|
+
| 指标 | 值 | 状态 |
|
|
92
|
+
|------|-----|------|
|
|
93
|
+
| 测试通过率 | 85/100 (85%) | ⚠️ 低于目标 |
|
|
94
|
+
| 测试覆盖率 | 42% | ❌ 偏低 |
|
|
95
|
+
| Lint 错误 | 23 | ⚠️ 需要关注 |
|
|
96
|
+
| 代码异味 | 7 个主要 | ⚠️ 需要关注 |
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
**质量闸门**:若测试通过率 < 70%,标记为高风险后再继续。
|
|
100
|
+
|
|
101
|
+
**引用规范**:
|
|
102
|
+
- [测试标准](../../../../core/testing-standards.md)
|
|
103
|
+
- [反向工程标准](../../../../core/reverse-engineering-standards.md)
|
|
104
|
+
|
|
105
|
+
### 步骤 0.2:架构理解
|
|
106
|
+
|
|
107
|
+
**目标**:绘制系统结构并识别架构模式。
|
|
108
|
+
|
|
109
|
+
**操作**:
|
|
110
|
+
1. 识别入口点(主文件、API 路由、事件处理器)
|
|
111
|
+
2. 绘制模块/套件依赖关系
|
|
112
|
+
3. 识别架构模式(MVC、DDD、微服务、单体式等)
|
|
113
|
+
4. 标记反模式(循环依赖、上帝模块)
|
|
114
|
+
5. 评估 AI 友善度(清晰边界、可发现性结构)
|
|
115
|
+
|
|
116
|
+
**输出格式**:
|
|
117
|
+
```markdown
|
|
118
|
+
## 架构概览
|
|
119
|
+
|
|
120
|
+
**模式**: [Confirmed] MVC 含服务层
|
|
121
|
+
**入口点**: src/index.ts, src/api/routes.ts
|
|
122
|
+
**模块数**: 24 个模块横跨 6 个套件
|
|
123
|
+
|
|
124
|
+
### 依赖地图(简化版)
|
|
125
|
+
routes -> controllers -> services -> repositories -> database
|
|
126
|
+
|
|
127
|
+
### 问题
|
|
128
|
+
- [Confirmed] UserService <-> AuthService 之间存在循环依赖
|
|
129
|
+
- [Inferred] 支付模块存在紧耦合
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
**质量闸门**:若无清晰模块边界,建议在功能开发前进行架构重构。
|
|
133
|
+
|
|
134
|
+
**引用规范**:
|
|
135
|
+
- [AI 友善架构](../../../../core/ai-friendly-architecture.md)
|
|
136
|
+
- [反向工程标准](../../../../core/reverse-engineering-standards.md)
|
|
137
|
+
|
|
138
|
+
### 步骤 0.3:文档盘点
|
|
139
|
+
|
|
140
|
+
**目标**:评估文档完整性和新鲜度。
|
|
141
|
+
|
|
142
|
+
**操作**:
|
|
143
|
+
1. 检查 README、CONTRIBUTING、CHANGELOG
|
|
144
|
+
2. 扫描架构决策记录(ADR)
|
|
145
|
+
3. 评估内嵌文档(JSDoc、docstring、注释)
|
|
146
|
+
4. 检查文档是否与当前代码状态一致
|
|
147
|
+
|
|
148
|
+
**输出格式**:
|
|
149
|
+
```markdown
|
|
150
|
+
## 文档盘点
|
|
151
|
+
|
|
152
|
+
| 文档 | 存在 | 最后更新 | 状态 |
|
|
153
|
+
|------|------|----------|------|
|
|
154
|
+
| README.md | ✅ | 2025-06-15 | ⚠️ 过期 |
|
|
155
|
+
| CHANGELOG.md | ❌ | — | — |
|
|
156
|
+
| API 文档 | ✅ | 2025-09-01 | ✅ 最新 |
|
|
157
|
+
| ADR | ❌ | — | — |
|
|
158
|
+
| 内嵌文档 | ⚠️ 部分 | — | — |
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
**质量闸门**:若 README 遗失或严重过期,建议先更新文档。
|
|
162
|
+
|
|
163
|
+
**引用规范**:
|
|
164
|
+
- [文档结构](../../../../core/documentation-structure.md)
|
|
165
|
+
- [变更日志标准](../../../../core/changelog-standards.md)
|
|
166
|
+
|
|
167
|
+
### 步骤 0.4:代码审查快照
|
|
168
|
+
|
|
169
|
+
**目标**:对关键代码路径进行抽样质量审计。
|
|
170
|
+
|
|
171
|
+
**操作**:
|
|
172
|
+
1. 识别 3-5 条最关键的代码路径(认证、支付、数据访问等)
|
|
173
|
+
2. 使用代码审查清单逐一检视
|
|
174
|
+
3. 套用反幻觉标签 -- 只报告你实际读过的内容
|
|
175
|
+
4. 标记任何安全疑虑或错误处理缺口
|
|
176
|
+
|
|
177
|
+
**输出格式**:
|
|
178
|
+
```markdown
|
|
179
|
+
## 代码审查快照
|
|
180
|
+
|
|
181
|
+
### 关键路径:认证
|
|
182
|
+
[Confirmed] 已审查 src/auth/login.ts、src/auth/middleware.ts
|
|
183
|
+
|
|
184
|
+
| 面向 | 评分 | 备注 |
|
|
185
|
+
|------|------|------|
|
|
186
|
+
| 错误处理 | ⚠️ | 缺少 token 更新失败的 catch |
|
|
187
|
+
| 安全性 | ✅ | bcrypt 杂凑、参数化查询 |
|
|
188
|
+
| 可读性 | ✅ | 命名清晰、函数长度合理 |
|
|
189
|
+
|
|
190
|
+
[Unknown] Token 轮换策略 -- 需要利害关系人确认
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
**质量闸门**:任何 ❌ 安全性发现必须在功能开发前立即处理。
|
|
194
|
+
|
|
195
|
+
**引用规范**:
|
|
196
|
+
- [反幻觉指南](../../../../core/anti-hallucination.md)
|
|
197
|
+
- [代码审查清单](../../../../core/code-review-checklist.md)
|
|
198
|
+
|
|
199
|
+
### 步骤 0.5:依赖与安全检查
|
|
200
|
+
|
|
201
|
+
**目标**:识别有漏洞、过期或不必要的依赖。
|
|
202
|
+
|
|
203
|
+
**操作**:
|
|
204
|
+
1. 执行 `npm audit` / `pip audit` / 等效指令
|
|
205
|
+
2. 列出过期套件及严重程度
|
|
206
|
+
3. 检查依赖中的已知 CVE
|
|
207
|
+
4. 识别未使用的依赖
|
|
208
|
+
|
|
209
|
+
**输出格式**:
|
|
210
|
+
```markdown
|
|
211
|
+
## 依赖报告
|
|
212
|
+
|
|
213
|
+
| 类别 | 数量 | 严重程度 |
|
|
214
|
+
|------|------|----------|
|
|
215
|
+
| 严重漏洞 | 1 | ❌ 高 |
|
|
216
|
+
| 高风险漏洞 | 3 | ⚠️ 中 |
|
|
217
|
+
| 过期(主要版本) | 5 | ⚠️ |
|
|
218
|
+
| 过期(次要/修补) | 12 | ℹ️ |
|
|
219
|
+
| 未使用依赖 | 2 | ℹ️ |
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
**质量闸门**:任何严重漏洞必须在新增功能前修补。
|
|
223
|
+
|
|
224
|
+
**引用规范**:
|
|
225
|
+
- [安全标准](../../../../core/security-standards.md)
|
|
226
|
+
- [签入标准](../../../../core/checkin-standards.md)
|
|
227
|
+
|
|
228
|
+
### 步骤 0.6:影响范围分析
|
|
229
|
+
|
|
230
|
+
**目标**:绘制提议变更在系统中的传播方式并评估风险。
|
|
231
|
+
|
|
232
|
+
**操作**:
|
|
233
|
+
1. 识别要修改的功能区域
|
|
234
|
+
2. 追踪直接和间接依赖
|
|
235
|
+
3. 评估爆炸半径(影响多少模块)
|
|
236
|
+
4. 构建风险矩阵(可能性 vs. 影响)
|
|
237
|
+
|
|
238
|
+
**输出格式**:
|
|
239
|
+
```markdown
|
|
240
|
+
## 影响分析
|
|
241
|
+
|
|
242
|
+
### 变更目标:用户个人资料模块
|
|
243
|
+
|
|
244
|
+
**爆炸半径**: 6 个模块直接受影响,3 个间接受影响
|
|
245
|
+
|
|
246
|
+
### 风险矩阵
|
|
247
|
+
|
|
248
|
+
| 风险 | 可能性 | 影响 | 缓解措施 |
|
|
249
|
+
|------|--------|------|----------|
|
|
250
|
+
| 认证流程中断 | 中 | 高 | 新增集成测试 |
|
|
251
|
+
| 支付回归 | 低 | 严重 | 部署前手动 QA |
|
|
252
|
+
| API 契约变更 | 高 | 中 | 为 API 端点加版本号 |
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
**质量闸门**:若爆炸半径超过模块总数的 30%,建议采用渐进式方法。
|
|
256
|
+
|
|
257
|
+
**引用规范**:
|
|
258
|
+
- [需求工程](../../../../core/requirement-engineering.md)
|
|
259
|
+
|
|
260
|
+
## 现况评估报告模板
|
|
261
|
+
|
|
262
|
+
完成全部 6 个步骤后,将发现汇整为现况评估报告:
|
|
263
|
+
|
|
264
|
+
```markdown
|
|
265
|
+
# 现况评估报告:[项目名称]
|
|
266
|
+
|
|
267
|
+
**日期**: YYYY-MM-DD
|
|
268
|
+
**评估者**: [AI / 人类]
|
|
269
|
+
|
|
270
|
+
## 执行摘要
|
|
271
|
+
[1-2 句:整体项目健康度与准备程度]
|
|
272
|
+
|
|
273
|
+
## 判定:[通过 / 不通过 / 有条件通过]
|
|
274
|
+
|
|
275
|
+
## 关键发现
|
|
276
|
+
1. ...
|
|
277
|
+
2. ...
|
|
278
|
+
3. ...
|
|
279
|
+
|
|
280
|
+
## 阻塞项目(如有)
|
|
281
|
+
- ...
|
|
282
|
+
|
|
283
|
+
## 建议
|
|
284
|
+
1. ...
|
|
285
|
+
2. ...
|
|
286
|
+
|
|
287
|
+
## 后续步骤
|
|
288
|
+
- [ ] /reverse(若旧代码需要 SDD 规格)
|
|
289
|
+
- [ ] /sdd(为新功能编写规格)
|
|
290
|
+
- [ ] 处理上述阻塞项目
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
## 与其他技能的集成
|
|
294
|
+
|
|
295
|
+
### 搭配 /reverse(反向工程)
|
|
296
|
+
|
|
297
|
+
在以下情况下于现况评估后使用 `/reverse`:
|
|
298
|
+
- 架构缺乏文档记录
|
|
299
|
+
- 需要为既有模块建立正式的 SDD 规格
|
|
300
|
+
- 旧有代码需要结构化分析才能进行变更
|
|
301
|
+
|
|
302
|
+
### 搭配 /sdd(规格驱动开发)
|
|
303
|
+
|
|
304
|
+
在现况评估后使用 `/sdd`:
|
|
305
|
+
- 根据现况评估发现编写新功能规格
|
|
306
|
+
- 在风险评估区段引用现况评估报告
|
|
307
|
+
|
|
308
|
+
### 搭配 /review(代码审查)
|
|
309
|
+
|
|
310
|
+
步骤 0.4 的快照是 `/review` 的轻量版。在以下情况使用完整的 `/review`:
|
|
311
|
+
- 现况评估发现重大质量疑虑
|
|
312
|
+
- 规划变更前需要更深入的审计
|
|
313
|
+
|
|
314
|
+
## 应避免的反模式
|
|
315
|
+
|
|
316
|
+
### 不应该做的事
|
|
317
|
+
|
|
318
|
+
1. **跳过现况评估**
|
|
319
|
+
- 错误:直接在不熟悉的代码上开始编码
|
|
320
|
+
- 正确:先执行 `/discover` 了解你正在处理的内容
|
|
321
|
+
|
|
322
|
+
2. **捏造指标**
|
|
323
|
+
- 错误:「测试覆盖率大概在 60% 左右」
|
|
324
|
+
- 正确:「[Unknown] 测试覆盖率 -- 需要执行测试套件才能量测」
|
|
325
|
+
|
|
326
|
+
3. **不完整的评估**
|
|
327
|
+
- 错误:只检查代码健康度,跳过依赖
|
|
328
|
+
- 正确:完成全部 6 个步骤以获得可靠的全貌
|
|
329
|
+
|
|
330
|
+
4. **忽视质量闸门**
|
|
331
|
+
- 错误:无视严重漏洞继续进行
|
|
332
|
+
- 正确:在增加复杂度前先处理阻塞项目
|
|
333
|
+
|
|
334
|
+
## 最佳实践
|
|
335
|
+
|
|
336
|
+
- 在做出声明前先阅读所有相关代码(反幻觉)
|
|
337
|
+
- 使用确定性标签:`[Confirmed]`、`[Inferred]`、`[Unknown]`
|
|
338
|
+
- 包含来源引用及 file:line 参考
|
|
339
|
+
- 清楚区分事实与建议
|
|
340
|
+
- 根据项目规模调整深度(小型项目 = 轻量评估)
|
|
341
|
+
|
|
342
|
+
---
|
|
343
|
+
|
|
344
|
+
## 相关规范
|
|
345
|
+
|
|
346
|
+
- [反向工程标准](../../../../core/reverse-engineering-standards.md) -- 深度代码分析方法论
|
|
347
|
+
- [测试标准](../../../../core/testing-standards.md) -- 测试覆盖率基准
|
|
348
|
+
- [安全标准](../../../../core/security-standards.md) -- 漏洞评估
|
|
349
|
+
- [AI 友善架构](../../../../core/ai-friendly-architecture.md) -- 架构评估标准
|
|
350
|
+
- [文档结构](../../../../core/documentation-structure.md) -- 文档完整性
|
|
351
|
+
- [变更日志标准](../../../../core/changelog-standards.md) -- 变更追踪
|
|
352
|
+
- [反幻觉指南](../../../../core/anti-hallucination.md) -- 证据导向分析
|
|
353
|
+
- [代码审查清单](../../../../core/code-review-checklist.md) -- 审查方法论
|
|
354
|
+
- [签入标准](../../../../core/checkin-standards.md) -- 质量闸门
|
|
355
|
+
- [需求工程](../../../../core/requirement-engineering.md) -- 影响分析
|
|
356
|
+
|
|
357
|
+
---
|
|
358
|
+
|
|
359
|
+
## 版本历史
|
|
360
|
+
|
|
361
|
+
| 版本 | 日期 | 变更 |
|
|
362
|
+
|------|------|------|
|
|
363
|
+
| 1.0.0 | 2026-02-10 | 初始发布 |
|
|
364
|
+
|
|
365
|
+
---
|
|
366
|
+
|
|
367
|
+
## 授权
|
|
368
|
+
|
|
369
|
+
此技能采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权。
|
|
370
|
+
|
|
371
|
+
**来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
2
|
+
source: ../../../../skills/project-structure-guide/SKILL.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2025-12-30
|
|
@@ -8,7 +8,7 @@ status: current
|
|
|
8
8
|
|
|
9
9
|
# 项目结构指南
|
|
10
10
|
|
|
11
|
-
> **Language**: [English](
|
|
11
|
+
> **Language**: [English](../../../../skills/project-structure-guide/SKILL.md) | 简体中文
|
|
12
12
|
|
|
13
13
|
**版本**:1.0.0
|
|
14
14
|
**最後更新**:2025-12-30
|
|
@@ -139,5 +139,5 @@ project/
|
|
|
139
139
|
|
|
140
140
|
## 相关标准
|
|
141
141
|
|
|
142
|
-
- [核心:项目结构](
|
|
143
|
-
- [AI:项目结构选项](
|
|
142
|
+
- [核心:项目结构](../../../../core/project-structure.md)
|
|
143
|
+
- [AI:项目结构选项](../../../../ai/options/project-structure/)
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/refactoring-assistant/SKILL.md
|
|
3
|
+
source_version: 2.0.0
|
|
4
|
+
translation_version: 2.0.0
|
|
5
|
+
last_synced: 2026-02-10
|
|
6
|
+
status: current
|
|
7
|
+
description: |
|
|
8
|
+
引导重构决策、推荐策略,并提供逐步执行工作流程。
|
|
9
|
+
使用时机:重构代码、评估重构 vs 重写、处理遗留代码。
|
|
10
|
+
关键字:refactor, strategy, legacy, technical debt, 重构, 策略, 遗留代码, 技术债。
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# 重构助手
|
|
14
|
+
|
|
15
|
+
> **语言**: [English](../../../../skills/refactoring-assistant/SKILL.md) | 简体中文
|
|
16
|
+
|
|
17
|
+
引导重构决策、推荐策略,并提供逐步执行工作流程。
|
|
18
|
+
|
|
19
|
+
## 使用方式
|
|
20
|
+
|
|
21
|
+
| 命令 | 用途 |
|
|
22
|
+
|------|------|
|
|
23
|
+
| `/refactor` | 启动交互式重构引导 |
|
|
24
|
+
| `/refactor decide` | 执行重构 vs 重写决策树 |
|
|
25
|
+
| `/refactor tactical` | 建议战术性(日常)策略 |
|
|
26
|
+
| `/refactor strategic` | 引导战略性/架构重构 |
|
|
27
|
+
| `/refactor legacy` | 遗留代码安全策略 |
|
|
28
|
+
| `/refactor debt` | 技术债评估 |
|
|
29
|
+
|
|
30
|
+
## 策略快速参考
|
|
31
|
+
|
|
32
|
+
### 战术性策略(日常)
|
|
33
|
+
|
|
34
|
+
| 策略 | 使用时机 |
|
|
35
|
+
|------|---------|
|
|
36
|
+
| **准备式重构** | 新增被阻挡的功能之前 |
|
|
37
|
+
| **童子军法则** | 任何维护工作中 |
|
|
38
|
+
| **红-绿-重构** | TDD 开发循环 |
|
|
39
|
+
|
|
40
|
+
### 战略性策略(架构)
|
|
41
|
+
|
|
42
|
+
| 策略 | 使用时机 |
|
|
43
|
+
|------|---------|
|
|
44
|
+
| **绞杀者无花果** | 逐步替换整个系统 |
|
|
45
|
+
| **防腐层** | 与遗留系统集成 |
|
|
46
|
+
| **抽象分支** | 在主干上重构共享代码 |
|
|
47
|
+
|
|
48
|
+
### 安全防护策略(遗留代码)
|
|
49
|
+
|
|
50
|
+
| 策略 | 使用时机 |
|
|
51
|
+
|------|---------|
|
|
52
|
+
| **特征化测试** | 任何遗留代码重构之前 |
|
|
53
|
+
| **草稿式重构** | 理解黑盒代码 |
|
|
54
|
+
| **寻找接缝** | 在遗留代码中注入测试替身 |
|
|
55
|
+
|
|
56
|
+
## 工作流程
|
|
57
|
+
|
|
58
|
+
1. **评估** - 识别要重构的代码,评估测试覆盖率
|
|
59
|
+
2. **决策** - 需要时执行决策树(重构 vs 重写)
|
|
60
|
+
3. **选择策略** - 根据范围和风险选择适当策略
|
|
61
|
+
4. **执行** - 遵循逐步工作流程,包含安全检查
|
|
62
|
+
5. **验证** - 执行测试以确认行为未被改变
|
|
63
|
+
|
|
64
|
+
## 参考
|
|
65
|
+
|
|
66
|
+
- 详细指南:[guide.md](./guide.md)
|
|
67
|
+
- 核心规范:[refactoring-standards.md](../../../../core/refactoring-standards.md)
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: skills/
|
|
2
|
+
source: ../../../../skills/refactoring-assistant/SKILL.md
|
|
3
3
|
source_version: 2.0.0
|
|
4
4
|
translation_version: 2.0.0
|
|
5
5
|
last_synced: 2026-01-21
|
|
6
6
|
status: current
|
|
7
|
-
name: refactoring-assistant
|
|
8
7
|
description: |
|
|
9
8
|
引导重构决策和大规模代码改进。
|
|
10
9
|
使用时机:重构代码、遗留系统现代化、技术债、重写决策。
|
|
@@ -13,7 +12,7 @@ description: |
|
|
|
13
12
|
|
|
14
13
|
# 重构助手
|
|
15
14
|
|
|
16
|
-
> **语言**: [English](
|
|
15
|
+
> **语言**: [English](../../../../skills/refactoring-assistant/SKILL.md) | 简体中文
|
|
17
16
|
|
|
18
17
|
**版本**: 2.0.0
|
|
19
18
|
**最后更新**: 2026-01-21
|
|
@@ -278,16 +277,16 @@ selection_guide:
|
|
|
278
277
|
## 详细指南
|
|
279
278
|
|
|
280
279
|
完整标准请参阅:
|
|
281
|
-
- [重构标准](
|
|
280
|
+
- [重构标准](../../../../core/refactoring-standards.md)
|
|
282
281
|
|
|
283
282
|
---
|
|
284
283
|
|
|
285
284
|
## 相关标准
|
|
286
285
|
|
|
287
|
-
- [重构标准](
|
|
288
|
-
- [测试驱动开发](
|
|
289
|
-
- [代码审查检查清单](
|
|
290
|
-
- [签入标准](
|
|
286
|
+
- [重构标准](../../../../core/refactoring-standards.md) - 核心标准
|
|
287
|
+
- [测试驱动开发](../../../../core/test-driven-development.md) - TDD 重构阶段
|
|
288
|
+
- [代码审查检查清单](../../../../core/code-review-checklist.md) - 重构 PR 审查
|
|
289
|
+
- [签入标准](../../../../core/checkin-standards.md) - 提交前要求
|
|
291
290
|
- [TDD 助手](../tdd-assistant/SKILL.md) - TDD 工作流程
|
|
292
291
|
|
|
293
292
|
---
|
|
@@ -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
|
|
@@ -169,9 +168,9 @@ This project follows **Keep a Changelog** format.
|
|
|
169
168
|
|
|
170
169
|
## 相关标准
|
|
171
170
|
|
|
172
|
-
- [版本控制](
|
|
173
|
-
- [变更日誌标准](
|
|
174
|
-
- [Git 工作流程](
|
|
171
|
+
- [版本控制](../../../../core/versioning.md)
|
|
172
|
+
- [变更日誌标准](../../../../core/changelog-standards.md)
|
|
173
|
+
- [Git 工作流程](../../../../core/git-workflow.md)
|
|
175
174
|
|
|
176
175
|
---
|
|
177
176
|
|
|
@@ -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
|
---
|
|
@@ -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
|
---
|