@chongyan/autospec 1.0.1 → 1.0.2
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/LICENSE +21 -21
- package/README.en.md +447 -321
- package/README.md +418 -286
- package/knowledge/01-principles/00-principles-hierarchy.md +247 -0
- package/knowledge/01-principles/01-first-principles.md +241 -0
- package/knowledge/01-principles/02-strategic-principles.md +286 -0
- package/knowledge/01-principles/03-tactical-principles.md +385 -0
- package/knowledge/01-principles/04-operational-principles.md +275 -0
- package/knowledge/01-principles/05-domain-principles.md +539 -0
- package/knowledge/01-principles/06-methodology-principles.md +281 -0
- package/knowledge/01-principles/07-cognitive-principles.md +277 -0
- package/knowledge/01-principles/08-auto-fix-principles.md +320 -0
- package/knowledge/01-principles/09-constitution.md +220 -0
- package/knowledge/{principles/evolution.md → 01-principles/10-evolution-mechanism.md} +160 -14
- package/knowledge/01-principles/README.en.md +385 -0
- package/knowledge/01-principles/README.md +385 -0
- package/knowledge/{process/overview.md → 02-process/00-overview.md} +90 -5
- package/knowledge/02-process/README.en.md +143 -0
- package/knowledge/02-process/README.md +186 -0
- package/knowledge/{guides/support/pipeline-protocol.md → 03-guides/00-pipeline-protocol.md} +10 -10
- package/knowledge/{guides/support/team-orchestrator.md → 03-guides/01-team-orchestrator.md} +53 -8
- package/knowledge/{guides/stages/requirement-analyzer.md → 03-guides/02-analyze-requirement.md} +3 -3
- package/knowledge/{guides/stages/ai-effect-evaluator.md → 03-guides/08-evaluate-ai-effect.md} +14 -7
- package/knowledge/{guides/support/skill-distiller.md → 03-guides/19-distill-skill.md} +3 -3
- package/knowledge/{guides/support/skill-updater.md → 03-guides/20-update-skill.md} +1 -1
- package/knowledge/{guides/support/methodology-extractor.md → 03-guides/22-extract-methodology.md} +2 -2
- package/knowledge/{guides/support/complexity-assessor.md → 03-guides/24-assess-complexity.md} +6 -4
- package/knowledge/{guides/support/tech-stack-analyzer.md → 03-guides/26-analyze-tech-stack.md} +1 -1
- package/knowledge/{guides/domain-driven-design.md → 03-guides/42-apply-ddd.md} +1 -1
- package/knowledge/{process/ai-sdlc.md → 03-guides/43-run-ai-sdlc.md} +1 -1
- package/knowledge/{guides/knowledge-management.md → 03-guides/44-manage-knowledge.md} +4 -4
- package/knowledge/03-guides/README.en.md +212 -0
- package/knowledge/03-guides/README.md +212 -0
- package/knowledge/{checklists/requirement.md → 04-checklists/00-requirement.md} +1 -1
- package/knowledge/{checklists/design.md → 04-checklists/01-design.md} +1 -1
- package/knowledge/{checklists/code.md → 04-checklists/02-code.md} +16 -1
- package/knowledge/{checklists/release.md → 04-checklists/04-release.md} +1 -1
- package/knowledge/04-checklists/README.en.md +119 -0
- package/knowledge/04-checklists/README.md +123 -0
- package/knowledge/{config/validation-patterns.yaml → 05-config/00-validation-patterns.yaml} +1 -1
- package/knowledge/{config/team-tasks.yaml → 05-config/02-team-tasks.yaml} +2 -2
- package/knowledge/05-config/03-role-composition.yaml +346 -0
- package/knowledge/{config/skill-compositions.yaml → 05-config/05-skill-compositions.yaml} +24 -24
- package/knowledge/05-config/README.en.md +54 -0
- package/knowledge/05-config/README.md +132 -0
- package/knowledge/06-environment/00-template-registry.md +310 -0
- package/knowledge/06-environment/01-detection-patterns.yaml +1692 -0
- package/knowledge/{environment → 06-environment}/README.en.md +4 -0
- package/knowledge/{environment → 06-environment}/README.md +66 -25
- package/knowledge/{standards/coding-style.md → 07-standards/00-coding-style.md} +123 -4
- package/knowledge/{standards/code-review.md → 07-standards/01-code-review.md} +3 -3
- package/knowledge/{standards/data-consistency.md → 07-standards/02-data-consistency.md} +1 -1
- package/knowledge/{standards/document-versioning.md → 07-standards/03-document-versioning.md} +1 -1
- package/knowledge/{standards/risk-detection.md → 07-standards/04-risk-detection.md} +5 -5
- package/knowledge/07-standards/README.en.md +119 -0
- package/knowledge/07-standards/README.md +123 -0
- package/knowledge/08-organization/00-vision-mission.md +113 -0
- package/knowledge/{organization/ai-native-team.md → 08-organization/01-ai-native-culture.md} +1 -1
- package/knowledge/{organization/team-metrics.md → 08-organization/02-team-metrics.md} +1 -1
- package/knowledge/08-organization/03-committee-structure.md +54 -0
- package/knowledge/08-organization/04-governance-metrics.md +55 -0
- package/knowledge/08-organization/05-improvement-process.md +71 -0
- package/knowledge/08-organization/README.en.md +165 -0
- package/knowledge/08-organization/README.md +165 -0
- package/knowledge/09-templates/00-requirement-proposal.md +344 -0
- package/knowledge/09-templates/01-architecture-design.md +494 -0
- package/knowledge/09-templates/02-api-design.md +408 -0
- package/knowledge/09-templates/03-database-design.md +313 -0
- package/knowledge/09-templates/04-product-design.md +237 -0
- package/knowledge/09-templates/05-domain-business.md +388 -0
- package/knowledge/09-templates/06-test-design.md +268 -0
- package/knowledge/09-templates/07-evaluation-design.md +372 -0
- package/knowledge/09-templates/08-component-knowledge.md +272 -0
- package/knowledge/09-templates/09-best-practices.md +218 -0
- package/knowledge/{environment/middleware-knowledge.md → 09-templates/10-middleware-knowledge.md} +106 -1
- package/knowledge/09-templates/README.en.md +222 -0
- package/knowledge/09-templates/README.md +216 -0
- package/knowledge/README.en.md +372 -0
- package/knowledge/README.md +354 -99
- package/package.json +1 -1
- package/plugins/.claude-plugin/plugin.json +460 -81
- package/plugins/agents/roles/ceo.md +1 -1
- package/plugins/agents/roles/product-owner.md +1 -1
- package/plugins/agents/roles/tech-lead.md +1 -1
- package/plugins/agents/support/consistency-checker.md +36 -3
- package/plugins/agents/support/monitoring-agent.md +215 -0
- package/plugins/agents/support/safety-auditor.md +2 -2
- package/plugins/agents/support/stage-gate-evaluator.md +95 -11
- package/plugins/agents/support/test-coverage-reviewer.md +1 -1
- package/plugins/benchmarks/templates/README.md +165 -13
- package/plugins/benchmarks/templates/commands/apply-template.yaml +108 -0
- package/plugins/benchmarks/templates/commands/archive-template.yaml +65 -0
- package/plugins/benchmarks/templates/commands/env-export-template.yaml +64 -0
- package/plugins/benchmarks/templates/commands/env-sync-template.yaml +104 -0
- package/plugins/benchmarks/templates/commands/env-template-template.yaml +96 -0
- package/plugins/benchmarks/templates/commands/env-template.yaml +58 -0
- package/plugins/benchmarks/templates/commands/env-update-template.yaml +110 -0
- package/plugins/benchmarks/templates/commands/env-validate-template.yaml +95 -0
- package/plugins/benchmarks/templates/commands/field-evolve-template.yaml +104 -0
- package/plugins/benchmarks/templates/commands/project-evolve-template.yaml +104 -0
- package/plugins/benchmarks/templates/commands/propose-template.yaml +88 -0
- package/plugins/benchmarks/templates/commands/review-template.yaml +124 -0
- package/plugins/benchmarks/templates/commands/run-template.yaml +127 -0
- package/plugins/benchmarks/templates/commands/test-template.yaml +149 -0
- package/plugins/benchmarks/templates/pipeline/experiment-template.yaml +92 -0
- package/plugins/benchmarks/templates/pipeline/hotfix-template.yaml +81 -0
- package/plugins/benchmarks/templates/skills/agile-iteration-template.yaml +78 -0
- package/plugins/benchmarks/templates/skills/benchmark-executor-template.yaml +114 -0
- package/plugins/benchmarks/templates/skills/benchmark-generator-template.yaml +52 -0
- package/plugins/benchmarks/templates/skills/delivery-stage-template.yaml +130 -0
- package/plugins/benchmarks/templates/skills/design-stage-template.yaml +131 -0
- package/plugins/benchmarks/templates/skills/experiment-iteration-template.yaml +60 -0
- package/plugins/benchmarks/templates/skills/exploration-phase-template.yaml +114 -0
- package/plugins/benchmarks/templates/skills/field-evolve-analyzer-template.yaml +51 -0
- package/plugins/benchmarks/templates/skills/field-evolve-distiller-template.yaml +34 -0
- package/plugins/benchmarks/templates/skills/field-evolve-executor-template.yaml +50 -0
- package/plugins/benchmarks/templates/skills/field-evolve-fixer-template.yaml +52 -0
- package/plugins/benchmarks/templates/skills/field-evolve-learner-template.yaml +33 -0
- package/plugins/benchmarks/templates/skills/field-evolve-scanner-template.yaml +74 -0
- package/plugins/benchmarks/templates/skills/field-evolve-template.yaml +71 -0
- package/plugins/benchmarks/templates/skills/field-evolve-verifier-template.yaml +51 -0
- package/plugins/benchmarks/templates/skills/hotfix-iteration-template.yaml +54 -0
- package/plugins/benchmarks/templates/skills/implementation-stage-template.yaml +127 -0
- package/plugins/benchmarks/templates/skills/layer1-validation-template.yaml +121 -0
- package/plugins/benchmarks/templates/skills/project-evolve-analyzer-template.yaml +51 -0
- package/plugins/benchmarks/templates/skills/project-evolve-fixer-template.yaml +52 -0
- package/plugins/benchmarks/templates/skills/project-evolve-generator-template.yaml +34 -0
- package/plugins/benchmarks/templates/skills/project-evolve-learner-template.yaml +50 -0
- package/plugins/benchmarks/templates/skills/project-evolve-reviewer-template.yaml +50 -0
- package/plugins/benchmarks/templates/skills/project-evolve-scanner-template.yaml +75 -0
- package/plugins/benchmarks/templates/skills/project-evolve-template.yaml +72 -0
- package/plugins/benchmarks/templates/skills/project-evolve-verifier-template.yaml +51 -0
- package/plugins/benchmarks/templates/skills/skill-forge-template.yaml +117 -0
- package/plugins/benchmarks/templates/skills/startup-guard-template.yaml +103 -0
- package/plugins/benchmarks/templates/skills/testing-stage-template.yaml +146 -0
- package/plugins/benchmarks/templates/skills/waterfall-iteration-template.yaml +55 -0
- package/plugins/commands/README.en.md +2 -2
- package/plugins/commands/README.md +2 -2
- package/plugins/commands/apply.md +102 -16
- package/plugins/commands/archive.md +60 -4
- package/plugins/commands/env-sync.md +1047 -406
- package/plugins/commands/env-template.md +11 -135
- package/plugins/commands/env-update.md +1 -1
- package/plugins/commands/env-validate.md +3 -3
- package/plugins/commands/explore.md +118 -1
- package/plugins/commands/field-evolve.md +51 -175
- package/plugins/commands/project-evolve.md +167 -68
- package/plugins/commands/propose.md +97 -6
- package/plugins/commands/review.md +5 -5
- package/plugins/commands/run.md +841 -13
- package/plugins/commands/status.md +138 -17
- package/plugins/commands/test.md +389 -0
- package/plugins/hooks/constitution-guard.js +1 -1
- package/plugins/hooks/environment-autocommit.js +366 -24
- package/plugins/hooks/environment-manager.js +3 -2
- package/plugins/hooks/execution-tracker.js +109 -4
- package/plugins/hooks/layer1-validator.js +117 -1
- package/plugins/hooks/lib/auto-fix-loop.js +605 -0
- package/plugins/hooks/lib/environment-config-loader.js +11 -7
- package/plugins/hooks/lib/hook-state-manager.js +98 -0
- package/plugins/hooks/lib/memory-extractor.js +27 -5
- package/plugins/hooks/lib/memory-manager.js +1 -1
- package/plugins/hooks/lib/test-auto-fix.test.js +194 -0
- package/plugins/hooks/monitoring-trigger.js +467 -0
- package/plugins/skills/README.en.md +15 -3
- package/plugins/skills/README.md +21 -11
- package/plugins/skills/agile-iteration/SKILL.md +187 -0
- package/plugins/skills/delivery-stage/SKILL.md +133 -12
- package/plugins/skills/design-stage/SKILL.md +103 -12
- package/plugins/skills/experiment-evaluator/SKILL.md +271 -0
- package/plugins/skills/experiment-iteration/SKILL.md +154 -0
- package/plugins/skills/exploration-phase/SKILL.md +93 -10
- package/plugins/skills/field-evolve-analyzer/SKILL.md +65 -0
- package/plugins/skills/field-evolve-distiller/SKILL.md +66 -0
- package/plugins/skills/field-evolve-executor/SKILL.md +94 -0
- package/plugins/skills/field-evolve-executor/executor.js +342 -0
- package/plugins/skills/field-evolve-fixer/SKILL.md +69 -0
- package/plugins/skills/field-evolve-learner/SKILL.md +65 -0
- package/plugins/skills/field-evolve-scanner/SKILL.md +87 -0
- package/plugins/skills/field-evolve-scanner/scripts/fallback-scanner.js +288 -0
- package/plugins/skills/field-evolve-verifier/SKILL.md +64 -0
- package/plugins/skills/hotfix-iteration/SKILL.md +279 -0
- package/plugins/skills/implementation-stage/SKILL.md +156 -15
- package/plugins/skills/layer1-validation/SKILL.md +1 -1
- package/plugins/skills/pending-dashboard/SKILL.md +9 -8
- package/plugins/skills/project-evolve-analyzer/SKILL.md +95 -0
- package/plugins/skills/project-evolve-fixer/SKILL.md +99 -0
- package/plugins/skills/project-evolve-generator/SKILL.md +149 -0
- package/plugins/skills/project-evolve-learner/SKILL.md +103 -0
- package/plugins/skills/project-evolve-reviewer/SKILL.md +104 -0
- package/plugins/skills/project-evolve-scanner/SKILL.md +95 -0
- package/plugins/skills/project-evolve-scanner/scripts/dependency-reuse-checker.js +395 -0
- package/plugins/skills/project-evolve-scanner/scripts/subsystem-coverage.js +315 -0
- package/plugins/skills/project-evolve-verifier/SKILL.md +105 -0
- package/plugins/skills/requirement-stage/SKILL.md +47 -13
- package/plugins/skills/skill-forge/SKILL.md +2 -2
- package/plugins/skills/testing-stage/SKILL.md +583 -8
- package/plugins/skills/waterfall-iteration/SKILL.md +115 -0
- package/scripts/cli/index.js +1 -1
- package/scripts/cli/init.js +30 -4
- package/scripts/cli/list.js +3 -2
- package/scripts/config/commands.config.js +8 -8
- package/scripts/config/hooks.config.js +1 -1
- package/scripts/install/constants.js +204 -165
- package/scripts/state.js +210 -1
- package/knowledge/config/README.en.md +0 -44
- package/knowledge/config/README.md +0 -44
- package/knowledge/config/role-composition.yaml +0 -98
- package/knowledge/config/team-triggers.yaml +0 -198
- package/knowledge/domain/README.md +0 -115
- package/knowledge/domain/flows/README.md +0 -194
- package/knowledge/domain/glossary.md +0 -143
- package/knowledge/domain/rules.md +0 -138
- package/knowledge/environment/component-knowledge.md +0 -316
- package/knowledge/environment/detection-patterns.yaml +0 -502
- package/knowledge/environment/template-registry.md +0 -321
- package/knowledge/guides/requirement-engineering.md +0 -329
- package/knowledge/guides/system-design.md +0 -352
- package/knowledge/principles/constitution.md +0 -134
- package/knowledge/principles/core-principles.md +0 -368
- package/knowledge/principles/design-philosophy.md +0 -877
- package/knowledge/process/README.en.md +0 -38
- package/knowledge/process/README.md +0 -48
- package/knowledge/templates/ai-evaluation.md +0 -150
- package/knowledge/templates/api-design.md +0 -117
- package/knowledge/templates/database-design.md +0 -132
- package/knowledge/templates/domain-driven-design.md +0 -321
- package/knowledge/templates/product-proposal.md +0 -201
- package/knowledge/templates/system-design.md +0 -227
- package/knowledge/templates/task-breakdown.md +0 -107
- package/knowledge/templates/test-case.md +0 -170
- package/plugins/commands/validate.md +0 -108
- package/plugins/skills/benchmark-executor/README.md +0 -93
- package/plugins/skills/evolution-process/SKILL.md +0 -291
- package/plugins/skills/project-evolution/SKILL.md +0 -847
- package/scripts/evolution/evolution-router.js +0 -273
- package/scripts/evolution/evolution-signal-collector.js +0 -307
- package/scripts/evolution/knowledge-loader.js +0 -346
- package/scripts/evolution/marketplace.js +0 -317
- package/scripts/evolution/version-manager.js +0 -371
- /package/knowledge/{process → 02-process}/01-requirement.md +0 -0
- /package/knowledge/{process → 02-process}/02-design.md +0 -0
- /package/knowledge/{process → 02-process}/03-implementation.md +0 -0
- /package/knowledge/{process → 02-process}/04-review.md +0 -0
- /package/knowledge/{process → 02-process}/05-testing.md +0 -0
- /package/knowledge/{process → 02-process}/06-delivery.md +0 -0
- /package/knowledge/{guides/stages/design-planner.md → 03-guides/03-design-solution.md} +0 -0
- /package/knowledge/{guides/stages/code-implementer.md → 03-guides/04-implement-code.md} +0 -0
- /package/knowledge/{guides/stages/test-planner.md → 03-guides/05-plan-testing.md} +0 -0
- /package/knowledge/{guides/stages/test-generator.md → 03-guides/06-generate-tests.md} +0 -0
- /package/knowledge/{guides/stages/release-checker.md → 03-guides/07-check-release.md} +0 -0
- /package/knowledge/{guides/stages/requirement-reviewer.md → 03-guides/09-review-requirement.md} +0 -0
- /package/knowledge/{guides/stages/design-reviewer.md → 03-guides/10-review-design.md} +0 -0
- /package/knowledge/{guides/stages/code-reviewer.md → 03-guides/11-review-code.md} +0 -0
- /package/knowledge/{guides/stages/test-reviewer.md → 03-guides/12-review-testing.md} +0 -0
- /package/knowledge/{guides/stages/security-reviewer.md → 03-guides/13-audit-security.md} +0 -0
- /package/knowledge/{guides/stages/consistency-checker.md → 03-guides/14-check-consistency.md} +0 -0
- /package/knowledge/{guides/stages/unit-test-runner.md → 03-guides/15-run-unit-tests.md} +0 -0
- /package/knowledge/{guides/stages/integration-test-runner.md → 03-guides/16-run-integration-tests.md} +0 -0
- /package/knowledge/{guides/stages/test-context-analyzer.md → 03-guides/17-analyze-test-context.md} +0 -0
- /package/knowledge/{guides/support/practice-logger.md → 03-guides/18-log-practice.md} +0 -0
- /package/knowledge/{guides/support/skill-validator.md → 03-guides/21-validate-skill.md} +0 -0
- /package/knowledge/{guides/support/scope-inference.md → 03-guides/23-infer-scope.md} +0 -0
- /package/knowledge/{guides/support/component-discovery.md → 03-guides/25-discover-component.md} +0 -0
- /package/knowledge/{guides/support/environment-scanner.md → 03-guides/27-scan-environment.md} +0 -0
- /package/knowledge/{guides/support/environment-validator.md → 03-guides/28-validate-environment.md} +0 -0
- /package/knowledge/{guides/support/knowledge-generator.md → 03-guides/29-generate-knowledge.md} +0 -0
- /package/knowledge/{guides/support/ai-capability-analyzer.md → 03-guides/30-analyze-ai-capability.md} +0 -0
- /package/knowledge/{guides/support/ai-component-analyzer.md → 03-guides/31-analyze-ai-component.md} +0 -0
- /package/knowledge/{guides/support/ai-agent-analyzer.md → 03-guides/32-analyze-ai-agent.md} +0 -0
- /package/knowledge/{guides/support/ai-rag-analyzer.md → 03-guides/33-analyze-ai-rag.md} +0 -0
- /package/knowledge/{guides/support/ai-task-assessor.md → 03-guides/34-assess-ai-task.md} +0 -0
- /package/knowledge/{guides/support/ai-pipeline-evaluator.md → 03-guides/35-evaluate-ai-pipeline.md} +0 -0
- /package/knowledge/{guides/support/ai-artifact-evaluator.md → 03-guides/36-evaluate-ai-artifact.md} +0 -0
- /package/knowledge/{guides/support/ai-evaluation-planner.md → 03-guides/37-plan-ai-evaluation.md} +0 -0
- /package/knowledge/{guides/support/ai-path-evaluator.md → 03-guides/38-evaluate-ai-path.md} +0 -0
- /package/knowledge/{guides/support/ai-data-validator.md → 03-guides/39-validate-ai-data.md} +0 -0
- /package/knowledge/{guides/support/ai-anomaly-analyzer.md → 03-guides/40-detect-ai-anomaly.md} +0 -0
- /package/knowledge/{guides/support/ai-test-diagnostics.md → 03-guides/41-diagnose-ai-test.md} +0 -0
- /package/knowledge/{guides/support/test-runner.md → 03-guides/45-test-runner.md} +0 -0
- /package/knowledge/{checklists/test.md → 04-checklists/03-test.md} +0 -0
- /package/knowledge/{config/team-stage.yaml → 05-config/01-team-stage.yaml} +0 -0
- /package/knowledge/{config/role-extensions.yaml → 05-config/04-role-extensions.yaml} +0 -0
|
@@ -0,0 +1,385 @@
|
|
|
1
|
+
# AutoSpec 原则体系
|
|
2
|
+
|
|
3
|
+
> **定位**: 框架的"原则操作系统",所有执行决策必须能追溯到本文的原则
|
|
4
|
+
>
|
|
5
|
+
> **进化分区**: 🔴 冻结区(宪法、进化规则、核心原则、设计哲学)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 原则体系总览
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
13
|
+
│ L1: 第一性原则 (First Principles) — 不可违背的"物理定律" │
|
|
14
|
+
│ ───────────────────────────────────────────────────────── │
|
|
15
|
+
│ 验证为王 | 极简实用 | 渐进自主 │
|
|
16
|
+
│ → 位于:01-first-principles.md │
|
|
17
|
+
└─────────────────────────────────────────────────────────────┘
|
|
18
|
+
│ 演绎
|
|
19
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
20
|
+
│ L2: 战略原则 (Strategic Principles) — 方向性指导 │
|
|
21
|
+
│ ───────────────────────────────────────────────────────── │
|
|
22
|
+
│ 双层验证 | 做审分离 | Harness 工程 | 知情猜测 │
|
|
23
|
+
│ → 位于:02-strategic-principles.md │
|
|
24
|
+
└─────────────────────────────────────────────────────────────┘
|
|
25
|
+
│ 展开
|
|
26
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
27
|
+
│ L3: 战术原则 (Tactical Principles) — 执行策略指导 │
|
|
28
|
+
│ ───────────────────────────────────────────────────────── │
|
|
29
|
+
│ 任务分解 | 上下文管理 | 精准回退 | 反模式预判 | 驯服非确定性 │
|
|
30
|
+
│ → 位于:03-tactical-principles.md │
|
|
31
|
+
└─────────────────────────────────────────────────────────────┘
|
|
32
|
+
│ 落地
|
|
33
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
34
|
+
│ L4: 操作原则 (Operational Principles) — 具体行为规范 │
|
|
35
|
+
│ ───────────────────────────────────────────────────────── │
|
|
36
|
+
│ 编码规范 | 自主修复 | 宪法门禁 | 检查清单 │
|
|
37
|
+
│ → 位于:04-operational-principles.md │
|
|
38
|
+
└─────────────────────────────────────────────────────────────┘
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 目录结构
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
principles/
|
|
47
|
+
├── README.md # 本文件(原则层导航)
|
|
48
|
+
├── 00-principles-hierarchy.md # 原则体系总纲(L1→L2→L3→L4 完整追溯)
|
|
49
|
+
├── 01-first-principles.md # L1 第一性原则(P1-P3 三棱锥)
|
|
50
|
+
├── 02-strategic-principles.md # L2 战略原则(S1-S4)
|
|
51
|
+
├── 03-tactical-principles.md # L3 战术原则(T1-T6)
|
|
52
|
+
├── 04-operational-principles.md # L4 操作原则(O1-O4)
|
|
53
|
+
├── 05-domain-principles.md # 领域实践原则(DDD/系统/需求/编码/CR/知识管理)
|
|
54
|
+
├── 06-methodology-principles.md # 方法论原则(P1-P44)
|
|
55
|
+
├── 07-cognitive-principles.md # 认知增强原则(CP1-CP10)
|
|
56
|
+
├── 08-auto-fix-principles.md # 自主修复原则(实战经验提炼)
|
|
57
|
+
├── 09-constitution.md # 项目宪法(15 条红线,违反即停线)
|
|
58
|
+
└── 10-evolution-mechanism.md # 三层进化机制
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 核心原则文档
|
|
64
|
+
|
|
65
|
+
### 00-principles-hierarchy.md — 原则体系总纲
|
|
66
|
+
|
|
67
|
+
**内容**: 完整的 L1→L2→L3→L4 追溯链,原则应用矩阵,原则速查表
|
|
68
|
+
|
|
69
|
+
**核心章节**:
|
|
70
|
+
- 原则体系总览(L1→L2→L3→L4)
|
|
71
|
+
- 原则追溯链
|
|
72
|
+
- 原则应用矩阵(按阶段/按错误类型)
|
|
73
|
+
- 原则速查表
|
|
74
|
+
- 进化分区说明
|
|
75
|
+
|
|
76
|
+
**位置**: [00-principles-hierarchy.md](00-principles-hierarchy.md)
|
|
77
|
+
|
|
78
|
+
### 01-first-principles.md — L1 第一性原则
|
|
79
|
+
|
|
80
|
+
**内容**: AutoSpec 的"物理定律",所有上层原则都由此演绎而来
|
|
81
|
+
|
|
82
|
+
**核心章节**:
|
|
83
|
+
- P1 验证为王(Verification-First)
|
|
84
|
+
- P2 极简实用(Minimal Viable Process)
|
|
85
|
+
- P3 渐进自主(Progressive Autonomy)
|
|
86
|
+
- 核心设计模式(两步生成、渐进式披露、做审分离、Harness Engineering)
|
|
87
|
+
|
|
88
|
+
**位置**: [01-first-principles.md](01-first-principles.md)
|
|
89
|
+
|
|
90
|
+
### 02-strategic-principles.md — L2 战略原则
|
|
91
|
+
|
|
92
|
+
**内容**: 由第一性原则演绎而来的方向性指导原则
|
|
93
|
+
|
|
94
|
+
**核心章节**:
|
|
95
|
+
- S1 双层验证(Two-Layer Validation)
|
|
96
|
+
- S2 做审分离(Evaluator-Optimizer Separation)
|
|
97
|
+
- S3 Harness Engineering 三部曲
|
|
98
|
+
- S4 知情猜测(Informed Guessing)
|
|
99
|
+
|
|
100
|
+
**位置**: [02-strategic-principles.md](02-strategic-principles.md)
|
|
101
|
+
|
|
102
|
+
### 03-tactical-principles.md — L3 战术原则
|
|
103
|
+
|
|
104
|
+
**内容**: 由战略原则展开而来的执行策略指导原则
|
|
105
|
+
|
|
106
|
+
**核心章节**:
|
|
107
|
+
- T1 任务分解质量(ATOMIC 原则)
|
|
108
|
+
- T2 上下文精确管理
|
|
109
|
+
- T3 精准回退(Precision Rollback)
|
|
110
|
+
- T4 反模式预判(Anti-Pattern Inoculation)
|
|
111
|
+
- T5 驯服非确定性(Taming Non-Determinism)
|
|
112
|
+
- T6 优先复用项目现有能力
|
|
113
|
+
|
|
114
|
+
**位置**: [03-tactical-principles.md](03-tactical-principles.md)
|
|
115
|
+
|
|
116
|
+
### 04-operational-principles.md — L4 操作原则
|
|
117
|
+
|
|
118
|
+
**内容**: 战术原则的具体落地,包含明确的行为规范和检查清单
|
|
119
|
+
|
|
120
|
+
**核心章节**:
|
|
121
|
+
- O1 编码规范(Coding Style)
|
|
122
|
+
- O2 自主修复机制(Auto-Fix Loop)
|
|
123
|
+
- O3 宪法门禁(Constitution Gate)
|
|
124
|
+
- O4 检查清单(Checklists)
|
|
125
|
+
|
|
126
|
+
**位置**: [04-operational-principles.md](04-operational-principles.md)
|
|
127
|
+
|
|
128
|
+
### 05-domain-principles.md — 领域实践原则
|
|
129
|
+
|
|
130
|
+
**内容**: 从各领域实践中提炼的通用原则,指导具体领域的执行决策
|
|
131
|
+
|
|
132
|
+
**核心章节**:
|
|
133
|
+
- DDP1-4: DDD 战术设计原则
|
|
134
|
+
- SDP1-3: 系统设计原则
|
|
135
|
+
- REP1-4: 需求工程原则
|
|
136
|
+
- CEP1-6: 编码实践原则
|
|
137
|
+
- CRP1-5: Code Review 原则
|
|
138
|
+
- KMP1-4: 知识管理原则
|
|
139
|
+
|
|
140
|
+
**位置**: [05-domain-principles.md](05-domain-principles.md)
|
|
141
|
+
|
|
142
|
+
### 06-methodology-principles.md — 方法论原则
|
|
143
|
+
|
|
144
|
+
**内容**: 从知识和实践中提炼的通用原则(P1-P44)
|
|
145
|
+
|
|
146
|
+
**核心章节**:
|
|
147
|
+
- 思维原则(P1-P6, P30-P31)
|
|
148
|
+
- 设计原则(P7-P13, P32-P34)
|
|
149
|
+
- 产品与需求原则(P14-P18)
|
|
150
|
+
- 工程与质量原则(P19-P21)
|
|
151
|
+
- 治理与进化原则(P22-P29)
|
|
152
|
+
- 架构落地原则(P35-P44)
|
|
153
|
+
|
|
154
|
+
**位置**: [06-methodology-principles.md](06-methodology-principles.md)
|
|
155
|
+
|
|
156
|
+
### 07-cognitive-principles.md — 认知增强原则
|
|
157
|
+
|
|
158
|
+
**内容**: 提升 AI 在自动化研发流程中的认知智能水平(CP1-CP10)
|
|
159
|
+
|
|
160
|
+
**核心章节**:
|
|
161
|
+
- 协作姿态(CP1 合伙人模式、CP2 情境匹配)
|
|
162
|
+
- 认知纪律(CP3 先问后做、CP4 逻辑链完整、CP5 置信度标注)
|
|
163
|
+
- 错误与学习(CP6 错误即信号、CP7 模式识别)
|
|
164
|
+
- 偏航检测(CP8 三级偏航提醒)
|
|
165
|
+
- 产出质量(CP9 刚好够用、CP10 自我质检)
|
|
166
|
+
|
|
167
|
+
**位置**: [07-cognitive-principles.md](07-cognitive-principles.md)
|
|
168
|
+
|
|
169
|
+
### 08-auto-fix-principles.md — 自主修复原则
|
|
170
|
+
|
|
171
|
+
**内容**: 从自主修复机制实战中提炼的原则集合
|
|
172
|
+
|
|
173
|
+
**核心章节**:
|
|
174
|
+
- 核心洞察(3 条)
|
|
175
|
+
- 原则体系(AFP1-AFP6)
|
|
176
|
+
- 原则应用矩阵
|
|
177
|
+
- 原则检查清单
|
|
178
|
+
|
|
179
|
+
**位置**: [08-auto-fix-principles.md](08-auto-fix-principles.md)
|
|
180
|
+
|
|
181
|
+
### 09-constitution.md — 项目宪法
|
|
182
|
+
|
|
183
|
+
**内容**: 不可违反的红线清单,违反任何一条立即停止全流程
|
|
184
|
+
|
|
185
|
+
**核心章节**:
|
|
186
|
+
- 安全红线(#1-#3)
|
|
187
|
+
- 流程红线(#4-#9)
|
|
188
|
+
- 决策红线(#10-#11)
|
|
189
|
+
- 停线条件
|
|
190
|
+
- 自主修复机制
|
|
191
|
+
|
|
192
|
+
**位置**: [09-constitution.md](09-constitution.md)
|
|
193
|
+
|
|
194
|
+
### 10-evolution-mechanism.md — 自进化机制
|
|
195
|
+
|
|
196
|
+
**内容**: 三层自进化体系,从项目实践到框架升级的完整闭环
|
|
197
|
+
|
|
198
|
+
**核心章节**:
|
|
199
|
+
- L1: Self-Evolve(框架自我进化)
|
|
200
|
+
- L2: Field-Evolve(领域进化)
|
|
201
|
+
- L3: Project-Evolve(项目自我进化)
|
|
202
|
+
- 进化分区(冻结区/受控区/自由区)
|
|
203
|
+
- 安全护栏
|
|
204
|
+
|
|
205
|
+
**位置**: [10-evolution-mechanism.md](10-evolution-mechanism.md)
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
## 快速导航
|
|
210
|
+
|
|
211
|
+
### 按场景查找原则
|
|
212
|
+
|
|
213
|
+
| 场景 | 适用原则 | 位置 |
|
|
214
|
+
|------|---------|------|
|
|
215
|
+
| **遇到错误需要修复** | 自主修复原则、修复循环原则 | [08-auto-fix-principles.md](08-auto-fix-principles.md) |
|
|
216
|
+
| **编码实现** | 编码规范、SOLID 原则、CEP 系列 | [04-operational-principles.md](04-operational-principles.md#二 o1-编码规范-coding-style) |
|
|
217
|
+
| **代码审查** | 审查规范、检查清单、CRP 系列 | [05-domain-principles.md](05-domain-principles.md#五 code-review-原则) |
|
|
218
|
+
| **任务分解** | ATOMIC 原则、任务分解质量 | [03-tactical-principles.md](03-tactical-principles.md#二 t1-任务分解质量-atomic-原则) |
|
|
219
|
+
| **需求分析** | 结构化澄清协议、需求分层、REP 系列 | [05-domain-principles.md](05-domain-principles.md#三需求工程原则) |
|
|
220
|
+
| **方案设计** | 领域驱动设计、系统设计、DDP/SDP 系列 | [05-domain-principles.md](05-domain-principles.md#一 ddd-战术设计原则) |
|
|
221
|
+
| **安全红线** | 宪法门禁、停线条件 | [09-constitution.md](09-constitution.md) |
|
|
222
|
+
| **框架进化** | 三层进化体系 | [10-evolution-mechanism.md](10-evolution-mechanism.md) |
|
|
223
|
+
|
|
224
|
+
### 原则速查表
|
|
225
|
+
|
|
226
|
+
#### L1: 第一性原则(3 条)
|
|
227
|
+
|
|
228
|
+
| 原则 | 一句话 | 应用场景 |
|
|
229
|
+
|------|--------|---------|
|
|
230
|
+
| P1 验证为王 | 确定性验证 > AI 审查 > AI 自审 | 所有产出物验证 |
|
|
231
|
+
| P2 极简实用 | 能一个文件说清的不拆两个 | 知识管理、任务分解 |
|
|
232
|
+
| P3 渐进自主 | 从"人审每步"到"人只管 harness" | 自主决策边界 |
|
|
233
|
+
|
|
234
|
+
#### L2: 战略原则(4 条)
|
|
235
|
+
|
|
236
|
+
| 原则 | 一句话 | 应用场景 |
|
|
237
|
+
|------|--------|---------|
|
|
238
|
+
| S1 双层验证 | Layer 1 不过,不进 Layer 2 | 所有阶段完成前 |
|
|
239
|
+
| S2 做审分离 | 做和审由不同 AI 实例执行 | 审查任务启动 |
|
|
240
|
+
| S3 Harness 工程 | 不满意产出时,改 harness | 产出质量差时 |
|
|
241
|
+
| S4 知情猜测 | 最多 3 个 NEEDS CLARIFICATION | 需求歧义处理 |
|
|
242
|
+
|
|
243
|
+
#### L3: 战术原则(6 条)
|
|
244
|
+
|
|
245
|
+
| 原则 | 一句话 | 应用场景 |
|
|
246
|
+
|------|--------|---------|
|
|
247
|
+
| T1 任务分解 | ATOMIC 原则,2-4 小时粒度 | 任务拆解 |
|
|
248
|
+
| T2 上下文管理 | 热/温/冷分层,按需加载 | 知识加载 |
|
|
249
|
+
| T3 精准回退 | 只重处理失败项,不全量重做 | 修复循环 |
|
|
250
|
+
| T4 反模式预判 | 堵死 6 种捷径路径 | skill 设计 |
|
|
251
|
+
| T5 驯服非确定性 | 四道防线,假设管理 | 关键决策 |
|
|
252
|
+
| T6 优先复用 | 先搜索后实现,禁止硬编码 | 编码/修复 |
|
|
253
|
+
|
|
254
|
+
#### L4: 操作原则(4 条)
|
|
255
|
+
|
|
256
|
+
| 原则 | 一句话 | 应用场景 |
|
|
257
|
+
|------|--------|---------|
|
|
258
|
+
| O1 编码规范 | SOLID+DDD,一锁二判三更新 | 代码编写 |
|
|
259
|
+
| O2 自主修复 | 分析→决策→执行→验证,最多 3 次 | 错误处理 |
|
|
260
|
+
| O3 宪法门禁 | 15 条红线,违反即停线 | 全流程 |
|
|
261
|
+
| O4 检查清单 | 5 阶段清单,嵌入式自检 | 阶段完成 |
|
|
262
|
+
|
|
263
|
+
---
|
|
264
|
+
|
|
265
|
+
## 原则追溯链示例
|
|
266
|
+
|
|
267
|
+
**场景**: 遇到 Maven 依赖缺失错误
|
|
268
|
+
|
|
269
|
+
```
|
|
270
|
+
错误发生
|
|
271
|
+
↓
|
|
272
|
+
L4-O2 自主修复机制 → 错误分类(依赖类)
|
|
273
|
+
↓
|
|
274
|
+
L3-T6 优先复用项目现有能力 → 扫描现有 pom.xml
|
|
275
|
+
↓
|
|
276
|
+
L3-T3 精准回退 → Level 2 修正循环
|
|
277
|
+
↓
|
|
278
|
+
L2-S1 双层验证 → 重新执行原命令验证
|
|
279
|
+
↓
|
|
280
|
+
L1-P1 验证为王 → 验证结果通过
|
|
281
|
+
↓
|
|
282
|
+
记录 practice-log → L3-进化机制
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
**场景**: 需求歧义需要澄清
|
|
286
|
+
|
|
287
|
+
```
|
|
288
|
+
需求歧义识别
|
|
289
|
+
↓
|
|
290
|
+
L2-S4 知情猜测 > 无限提问 → 做合理默认 + 标记
|
|
291
|
+
↓
|
|
292
|
+
L3-T5 驯服非确定性 → 防线 2 锚定一致性
|
|
293
|
+
↓
|
|
294
|
+
L2-宪法#11 → 最多 3 个 NEEDS CLARIFICATION
|
|
295
|
+
↓
|
|
296
|
+
L3-T4 反模式预判 → 防止假设漂移
|
|
297
|
+
↓
|
|
298
|
+
L4-templates → 写入需求文档
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
完整追溯链:[00-principles-hierarchy.md](00-principles-hierarchy.md)
|
|
302
|
+
|
|
303
|
+
---
|
|
304
|
+
|
|
305
|
+
## 进化分区说明
|
|
306
|
+
|
|
307
|
+
| 分区 | 说明 | 变更方式 |
|
|
308
|
+
|------|------|---------|
|
|
309
|
+
| 🔴 **冻结区** | 宪法、进化规则、核心原则、设计哲学 | 人工变更,需经过完整的 review 流程 |
|
|
310
|
+
| 🟡 **受控区** | 流程定义、通用 skills、检查清单、编码规范 | 自动提议 + 人工批准 |
|
|
311
|
+
| 🟢 **自由区** | domain skills、benchmarks、支撑技能 | 自动进化 + validator 验证 |
|
|
312
|
+
| 🔵 **环境知识区** | 中间件、组件、集成知识 | 项目级自动优化 |
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
316
|
+
## 与相关文档的映射关系
|
|
317
|
+
|
|
318
|
+
| 本文档章节 | 对应文档 | 说明 |
|
|
319
|
+
|-----------|---------|------|
|
|
320
|
+
| L1 第一性原则 | [01-first-principles.md](01-first-principles.md) | 三棱锥 P1/P2/P3 |
|
|
321
|
+
| L2 战略原则 | [02-strategic-principles.md](02-strategic-principles.md) | S1-S4 |
|
|
322
|
+
| L3 战术原则 | [03-tactical-principles.md](03-tactical-principles.md) | T1-T6 |
|
|
323
|
+
| L4 操作原则 | [04-operational-principles.md](04-operational-principles.md) | O1-O4 |
|
|
324
|
+
| 领域原则 | [05-domain-principles.md](05-domain-principles.md) | DDP/SDP/REP/CEP/CRP/KMP |
|
|
325
|
+
| 方法论原则 | [06-methodology-principles.md](06-methodology-principles.md) | P1-P44 |
|
|
326
|
+
| 认知增强原则 | [07-cognitive-principles.md](07-cognitive-principles.md) | CP1-CP10 |
|
|
327
|
+
| 自主修复原则 | [08-auto-fix-principles.md](08-auto-fix-principles.md) | AFP1-AFP6 |
|
|
328
|
+
| 项目宪法 | [09-constitution.md](09-constitution.md) | 15 条红线 |
|
|
329
|
+
| 进化机制 | [10-evolution-mechanism.md](10-evolution-mechanism.md) | 三层自进化体系 |
|
|
330
|
+
|
|
331
|
+
---
|
|
332
|
+
|
|
333
|
+
## 使用指南
|
|
334
|
+
|
|
335
|
+
### 快速定位原则
|
|
336
|
+
|
|
337
|
+
**场景**: 遇到 X 问题,应该遵循什么原则?
|
|
338
|
+
|
|
339
|
+
1. 识别问题类型(验证/自主/知识/修复/...)
|
|
340
|
+
2. 查本节原则速查表
|
|
341
|
+
3. 追溯上游原则(理解为什么)
|
|
342
|
+
4. 查看下游操作规范(知道怎么做)
|
|
343
|
+
|
|
344
|
+
**示例**:
|
|
345
|
+
```
|
|
346
|
+
问题:"AI 总是重复造轮子,不扫描现有代码"
|
|
347
|
+
→ 问题类型:知识管理/复用
|
|
348
|
+
→ 速查表:T6 优先复用项目现有能力
|
|
349
|
+
→ 上游原则:P2 极简实用、S3 Harness Engineering
|
|
350
|
+
→ 下游操作:04-operational-principles.md 编码规范、08-auto-fix-principles.md AFP3
|
|
351
|
+
```
|
|
352
|
+
|
|
353
|
+
### 原则应用检查点
|
|
354
|
+
|
|
355
|
+
**执行任务前**:
|
|
356
|
+
- [ ] 已读取本文档,理解相关原则
|
|
357
|
+
- [ ] 已识别任务类型和适用原则
|
|
358
|
+
- [ ] 已准备好必要的知识(热层/温层)
|
|
359
|
+
|
|
360
|
+
**执行任务中**:
|
|
361
|
+
- [ ] 遵循 ATOMIC 原则分解任务
|
|
362
|
+
- [ ] 遵循知情猜测原则(最多 3 个不确定项)
|
|
363
|
+
- [ ] 遵循做审分离原则(审查启动独立 Agent)
|
|
364
|
+
|
|
365
|
+
**执行任务后**:
|
|
366
|
+
- [ ] 遵循双层验证原则(Layer 1+Layer 2)
|
|
367
|
+
- [ ] 遵循检查清单原则(阶段自检)
|
|
368
|
+
- [ ] 遵循实践日志原则(记录经验)
|
|
369
|
+
|
|
370
|
+
---
|
|
371
|
+
|
|
372
|
+
**维护者**: AutoSpec 团队
|
|
373
|
+
**反馈渠道**: 知识库 Git 仓库 Issue
|
|
374
|
+
**关联文档**:
|
|
375
|
+
- [原则体系总纲](00-principles-hierarchy.md)
|
|
376
|
+
- [L1 第一性原则](01-first-principles.md)
|
|
377
|
+
- [L2 战略原则](02-strategic-principles.md)
|
|
378
|
+
- [L3 战术原则](03-tactical-principles.md)
|
|
379
|
+
- [L4 操作原则](04-operational-principles.md)
|
|
380
|
+
- [领域实践原则](05-domain-principles.md)
|
|
381
|
+
- [方法论原则](06-methodology-principles.md)
|
|
382
|
+
- [认知增强原则](07-cognitive-principles.md)
|
|
383
|
+
- [自主修复原则](08-auto-fix-principles.md)
|
|
384
|
+
- [项目宪法](09-constitution.md)
|
|
385
|
+
- [自进化机制](10-evolution-mechanism.md)
|
|
@@ -7,10 +7,20 @@
|
|
|
7
7
|
| **交互模式** | 普通运行、单阶段命令 | 有人值守,可询问用户 | 允许阻塞等待用户输入 |
|
|
8
8
|
| **自动模式** | `/autospec:run` | 无人值守,全自动执行 | **禁止阻塞**,必须自动决策或记录待办 |
|
|
9
9
|
|
|
10
|
+
**【强制】** 执行模式必须持久化到 state.json:
|
|
11
|
+
|
|
12
|
+
| 命令 | 执行模式 | executionMode 值 |
|
|
13
|
+
|------|---------|-----------------|
|
|
14
|
+
| `/autospec:run` | 自主模式 | `autonomous` |
|
|
15
|
+
| `/autospec:explore` | 交互模式 | `interactive` |
|
|
16
|
+
| `/autospec:propose` | 交互模式 | `interactive` |
|
|
17
|
+
| `/autospec:apply` | 交互模式 | `interactive` |
|
|
18
|
+
|
|
10
19
|
**核心原则**:
|
|
11
20
|
- 自动模式下,所有"需要用户确认"的场景 → 使用推荐值 + 记录 `pendingConfirmations`
|
|
12
21
|
- 交互模式下,利用 AskUserQuestion 批处理提升效率(收集所有歧义一次性提问)
|
|
13
22
|
- 同一套阶段逻辑,通过模式开关控制行为
|
|
23
|
+
- **自主模式完成后自动触发下一阶段,无需用户确认**
|
|
14
24
|
|
|
15
25
|
### 执行模式
|
|
16
26
|
|
|
@@ -140,7 +150,21 @@ Level 3: 使用 failure-diagnostician Agent 执行根因分析 → 升级人工
|
|
|
140
150
|
| **waterfall** | 需求→设计→实现(含自测)→审查→QA测试→部署 | 完整6阶段 | 新功能开发 |
|
|
141
151
|
| **agile** | 需求(拆故事)→[设计→实现→审查]×N→集成测试→部署 | 故事驱动循环 | 迭代开发、用户故事驱动 |
|
|
142
152
|
| **experiment** | 需求→设计→原型+效果评测 | AI实验验证 | 技术探索、AI/ML |
|
|
143
|
-
| **hotfix** |
|
|
153
|
+
| **hotfix** | 需求→风险评估→实现(含自测)→审查→部署 | 快速通道 | 紧急修复 |
|
|
154
|
+
|
|
155
|
+
### Waterfall(瀑布迭代)模式说明
|
|
156
|
+
|
|
157
|
+
```
|
|
158
|
+
需求分析 → 方案设计 → 编码实现 → 代码审查 → QA测试 → 交付部署
|
|
159
|
+
│ │ │ │ │ │
|
|
160
|
+
▼ ▼ ▼ ▼ ▼ ▼
|
|
161
|
+
双层验证 双层验证 双层验证 双层验证 双层验证 双层验证
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
- 完整6阶段顺序执行
|
|
165
|
+
- 每阶段必须通过双层验证才能进入下一阶段
|
|
166
|
+
- 阶段间传递精炼契约
|
|
167
|
+
- 适合新功能开发、大型变更
|
|
144
168
|
|
|
145
169
|
### Agile(敏捷迭代)模式说明
|
|
146
170
|
|
|
@@ -149,7 +173,7 @@ Level 3: 使用 failure-diagnostician Agent 执行根因分析 → 升级人工
|
|
|
149
173
|
│
|
|
150
174
|
▼ 对每个故事循环:
|
|
151
175
|
┌─────────────────────────────┐
|
|
152
|
-
│ 方案设计 → 编码实现 → 代码审查 │ ←
|
|
176
|
+
│ 方案设计 → 编码实现 → 代码审查 │ ← 小循环,快速验证
|
|
153
177
|
└─────────────────────────────┘
|
|
154
178
|
│
|
|
155
179
|
▼ 所有故事完成后:
|
|
@@ -157,9 +181,70 @@ Level 3: 使用 failure-diagnostician Agent 执行根因分析 → 升级人工
|
|
|
157
181
|
```
|
|
158
182
|
|
|
159
183
|
- 需求阶段产出用户故事列表,每个故事有验收标准
|
|
160
|
-
-
|
|
161
|
-
-
|
|
162
|
-
-
|
|
184
|
+
- 设计→编码→审查是每个故事的小循环
|
|
185
|
+
- 每个小循环使用**快速验证**(编译 + 单元测试 + Lint)
|
|
186
|
+
- 所有故事完成后使用**完整验证**
|
|
187
|
+
- 支持并行执行(用户可选择)
|
|
188
|
+
- 默认顺序执行,带冲突检测
|
|
189
|
+
|
|
190
|
+
### Experiment(实验模式)模式说明
|
|
191
|
+
|
|
192
|
+
```
|
|
193
|
+
需求分析(含假设定义)
|
|
194
|
+
│
|
|
195
|
+
▼
|
|
196
|
+
实验设计(含评测方案)
|
|
197
|
+
│
|
|
198
|
+
▼
|
|
199
|
+
原型实现(最小可行)
|
|
200
|
+
│
|
|
201
|
+
▼
|
|
202
|
+
效果评测
|
|
203
|
+
│
|
|
204
|
+
├─ 达标 → 交付(简化)
|
|
205
|
+
│
|
|
206
|
+
└─ 未达标 → 假设分析 → 迭代或终止
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
- 需求阶段产出假设清单
|
|
210
|
+
- 设计阶段产出评测方案
|
|
211
|
+
- 原型阶段轻量化实现
|
|
212
|
+
- 效果评测自动触发
|
|
213
|
+
- 迭代次数根据复杂度动态调整:
|
|
214
|
+
- 简单实验:最多3次
|
|
215
|
+
- 中等实验:最多5次
|
|
216
|
+
- 复杂实验:最多10次
|
|
217
|
+
|
|
218
|
+
### Hotfix(热修复)模式说明
|
|
219
|
+
|
|
220
|
+
```
|
|
221
|
+
问题诊断(快速定位)
|
|
222
|
+
│
|
|
223
|
+
▼
|
|
224
|
+
风险评估
|
|
225
|
+
│
|
|
226
|
+
├─ 高风险 → 提示用户选择(升级瀑布/继续热修复)
|
|
227
|
+
│
|
|
228
|
+
└─ 低风险 → 继续
|
|
229
|
+
│
|
|
230
|
+
▼
|
|
231
|
+
快速编码(最小变更)
|
|
232
|
+
│
|
|
233
|
+
▼
|
|
234
|
+
快速审查(自动化)
|
|
235
|
+
│
|
|
236
|
+
▼
|
|
237
|
+
快速验证(精简)
|
|
238
|
+
│
|
|
239
|
+
▼
|
|
240
|
+
快速部署
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
- 问题诊断快速定位根因
|
|
244
|
+
- 风险评估:检测风险因素,高风险提示用户选择
|
|
245
|
+
- 变更控制:最大5文件/100行,禁止变更敏感目录
|
|
246
|
+
- 最小化验证:编译 + 受影响测试
|
|
247
|
+
- 适合紧急修复
|
|
163
248
|
|
|
164
249
|
## 标准化产物结构(DP16)
|
|
165
250
|
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# Process Layer
|
|
2
|
+
|
|
3
|
+
> **Purpose**: Product development process definition, covering 6-stage execution flow
|
|
4
|
+
>
|
|
5
|
+
> **Evolution Zone**: 🟡 Controlled (Auto-proposed + Human-approved)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Directory Structure
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
02-process/
|
|
13
|
+
├── README.md # This file (Process Navigation)
|
|
14
|
+
├── 00-overview.md # Process Overview
|
|
15
|
+
├── 01-requirement.md # Requirement Analysis Stage
|
|
16
|
+
├── 02-design.md # Solution Design Stage
|
|
17
|
+
├── 03-implementation.md # Implementation Stage
|
|
18
|
+
├── 04-review.md # Code Review Stage
|
|
19
|
+
├── 05-testing.md # QA Testing Stage
|
|
20
|
+
└── 06-delivery.md # Delivery Stage
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Process Description
|
|
26
|
+
|
|
27
|
+
### 00-overview.md — Process Overview
|
|
28
|
+
|
|
29
|
+
**Content**: Development process overview, startup gate, execution modes
|
|
30
|
+
|
|
31
|
+
**Core Chapters**:
|
|
32
|
+
- 6-Stage Process Framework
|
|
33
|
+
- Startup Gate Rules
|
|
34
|
+
- Execution Modes (Autonomous / Interactive)
|
|
35
|
+
- Iteration Modes (Waterfall / Agile / Experiment / Hotfix)
|
|
36
|
+
|
|
37
|
+
**Location**: [00-overview.md](00-overview.md)
|
|
38
|
+
|
|
39
|
+
### 01-requirement.md — Requirement Analysis Stage
|
|
40
|
+
|
|
41
|
+
**Content**: Execution guide for Requirement Analysis stage
|
|
42
|
+
|
|
43
|
+
**Core Chapters**:
|
|
44
|
+
- Requirement Exploration & Clarification
|
|
45
|
+
- Requirement Structuring
|
|
46
|
+
- Acceptance Criteria Definition
|
|
47
|
+
- Requirement Checklist
|
|
48
|
+
|
|
49
|
+
**Location**: [01-requirement.md](01-requirement.md)
|
|
50
|
+
|
|
51
|
+
### 02-design.md — Solution Design Stage
|
|
52
|
+
|
|
53
|
+
**Content**: Execution guide for Solution Design stage
|
|
54
|
+
|
|
55
|
+
**Core Chapters**:
|
|
56
|
+
- Architecture Design
|
|
57
|
+
- API Design
|
|
58
|
+
- Data Model Design
|
|
59
|
+
- Technology Selection
|
|
60
|
+
- Design Checklist
|
|
61
|
+
|
|
62
|
+
**Location**: [02-design.md](02-design.md)
|
|
63
|
+
|
|
64
|
+
### 03-implementation.md — Implementation Stage
|
|
65
|
+
|
|
66
|
+
**Content**: Execution guide for Implementation stage
|
|
67
|
+
|
|
68
|
+
**Core Chapters**:
|
|
69
|
+
- Coding Standards
|
|
70
|
+
- Layer 1 Validation
|
|
71
|
+
- Data Safety Practices
|
|
72
|
+
- Implementation Checklist
|
|
73
|
+
|
|
74
|
+
**Location**: [03-implementation.md](03-implementation.md)
|
|
75
|
+
|
|
76
|
+
### 04-review.md — Code Review Stage
|
|
77
|
+
|
|
78
|
+
**Content**: Execution guide for Code Review stage
|
|
79
|
+
|
|
80
|
+
**Core Chapters**:
|
|
81
|
+
- Review Process
|
|
82
|
+
- Review Dimensions (Architecture/Security/Performance/Maintainability/Logic)
|
|
83
|
+
- Review Comment Format
|
|
84
|
+
- Review Pass Criteria
|
|
85
|
+
|
|
86
|
+
**Location**: [04-review.md](04-review.md)
|
|
87
|
+
|
|
88
|
+
### 05-testing.md — QA Testing Stage
|
|
89
|
+
|
|
90
|
+
**Content**: Execution guide for QA Testing stage
|
|
91
|
+
|
|
92
|
+
**Core Chapters**:
|
|
93
|
+
- Testing Strategy
|
|
94
|
+
- Test Case Design
|
|
95
|
+
- Integration Testing
|
|
96
|
+
- E2E Testing
|
|
97
|
+
- Testing Checklist
|
|
98
|
+
|
|
99
|
+
**Location**: [05-testing.md](05-testing.md)
|
|
100
|
+
|
|
101
|
+
### 06-delivery.md — Delivery Stage
|
|
102
|
+
|
|
103
|
+
**Content**: Execution guide for Delivery stage
|
|
104
|
+
|
|
105
|
+
**Core Chapters**:
|
|
106
|
+
- Pre-release Check
|
|
107
|
+
- Deployment Process
|
|
108
|
+
- Rollback Plan
|
|
109
|
+
- Monitoring & Alerting
|
|
110
|
+
- Release Checklist
|
|
111
|
+
|
|
112
|
+
**Location**: [06-delivery.md](06-delivery.md)
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## Usage
|
|
117
|
+
|
|
118
|
+
Process files are applied in the following scenarios:
|
|
119
|
+
|
|
120
|
+
1. **Start New Task**: Read `00-overview.md` to confirm startup gate
|
|
121
|
+
2. **Requirement Analysis**: Follow `01-requirement.md`
|
|
122
|
+
3. **Solution Design**: Follow `02-design.md`
|
|
123
|
+
4. **Implementation**: Follow `03-implementation.md`
|
|
124
|
+
5. **Code Review**: Follow `04-review.md`
|
|
125
|
+
6. **Testing**: Follow `05-testing.md`
|
|
126
|
+
7. **Delivery**: Follow `06-delivery.md`
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## Related Documents
|
|
131
|
+
|
|
132
|
+
| Document | Description |
|
|
133
|
+
|----------|-------------|
|
|
134
|
+
| [../01-principles/](../01-principles/) | Principles Layer (Basis for process design) |
|
|
135
|
+
| [../03-guides/](../03-guides/) | Capability Guides (Detailed skills for stage execution) |
|
|
136
|
+
| [../04-checklists/](../04-checklists/) | Checklists (Self-check items before stage completion) |
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
**Maintainer**: AutoSpec Team
|
|
141
|
+
**Evolution Zone**: 🟡 Controlled
|
|
142
|
+
**Version**: v1.0
|
|
143
|
+
**Last Updated**: 2026-03-27
|