@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
|
@@ -11,6 +11,10 @@ environment/
|
|
|
11
11
|
└── detection-patterns.yaml # Detection pattern configuration
|
|
12
12
|
```
|
|
13
13
|
|
|
14
|
+
> **Note**: Middleware and component knowledge templates have been integrated into `09-templates/`:
|
|
15
|
+
> - [09-templates/13-middleware-knowledge.md](../09-templates/13-middleware-knowledge.md)
|
|
16
|
+
> - [09-templates/10-component-knowledge.md](../09-templates/10-component-knowledge.md)
|
|
17
|
+
|
|
14
18
|
## Core Features
|
|
15
19
|
|
|
16
20
|
### Auto Detection
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
# 环境衔接协议
|
|
2
2
|
|
|
3
|
-
> 让 AutoSpec
|
|
3
|
+
> **定位**: 让 AutoSpec 能够快捷地与不同组织的中间件、组件、自定义框架、集成环境等稳定安全高效衔接
|
|
4
|
+
>
|
|
5
|
+
> **进化分区**: 🔵 环境知识区
|
|
6
|
+
|
|
7
|
+
---
|
|
4
8
|
|
|
5
9
|
## 核心概念
|
|
6
10
|
|
|
@@ -30,36 +34,50 @@ Layer 3: Integration Knowledge(集成知识)
|
|
|
30
34
|
| 环境知识 | 受控区 | 人工定义 + 自动验证 |
|
|
31
35
|
| 组件知识 | 自由区 | 自动进化 + validator 验证 |
|
|
32
36
|
| 集成知识 | 受控区 | 人工定义 + 自动执行 |
|
|
33
|
-
| 测试知识 | 受控区 |
|
|
37
|
+
| 测试知识 | 受控区 | field-evolve-distiller 自动学习 + 人工审批 |
|
|
38
|
+
|
|
39
|
+
---
|
|
34
40
|
|
|
35
41
|
## 目录结构
|
|
36
42
|
|
|
37
43
|
```
|
|
38
|
-
|
|
39
|
-
├──
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
│ └── env-variables/ # 环境变量模板
|
|
43
|
-
│
|
|
44
|
-
├── component-lib/ # 组件知识库
|
|
45
|
-
│ ├── components/ # 组织组件库(auth/, payment/)
|
|
46
|
-
│ ├── best-practices/ # 最佳实践
|
|
47
|
-
│ └── domain-models/ # 领域模型
|
|
48
|
-
│
|
|
49
|
-
├── integration/ # 集成知识
|
|
50
|
-
│ ├── ci-cd/ # CI/CD 配置
|
|
51
|
-
│ ├── testing/ # 测试知识(自进化)
|
|
52
|
-
│ │ └── overview.md # 集成测试概述
|
|
53
|
-
│ └── deployment/ # 部署配置
|
|
54
|
-
│
|
|
55
|
-
├── detection-patterns.yaml # 自定义检测模式(可选)
|
|
56
|
-
└── registry.json # 知识注册表
|
|
44
|
+
06-environment/
|
|
45
|
+
├── README.md # 本文件(环境衔接协议)
|
|
46
|
+
├── 00-template-registry.md # 模板注册表
|
|
47
|
+
└── 01-detection-patterns.yaml # 检测模式配置
|
|
57
48
|
```
|
|
58
49
|
|
|
50
|
+
> **注意**: 中间件和组件知识模板已整合到 `09-templates/` 目录:
|
|
51
|
+
> - [09-templates/13-middleware-knowledge.md](../09-templates/13-middleware-knowledge.md)
|
|
52
|
+
> - [09-templates/10-component-knowledge.md](../09-templates/10-component-knowledge.md)
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
59
56
|
## 知识模板
|
|
60
57
|
|
|
61
|
-
|
|
62
|
-
|
|
58
|
+
### 00-template-registry.md — 模板注册表
|
|
59
|
+
|
|
60
|
+
**内容**: 环境知识模板注册表
|
|
61
|
+
|
|
62
|
+
**核心章节**:
|
|
63
|
+
- 模板列表
|
|
64
|
+
- 模板使用说明
|
|
65
|
+
- 模板更新记录
|
|
66
|
+
|
|
67
|
+
**位置**: [00-template-registry.md](00-template-registry.md)
|
|
68
|
+
|
|
69
|
+
### 01-detection-patterns.yaml — 检测模式配置
|
|
70
|
+
|
|
71
|
+
**内容**: 自定义环境检测模式
|
|
72
|
+
|
|
73
|
+
**核心配置**:
|
|
74
|
+
- 检测规则
|
|
75
|
+
- 检测条件
|
|
76
|
+
- 检测动作
|
|
77
|
+
|
|
78
|
+
**位置**: [01-detection-patterns.yaml](01-detection-patterns.yaml)
|
|
79
|
+
|
|
80
|
+
---
|
|
63
81
|
|
|
64
82
|
## CLI 命令
|
|
65
83
|
|
|
@@ -73,6 +91,8 @@ Layer 3: Integration Knowledge(集成知识)
|
|
|
73
91
|
| `autospec component` | 列出可用的组织组件 |
|
|
74
92
|
| `autospec component:add <name>` | 添加组件知识 |
|
|
75
93
|
|
|
94
|
+
---
|
|
95
|
+
|
|
76
96
|
## 自动检测机制
|
|
77
97
|
|
|
78
98
|
`autospec init` 会自动扫描项目代码,检测:
|
|
@@ -83,5 +103,26 @@ Layer 3: Integration Knowledge(集成知识)
|
|
|
83
103
|
|
|
84
104
|
检测到后会自动:
|
|
85
105
|
- 生成环境知识配置
|
|
86
|
-
- 注册到 registry
|
|
87
|
-
- 激活知识(后续流程自动注入上下文)
|
|
106
|
+
- 注册到 template-registry
|
|
107
|
+
- 激活知识(后续流程自动注入上下文)
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## 与相关文档的关系
|
|
112
|
+
|
|
113
|
+
| 文档 | 说明 |
|
|
114
|
+
|------|------|
|
|
115
|
+
| [../05-config/](../05-config/) | 配置文件(验证模式) |
|
|
116
|
+
| [../03-guides/](../03-guides/) | 能力指南(环境相关技能) |
|
|
117
|
+
| [../02-process/03-implementation.md](../02-process/03-implementation.md) | 编码实现阶段(环境检测) |
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
**维护者**: AutoSpec 团队
|
|
122
|
+
**进化分区**: 🔵 环境知识区
|
|
123
|
+
**版本**: v1.1
|
|
124
|
+
**最后更新**: 2026-03-28
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
⬆️ [返回知识层目录](../README.md) · 🌍 [环境知识总览](#)
|
|
@@ -1,14 +1,15 @@
|
|
|
1
1
|
# 通用编码规范
|
|
2
2
|
|
|
3
|
-
> **版本**: v1.
|
|
4
|
-
> **最后更新**: 2026-03-
|
|
3
|
+
> **版本**: v1.1
|
|
4
|
+
> **最后更新**: 2026-03-27
|
|
5
5
|
> **适用范围**: 所有 Java/后端项目
|
|
6
|
-
> **设计原则**:
|
|
6
|
+
> **设计原则**: 安全第一、可读性优先、预防为主、复用优先
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
## 📑 目录
|
|
11
11
|
|
|
12
|
+
0. [复用优先与禁止硬编码](#0-复用优先与禁止硬编码)
|
|
12
13
|
1. [数据安全](#1-数据安全)
|
|
13
14
|
2. [异常处理](#2-异常处理)
|
|
14
15
|
3. [多线程](#3-多线程)
|
|
@@ -23,6 +24,124 @@
|
|
|
23
24
|
|
|
24
25
|
---
|
|
25
26
|
|
|
27
|
+
## 0. 复用优先与禁止硬编码
|
|
28
|
+
|
|
29
|
+
### 0.1 优先复用项目现有能力
|
|
30
|
+
|
|
31
|
+
**说明**: 在实现任何功能或修复问题时,必须先扫描项目已有的框架、工具类、组件。
|
|
32
|
+
|
|
33
|
+
**强制要求**:
|
|
34
|
+
- 实现前先搜索代码库,查找是否有类似实现
|
|
35
|
+
- 优先使用项目已有的 AOP 框架、Helper 工具、Util 类
|
|
36
|
+
- 按已有代码的模式和风格实现新功能
|
|
37
|
+
- 绝不重复造轮子
|
|
38
|
+
|
|
39
|
+
**错误示例**:
|
|
40
|
+
```java
|
|
41
|
+
// ❌ 项目已有 TracingHelper,却自己新建埋点类
|
|
42
|
+
public class MyTracingHelper {
|
|
43
|
+
// 重复实现埋点逻辑
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// ❌ 项目已有 LogUtil,却直接使用 logger
|
|
47
|
+
private static final Logger logger = LoggerFactory.getLogger(Xxx.class);
|
|
48
|
+
logger.info("xxx"); // 没有 TraceId,无法链路追踪
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
**正确示例**:
|
|
52
|
+
```java
|
|
53
|
+
// ✅ 复用项目已有的 TracingHelper
|
|
54
|
+
@Autowired
|
|
55
|
+
private TracingHelper tracingHelper;
|
|
56
|
+
|
|
57
|
+
// ✅ 使用项目已有的 LogUtil(带 TraceId)
|
|
58
|
+
LogUtil.info("key", "value");
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### 0.2 禁止硬编码
|
|
62
|
+
|
|
63
|
+
**说明**: 不可在代码中硬编码目录名、包名、类名、配置项等。
|
|
64
|
+
|
|
65
|
+
**强制要求**:
|
|
66
|
+
- 路径配置从配置文件或环境知识中读取
|
|
67
|
+
- 技术栈信息从项目文件中动态识别
|
|
68
|
+
- 支持不同项目的差异化配置
|
|
69
|
+
|
|
70
|
+
**错误示例**:
|
|
71
|
+
```java
|
|
72
|
+
// ❌ 硬编码路径
|
|
73
|
+
String configPath = "/home/user/projects/myapp/config/";
|
|
74
|
+
|
|
75
|
+
// ❌ 硬编码包名
|
|
76
|
+
String basePackage = "com.example.myapp.service";
|
|
77
|
+
|
|
78
|
+
// ❌ 硬编码文件名
|
|
79
|
+
String pomFile = "backend/service/pom.xml";
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
**正确示例**:
|
|
83
|
+
```java
|
|
84
|
+
// ✅ 从配置文件读取
|
|
85
|
+
@Value("${app.config.path}")
|
|
86
|
+
private String configPath;
|
|
87
|
+
|
|
88
|
+
// ✅ 动态扫描识别
|
|
89
|
+
File projectRoot = findProjectRoot();
|
|
90
|
+
List<String> pomFiles = scanForPattern(projectRoot, "**/pom.xml");
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### 0.3 设计原则约束
|
|
94
|
+
|
|
95
|
+
自主修复场景下,必须遵循以下面向对象设计原则:
|
|
96
|
+
|
|
97
|
+
**单一职责原则 (SRP)**:
|
|
98
|
+
- 每个类/方法只负责一项职责
|
|
99
|
+
- 修复代码不创建"上帝类"或"万能方法"
|
|
100
|
+
- 职责单一便于维护、测试和复用
|
|
101
|
+
|
|
102
|
+
**开闭原则 (OCP)**:
|
|
103
|
+
- 对扩展开放,对修改关闭
|
|
104
|
+
- 新增功能通过扩展实现,不修改已有核心代码
|
|
105
|
+
- 通过接口或抽象类约束扩展边界
|
|
106
|
+
|
|
107
|
+
**里氏替换原则 (LSP)**:
|
|
108
|
+
- 子类必须能够替换其父类,程序行为不变
|
|
109
|
+
- 继承必须确保合理,不破坏继承体系
|
|
110
|
+
- 避免滥用继承,优先考虑组合
|
|
111
|
+
|
|
112
|
+
**依赖倒置原则 (DIP)**:
|
|
113
|
+
- 面向接口编程,不依赖具体实现
|
|
114
|
+
- 高层模块和低层模块都依赖抽象
|
|
115
|
+
- 通过构造函数注入、setter 注入实现依赖注入
|
|
116
|
+
|
|
117
|
+
**接口隔离原则 (ISP)**:
|
|
118
|
+
- 使用多个专门的接口,不使用单一的总接口
|
|
119
|
+
- 将臃肿庞大的接口分解为多个独立的较小接口
|
|
120
|
+
- 客户端不应该依赖它不需要的接口
|
|
121
|
+
|
|
122
|
+
**迪米特法则 (最少知道原则)**:
|
|
123
|
+
- 一个对象应该对其他对象有最少的了解
|
|
124
|
+
- 只与直接的朋友通信,不与"陌生人"交谈
|
|
125
|
+
- 降低类与类之间的耦合
|
|
126
|
+
|
|
127
|
+
**合成/复用原则**:
|
|
128
|
+
- 优先使用组合/聚合,其次才是继承
|
|
129
|
+
- 组合复用比继承复用更灵活,耦合度更低
|
|
130
|
+
|
|
131
|
+
**高内聚低耦合**:
|
|
132
|
+
- 模块内部元素应紧密相关(高内聚)
|
|
133
|
+
- 模块之间依赖应尽可能少(低耦合)
|
|
134
|
+
- 变化点必须封装隔离(面向变化设计)
|
|
135
|
+
|
|
136
|
+
**AOP 优先**:
|
|
137
|
+
- 涉及跨切面功能(日志、埋点、鉴权、事务等)时,优先使用 AOP 切面方式
|
|
138
|
+
- 禁止侵入业务代码,通过切面增强实现
|
|
139
|
+
- 保持核心业务逻辑的纯净性
|
|
140
|
+
|
|
141
|
+
> 详细说明和代码示例见:[第 11 节 面向对象设计原则](#11-面向对象设计原则)
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
26
145
|
## 1. 数据安全
|
|
27
146
|
|
|
28
147
|
### 1.1 更新数据前必须加锁(一锁二判三更新)
|
|
@@ -937,4 +1056,4 @@ public class OrderService {
|
|
|
937
1056
|
|
|
938
1057
|
**维护者**: AutoSpec 团队
|
|
939
1058
|
**反馈渠道**: 知识库 Git 仓库 Issue
|
|
940
|
-
**关联文档**: `knowledge/standards/data-consistency.md`, `knowledge/standards/code-review.md`
|
|
1059
|
+
**关联文档**: `knowledge/07-standards/02-data-consistency.md`, `knowledge/07-standards/01-code-review.md`
|
|
@@ -690,15 +690,15 @@ refactor(user): extract user validation logic to separate class
|
|
|
690
690
|
1. **《风险防范基本条例》** - 代码评审强制要求
|
|
691
691
|
2. **Conventional Commits** - 提交信息格式规范
|
|
692
692
|
3. **前端研发框架最佳实践** - 前端开发规范
|
|
693
|
-
4. **编码规范** - `knowledge/standards/coding-style.md`
|
|
694
|
-
5. **数据一致性规范** - `knowledge/standards/data-consistency.md`
|
|
693
|
+
4. **编码规范** - `knowledge/07-standards/00-coding-style.md`
|
|
694
|
+
5. **数据一致性规范** - `knowledge/07-standards/02-data-consistency.md`
|
|
695
695
|
|
|
696
696
|
---
|
|
697
697
|
|
|
698
698
|
## 九、AI 增强 Code Review
|
|
699
699
|
|
|
700
700
|
> 本章节定义如何利用 AI 增强代码审查流程。
|
|
701
|
-
> 与
|
|
701
|
+
> 与 [organization/01-ai-native-culture.md](../organization/01-ai-native-culture.md) 中的多代理审查系统互补。
|
|
702
702
|
|
|
703
703
|
### 9.1 AI 审查角色定义
|
|
704
704
|
|
|
@@ -1082,4 +1082,4 @@ public class DataReconciliationJob {
|
|
|
1082
1082
|
---
|
|
1083
1083
|
|
|
1084
1084
|
**维护者**: AutoSpec 团队
|
|
1085
|
-
**关联文档**: `knowledge/standards/coding-style.md`, `knowledge/standards/code-review.md`
|
|
1085
|
+
**关联文档**: `knowledge/07-standards/00-coding-style.md`, `knowledge/07-standards/01-code-review.md`
|
|
@@ -142,10 +142,10 @@ upstream: [REQ-{feature}-001, DES-{feature}-001]
|
|
|
142
142
|
|
|
143
143
|
| 阶段 | 检查清单引用 |
|
|
144
144
|
|------|-------------|
|
|
145
|
-
| 需求分析 | `knowledge/checklists/requirement.md` |
|
|
146
|
-
| 方案设计 | `knowledge/checklists/design.md` |
|
|
147
|
-
| 编码实现 | `knowledge/checklists/code.md` |
|
|
148
|
-
| 交付部署 | `knowledge/checklists/release.md` |
|
|
145
|
+
| 需求分析 | `knowledge/04-checklists/00-requirement.md` |
|
|
146
|
+
| 方案设计 | `knowledge/04-checklists/01-design.md` |
|
|
147
|
+
| 编码实现 | `knowledge/04-checklists/02-code.md` |
|
|
148
|
+
| 交付部署 | `knowledge/04-checklists/04-release.md` |
|
|
149
149
|
|
|
150
150
|
## 风险等级定义
|
|
151
151
|
|
|
@@ -183,4 +183,4 @@ upstream: [REQ-{feature}-001, DES-{feature}-001]
|
|
|
183
183
|
---
|
|
184
184
|
|
|
185
185
|
**维护者**: 项目团队
|
|
186
|
-
**关联文档**: `knowledge/checklists/release.md`, `knowledge/
|
|
186
|
+
**关联文档**: `knowledge/04-checklists/04-release.md`, `knowledge/09-templates/06-business-rules.md`
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
# Standards
|
|
2
|
+
|
|
3
|
+
> **Purpose**: Standards for coding, review, data consistency, etc.
|
|
4
|
+
>
|
|
5
|
+
> **Evolution Zone**: 🟡 Controlled (Auto-proposed + Human-approved)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Directory Structure
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
07-standards/
|
|
13
|
+
├── README.md # This file (Standards Navigation)
|
|
14
|
+
├── 00-coding-style.md # Coding Style Guide
|
|
15
|
+
├── 01-code-review.md # Code Review Standard
|
|
16
|
+
├── 02-data-consistency.md # Data Consistency Standard
|
|
17
|
+
├── 03-document-versioning.md # Document Versioning Standard
|
|
18
|
+
└── 04-risk-detection.md # Risk Detection Standard
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Standards Description
|
|
24
|
+
|
|
25
|
+
### 00-coding-style.md — Coding Style Guide
|
|
26
|
+
|
|
27
|
+
**Content**: General coding standards, covering data safety, exception handling, multi-threading, database operations, etc.
|
|
28
|
+
|
|
29
|
+
**Core Chapters**:
|
|
30
|
+
- Reuse First & No Hardcoding
|
|
31
|
+
- Data Safety (Lock-Check-Update)
|
|
32
|
+
- Exception Handling
|
|
33
|
+
- Multi-threading
|
|
34
|
+
- Database Operations
|
|
35
|
+
- Internationalization
|
|
36
|
+
- Security
|
|
37
|
+
- Logging Standards
|
|
38
|
+
- Monitoring Standards
|
|
39
|
+
- Coding Basics
|
|
40
|
+
- Naming Conventions
|
|
41
|
+
- SOLID Principles
|
|
42
|
+
|
|
43
|
+
**Location**: [00-coding-style.md](00-coding-style.md)
|
|
44
|
+
|
|
45
|
+
### 01-code-review.md — Code Review Standard
|
|
46
|
+
|
|
47
|
+
**Content**: Standards and processes for code review
|
|
48
|
+
|
|
49
|
+
**Core Chapters**:
|
|
50
|
+
- Review Process
|
|
51
|
+
- Review Dimensions (Architecture/Security/Performance/Maintainability/Logic)
|
|
52
|
+
- Review Comment Format
|
|
53
|
+
- Review Pass Criteria
|
|
54
|
+
- AI-Enhanced Code Review
|
|
55
|
+
|
|
56
|
+
**Location**: [01-code-review.md](01-code-review.md)
|
|
57
|
+
|
|
58
|
+
### 02-data-consistency.md — Data Consistency Standard
|
|
59
|
+
|
|
60
|
+
**Content**: Standards and best practices for data consistency guarantees
|
|
61
|
+
|
|
62
|
+
**Core Chapters**:
|
|
63
|
+
- Distributed Transactions
|
|
64
|
+
- Eventual Consistency
|
|
65
|
+
- Data Synchronization
|
|
66
|
+
- Idempotency Design
|
|
67
|
+
|
|
68
|
+
**Location**: [02-data-consistency.md](02-data-consistency.md)
|
|
69
|
+
|
|
70
|
+
### 03-document-versioning.md — Document Versioning Standard
|
|
71
|
+
|
|
72
|
+
**Content**: Standards for document version management
|
|
73
|
+
|
|
74
|
+
**Core Chapters**:
|
|
75
|
+
- Version Number Rules
|
|
76
|
+
- Version History
|
|
77
|
+
- Change Marking
|
|
78
|
+
|
|
79
|
+
**Location**: [03-document-versioning.md](03-document-versioning.md)
|
|
80
|
+
|
|
81
|
+
### 04-risk-detection.md — Risk Detection Standard
|
|
82
|
+
|
|
83
|
+
**Content**: Standards and processes for risk detection
|
|
84
|
+
|
|
85
|
+
**Core Chapters**:
|
|
86
|
+
- Risk Type Identification
|
|
87
|
+
- Risk Level Assessment
|
|
88
|
+
- Risk Handling Process
|
|
89
|
+
|
|
90
|
+
**Location**: [04-risk-detection.md](04-risk-detection.md)
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## Usage
|
|
95
|
+
|
|
96
|
+
Standards are applied in the following scenarios:
|
|
97
|
+
|
|
98
|
+
1. **Implementation**: Follow `00-coding-style.md`
|
|
99
|
+
2. **Code Review**: Follow `01-code-review.md`
|
|
100
|
+
3. **Solution Design**: Follow `02-data-consistency.md` for data consistency requirements
|
|
101
|
+
4. **Documentation**: Follow `03-document-versioning.md` for versioning standards
|
|
102
|
+
5. **Risk Assessment**: Follow `04-risk-detection.md` for detection standards
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Related Documents
|
|
107
|
+
|
|
108
|
+
| Document | Description |
|
|
109
|
+
|----------|-------------|
|
|
110
|
+
| [../04-checklists/](../04-checklists/) | Checklists (Based on standards) |
|
|
111
|
+
| [../03-guides/04-implement-code.md](../03-guides/04-implement-code.md) | Implementation Skills |
|
|
112
|
+
| [../03-guides/11-review-code.md](../03-guides/11-review-code.md) | Code Review Skills |
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
**Maintainer**: AutoSpec Team
|
|
117
|
+
**Evolution Zone**: 🟡 Controlled
|
|
118
|
+
**Version**: v1.0
|
|
119
|
+
**Last Updated**: 2026-03-27
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# 标准规范
|
|
2
|
+
|
|
3
|
+
> **定位**: 编码、审查、数据一致性等标准规范
|
|
4
|
+
>
|
|
5
|
+
> **进化分区**: 🟡 受控区(自动提议 + 人工批准)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 目录结构
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
07-standards/
|
|
13
|
+
├── README.md # 本文件(标准规范导航)
|
|
14
|
+
├── 00-coding-style.md # 编码规范
|
|
15
|
+
├── 01-code-review.md # 代码审查规范
|
|
16
|
+
├── 02-data-consistency.md # 数据一致性规范
|
|
17
|
+
├── 03-document-versioning.md # 文档版本化规范
|
|
18
|
+
└── 04-risk-detection.md # 风险检测规范
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 规范说明
|
|
24
|
+
|
|
25
|
+
### 00-coding-style.md — 编码规范
|
|
26
|
+
|
|
27
|
+
**内容**: 通用编码规范,覆盖数据安全、异常处理、多线程、数据库等
|
|
28
|
+
|
|
29
|
+
**核心章节**:
|
|
30
|
+
- 复用优先与禁止硬编码
|
|
31
|
+
- 数据安全(一锁二判三更新)
|
|
32
|
+
- 异常处理
|
|
33
|
+
- 多线程
|
|
34
|
+
- 数据库操作
|
|
35
|
+
- 国际化
|
|
36
|
+
- 安全
|
|
37
|
+
- 日志打印
|
|
38
|
+
- 监控规范
|
|
39
|
+
- 编码基础
|
|
40
|
+
- 命名规范
|
|
41
|
+
- 面向对象设计原则(SOLID)
|
|
42
|
+
|
|
43
|
+
**位置**: [00-coding-style.md](00-coding-style.md)
|
|
44
|
+
|
|
45
|
+
### 01-code-review.md — 代码审查规范
|
|
46
|
+
|
|
47
|
+
**内容**: 代码审查的标准和流程
|
|
48
|
+
|
|
49
|
+
**核心章节**:
|
|
50
|
+
- 审查流程
|
|
51
|
+
- 审查维度(架构/安全/性能/可维护性/逻辑)
|
|
52
|
+
- 审查意见格式
|
|
53
|
+
- 审查通过标准
|
|
54
|
+
- AI 增强 Code Review
|
|
55
|
+
|
|
56
|
+
**位置**: [01-code-review.md](01-code-review.md)
|
|
57
|
+
|
|
58
|
+
### 02-data-consistency.md — 数据一致性规范
|
|
59
|
+
|
|
60
|
+
**内容**: 数据一致性保障的标准和最佳实践
|
|
61
|
+
|
|
62
|
+
**核心章节**:
|
|
63
|
+
- 分布式事务
|
|
64
|
+
- 最终一致性
|
|
65
|
+
- 数据同步
|
|
66
|
+
- 幂等性设计
|
|
67
|
+
|
|
68
|
+
**位置**: [02-data-consistency.md](02-data-consistency.md)
|
|
69
|
+
|
|
70
|
+
### 03-document-versioning.md — 文档版本化规范
|
|
71
|
+
|
|
72
|
+
**内容**: 文档版本管理的标准
|
|
73
|
+
|
|
74
|
+
**核心章节**:
|
|
75
|
+
- 版本号规则
|
|
76
|
+
- 版本历史
|
|
77
|
+
- 变更标记
|
|
78
|
+
|
|
79
|
+
**位置**: [03-document-versioning.md](03-document-versioning.md)
|
|
80
|
+
|
|
81
|
+
### 04-risk-detection.md — 风险检测规范
|
|
82
|
+
|
|
83
|
+
**内容**: 风险检测的标准和流程
|
|
84
|
+
|
|
85
|
+
**核心章节**:
|
|
86
|
+
- 风险类型识别
|
|
87
|
+
- 风险等级评估
|
|
88
|
+
- 风险处理流程
|
|
89
|
+
|
|
90
|
+
**位置**: [04-risk-detection.md](04-risk-detection.md)
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## 使用方式
|
|
95
|
+
|
|
96
|
+
标准规范在以下场景应用:
|
|
97
|
+
|
|
98
|
+
1. **编码实现**: 遵循 `00-coding-style.md`
|
|
99
|
+
2. **代码审查**: 遵循 `01-code-review.md`
|
|
100
|
+
3. **方案设计**: 遵循 `02-data-consistency.md` 数据一致性要求
|
|
101
|
+
4. **文档编写**: 遵循 `03-document-versioning.md` 版本化规范
|
|
102
|
+
5. **风险评估**: 遵循 `04-risk-detection.md` 检测规范
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 与相关文档的关系
|
|
107
|
+
|
|
108
|
+
| 文档 | 说明 |
|
|
109
|
+
|------|------|
|
|
110
|
+
| [../04-checklists/](../04-checklists/) | 检查清单(基于标准规范) |
|
|
111
|
+
| [../03-guides/04-implement-code.md](../03-guides/04-implement-code.md) | 编码实现技能 |
|
|
112
|
+
| [../03-guides/11-review-code.md](../03-guides/11-review-code.md) | 代码审查技能 |
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
**维护者**: AutoSpec 团队
|
|
117
|
+
**进化分区**: 🟡 受控区
|
|
118
|
+
**版本**: v1.1
|
|
119
|
+
**最后更新**: 2026-03-28
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
⬆️ [返回知识层目录](../README.md) · 📐 [标准规范总览](#)
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# AutoSpec 愿景与使命
|
|
2
|
+
|
|
3
|
+
> **定位**: 组织层的纲领性文件,定义 AutoSpec 项目的愿景、使命和核心价值观
|
|
4
|
+
>
|
|
5
|
+
> **进化分区**: 🟡 受控区(自动提议 + 人工批准)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 愿景 (Vision)
|
|
10
|
+
|
|
11
|
+
**让 AI 成为可靠的研发伙伴,释放人类创造力**
|
|
12
|
+
|
|
13
|
+
我们相信 AI 不应该替代人类,而是成为人类最可靠的协作伙伴。通过承担重复性、确定性的研发工作,AI 让人类从繁琐的编码任务中解放出来,专注于真正需要创造力和战略思维的高价值工作。
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 使命 (Mission)
|
|
18
|
+
|
|
19
|
+
**构建无人值守的自动化产品研发框架,通过 AI 驱动完整 SDLC,人类专注于高价值决策**
|
|
20
|
+
|
|
21
|
+
AutoSpec 的使命是实现"Human On the Loop"(人类在环上)而非"Human In the Loop"(人类在环内)的协作模式:
|
|
22
|
+
- **AI 负责**: 需求分析、方案设计、编码实现、代码审查、测试验证、交付部署
|
|
23
|
+
- **人类负责**: 方向决策、安全确认、价值判断、异常处理
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 核心价值观 (Core Values)
|
|
28
|
+
|
|
29
|
+
### 1. 验证为王 (Verification First)
|
|
30
|
+
|
|
31
|
+
**确定性验证 > AI 审查 > AI 自审**
|
|
32
|
+
|
|
33
|
+
- 所有 AI 产出必须经过确定性验证(编译、测试、lint)
|
|
34
|
+
- Layer 1 验证不通过,不进入 Layer 2 审查
|
|
35
|
+
- 验证是质量的唯一标准,不是可选项
|
|
36
|
+
|
|
37
|
+
### 2. 极简实用 (Minimal Viable Process)
|
|
38
|
+
|
|
39
|
+
**能一个文件说清的不拆两个**
|
|
40
|
+
|
|
41
|
+
- 5 分钟上手,按复杂度动态调整
|
|
42
|
+
- 拒绝过度设计,追求刚好够用
|
|
43
|
+
- 维护成本远低于收益时,才引入新机制
|
|
44
|
+
|
|
45
|
+
### 3. 渐进自主 (Progressive Autonomy)
|
|
46
|
+
|
|
47
|
+
**从"人审每步"到"人只管 harness"**
|
|
48
|
+
|
|
49
|
+
- AI 先在受约束领域证明可靠
|
|
50
|
+
- 通过双层验证建立信任
|
|
51
|
+
- 逐步扩大 AI 自主决策边界
|
|
52
|
+
|
|
53
|
+
### 4. 安全优先 (Safety First)
|
|
54
|
+
|
|
55
|
+
**15 条宪法红线,不可逆操作人工确认**
|
|
56
|
+
|
|
57
|
+
- 安全漏洞/数据丢失/3 次修不好 → 立即停线
|
|
58
|
+
- DB 迁移、部署、外部 API → 必须人工确认
|
|
59
|
+
- 进化系统不可修改自己的评判标准
|
|
60
|
+
|
|
61
|
+
### 5. 持续进化 (Continuous Evolution)
|
|
62
|
+
|
|
63
|
+
**三层自进化体系,实战经验自动回流**
|
|
64
|
+
|
|
65
|
+
- L1 Self-Evolve: 框架自身的迭代升级
|
|
66
|
+
- L2 Field-Evolve: 从实战项目中学习和提炼
|
|
67
|
+
- L3 Project-Evolve: 实战项目自身的优化
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 原则应用
|
|
72
|
+
|
|
73
|
+
### 按场景应用
|
|
74
|
+
|
|
75
|
+
| 场景 | 适用价值观 | 应用方式 |
|
|
76
|
+
|------|-----------|---------|
|
|
77
|
+
| **需求分析** | 极简实用 | 不多问,用 CEO 探索机制自动澄清 |
|
|
78
|
+
| **方案设计** | 验证为王 | 设计方案必须可验证 |
|
|
79
|
+
| **编码实现** | 渐进自主 | AI 自主实现,人类抽检 |
|
|
80
|
+
| **代码审查** | 安全优先 | 做审分离,独立 Agent 审查 |
|
|
81
|
+
| **错误修复** | 持续进化 | 记录 practice-log,触发进化 |
|
|
82
|
+
| **框架改进** | 持续进化 | 三层自进化体系 |
|
|
83
|
+
|
|
84
|
+
### 决策检查清单
|
|
85
|
+
|
|
86
|
+
**重大决策前**:
|
|
87
|
+
- [ ] 这个决策符合我们的愿景吗?
|
|
88
|
+
- [ ] 这个决策服务于我们的使命吗?
|
|
89
|
+
- [ ] 这个决策与核心价值观一致吗?
|
|
90
|
+
|
|
91
|
+
**重大决策后**:
|
|
92
|
+
- [ ] 决策结果可以追溯吗?
|
|
93
|
+
- [ ] 有验证机制确保执行质量吗?
|
|
94
|
+
- [ ] 有安全护栏防止意外吗?
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## 关联文档
|
|
99
|
+
|
|
100
|
+
| 文档 | 说明 |
|
|
101
|
+
|------|------|
|
|
102
|
+
| [principles/01-first-principles.md](../principles/01-first-principles.md) | L1 第一性原则 |
|
|
103
|
+
| [principles/09-constitution.md](../principles/09-constitution.md) | 项目宪法(15 条红线) |
|
|
104
|
+
| [principles/10-evolution-mechanism.md](../principles/10-evolution-mechanism.md) | 自进化机制 |
|
|
105
|
+
| [01-ai-native-culture.md](01-ai-native-culture.md) | AI Native 团队文化 |
|
|
106
|
+
| [03-committee-structure.md](03-committee-structure.md) | 治理委员会架构 |
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
**维护者**: AutoSpec 团队
|
|
111
|
+
**进化分区**: 🟡 受控区
|
|
112
|
+
**版本**: v1.0
|
|
113
|
+
**最后更新**: 2026-03-27
|