universal-dev-standards 5.16.0 → 6.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/uds.js +13 -135
- package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +13 -4
- package/bundled/ai/standards/accessibility-standards.ai.yaml +1 -1
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +15 -2
- package/bundled/ai/standards/api-design-standards.ai.yaml +27 -4
- package/bundled/ai/standards/behavior-snapshot.ai.yaml +86 -9
- package/bundled/ai/standards/checkin-standards.ai.yaml +2 -2
- package/bundled/ai/standards/code-review.ai.yaml +2 -2
- package/bundled/ai/standards/context-aware-loading.ai.yaml +3 -3
- package/bundled/ai/standards/data-migration-testing.ai.yaml +79 -3
- package/bundled/ai/standards/deprecation-standards.ai.yaml +10 -2
- package/bundled/ai/standards/developer-memory.ai.yaml +4 -3
- package/bundled/ai/standards/flow-based-testing.ai.yaml +2 -2
- package/bundled/ai/standards/forward-derivation-standards.ai.yaml +26 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +34 -2
- package/bundled/ai/standards/git-worktree.ai.yaml +3 -3
- package/bundled/ai/standards/logging.ai.yaml +97 -3
- package/bundled/ai/standards/mock-boundary.ai.yaml +48 -2
- package/bundled/ai/standards/model-provenance.ai.yaml +297 -0
- package/bundled/ai/standards/model-selection.ai.yaml +11 -2
- package/bundled/ai/standards/observability-standards.ai.yaml +10 -0
- package/bundled/ai/standards/performance-standards.ai.yaml +46 -1
- package/bundled/ai/standards/pii-classification.ai.yaml +15 -1
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +10 -0
- package/bundled/ai/standards/privacy-standards.ai.yaml +2 -2
- package/bundled/ai/standards/project-context-memory.ai.yaml +2 -2
- package/bundled/ai/standards/refactoring-standards.ai.yaml +68 -3
- package/bundled/ai/standards/resource-cost-boundary.ai.yaml +279 -0
- package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +55 -2
- package/bundled/ai/standards/security-testing.ai.yaml +13 -2
- package/bundled/ai/standards/skill-standard-alignment-check.ai.yaml +37 -2
- package/bundled/ai/standards/user-journey-testing.ai.yaml +107 -0
- package/bundled/ai/standards/verification-oracle.ai.yaml +278 -0
- package/bundled/ai/standards/versioning.ai.yaml +32 -38
- package/bundled/core/acceptance-criteria-traceability.md +15 -5
- package/bundled/core/accessibility-standards.md +8 -4
- package/bundled/core/ai-friendly-architecture.md +1 -1
- package/bundled/core/ai-response-navigation.md +31 -3
- package/bundled/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/core/api-design-standards.md +92 -7
- package/bundled/core/audit-trail.md +119 -0
- package/bundled/core/behavior-snapshot.md +94 -7
- package/bundled/core/browser-compatibility-standards.md +15 -2
- package/bundled/core/checkin-standards.md +9 -2
- package/bundled/core/code-review-checklist.md +10 -2
- package/bundled/core/container-image-standards.md +97 -0
- package/bundled/core/context-aware-loading.md +2 -2
- package/bundled/core/cost-budget-test.md +1 -1
- package/bundled/core/cross-flow-regression.md +3 -2
- package/bundled/core/data-contract.md +104 -0
- package/bundled/core/data-migration-testing.md +90 -0
- package/bundled/core/data-pipeline.md +113 -0
- package/bundled/core/deprecation-standards.md +16 -2
- package/bundled/core/developer-memory.md +13 -8
- package/bundled/core/documentation-writing-standards.md +1 -1
- package/bundled/core/error-code-standards.md +4 -3
- package/bundled/core/flaky-test-management.md +1 -1
- package/bundled/core/flow-based-testing.md +3 -3
- package/bundled/core/forward-derivation-standards.md +33 -5
- package/bundled/core/full-coverage-testing.md +72 -0
- package/bundled/core/git-worktree.md +4 -4
- package/bundled/core/guides/performance-guide.md +1 -1
- package/bundled/core/guides/security-guide.md +1 -1
- package/bundled/core/health-check-standards.md +2 -2
- package/bundled/core/iac-design-principles.md +97 -0
- package/bundled/core/incident-response.md +119 -0
- package/bundled/core/license-compliance.md +2 -0
- package/bundled/core/logging-standards.md +78 -2
- package/bundled/core/mock-boundary.md +54 -2
- package/bundled/core/model-provenance.md +181 -0
- package/bundled/core/model-selection.md +27 -2
- package/bundled/core/packaging-standards.md +1 -0
- package/bundled/core/performance-standards.md +96 -2
- package/bundled/core/pii-classification.md +148 -0
- package/bundled/core/pipeline-security-gates.md +22 -2
- package/bundled/core/postmortem-standards.md +2 -0
- package/bundled/core/prd-standards.md +91 -0
- package/bundled/core/privacy-standards.md +14 -3
- package/bundled/core/product-metrics-standards.md +100 -0
- package/bundled/core/project-context-memory.md +8 -2
- package/bundled/core/prompt-regression.md +1 -1
- package/bundled/core/refactoring-standards.md +44 -3
- package/bundled/core/replay-test.md +1 -1
- package/bundled/core/resource-cost-boundary.md +180 -0
- package/bundled/core/reverse-engineering-standards.md +66 -2
- package/bundled/core/runbook.md +113 -0
- package/bundled/core/schema-evolution.md +105 -0
- package/bundled/core/secret-management-standards.md +110 -0
- package/bundled/core/security-testing.md +26 -2
- package/bundled/core/self-review-protocol.md +2 -2
- package/bundled/core/skill-standard-alignment-check.md +53 -0
- package/bundled/core/slo-sli.md +109 -0
- package/bundled/core/smoke-test.md +1 -1
- package/bundled/core/spec-driven-development.md +21 -3
- package/bundled/core/tech-debt-standards.md +1 -1
- package/bundled/core/test-data-standards.md +2 -2
- package/bundled/core/user-journey-testing.md +102 -0
- package/bundled/core/user-story-mapping.md +96 -0
- package/bundled/core/verification-oracle.md +167 -0
- package/bundled/core/versioning.md +133 -109
- package/bundled/locales/COVERAGE.md +84 -73
- package/bundled/locales/zh-CN/CHANGELOG.md +81 -6
- package/bundled/locales/zh-CN/CLAUDE.md +1 -1
- package/bundled/locales/zh-CN/README.md +22 -9
- package/bundled/locales/zh-CN/SECURITY.md +1 -1
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +4 -6
- package/bundled/locales/zh-CN/core/accessibility-standards.md +1 -1
- package/bundled/locales/zh-CN/core/adversarial-test.md +226 -0
- package/bundled/locales/zh-CN/core/agent-behavior-discipline.md +187 -0
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +32 -6
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/locales/zh-CN/core/api-design-standards.md +1 -1
- package/bundled/locales/zh-CN/core/behavior-snapshot.md +335 -0
- package/bundled/locales/zh-CN/core/browser-compatibility-standards.md +229 -0
- package/bundled/locales/zh-CN/core/cd-deployment-strategies.md +135 -0
- package/bundled/locales/zh-CN/core/chaos-injection-tests.md +130 -0
- package/bundled/locales/zh-CN/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-CN/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-CN/core/container-security.md +535 -0
- package/bundled/locales/zh-CN/core/context-aware-loading.md +1 -1
- package/bundled/locales/zh-CN/core/contract-testing-standards.md +191 -0
- package/bundled/locales/zh-CN/core/cost-budget-test.md +86 -0
- package/bundled/locales/zh-CN/core/cross-flow-regression.md +199 -0
- package/bundled/locales/zh-CN/core/data-migration-testing.md +217 -0
- package/bundled/locales/zh-CN/core/deployment-standards.md +328 -9
- package/bundled/locales/zh-CN/core/deprecation-standards.md +1 -1
- package/bundled/locales/zh-CN/core/developer-memory.md +2 -2
- package/bundled/locales/zh-CN/core/disaster-recovery-drill.md +87 -0
- package/bundled/locales/zh-CN/core/documentation-structure.md +1 -1
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-CN/core/error-code-standards.md +2 -2
- package/bundled/locales/zh-CN/core/feature-manifest-standard.md +222 -0
- package/bundled/locales/zh-CN/core/flaky-test-management.md +87 -0
- package/bundled/locales/zh-CN/core/flow-based-testing.md +284 -0
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +3 -4
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +197 -0
- package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
- package/bundled/locales/zh-CN/core/governance-layer.md +160 -0
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +515 -0
- package/bundled/locales/zh-CN/core/guides/security-guide.md +494 -0
- package/bundled/locales/zh-CN/core/knowledge-graph-memory.md +128 -0
- package/bundled/locales/zh-CN/core/license-compliance.md +129 -0
- package/bundled/locales/zh-CN/core/llm-output-validation.md +192 -0
- package/bundled/locales/zh-CN/core/logging-standards.md +130 -8
- package/bundled/locales/zh-CN/core/mock-boundary.md +109 -0
- package/bundled/locales/zh-CN/core/model-selection.md +28 -5
- package/bundled/locales/zh-CN/core/mutation-testing.md +106 -0
- package/bundled/locales/zh-CN/core/no-cicd-deployment.md +219 -0
- package/bundled/locales/zh-CN/core/packaging-standards.md +76 -5
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +126 -0
- package/bundled/locales/zh-CN/core/policy-as-code-testing.md +203 -0
- package/bundled/locales/zh-CN/core/privacy-standards.md +1 -1
- package/bundled/locales/zh-CN/core/project-context-memory.md +1 -1
- package/bundled/locales/zh-CN/core/prompt-regression.md +88 -0
- package/bundled/locales/zh-CN/core/property-based-testing.md +87 -0
- package/bundled/locales/zh-CN/core/release-quality-manifest.md +207 -0
- package/bundled/locales/zh-CN/core/release-readiness-gate.md +193 -0
- package/bundled/locales/zh-CN/core/replay-test.md +102 -0
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +46 -1
- package/bundled/locales/zh-CN/core/rollback-standards.md +120 -0
- package/bundled/locales/zh-CN/core/sast-advanced.md +309 -0
- package/bundled/locales/zh-CN/core/secure-op.md +328 -0
- package/bundled/locales/zh-CN/core/security-testing.md +96 -0
- package/bundled/locales/zh-CN/core/self-review-protocol.md +167 -0
- package/bundled/locales/zh-CN/core/server-ops-security.md +507 -0
- package/bundled/locales/zh-CN/core/smoke-test.md +79 -0
- package/bundled/locales/zh-CN/core/spec-driven-development.md +55 -5
- package/bundled/locales/zh-CN/core/supply-chain-attestation.md +131 -0
- package/bundled/locales/zh-CN/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +31 -6
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +61 -34
- package/bundled/locales/zh-CN/docs/MIGRATION-v6.md +88 -0
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +2 -2
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +14 -14
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +105 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +132 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +144 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +178 -0
- package/bundled/locales/zh-CN/docs/user/README.md +70 -0
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +190 -0
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +1 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +3 -3
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-CN/methodologies/guides/sdd-guide.md +836 -0
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +166 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +140 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +214 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +166 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +167 -0
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +191 -0
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +150 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +131 -0
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +144 -0
- package/bundled/locales/zh-CN/options/project-structure/php.md +168 -0
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +156 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +136 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +165 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +237 -0
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +200 -0
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +144 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +251 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +192 -0
- package/bundled/locales/zh-CN/skills/README.md +89 -126
- package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +5 -7
- package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +263 -0
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +410 -0
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +357 -0
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +410 -0
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +368 -0
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +3 -4
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +1 -2
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +109 -13
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +30 -8
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +50 -0
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +5 -5
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +3 -3
- package/bundled/locales/zh-CN/skills/commands/bdd.md +2 -2
- package/bundled/locales/zh-CN/skills/commands/brainstorm.md +26 -17
- package/bundled/locales/zh-CN/skills/commands/{review.md → code-review.md} +4 -4
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +2 -3
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +2 -2
- package/bundled/locales/zh-CN/skills/commands/methodology.md +4 -4
- package/bundled/locales/zh-CN/skills/commands/pr.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/tdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +456 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/guide.md +6 -6
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +296 -0
- package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +5 -5
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +146 -142
- package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/observability-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +3 -3
- package/bundled/locales/zh-CN/skills/slo-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/guide.md +8 -9
- package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/sweep/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +2298 -0
- package/bundled/locales/zh-CN/skills/workflows/README.md +451 -0
- package/bundled/locales/zh-TW/CHANGELOG.md +81 -6
- package/bundled/locales/zh-TW/CLAUDE.md +1 -1
- package/bundled/locales/zh-TW/MAINTENANCE.md +25 -2
- package/bundled/locales/zh-TW/README.md +22 -9
- package/bundled/locales/zh-TW/SECURITY.md +1 -1
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
- package/bundled/locales/zh-TW/ai/standards/versioning.ai.yaml +8 -48
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +4 -6
- package/bundled/locales/zh-TW/core/accessibility-standards.md +1 -1
- package/bundled/locales/zh-TW/core/adversarial-test.md +226 -0
- package/bundled/locales/zh-TW/core/agent-behavior-discipline.md +187 -0
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +32 -6
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +91 -9
- package/bundled/locales/zh-TW/core/audit-trail.md +110 -0
- package/bundled/locales/zh-TW/core/behavior-snapshot.md +335 -0
- package/bundled/locales/zh-TW/core/browser-compatibility-standards.md +1 -0
- package/bundled/locales/zh-TW/core/cd-deployment-strategies.md +135 -0
- package/bundled/locales/zh-TW/core/chaos-injection-tests.md +130 -0
- package/bundled/locales/zh-TW/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-TW/core/container-image-standards.md +93 -0
- package/bundled/locales/zh-TW/core/container-security.md +535 -0
- package/bundled/locales/zh-TW/core/cost-budget-test.md +86 -0
- package/bundled/locales/zh-TW/core/cross-flow-regression.md +1 -0
- package/bundled/locales/zh-TW/core/data-contract.md +101 -0
- package/bundled/locales/zh-TW/core/data-migration-testing.md +217 -0
- package/bundled/locales/zh-TW/core/data-pipeline.md +105 -0
- package/bundled/locales/zh-TW/core/deployment-standards.md +363 -25
- package/bundled/locales/zh-TW/core/deprecation-standards.md +17 -4
- package/bundled/locales/zh-TW/core/developer-memory.md +2 -2
- package/bundled/locales/zh-TW/core/disaster-recovery-drill.md +87 -0
- package/bundled/locales/zh-TW/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-TW/core/error-code-standards.md +2 -2
- package/bundled/locales/zh-TW/core/feature-manifest-standard.md +222 -0
- package/bundled/locales/zh-TW/core/flaky-test-management.md +87 -0
- package/bundled/locales/zh-TW/core/flow-based-testing.md +284 -0
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +3 -4
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +250 -0
- package/bundled/locales/zh-TW/core/git-worktree.md +1 -1
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +515 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +494 -0
- package/bundled/locales/zh-TW/core/iac-design-principles.md +90 -0
- package/bundled/locales/zh-TW/core/incident-response.md +111 -0
- package/bundled/locales/zh-TW/core/license-compliance.md +129 -0
- package/bundled/locales/zh-TW/core/llm-output-validation.md +192 -0
- package/bundled/locales/zh-TW/core/logging-standards.md +208 -4
- package/bundled/locales/zh-TW/core/mock-boundary.md +161 -0
- package/bundled/locales/zh-TW/core/model-provenance.md +173 -0
- package/bundled/locales/zh-TW/core/model-selection.md +28 -5
- package/bundled/locales/zh-TW/core/mutation-testing.md +106 -0
- package/bundled/locales/zh-TW/core/no-cicd-deployment.md +219 -0
- package/bundled/locales/zh-TW/core/packaging-standards.md +76 -5
- package/bundled/locales/zh-TW/core/performance-standards.md +84 -5
- package/bundled/locales/zh-TW/core/pii-classification.md +102 -0
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +126 -0
- package/bundled/locales/zh-TW/core/policy-as-code-testing.md +203 -0
- package/bundled/locales/zh-TW/core/prd-standards.md +88 -0
- package/bundled/locales/zh-TW/core/privacy-standards.md +1 -1
- package/bundled/locales/zh-TW/core/product-metrics-standards.md +96 -0
- package/bundled/locales/zh-TW/core/project-context-memory.md +1 -1
- package/bundled/locales/zh-TW/core/prompt-regression.md +88 -0
- package/bundled/locales/zh-TW/core/property-based-testing.md +87 -0
- package/bundled/locales/zh-TW/core/refactoring-standards.md +43 -6
- package/bundled/locales/zh-TW/core/release-quality-manifest.md +207 -0
- package/bundled/locales/zh-TW/core/replay-test.md +102 -0
- package/bundled/locales/zh-TW/core/resource-cost-boundary.md +175 -0
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +64 -5
- package/bundled/locales/zh-TW/core/rollback-standards.md +120 -0
- package/bundled/locales/zh-TW/core/runbook.md +110 -0
- package/bundled/locales/zh-TW/core/sast-advanced.md +309 -0
- package/bundled/locales/zh-TW/core/schema-evolution.md +98 -0
- package/bundled/locales/zh-TW/core/secret-management-standards.md +101 -0
- package/bundled/locales/zh-TW/core/secure-op.md +328 -0
- package/bundled/locales/zh-TW/core/security-testing.md +96 -0
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -2
- package/bundled/locales/zh-TW/core/server-ops-security.md +507 -0
- package/bundled/locales/zh-TW/core/slo-sli.md +108 -0
- package/bundled/locales/zh-TW/core/smoke-test.md +79 -0
- package/bundled/locales/zh-TW/core/spec-driven-development.md +39 -13
- package/bundled/locales/zh-TW/core/supply-chain-attestation.md +131 -0
- package/bundled/locales/zh-TW/core/user-journey-testing.md +111 -0
- package/bundled/locales/zh-TW/core/user-story-mapping.md +94 -0
- package/bundled/locales/zh-TW/core/verification-oracle.md +159 -0
- package/bundled/locales/zh-TW/core/versioning.md +112 -112
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +31 -6
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +6 -6
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +61 -34
- package/bundled/locales/zh-TW/docs/MIGRATION-v6.md +88 -0
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -2
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +14 -14
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +105 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +132 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +144 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +178 -0
- package/bundled/locales/zh-TW/docs/user/README.md +70 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +190 -0
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +1 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +3 -3
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +523 -26
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +166 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +140 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +214 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +166 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +167 -0
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +191 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +150 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +131 -0
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +144 -0
- package/bundled/locales/zh-TW/options/project-structure/php.md +168 -0
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +156 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +136 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +165 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +237 -0
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +200 -0
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +144 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +251 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +192 -0
- package/bundled/locales/zh-TW/skills/README.md +91 -128
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +4 -6
- package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +263 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +410 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +357 -0
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +410 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +368 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +3 -4
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +1 -2
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +110 -14
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +31 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +50 -0
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +7 -5
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/atdd.md +3 -3
- package/bundled/locales/zh-TW/skills/commands/bdd.md +2 -2
- package/bundled/locales/zh-TW/skills/commands/brainstorm.md +26 -17
- package/bundled/locales/zh-TW/skills/commands/{review.md → code-review.md} +5 -5
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +2 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +2 -2
- package/bundled/locales/zh-TW/skills/commands/methodology.md +4 -4
- package/bundled/locales/zh-TW/skills/commands/pr.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/tdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +456 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/guide.md +5 -5
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +296 -0
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +5 -5
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +29 -27
- package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +2 -2
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/guide.md +7 -8
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +2298 -0
- package/bundled/locales/zh-TW/skills/workflows/README.md +451 -0
- package/bundled/skills/README.md +1 -1
- package/bundled/skills/ac-coverage/SKILL.md +17 -7
- package/bundled/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/skills/agents/code-architect.md +1 -1
- package/bundled/skills/agents/doc-writer.md +1 -1
- package/bundled/skills/agents/reviewer.md +2 -2
- package/bundled/skills/agents/spec-analyst.md +1 -1
- package/bundled/skills/agents/test-specialist.md +1 -1
- package/bundled/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/skills/atdd-assistant/SKILL.md +7 -0
- package/bundled/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/skills/atdd-assistant/atdd-workflow.md +6 -8
- package/bundled/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/skills/bdd-assistant/SKILL.md +7 -0
- package/bundled/skills/bdd-assistant/guide.md +1 -2
- package/bundled/skills/brainstorm-assistant/SKILL.md +133 -11
- package/bundled/skills/brainstorm-assistant/guide.md +33 -5
- package/bundled/skills/checkin-assistant/SKILL.md +8 -1
- package/bundled/skills/ci-cd-assistant/SKILL.md +57 -0
- package/bundled/skills/code-review-assistant/SKILL.md +15 -8
- package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +2 -2
- package/bundled/skills/commands/COMMAND-INDEX.json +3 -3
- package/bundled/skills/commands/README.md +2 -2
- package/bundled/skills/commands/ac-coverage.md +1 -1
- package/bundled/skills/commands/atdd.md +2 -2
- package/bundled/skills/commands/bdd.md +2 -2
- package/bundled/skills/commands/brainstorm.md +25 -14
- package/bundled/skills/commands/{review.md → code-review.md} +6 -6
- package/bundled/skills/commands/derive-all.md +1 -1
- package/bundled/skills/commands/derive-atdd.md +1 -1
- package/bundled/skills/commands/derive-bdd.md +2 -3
- package/bundled/skills/commands/derive-tdd.md +1 -1
- package/bundled/skills/commands/derive.md +1 -1
- package/bundled/skills/commands/dev-workflow.md +1 -1
- package/bundled/skills/commands/journey-test.md +45 -0
- package/bundled/skills/commands/methodology.md +4 -4
- package/bundled/skills/commands/pr.md +1 -1
- package/bundled/skills/commands/skill-builder.md +42 -0
- package/bundled/skills/commands/tdd.md +1 -1
- package/bundled/skills/dev-methodology/create-methodology.md +1 -1
- package/bundled/skills/dev-methodology/guide.md +1 -1
- package/bundled/skills/dev-methodology/runtime.md +1 -1
- package/bundled/skills/dev-workflow-guide/SKILL.md +3 -3
- package/bundled/skills/dev-workflow-guide/workflow-phases.md +3 -3
- package/bundled/skills/docs-generator/SKILL.md +3 -3
- package/bundled/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/skills/logging-guide/SKILL.md +38 -2
- package/bundled/skills/migration-assistant/SKILL.md +226 -0
- package/bundled/skills/observability-assistant/SKILL.md +74 -0
- package/bundled/skills/pr-automation-assistant/SKILL.md +5 -1
- package/bundled/skills/project-discovery/guide.md +2 -2
- package/bundled/skills/push/SKILL.md +1 -1
- package/bundled/skills/release-standards/SKILL.md +19 -5
- package/bundled/skills/security-assistant/SKILL.md +1 -1
- package/bundled/skills/skill-builder/SKILL.md +1 -1
- package/bundled/skills/spec-derivation/guide.md +3 -4
- package/bundled/skills/spec-driven-dev/SKILL.md +27 -0
- package/bundled/skills/sweep/SKILL.md +1 -1
- package/bundled/skills/tdd-assistant/SKILL.md +8 -1
- package/bundled/skills/testing-guide/SKILL.md +1 -1
- package/bundled/skills/testing-guide/testing-theory.md +1 -1
- package/bundled/skills/workflows/README.md +2 -2
- package/package.json +3 -3
- package/src/commands/audit.js +30 -9
- package/src/commands/config.js +33 -2
- package/src/commands/hitl.js +14 -1
- package/src/commands/init.js +110 -58
- package/src/commands/quickstart.js +1 -2
- package/src/commands/release.js +51 -6
- package/src/commands/run-intent.js +9 -0
- package/src/commands/spec-split.js +27 -2
- package/src/commands/update.js +22 -6
- package/src/config/ai-agent-paths.js +3 -1
- package/src/i18n/messages.js +3 -102
- package/src/missions/MissionManager.js +44 -12
- package/src/utils/build-manifest.js +35 -3
- package/src/utils/friction-detector.js +71 -22
- package/src/utils/health-checker.js +29 -2
- package/src/utils/transaction.js +111 -0
- package/src/utils/version-promote.js +16 -0
- package/standards-registry.json +58 -146
- package/bundled/ai/standards/agent-communication-protocol.ai.yaml +0 -42
- package/bundled/ai/standards/agent-dispatch.ai.yaml +0 -42
- package/bundled/ai/standards/branch-completion.ai.yaml +0 -44
- package/bundled/ai/standards/change-batching-standards.ai.yaml +0 -44
- package/bundled/ai/standards/execution-history.ai.yaml +0 -42
- package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +0 -42
- package/bundled/ai/standards/workflow-enforcement.ai.yaml +0 -44
- package/bundled/ai/standards/workflow-state-protocol.ai.yaml +0 -43
- package/src/commands/flow.js +0 -260
- package/src/commands/start.js +0 -372
- package/src/commands/sweep.js +0 -151
- package/src/commands/workflow.js +0 -681
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: brainstorm-assistant
|
|
3
3
|
source: ../../../../skills/brainstorm-assistant/SKILL.md
|
|
4
|
-
source_version:
|
|
4
|
+
source_version: 4.0.0
|
|
5
5
|
source_hash: 25e622a7d063
|
|
6
|
-
translation_version:
|
|
7
|
-
last_synced: 2026-06-
|
|
6
|
+
translation_version: 4.0.0
|
|
7
|
+
last_synced: 2026-06-22
|
|
8
8
|
status: current
|
|
9
9
|
description: |
|
|
10
10
|
在编写规格前进行结构化 AI 辅助头脑风暴。
|
|
@@ -18,11 +18,13 @@ description: |
|
|
|
18
18
|
|
|
19
19
|
在编写规格前进行结构化发想。以 2024–2026 年 AI 辅助发想研究为基础,通过引导式头脑风暴,将模糊构想转化为可执行的功能提案。
|
|
20
20
|
|
|
21
|
-
> **实现**: XSPEC-
|
|
22
|
-
>
|
|
21
|
+
> **实现**: XSPEC-296 头脑风暴质量标准(BQS v1)—— brainstorm v4,叠加于
|
|
22
|
+
> XSPEC-247 brainstorm v3(Multi-Persona Ensemble + Multi-Critic Convergence)。
|
|
23
23
|
|
|
24
24
|
**v3 的核心改动:** v3 把发散从「单一 AI 冲数量」改为 **persona 集成**(每个角色以思维链独立推理)×**多样性透镜**;把收敛从「单一 AI 评分 + 单一反驳」改为**多评审面板** + **硬角色反驳**(Devil's Advocate + Steelman)。这直接对应文献中最强的结论:多 persona 胜过单次 pass,而单一 LLM 评审既弱又易谄媚。
|
|
25
25
|
|
|
26
|
+
**v4 的核心改动:** v3 提供了强健的*机制*,却没有可判定 pass/fail 的质量闸。v4 在其上叠加一道**时序化质量契约**——**头脑风暴质量标准(BQS v1)**——且不移除任何 v3 行为。BQS 是**四层 × 时间轴**结构:第 0 层宣告 explore/exploit 配比;第 1 层(过程、leading、发散期全程可见)跑维度 **D1–D4**;第 2 层(产物、leading、收敛后仅施于 Top 3)跑 **D5–D8** 加 Seeds 栏与争议区;第 3 层是不受治理的 **Judgment Override**。第一原理:**决策用 leading 信号、校准用 lagging 信号——两者是时间前后,而非对错取舍。** 硬序列闸禁止 D5–D8 在发散期被揭示或评分。详见下方「BQS v1 — 质量契约」。
|
|
27
|
+
|
|
26
28
|
## 使用前先选模式
|
|
27
29
|
|
|
28
30
|
使用前套用以下**客观触发条件**。默认为完整 v3,路由规则是跳过阶段的快捷方式,而非额外障碍。
|
|
@@ -43,10 +45,69 @@ description: |
|
|
|
43
45
|
```
|
|
44
46
|
[模式选择] ─► PRE-FLIGHT ─► FRAME ─► DIVERGE ───────────► CONVERGE ──────────► OUTPUT
|
|
45
47
|
客观路由 防止锚定 定义问题 persona 集成+透镜 多评审面板+硬角色反驳 输出提案
|
|
48
|
+
▲ 第 0 层 意图 ▲ 第 1 层(D1–D4,leading) ▲ 第 2 层(D5–D8,Top 3) ▲ 第 3 层 override
|
|
46
49
|
```
|
|
47
50
|
|
|
48
51
|
---
|
|
49
52
|
|
|
53
|
+
## BQS v1 — 质量契约
|
|
54
|
+
|
|
55
|
+
> **第一原理:** 头脑风暴的产物是**假说,不是答案**。一个点子好不好在发想当下不可知,所以质量只能用 **leading** 信号(过程+认识论完整性)判;标准的正当性靠 **lagging** 信号(事后结果)**校准**。决策用 leading、校准用 lagging,两者是**时间**前后,不是对错取舍。(此处修正任何「只用 leading 不用 lagging」的绝对说法。)
|
|
56
|
+
|
|
57
|
+
BQS 是**四层 × 时间轴**契约。它是 v3 的**叠加**——所有 v3 旗标与机制都保留(见「向后兼容」)。
|
|
58
|
+
|
|
59
|
+
### 第 0 层 — 意图(开场宣告)
|
|
60
|
+
|
|
61
|
+
开场宣告本次 **explore/exploit 配比** 与赌注类型(渐进 vs barbell 长尾)。此层**调节维度权重**:偏 exploit 的工作阶段,**D2(发散覆盖)低分是正确的、不扣分**。
|
|
62
|
+
|
|
63
|
+
### 第 1 层 — 过程(发散期 leading,全程可见)
|
|
64
|
+
|
|
65
|
+
| 维度 | Oracle(怎么判 fail)|
|
|
66
|
+
|------|----------------------|
|
|
67
|
+
| **D1 框架纯度** | 问题内嵌特定方案或「像 X 给 Y」→fail;须 5-Whys 到根因 |
|
|
68
|
+
| **D2 发散覆盖** | 存活想法跨 <3 独立 persona/透镜→fail(受第 0 层权重调节);连一轮零新增才算饱和 |
|
|
69
|
+
| **D3 跨会话多样性** | 种子是竞品类比→fail;Top 全来自单一 lens→fail |
|
|
70
|
+
| **D4 评估去偏** | 须 ≥3 评审 + 硬角色 Devil's Advocate + Steelman;**pass 须在独立 context 执行**,否则标 `[degraded]` 不得标 pass |
|
|
71
|
+
|
|
72
|
+
> **硬序列闸:** D5–D8 禁止在发散期揭示或评分;CONVERGE 的 critic 不得在**最后一个 persona** 产完前被调用。
|
|
73
|
+
|
|
74
|
+
### 第 2 层 — 产物(收敛后 leading,仅施于 Top 3)
|
|
75
|
+
|
|
76
|
+
> 评判维度限缩在**收敛后 × 仅 Top 3**,绝不在发散期对全部想法当硬闸(否则回溯污染发散、扼杀无证据的未来想法、制造填表剧场)。
|
|
77
|
+
|
|
78
|
+
| 维度 | Oracle |
|
|
79
|
+
|------|--------|
|
|
80
|
+
| **D5 接地** | 「现状/外部事实」主张无 file:line/来源→fail;「未来/假说」免接地、标 `[假说]`。**外部事实宣称为跨级地板**(creative 级亦适用)|
|
|
81
|
+
| **D6 净值** | 入选想法未答「解谁问题/我们真有吗/不做的代价」→fail;至少一个「不值得做」淘汰。**挂 lagging 登记栏**:此判断事后拿什么信号验证? |
|
|
82
|
+
| **D7 可证伪** | 二态:`[现可陈述证伪]` 或 `[需先做 X 才能定义证伪]`;后者**转 next-step 喂 D8,不算 fail** |
|
|
83
|
+
| **D8 可行动** | 无 next-step 裁决(含「暂不做」)→fail |
|
|
84
|
+
| **+Seeds 栏** | 杀想法时强制存「错在哪、指向什么真问题」;被杀 ≥1 则 Seeds ≥1(只检查非空)|
|
|
85
|
+
| **+争议区** | critic 方差 > 阈值的想法分流呈现,不按 mean 排序淘汰(守 barbell 长尾)|
|
|
86
|
+
|
|
87
|
+
### 第 3 层 — 不可治理区(Judgment Override)
|
|
88
|
+
|
|
89
|
+
明文留一块 oracle 不进入的地:人类直觉「保留/毙掉」附一句理由即可,**凌驾聚合分数、不需过任何维度**。承认标准不完备,避免「为过维度而 brainstorm」。
|
|
90
|
+
|
|
91
|
+
### 结构规则
|
|
92
|
+
|
|
93
|
+
1. **Meta 停止规则:** 该层维度全绿 **且** 再跑一轮后 **Top 3 集合成员不变**(看集合成员、不看内部排序)→停。**硬上限 2 轮**。取代模糊的「不翻决策」。
|
|
94
|
+
2. **判官≠产生者:** D2/D4/D5/D7 判定须独立视角;单 context 自评只能 `[degraded]`,不得 pass。
|
|
95
|
+
3. **校准回路(吃 lagging):** v3 的三个工作阶段自评指标收编为此回路 **lagging** 端——**Adoption Rate=D6 滞后验证、Diversity=D2/D3 滞后观测、Cognitive Load=成本约束**;**禁两套平行评估**。
|
|
96
|
+
4. **BQS 自我演化(轻量):** 版本化 + 证据清单 last-reviewed 逾期 flag;「定期对 BQS 自身 brainstorm」列可选。
|
|
97
|
+
5. **最小充分原则:** 套用该 tier 所需的最少维度 + Top-3 限缩——认知经济性的守门,不另设成本维度。
|
|
98
|
+
|
|
99
|
+
### 分级(绑 v3 既有客观触发,非自评)
|
|
100
|
+
|
|
101
|
+
| Tier(来自模式选择触发)| 套用维度 |
|
|
102
|
+
|--------------------------|----------|
|
|
103
|
+
| creative / `--quick` | D1–D3 + D5 外部事实地板 |
|
|
104
|
+
| default | D1–D5 + D8 |
|
|
105
|
+
| strategic / architecture / business | 全层 |
|
|
106
|
+
|
|
107
|
+
> 分级由**客观模式选择触发表**(字数、旗标、是否有规格)决定,而非发起者自评。
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
50
111
|
### 阶段 0:PRE-FLIGHT | 防止 AI 锚定
|
|
51
112
|
|
|
52
113
|
**本阶段存在的原因:** 在 AI 生成任何内容**之前**先写下自己的想法,能持续产出更多样的结果。在 AI 情境下这**更**重要,而非更不重要:设计固着研究显示,流畅、高保真的 AI 输出反而**加深**固着,而非缓解(Wadinambiarachchi 等,CHI 2024)。
|
|
@@ -63,6 +124,8 @@ description: |
|
|
|
63
124
|
|
|
64
125
|
> **反种子 guardrail(v3 新增):** 不要接受或生成「像 X 但给 Y」的框架当种子(如「给医生用的 Slack」)。这类产品类比种子会把 LLM 锁进单一解空间、明显降低想法多样性。请捕捉底层**问题**,而非产品类比。
|
|
65
126
|
|
|
127
|
+
> **BQS 第 0 层 — 意图宣告(v4 新增):** 在 FRAME 之前,宣告本次的 **explore/exploit 配比** 与赌注类型(渐进 vs barbell 长尾)。此宣告下游调节 D2 权重——偏 exploit 时低发散覆盖是正确的、不扣分。未宣告时默认:偏 explore。
|
|
128
|
+
|
|
66
129
|
**旗标:** `--skip-preflight` 跳过本阶段并显示一行警告:
|
|
67
130
|
`⚠ Skipping Pre-flight may cause AI anchoring`
|
|
68
131
|
|
|
@@ -115,6 +178,8 @@ description: |
|
|
|
115
178
|
|
|
116
179
|
「好点子出现在后半段」(Nijstad)是**人类群体**现象,**未在 LLM 上得到证实**(LLM 多为达到高原 / 枯竭)。因此固定数量门槛降为**辅助提示**:若全组少于约 8 个相异想法,提示「继续——加一个还没用过的 persona 或透镜」。真正的门槛是**多样性**(覆盖了几个不同视角),而非数量。
|
|
117
180
|
|
|
181
|
+
> **此处生效 BQS 第 1 层(D1–D4,leading,全程可见):** 发散期只对 **D1(框架纯度)、D2(发散覆盖,依第 0 层加权)、D3(跨会话多样性)、D4(评估去偏)** 评分与呈现。**硬序列闸:** 评判维度 **D5–D8 在最后一个 persona 产完前不得揭示或评分**——CONVERGE 的 critic 在发散完成前不被调用。
|
|
182
|
+
|
|
118
183
|
#### 经典技法(仍保留)
|
|
119
184
|
|
|
120
185
|
| 技法 | 使用时机 |
|
|
@@ -159,6 +224,19 @@ description: |
|
|
|
159
224
|
|
|
160
225
|
**旗标:** `--no-rebuttal` 跳过此步骤;报告区段标注「Rebuttal: skipped」。
|
|
161
226
|
|
|
227
|
+
> **BQS D4 — 判官≠产生者:** D4 唯有**评审/Devil's Advocate 在独立 context 执行**(`--enhanced` 隔离 agent 宿主)才可 pass。baseline 单 context 下,面板是同 context 自评,标 `[degraded]`、**不得标 pass**——诚实但非独立。不得把 baseline 跑当成 D4 pass 静默通过。
|
|
228
|
+
|
|
229
|
+
#### 步骤 3c:BQS 第 2 层——对 Top 3 的产物闸
|
|
230
|
+
|
|
231
|
+
收敛后,**仅对 Top 3** 套用 **D5–D8**(绝不对全部发散想法)。对每个 Top-3 想法:
|
|
232
|
+
|
|
233
|
+
- **D5 接地:** 将每个主张分流为 `[现状/外部事实]`(需 file:line 或来源,否则 fail)vs `[未来/假说]`(免接地、标 `[假说]`)。**外部事实宣称为跨级地板**——creative 级也须接地。
|
|
234
|
+
- **D6 净值:** 每个 Top-3 须答「解谁问题/我们真有吗/不做的代价」;至少一个淘汰为「不值得做」;挂 **lagging 登记栏**(事后哪个信号验证)。
|
|
235
|
+
- **D7 可证伪(二态):** 标 `[现可陈述证伪]` **或** `[需先做 X 才能定义证伪]`。后者**转 next-step 喂 D8——不算 fail**。
|
|
236
|
+
- **D8 可行动:** 每个存活想法需 next-step 裁决(含明确「暂不做」);无 → fail。
|
|
237
|
+
|
|
238
|
+
> **Meta 停止规则(BQS 结构规则 1):** 当套用的维度全绿 **且** 再跑一轮后 **Top 3 集合成员不变**(看集合成员、非内部排序)→停。**硬上限 2 轮。**
|
|
239
|
+
|
|
162
240
|
---
|
|
163
241
|
|
|
164
242
|
### 阶段 4:OUTPUT | 输出提案
|
|
@@ -181,8 +259,21 @@ description: |
|
|
|
181
259
|
|---|------|---------|------|-------------|---------------|--------------|-----------|
|
|
182
260
|
| 1 | ... | Skeptic | Reversal | 4.0 | 4.5 | 4.0 | 4.2 |
|
|
183
261
|
|
|
184
|
-
## Top 3 Recommendations
|
|
262
|
+
## Top 3 Recommendations (BQS Layer 2 applied)
|
|
185
263
|
1. **[Idea]** ✓ Passed rebuttal — [Why] — Persona: [..] — [User rebuttal response]
|
|
264
|
+
- D5 grounding: [current-state claims with file:line | future claims marked [hypothesis]]
|
|
265
|
+
- D6 net benefit: [whose problem / do we have it / cost of not doing] — lagging signal: [..]
|
|
266
|
+
- D7 falsifiability: [falsifiable now | need to do X first → next-step]
|
|
267
|
+
- D8 next-step: [action | defer]
|
|
268
|
+
|
|
269
|
+
## Contested Zone (high critic-variance ideas)
|
|
270
|
+
[Ideas whose critic variance exceeded threshold — surfaced, NOT eliminated by mean ranking (barbell long-tail)]
|
|
271
|
+
|
|
272
|
+
## Seeds (from killed ideas)
|
|
273
|
+
[For each killed idea: what was wrong, what real problem it points to. Non-empty if ≥1 idea was killed.]
|
|
274
|
+
|
|
275
|
+
## Judgment Override (Layer 3, ungoverned)
|
|
276
|
+
[Human keep/kill decisions that override the aggregate score, each with a one-line reason. Optional.]
|
|
186
277
|
|
|
187
278
|
## Diversity Note
|
|
188
279
|
[How many distinct lenses/personas the surviving ideas span — flag if all from one cluster]
|
|
@@ -195,6 +286,8 @@ description: |
|
|
|
195
286
|
- [ ] Proceed to `/sdd` if requirements are clear
|
|
196
287
|
```
|
|
197
288
|
|
|
289
|
+
> **BQS 输出新增(v4):** **Seeds** 区(规则:被杀 ≥1 则非空)、**争议区**(高方差想法不按 mean 淘汰)、**Judgment Override** 通道(人类裁决凌驾聚合分)为 BQS 第 2/3 层所要求。Top-3 区块逐项记录 D5–D8 状态。
|
|
290
|
+
|
|
198
291
|
## 多样性崩塌防护
|
|
199
292
|
|
|
200
293
|
使用单一 LLM 发想会降低**跨用户的想法多样性**,即使每个个体都觉得自己更有创意(Anderson、Shah、Kreminski,2024;与广为引用的 Doshi & Hauser,《Science Advances》2024 同向)。防范方式:
|
|
@@ -221,15 +314,17 @@ description: |
|
|
|
221
314
|
| **Devil's Advocate + Steelman** | 硬角色反驳 |
|
|
222
315
|
| **SCAMPER / 六顶帽** | 经典发散(可当 persona) |
|
|
223
316
|
|
|
224
|
-
##
|
|
317
|
+
## 校准回路——lagging 信号(BQS)
|
|
225
318
|
|
|
226
|
-
|
|
319
|
+
> **这是同一道 BQS 质量回路的 lagging 端——不是第二套平行评估系统。** 工作阶段中由 BQS 第 0–2 层做 leading 决策;这三个指标事后校准标准。禁止在 BQS 之外另跑一套自评。
|
|
227
320
|
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
|
231
|
-
|
|
232
|
-
|
|
|
321
|
+
每次工作阶段结束后记录三个指标(1–5 分),各自对应一个 BQS 维度作为其滞后验证:
|
|
322
|
+
|
|
323
|
+
| 指标 | 问题 | BQS 滞后角色 |
|
|
324
|
+
|------|------|--------------|
|
|
325
|
+
| **采用率** | 今天的想法我实际会用多少个? | **D6 净值滞后验证** |
|
|
326
|
+
| **多样性** | 存活的想法是否跨越多个 persona/透镜? | **D2/D3 滞后观测** |
|
|
327
|
+
| **认知负担** | 这次有多耗费心力?(5 = 毫不费力) | **成本约束** |
|
|
233
328
|
|
|
234
329
|
收集 3 次工作阶段的数据再下结论。完整的 A/B 实验协议见 [guide.md](./guide.md)。
|
|
235
330
|
|
|
@@ -237,6 +332,7 @@ description: |
|
|
|
237
332
|
|
|
238
333
|
| 旗标 | 效果 |
|
|
239
334
|
|------|------|
|
|
335
|
+
| `--intent explore\|exploit\|<比例>` | 宣告 BQS 第 0 层 explore/exploit 意图(调节 D2 权重) |
|
|
240
336
|
| `--personas "a,b,c"` | 覆写默认的 persona 组 |
|
|
241
337
|
| `--lens analogical\|reversal\|morphological` | 强制指定主要的多样性透镜 |
|
|
242
338
|
| `--enhanced` | 并行 persona/评审代理(不支持则退回) |
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
scope: universal
|
|
3
3
|
source: ../../../../skills/brainstorm-assistant/guide.md
|
|
4
|
-
source_version:
|
|
4
|
+
source_version: 4.0.0
|
|
5
5
|
source_hash: 24f4fe4819a4
|
|
6
|
-
translation_version:
|
|
7
|
-
last_synced: 2026-06-
|
|
6
|
+
translation_version: 4.0.0
|
|
7
|
+
last_synced: 2026-06-22
|
|
8
8
|
status: current
|
|
9
9
|
description: |
|
|
10
10
|
指导在编写规格前进行结构化 AI 辅助头脑风暴。
|
|
@@ -16,8 +16,8 @@ description: |
|
|
|
16
16
|
|
|
17
17
|
> **语言**: [English](../../../../skills/brainstorm-assistant/guide.md) | 简体中文
|
|
18
18
|
|
|
19
|
-
**版本**:
|
|
20
|
-
**最后更新**: 2026-06-
|
|
19
|
+
**版本**: 4.0.0
|
|
20
|
+
**最后更新**: 2026-06-22
|
|
21
21
|
**适用范围**: 所有软件项目
|
|
22
22
|
**Scope**: universal
|
|
23
23
|
**类型**: 工具型 Skill(无对应核心标准)
|
|
@@ -49,6 +49,17 @@ v1 是通用的 FRAME→DIVERGE→CONVERGE 流程。v2 加入了认知科学闸
|
|
|
49
49
|
|
|
50
50
|
飞行前阶段被**保留并强化**(固着研究表明 AI 锚定真实存在,甚至可能更糟),而 10 个想法闸门和单一 AI 反驳被**降级 / 硬化**,因为它们原本基于人类群体的证据无法干净地迁移到单一 LLM。
|
|
51
51
|
|
|
52
|
+
### v4 的变更(BQS v1)
|
|
53
|
+
|
|
54
|
+
v3 提供了强健的*机制*,却没有**可判定 pass/fail 的质量闸**——它唯一接近的工作阶段自评是事后、自评、不卡关的。**v4 在 v3 上叠加头脑风暴质量标准(BQS v1),且不移除任何东西**(见「向后兼容」)。BQS 是**四层 × 时间轴**质量契约:
|
|
55
|
+
|
|
56
|
+
- **第 0 层 — 意图**:宣告 explore/exploit 配比;调节维度权重。
|
|
57
|
+
- **第 1 层 — 过程(发散期 leading、可见)**:维度 **D1 框架纯度/D2 发散覆盖/D3 跨会话多样性/D4 评估去偏**,各有 oracle。**硬序列闸**禁止评判维度 D5–D8 在发散期被揭示或评分。
|
|
58
|
+
- **第 2 层 — 产物(收敛后 leading、仅 Top 3)**:**D5 接地/D6 净值/D7 可证伪/D8 可行动**,加 Seeds 栏与高方差想法的争议区。
|
|
59
|
+
- **第 3 层 — 不可治理**:Judgment Override,人类直觉凌驾聚合分数。
|
|
60
|
+
|
|
61
|
+
第一原理被修正:**决策用 leading 信号、校准用 lagging 信号——两者是时间前后,而非对错取舍**(移除任何「只用 leading 不用 lagging」绝对说法)。核心主张:评判维度限缩在**收敛后 × 仅 Top 3**,绝不在发散期对全部想法当硬闸——否则回溯污染发散、扼杀无证据的未来想法、制造填表剧场。完整契约、oracle 与结构规则见 **SKILL.md →「BQS v1 — 质量契约」**。
|
|
62
|
+
|
|
52
63
|
---
|
|
53
64
|
|
|
54
65
|
## Research Foundations | 认知科学依据
|
|
@@ -405,11 +416,11 @@ SKILL.md 中的模式选择表使用客观触发条件(字数、是否带旗
|
|
|
405
416
|
|
|
406
417
|
---
|
|
407
418
|
|
|
408
|
-
##
|
|
419
|
+
## 校准回路(BQS lagging 端)| Calibration Loop
|
|
409
420
|
|
|
410
|
-
|
|
421
|
+
> **v4 中这三个指标是同一道 BQS 质量回路的 lagging 端,不是第二套平行评估系统。** 工作阶段中由 BQS 第 0–2 层做 leading pass/fail 决策;这些指标事后校准标准。**采用率=D6 净值滞后验证、多样性=D2/D3 滞后观测、认知负担=成本约束。** 禁止在 BQS 之外另跑一套自评。
|
|
411
422
|
|
|
412
|
-
|
|
423
|
+
每次工作阶段后记录三个指标,建立实证记录。不要以单次评估跨版本,至少收集 3 次可比较的工作阶段。
|
|
413
424
|
|
|
414
425
|
### 三个指标
|
|
415
426
|
|
|
@@ -547,6 +558,16 @@ Nemeth 的效应是关于*有利害关系的人之间的真实异议*。AI 按
|
|
|
547
558
|
|
|
548
559
|
---
|
|
549
560
|
|
|
561
|
+
## 向后兼容(v3 → v4)| Backward Compatibility
|
|
562
|
+
|
|
563
|
+
BQS v1 是**叠加的质量契约**,不是推倒重来。v3 的一切都保留:
|
|
564
|
+
|
|
565
|
+
- **所有旗标**:`--personas`、`--lens`、`--enhanced`、`--skip-preflight`、`--no-rebuttal`、`--quick`、`--technique` 行为与 v3 完全相同。v4 仅新增一个可选旗标 `--intent`,供第 0 层宣告。
|
|
566
|
+
- **所有机制**:PRE-FLIGHT 防锚定、FRAME 5-Whys/HMW、persona 集成、多样性透镜、多评审面板、硬角色反驳(Devil's Advocate + Steelman)、多样性坍缩护栏、Enhanced 层,皆不变。
|
|
567
|
+
- **`--enhanced` 隔离 agent 宿主**正是让 BQS **D4 pass**(判官≠产生者)的条件;baseline 单 context 标 `[degraded]`、不静默通过。
|
|
568
|
+
|
|
569
|
+
---
|
|
570
|
+
|
|
550
571
|
## 与 UDS 工作流的整合
|
|
551
572
|
|
|
552
573
|
### 映射到 `/requirement`
|
|
@@ -585,6 +606,7 @@ Nemeth 的效应是关于*有利害关系的人之间的真实异议*。AI 按
|
|
|
585
606
|
|
|
586
607
|
| 版本 | 日期 | 变更 |
|
|
587
608
|
|------|------|------|
|
|
609
|
+
| 4.0.0 | 2026-06-22 | XSPEC-296:头脑风暴质量标准(BQS v1)——叠加于 v3 的四层 × 时间轴质量契约。第 0 层 explore/exploit 意图(调节 D2 权重);第 1 层过程 leading 维度 D1–D4 + 硬序列闸(发散期禁 D5–D8);第 2 层产物 leading 维度 D5–D8 仅施于 Top 3,加 Seeds 栏与高方差争议区;第 3 层 Judgment Override(凌驾聚合分)。D4 判官≠产生者(须独立 context,否则 `[degraded]`);D5 主张分流(外部事实跨级地板);D7 二态证伪(「需先做 X」→next-step、不算 fail);Meta 停止规则(Top-3 集合稳定 + 硬上限 2 轮)。工作阶段自评重新定位为校准回路 lagging 端(Adoption→D6、Diversity→D2/D3、Cognitive Load→成本;禁两套平行评估)。第一原理修正为「决策用 leading、校准用 lagging」。分级绑客观模式选择触发。新增旗标 `--intent`。所有 v3 旗标/机制保留。 |
|
|
588
610
|
| 3.0.0 | 2026-06-01 | XSPEC-247:DIVERGE 重新聚焦于 persona 集成 + 多样性透镜(类比 / 反转 / 形态学);CONVERGE 重新聚焦于多评审面板 + 硬角色反驳(Devil's Advocate + Steelman);多样性坍缩护栏;Enhanced 层级(并行 persona/评审智能体,优雅回退);Research Foundations 基于 6 项已验证的 2024–2026 出处重建;效度说明重新评级(飞行前为低、Nijstad/Nemeth 降级);新旗标 `--personas`/`--lens`/`--enhanced`;反种子护栏 |
|
|
589
611
|
| 2.1.0 | 2026-05-09 | XSPEC-196 Phase 2:模式选择客观路由;自我评估框架;A/B 实验协议;研究效度说明;渐进采用协议 |
|
|
590
612
|
| 2.0.0 | 2026-05-09 | XSPEC-196:Phase 0 飞行前(反锚定)、反驳轮、10 个想法最低闸门 + 语义批次化 |
|
|
@@ -59,6 +59,56 @@ BUILD ──► TEST ──► ANALYZE ──► DEPLOY ──► VERIFY
|
|
|
59
59
|
| **GitLab CI** | `cache:` 关键字 | `parallel:` 关键字 | CI/CD Variables | 使用 `include:` 模块化 |
|
|
60
60
|
| **Jenkins** | Stash/unstash | `parallel {}` 块 | Credentials plugin | 使用 shared libraries |
|
|
61
61
|
|
|
62
|
+
## CI 作业编排模式
|
|
63
|
+
|
|
64
|
+
反复出现的 CI 作业编排模式(UDS #126)。每条原则平台无关;对照栏显示各平台的写法。
|
|
65
|
+
|
|
66
|
+
### 触发分离
|
|
67
|
+
|
|
68
|
+
将重型慢速套件(完整 E2E)以**触发条件**与每次变更的轻量检查分离,使 runner 成本随风险而非每次 push 增长。
|
|
69
|
+
|
|
70
|
+
| 需求 | GitHub Actions | GitLab CI | Jenkins |
|
|
71
|
+
|------|----------------|-----------|---------|
|
|
72
|
+
| 重型套件排程触发 | `on: schedule:` | `rules: if $CI_PIPELINE_SOURCE == "schedule"` | cron 触发 |
|
|
73
|
+
| 轻量检查每次变更 | `on: pull_request` | `rules: if $CI_PIPELINE_SOURCE == "merge_request_event"` | SCM webhook |
|
|
74
|
+
|
|
75
|
+
> ⚠️ 反模式:每次 push 跑完整 E2E。
|
|
76
|
+
|
|
77
|
+
### 共享资源序列化
|
|
78
|
+
|
|
79
|
+
当多个作业触及同一个**有状态共享资源**(单一测试环境 / runner / 部署目标)时,序列化以防并发污染。
|
|
80
|
+
|
|
81
|
+
| 需求 | GitHub Actions | GitLab CI | Jenkins |
|
|
82
|
+
|------|----------------|-----------|---------|
|
|
83
|
+
| 互斥 | `concurrency: { group: … }` | `resource_group:` | `lock(resource: …)` |
|
|
84
|
+
|
|
85
|
+
> ⚠️ 反模式:两作业并行写同一 DB/环境。
|
|
86
|
+
|
|
87
|
+
### 变更检测闸控
|
|
88
|
+
|
|
89
|
+
当某范围的 `HEAD` 自上次成功未变(或变更只触及范围外路径)时,跳过 deploy/test 以节省 runner。**明确**定义「未变」(上次成功 SHA 或路径过滤)。
|
|
90
|
+
|
|
91
|
+
| 需求 | GitHub Actions | GitLab CI | Jenkins |
|
|
92
|
+
|------|----------------|-----------|---------|
|
|
93
|
+
| 范围未变则跳过 | `paths:` / `dorny/paths-filter` | `rules: changes:` / SHA 比对 | `changeset` 条件 |
|
|
94
|
+
|
|
95
|
+
> ⚠️ 反模式:文档-only commit 跑完整部署。
|
|
96
|
+
|
|
97
|
+
### 咨询 vs 闸控作业
|
|
98
|
+
|
|
99
|
+
明确声明每个作业是 **advisory**(回报但不挡合并)或 **gating**(挡合并)。混淆会在噪声上卡关、或漏掉该挡的。(安全闸门是 Block/Warn/Log 特例——见 [`pipeline-security-gates`](../../../../core/pipeline-security-gates.md)。)
|
|
100
|
+
|
|
101
|
+
| 需求 | GitHub Actions | GitLab CI | Jenkins |
|
|
102
|
+
|------|----------------|-----------|---------|
|
|
103
|
+
| Advisory(不挡) | `continue-on-error: true` | `allow_failure: true` | `catchError` → `unstable` |
|
|
104
|
+
| Gating(挡合并) | required status check | 默认(无 `allow_failure`) | hard fail |
|
|
105
|
+
|
|
106
|
+
> ⚠️ 反模式:把噪声 lint 设硬闸,或把关键套件设 advisory。
|
|
107
|
+
|
|
108
|
+
### 排错:`npm ci` `EUSAGE`
|
|
109
|
+
|
|
110
|
+
`npm ci` 需要 **committed** lockfile。若 `package-lock.json` 被 gitignore,CI 会以 `EUSAGE` 失败。修法:commit lockfile,或 CI-only 安装用 `npm install --no-audit --no-fund --ignore-scripts`(跳过 CI 不需要的 `prepare`/husky hook)。
|
|
111
|
+
|
|
62
112
|
## 使用方式
|
|
63
113
|
|
|
64
114
|
- `/ci-cd` - 显示完整管线指引
|
|
@@ -46,16 +46,16 @@ description: |
|
|
|
46
46
|
|
|
47
47
|
## 使用方式
|
|
48
48
|
|
|
49
|
-
- `/review` - 审查目前分支的所有变更
|
|
50
|
-
- `/review src/auth.js` - 审查特定文件
|
|
51
|
-
- `/review feature/login` - 审查特定分支
|
|
49
|
+
- `/code-review` - 审查目前分支的所有变更
|
|
50
|
+
- `/code-review src/auth.js` - 审查特定文件
|
|
51
|
+
- `/code-review feature/login` - 审查特定分支
|
|
52
52
|
|
|
53
53
|
## 下一步引导
|
|
54
54
|
|
|
55
|
-
`/review` 完成后,AI 助手应建议:
|
|
55
|
+
`/code-review` 完成后,AI 助手应建议:
|
|
56
56
|
|
|
57
57
|
> **代码审查完成。建议下一步:**
|
|
58
|
-
> - 有 ❗ BLOCKING 项目 → 修复后重新执行 `/review`
|
|
58
|
+
> - 有 ❗ BLOCKING 项目 → 修复后重新执行 `/code-review`
|
|
59
59
|
> - 全部通过 → 执行 `/checkin` 品质关卡
|
|
60
60
|
> - 仅有 💡 SUGGESTION → 执行 `/commit` 提交变更
|
|
61
61
|
> - 审查中发现规范不实用或缺失 → 执行 `/audit --report` 回报
|
|
@@ -91,7 +91,7 @@ argument-hint: "[spec file path | 规格文件路径]"
|
|
|
91
91
|
|
|
92
92
|
## 参考
|
|
93
93
|
|
|
94
|
-
- [AC Coverage Assistant Skill](../ac-coverage
|
|
94
|
+
- [AC Coverage Assistant Skill](../ac-coverage/SKILL.md)
|
|
95
95
|
- [Core Standard: Acceptance Criteria Traceability](../../core/acceptance-criteria-traceability.md)
|
|
96
96
|
- 相关: [/coverage](./coverage.md) (代码层级覆盖率)
|
|
97
97
|
- 相关: [/checkin](./checkin.md) (品质关卡)
|
|
@@ -31,7 +31,7 @@ status: experimental
|
|
|
31
31
|
3. **追踪阶段转换**随着工作进展
|
|
32
32
|
4. **在响应中显示阶段指示器**(🤝 工作坊、🧪 提炼、💻 开发、🎬 展示、✅ 完成)
|
|
33
33
|
|
|
34
|
-
详见 [methodology-system](../methodology
|
|
34
|
+
详见 [methodology-system](../dev-methodology/SKILL.md) 了解完整方法论追踪。
|
|
35
35
|
|
|
36
36
|
## ATDD 循环
|
|
37
37
|
|
|
@@ -159,5 +159,5 @@ ATDD Level (Business Acceptance)
|
|
|
159
159
|
|
|
160
160
|
- 核心规范: [acceptance-test-driven-development.md](../../core/acceptance-test-driven-development.md)
|
|
161
161
|
- 技能: [atdd-assistant](../atdd-assistant/SKILL.md)
|
|
162
|
-
- 方法论: [atdd.methodology.yaml](
|
|
163
|
-
- 方法论系统: [methodology-system](../methodology
|
|
162
|
+
- 方法论: [atdd.methodology.yaml](../../../../methodologies/atdd.methodology.yaml)
|
|
163
|
+
- 方法论系统: [methodology-system](../dev-methodology/SKILL.md)
|
|
@@ -31,7 +31,7 @@ status: experimental
|
|
|
31
31
|
3. **追蹤阶段转换**隨著工作进展
|
|
32
32
|
4. **在响应中顯示阶段指示器**(🔍 探索、📝 制定、🤖 自动化、📚 活文件)
|
|
33
33
|
|
|
34
|
-
詳見 [methodology-system](../methodology
|
|
34
|
+
詳見 [methodology-system](../dev-methodology/SKILL.md) 了解完整方法論追蹤。
|
|
35
35
|
|
|
36
36
|
## BDD 循環
|
|
37
37
|
|
|
@@ -139,4 +139,4 @@ BDD 最適合协作:
|
|
|
139
139
|
## 參考
|
|
140
140
|
|
|
141
141
|
- 方法論: [bdd.methodology.yaml](../../../../methodologies/bdd.methodology.yaml)
|
|
142
|
-
- 方法論系统: [methodology-system](../methodology
|
|
142
|
+
- 方法論系统: [methodology-system](../dev-methodology/SKILL.md)
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../../skills/commands/brainstorm.md
|
|
3
|
-
source_version:
|
|
3
|
+
source_version: 4.0.0
|
|
4
4
|
source_hash: 3212203924de
|
|
5
|
-
translation_version:
|
|
6
|
-
last_synced: 2026-06-
|
|
5
|
+
translation_version: 4.0.0
|
|
6
|
+
last_synced: 2026-06-22
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
---
|
|
@@ -29,13 +29,15 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
|
|
|
29
29
|
防锚定 定义问题 persona 集成+透镜 多评审面板+硬角色反驳 输出提案
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
| 阶段 | 目标 | 关键技法(v3) |
|
|
33
|
-
|
|
34
|
-
| **PRE-FLIGHT** | 防止 AI 锚定 | 用户先写 3
|
|
35
|
-
| **FRAME** | 清楚定义问题 | 5 Whys, HMW, Stakeholder Map |
|
|
36
|
-
| **DIVERGE** | 逼出视角多样性 | persona 集成 +
|
|
37
|
-
| **CONVERGE** | 经偏误检查的选择 | 多评审面板 + Devil's Advocate/Steelman |
|
|
38
|
-
| **OUTPUT** | 可执行的报告 | Brainstorm Report
|
|
32
|
+
| 阶段 | 目标 | 关键技法(v3)+ BQS 闸(v4) |
|
|
33
|
+
|------|------|-------------------------------|
|
|
34
|
+
| **PRE-FLIGHT** | 防止 AI 锚定 | 用户先写 3 个想法;不用类比种子;**BQS 第 0 层意图(explore/exploit)** |
|
|
35
|
+
| **FRAME** | 清楚定义问题 | 5 Whys, HMW, Stakeholder Map;**D1 框架纯度** |
|
|
36
|
+
| **DIVERGE** | 逼出视角多样性 | persona 集成 + 多样性透镜;**BQS 第 1 层 D1–D4,硬闸隐藏 D5–D8** |
|
|
37
|
+
| **CONVERGE** | 经偏误检查的选择 | 多评审面板 + Devil's Advocate/Steelman;**BQS 第 2 层 D5–D8 施于 Top 3,D4 判官≠产生者** |
|
|
38
|
+
| **OUTPUT** | 可执行的报告 | Brainstorm Report + Seeds + 争议区 + **第 3 层 Judgment Override** |
|
|
39
|
+
|
|
40
|
+
> **BQS v1(XSPEC-296):** v4 在 v3 上叠加四层 × 时间轴质量契约。完整 oracle 与结构规则见 skill:[Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md#bqs-v1--质量契约)。
|
|
39
41
|
|
|
40
42
|
## 技法
|
|
41
43
|
|
|
@@ -98,34 +100,39 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
|
|
|
98
100
|
| `/brainstorm "topic"` | 以指定主题启动 PRE-FLIGHT,再进入 FRAME |
|
|
99
101
|
| `/brainstorm --personas "a,b,c"` | 以自定义 persona 组进入 DIVERGE |
|
|
100
102
|
| `/brainstorm --lens <name>` | 以指定多样性透镜为主进入 DIVERGE |
|
|
101
|
-
| `/brainstorm --enhanced` | 若宿主支持子代理则并行跑 persona/评审,否则静默退回 baseline |
|
|
103
|
+
| `/brainstorm --enhanced` | 若宿主支持子代理则并行跑 persona/评审,否则静默退回 baseline;此模式下 BQS D4 方可 pass |
|
|
104
|
+
| `/brainstorm --intent exploit` | 以 exploit 意图启动(BQS 第 0 层),D2 低覆盖不扣分 |
|
|
102
105
|
|
|
103
106
|
### 交互脚本
|
|
104
107
|
|
|
105
108
|
#### PRE-FLIGHT 阶段
|
|
106
109
|
1. 请用户先写 问题(一句)+3 个初始想法+最不想要的解法类型
|
|
107
110
|
2. 拒绝「像 X 但给 Y」种子,改写为底层问题
|
|
111
|
+
3. **BQS 第 0 层**:宣告本次 explore/exploit 配比与赌注类型(未宣告默认偏 explore)
|
|
108
112
|
|
|
109
113
|
🛑 **STOP**: 收到三项输入前不生成任何想法(`--skip-preflight` 例外,显示锚定警告)
|
|
110
114
|
|
|
111
115
|
#### FRAME 阶段
|
|
112
116
|
1. 厘清问题陈述(5 Whys 找根因)
|
|
113
117
|
2. 重构为 HMW 问题;识别利益相关者
|
|
118
|
+
3. **BQS D1 框架纯度**:问题不得内嵌特定方案或「像 X 给 Y」,须到根因
|
|
114
119
|
|
|
115
120
|
🛑 **STOP**: 问题定义后等待用户确认
|
|
116
121
|
|
|
117
|
-
#### DIVERGE
|
|
122
|
+
#### DIVERGE 阶段(BQS 第 1 层 — D1–D4 leading,全程可见)
|
|
118
123
|
1. 逐一以默认 persona(领域专家/怀疑者/跨域类比者/成本约束者/用户代言)思维链生成想法
|
|
119
124
|
2. **分支隔离**:生成各 persona 时不互相预览,全部产完才一起呈现
|
|
120
125
|
3. 至少套用一个多样性透镜(类比/假设反转/形态矩阵)
|
|
121
|
-
4. 以多样性(覆盖的 persona
|
|
126
|
+
4. 以多样性(覆盖的 persona/透镜数,D2/D3)而非数量为继续门槛
|
|
127
|
+
5. **硬序列闸**:D5–D8 在最后一个 persona 产完前**不得揭示或评分**;CONVERGE critic 不得提前调用
|
|
122
128
|
|
|
123
|
-
#### CONVERGE
|
|
129
|
+
#### CONVERGE 阶段(BQS 第 2 层 — D5–D8 仅施于 Top 3)
|
|
124
130
|
1. 以 3 个独立评审(工程可行性/用户影响/战略一致)各自评分后聚合
|
|
125
|
-
2. 对前 3 名跑硬角色 Devil's Advocate(论证会失败)+ Steelman;用户以 (a)修改/(b)反驳/(c)移除
|
|
126
|
-
3.
|
|
131
|
+
2. 对前 3 名跑硬角色 Devil's Advocate(论证会失败)+ Steelman;用户以 (a)修改/(b)反驳/(c)移除 回应。**D4 判官≠产生者**:评审须在独立 context(`--enhanced`)方可 pass,否则标 `[degraded]` 不得 pass
|
|
132
|
+
3. **仅对 Top 3** 套用 D5 接地(外部事实需 file:line/来源、跨级地板;假说免接地)、D6 净值(解谁问题/真有吗/不做代价+挂 lagging 栏)、D7 二态证伪(「需先做 X」转 next-step、不算 fail)、D8 next-step 裁决
|
|
133
|
+
4. **Meta 停止规则**:维度全绿且再跑一轮 Top 3 集合成员不变→停;硬上限 2 轮
|
|
127
134
|
|
|
128
|
-
🛑 **STOP**: 展示 Brainstorm Report
|
|
135
|
+
🛑 **STOP**: 展示 Brainstorm Report(含 Seeds/争议区/Judgment Override)后等待用户决定下一步
|
|
129
136
|
|
|
130
137
|
### 停止点
|
|
131
138
|
|
|
@@ -145,6 +152,8 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
|
|
|
145
152
|
| 指定的 persona/透镜不存在 | 列出可用选项供选择 |
|
|
146
153
|
| `--enhanced` 但宿主不支持子代理 | 静默退回 baseline,照常进行 |
|
|
147
154
|
| 前 3 名全来自同一 persona/透镜 | 标示并在输出前再跑一个透镜 |
|
|
155
|
+
| baseline 单 context 跑评审(无独立 context) | BQS D4 标 `[degraded]`,不得标 pass |
|
|
156
|
+
| 外部事实宣称无 file:line/来源 | D5 接地 fail,要求补来源或改标 `[假说]` |
|
|
148
157
|
|
|
149
158
|
## 参考
|
|
150
159
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
source: ../../../../skills/commands/review.md
|
|
2
|
+
source: ../../../../skills/commands/code-review.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
5
|
last_synced: 2026-04-22
|
|
@@ -48,9 +48,9 @@ Perform systematic code review using standardized checklists and comment prefixe
|
|
|
48
48
|
|
|
49
49
|
## Usage | 使用方式
|
|
50
50
|
|
|
51
|
-
- `/review` - 审查当前分支的所有变更
|
|
52
|
-
- `/review src/auth.js` - 审查特定文件
|
|
53
|
-
- `/review feature/login` - 审查特定分支
|
|
51
|
+
- `/code-review` - 审查当前分支的所有变更
|
|
52
|
+
- `/code-review src/auth.js` - 审查特定文件
|
|
53
|
+
- `/code-review feature/login` - 审查特定分支
|
|
54
54
|
|
|
55
55
|
## Reference | 参考
|
|
56
56
|
|
|
@@ -53,6 +53,6 @@ SPEC-XXX.md ──► /derive-bdd ──► /derive-tdd ──► [/derive-atdd]
|
|
|
53
53
|
|
|
54
54
|
## 参考
|
|
55
55
|
|
|
56
|
-
- 父命令: [/derive](../
|
|
56
|
+
- 父命令: [/derive](../spec-derivation/SKILL.md)
|
|
57
57
|
- 核心规范: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)
|
|
58
58
|
- 子命令: [/derive-bdd](./derive-bdd.md), [/derive-tdd](./derive-tdd.md), [/derive-atdd](./derive-atdd.md)
|
|
@@ -50,5 +50,5 @@ SPEC-XXX.md ──► Parse AC ──► Generate acceptance.md ──► Review
|
|
|
50
50
|
|
|
51
51
|
## 参考
|
|
52
52
|
|
|
53
|
-
- 父命令: [/derive](../
|
|
53
|
+
- 父命令: [/derive](../spec-derivation/SKILL.md)
|
|
54
54
|
- 核心规范: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)
|
|
@@ -30,10 +30,9 @@ SPEC-XXX.md ──► Parse AC ──► Generate .feature ──► Review
|
|
|
30
30
|
## 输出格式
|
|
31
31
|
|
|
32
32
|
```gherkin
|
|
33
|
-
@SPEC-001
|
|
34
33
|
Feature: [Feature Name]
|
|
35
34
|
|
|
36
|
-
@AC-1
|
|
35
|
+
@SPEC-001 @AC-1
|
|
37
36
|
Scenario: [AC-1 description]
|
|
38
37
|
Given [context]
|
|
39
38
|
When [action]
|
|
@@ -49,5 +48,5 @@ Feature: [Feature Name]
|
|
|
49
48
|
|
|
50
49
|
## 参考
|
|
51
50
|
|
|
52
|
-
- 父命令: [/derive](../
|
|
51
|
+
- 父命令: [/derive](../spec-derivation/SKILL.md)
|
|
53
52
|
- 核心规范: [forward-derivation-standards.md](../../core/forward-derivation-standards.md)
|
|
@@ -86,7 +86,7 @@ ls docs/specs/SPEC-*.md 2>/dev/null
|
|
|
86
86
|
| **I. 规划** | `/brainstorm` `/requirement` `/sdd` `/reverse` | 需求、规格、逆向工程 |
|
|
87
87
|
| **II. 测试** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` | 先写测试再写代码 |
|
|
88
88
|
| **III. 实作** | `/refactor` `/reverse` | 编写与改善代码 |
|
|
89
|
-
| **IV. 质量** | `/checkin` `/review` | 提交前检查与审查 |
|
|
89
|
+
| **IV. 质量** | `/checkin` `/code-review` | 提交前检查与审查 |
|
|
90
90
|
| **V. 发布** | `/commit` `/changelog` `/release` | 版本、提交、发布 |
|
|
91
91
|
| **VI. 文档** | `/docs` `/docgen` `/struct` | 文档与专案结构 |
|
|
92
92
|
| **VII. 标准** | `/discover` `/guide` | 参考指南 |
|
|
@@ -115,5 +115,5 @@ ls docs/specs/SPEC-*.md 2>/dev/null
|
|
|
115
115
|
## 参考
|
|
116
116
|
|
|
117
117
|
- [开发工作流程技能](../dev-workflow-guide/SKILL.md)
|
|
118
|
-
- [详细阶段指南](
|
|
118
|
+
- [详细阶段指南](../../../../skills/dev-workflow-guide/workflow-phases.md)
|
|
119
119
|
- [日常工作流程指南](../../adoption/DAILY-WORKFLOW-GUIDE.md)
|
|
@@ -179,7 +179,7 @@ status: experimental
|
|
|
179
179
|
/methodology create
|
|
180
180
|
```
|
|
181
181
|
|
|
182
|
-
啟动互动式方法論建立精靈。詳見[建立自订方法論](../methodology
|
|
182
|
+
啟动互动式方法論建立精靈。詳見[建立自订方法論](../dev-methodology/create-methodology.md)。
|
|
183
183
|
|
|
184
184
|
---
|
|
185
185
|
|
|
@@ -261,9 +261,9 @@ status: experimental
|
|
|
261
261
|
|
|
262
262
|
## 參考
|
|
263
263
|
|
|
264
|
-
- [方法論系统 Skill](../methodology
|
|
265
|
-
- [执行时引導](../methodology
|
|
266
|
-
- [建立自订方法論](../methodology
|
|
264
|
+
- [方法論系统 Skill](../dev-methodology/SKILL.md) - 完整 skill 文档
|
|
265
|
+
- [执行时引導](../dev-methodology/runtime.md) - AI 行为規格
|
|
266
|
+
- [建立自订方法論](../dev-methodology/create-methodology.md) - 自订方法論指南
|
|
267
267
|
|
|
268
268
|
---
|
|
269
269
|
|