@chongyan/autospec 1.0.1 → 1.0.2

package/knowledge/README.md

@@ -1,119 +1,348 @@
 # AutoSpec 知识层
 
+> **版本**: v5.1
+> **最后更新**: 2026-03-28
+> **变更说明**: 知识层全面重构 - 所有目录添加序号前缀，文件按优先级排序，统一动词开头命名
+
 本目录包含 AutoSpec 的核心知识文件，在 `autospec init` 时会复制到用户项目的 `.autospec/knowledge/` 目录。
 
-## 人类-[skills]-创业团队-skills-领域知识分层理念
+---
+
+## 快速导航
+
+| 🔴 冻结区 | 🟡 受控区 | 🟢 自由区 | 🔵 环境区 |
+|-----------|-----------|-----------|-----------|
+| [01-principles/](01-principles/) | [02-process/](02-process/) | [08-organization/](08-organization/) | [06-environment/](06-environment/) |
+| 宪法、原则、进化机制 | 流程、阶段定义 | 组织、文化、治理 | 中间件、组件 |
+
+**按场景导航**：
+- 🎯 **启动任务** → [02-process/00-overview.md](02-process/00-overview.md)
+- 📋 **需求分析** → [02-process/01-requirement.md](02-process/01-requirement.md)
+- 🎨 **方案设计** → [02-process/02-design.md](02-process/02-design.md)
+- 💻 **编码实现** → [02-process/03-implementation.md](02-process/03-implementation.md)
+- 🔍 **代码审查** → [02-process/04-review.md](02-process/04-review.md)
+- 🧪 **测试** → [02-process/05-testing.md](02-process/05-testing.md)
+- 🚀 **交付部署** → [02-process/06-delivery.md](02-process/06-delivery.md)
+- ⚙️ **框架进化** → [01-principles/10-evolution-mechanism.md](01-principles/10-evolution-mechanism.md)
+
+---
+
+## 目录结构
 
 ```
-┌─────────────────────────────────────────────────────────────────┐
-│  人类维护层 (Human-maintained)                                    │
-│  domain/ - 业务知识（术语、规则、流程）                          │
-│  由领域专家维护，AI 读取但不修改                                   │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 驱动
-┌─────────────────────────────────────────────────────────────────┐
-│  创业团队 Skills (AI Agent Roles)                                 │
-│  ../plugins/agents/roles/ - CEO、产品负责人、技术负责人、工程师等   │
-│  模拟创业团队对抗审查，多视角审视产出                              │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 执行
-┌─────────────────────────────────────────────────────────────────┐
-│  阶段 Skills (Stage Skills)                                       │
-│  ../plugins/skills/*-stage/ - 需求分析、方案设计、编码实现等       │
-│  驱动各阶段执行，产出标准化产物                                    │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 支撑
-┌─────────────────────────────────────────────────────────────────┐
-│  领域知识/规范分层 (Knowledge & Standards)                        │
-│  本目录 - 原则、流程、指南、检查清单                              │
-│  按冻结区/受控区/自由区分层管理                                    │
-└─────────────────────────────────────────────────────────────────┘
+knowledge/
+├── README.md                 # 本文件（知识层总导航）
+│
+├── 01-principles/            # 原则层 — 🔴 冻结区（宪法级）
+│   ├── README.md             # 原则体系总览 + 速查导航
+│   ├── 00-principles-hierarchy.md  # 原则体系总纲（L1→L2→L3→L4 完整追溯）
+│   ├── 01-first-principles.md      # L1 第一性原则（P1-P3 三棱锥）
+│   ├── 02-strategic-principles.md  # L2 战略原则（S1-S4）
+│   ├── 03-tactical-principles.md   # L3 战术原则（T1-T6）
+│   ├── 04-operational-principles.md # L4 操作原则（O1-O4）
+│   ├── 05-domain-principles.md     # 领域实践原则（DDD/系统/需求/编码/CR/知识管理）
+│   ├── 06-methodology-principles.md # 方法论原则（P1-P44）
+│   ├── 07-cognitive-principles.md  # 认知增强原则（CP1-CP10）
+│   ├── 08-auto-fix-principles.md   # 自主修复原则（实战经验提炼）
+│   ├── 09-constitution.md          # 项目宪法（15 条红线）
+│   └── 10-evolution-mechanism.md   # 自进化机制（三层进化体系）
+│
+├── 02-process/               # 流程层 — 🟡 受控区（6 阶段执行流程）
+│   ├── README.md             # 流程层导航
+│   ├── 00-overview.md        # 流程概览（启动门禁 + 执行模式）
+│   ├── 01-requirement.md     # 需求分析阶段
+│   ├── 02-design.md          # 方案设计阶段
+│   ├── 03-implementation.md  # 编码实现阶段
+│   ├── 04-review.md          # 代码审查阶段
+│   ├── 05-testing.md         # QA 测试阶段
+│   └── 06-delivery.md        # 交付部署阶段
+│
+├── 03-guides/                # 能力指南 — 🟡/🟢 受控/自由区（51 个技能文件）
+│   # 核心协议 (00-01)
+│   ├── 00-pipeline-protocol.md      # 流水线协议
+│   ├── 01-team-orchestrator.md      # 团队编排器
+│   # 阶段执行 (02-08)
+│   ├── 02-analyze-requirement.md    # 需求分析
+│   ├── 03-design-solution.md        # 方案设计
+│   ├── 04-implement-code.md         # 编码实现
+│   ├── 05-plan-testing.md           # 测试计划
+│   ├── 06-generate-tests.md         # 生成测试
+│   ├── 07-check-release.md          # 发布检查
+│   ├── 08-evaluate-ai-effect.md     # AI 效果评估
+│   # 审查技能 (09-14)
+│   ├── 09-review-requirement.md     # 需求审查
+│   ├── 10-review-design.md          # 设计审查
+│   ├── 11-review-code.md            # 代码审查
+│   ├── 12-review-testing.md         # 测试审查
+│   ├── 13-audit-security.md         # 安全审计
+│   ├── 14-check-consistency.md      # 一致性检查
+│   # 测试执行 (15-17)
+│   ├── 15-run-unit-tests.md         # 单元测试
+│   ├── 16-run-integration-tests.md  # 集成测试
+│   ├── 17-analyze-test-context.md   # 测试上下文分析
+│   # 进化支撑 (18-22)
+│   ├── 18-log-practice.md           # 实践日志
+│   ├── 19-distill-skill.md          # 技能蒸馏
+│   ├── 20-update-skill.md           # 技能更新
+│   ├── 21-validate-skill.md         # 技能验证
+│   ├── 22-extract-methodology.md    # 方法论提取
+│   # 上下文/环境 (23-29)
+│   ├── 23-infer-scope.md            # 范围推断
+│   ├── 24-assess-complexity.md      # 复杂度评估
+│   ├── 25-discover-component.md     # 组件发现
+│   ├── 26-analyze-tech-stack.md     # 技术栈分析
+│   ├── 27-scan-environment.md       # 环境扫描
+│   ├── 28-validate-environment.md   # 环境验证
+│   ├── 29-generate-knowledge.md     # 知识生成
+│   # AI 专项 (30-41)
+│   ├── 30-analyze-ai-capability.md  # AI 能力分析
+│   ├── 31-analyze-ai-component.md   # AI 组件分析
+│   ├── 32-analyze-ai-agent.md       # AI 代理分析
+│   ├── 33-analyze-ai-rag.md         # AI RAG 分析
+│   ├── 34-assess-ai-task.md         # AI 任务评估
+│   ├── 35-evaluate-ai-pipeline.md   # AI 流水线评估
+│   ├── 36-evaluate-ai-artifact.md   # AI 产出物评估
+│   ├── 37-plan-ai-evaluation.md     # AI 评测计划
+│   ├── 38-evaluate-ai-path.md       # AI 路径评估
+│   ├── 39-validate-ai-data.md       # AI 数据验证
+│   ├── 40-detect-ai-anomaly.md      # AI 异常检测
+│   ├── 41-diagnose-ai-test.md       # AI 测试诊断
+│   # 领域方法论 (42-44)
+│   ├── 42-apply-ddd.md              # DDD 应用
+│   ├── 43-run-ai-sdlc.md            # AI-SDLC 执行
+│   ├── 44-manage-knowledge.md       # 知识管理
+│   # 工具技能 (45)
+│   └── 45-test-runner.md            # 测试运行器
+│   # 已整合到 templates 的文件（已删除）
+│   # ├── 51-build-glossary.md → 09-templates/05-business-glossary.md
+│   # ├── 52-define-domain-rules.md → 09-templates/06-business-rules.md
+│   # ├── 53-engineer-requirement.md → 09-templates/00-requirement-proposal.md
+│   # ├── 54-design-system.md → 09-templates/01-architecture-design.md
+│   # ├── 56-draw-flow-chart.md → 09-templates/07-business-flows.md
+│
+├── 04-checklists/            # 检查清单 — 🟡 受控区（各阶段检查项）
+│   ├── README.md             # 检查清单导航
+│   ├── 00-requirement.md     # 需求检查清单
+│   ├── 01-design.md          # 设计检查清单
+│   ├── 02-code.md            # 编码检查清单
+│   ├── 03-test.md            # 测试检查清单
+│   └── 04-release.md         # 发布检查清单
+│
+├── 05-config/                # 配置文件 — 🟡 受控区（验证模式 + 团队配置）
+│   ├── README.md             # 配置目录导航
+│   ├── 00-validation-patterns.yaml  # 验证模式配置
+│   ├── 01-team-stage.yaml           # 团队阶段配置（含触发器）
+│   ├── 02-team-tasks.yaml           # 团队任务配置
+│   ├── 03-role-composition.yaml     # 角色组合配置（含动态决策树）
+│   ├── 04-role-extensions.yaml      # 角色扩展配置
+│   └── 05-skill-compositions.yaml   # 技能组合配置
+│
+├── 06-environment/           # 环境知识 — 🔵 环境知识区（中间件/组件/集成）
+│   ├── README.md             # 环境衔接协议
+│   ├── 00-template-registry.md      # 模板注册表
+│   └── 01-detection-patterns.yaml   # 检测模式
+│
+├── 07-standards/             # 标准规范 — 🟡 受控区（编码/审查/数据一致性）
+│   ├── README.md             # 标准规范导航
+│   ├── 00-coding-style.md    # 编码规范
+│   ├── 01-code-review.md     # 代码审查规范
+│   ├── 02-data-consistency.md # 数据一致性规范
+│   ├── 03-document-versioning.md # 文档版本化规范
+│   └── 04-risk-detection.md  # 风险检测规范
+│
+├── 08-organization/          # 组织知识 — 🟢 自由区（愿景/文化/治理）
+│   ├── README.md             # 组织层导航
+│   ├── 00-vision-mission.md  # 愿景、使命、核心价值观
+│   ├── 01-ai-native-culture.md # AI Native 团队文化手册
+│   ├── 02-team-metrics.md    # 团队度量体系
+│   ├── 03-committee-structure.md # 治理委员会架构
+│   ├── 04-governance-metrics.md # 治理监测指标
+│   └── 05-improvement-process.md # 改进流程
+│
+└── 09-templates/             # 文档模板 — 🟡 受控区（标准化模板）
+    ├── README.md             # 模板导航
+    ├── 00-requirement-proposal.md # 需求提案模板
+    ├── 01-architecture-design.md  # 架构设计模板
+    ├── 02-api-design.md           # API 设计模板
+    ├── 03-database-design.md      # 数据库设计模板
+    ├── 04-product-design.md       # 产品设计模板
+    ├── 05-business-glossary.md    # 业务术语模板
+    ├── 06-business-rules.md       # 业务规则模板
+    ├── 07-business-flows.md       # 业务流程模板
+    ├── 08-test-design.md          # 测试设计模板
+    ├── 09-evaluation-design.md    # 评测设计模板（AI/模型）
+    ├── 10-component-knowledge.md  # 组件知识模板
+    ├── 11-best-practices.md       # 最佳实践模板
+    └── 12-domain-model.md         # 领域模型模板
 ```
 
+## 核心文件说明
+
+### 01-principles/ — 原则层（宪法级）
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [01-principles/README.md](01-principles/README.md) | 原则体系总览 + 速查导航 | 🔴 冻结区 |
+| [01-principles/00-principles-hierarchy.md](01-principles/00-principles-hierarchy.md) | 原则体系总纲（L1→L2→L3→L4） | 🔴 冻结区 |
+| [01-principles/01-first-principles.md](01-principles/01-first-principles.md) | L1 第一性原则（P1-P3 三棱锥） | 🔴 冻结区 |
+| [01-principles/02-strategic-principles.md](01-principles/02-strategic-principles.md) | L2 战略原则（S1-S4） | 🔴 冻结区 |
+| [01-principles/03-tactical-principles.md](01-principles/03-tactical-principles.md) | L3 战术原则（T1-T6） | 🟡 受控区 |
+| [01-principles/04-operational-principles.md](01-principles/04-operational-principles.md) | L4 操作原则（O1-O4） | 🟡 受控区 |
+| [01-principles/05-domain-principles.md](01-principles/05-domain-principles.md) | 领域实践原则（DDP/SDP/REP/CEP/CRP/KMP） | 🟡 受控区 |
+| [01-principles/06-methodology-principles.md](01-principles/06-methodology-principles.md) | 方法论原则（P1-P44） | 🟡 受控区 |
+| [01-principles/07-cognitive-principles.md](01-principles/07-cognitive-principles.md) | 认知增强原则（CP1-CP10） | 🟡 受控区 |
+| [01-principles/08-auto-fix-principles.md](01-principles/08-auto-fix-principles.md) | 自主修复原则（AFP1-AFP6） | 🟡 受控区 |
+| [01-principles/09-constitution.md](01-principles/09-constitution.md) | 项目宪法（15 条红线） | 🔴 冻结区 |
+| [01-principles/10-evolution-mechanism.md](01-principles/10-evolution-mechanism.md) | 自进化机制（三层进化体系） | 🔴 冻结区 |
+
+### 02-process/ — 流程层
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [02-process/README.md](02-process/README.md) | 流程层导航、运行模式、保障机制 | 🟡 受控区 |
+| [02-process/00-overview.md](02-process/00-overview.md) | 流程概览、启动门禁、执行模式 | 🟡 受控区 |
+| [02-process/01-requirement.md](02-process/01-requirement.md) | 需求分析阶段 | 🟡 受控区 |
+| [02-process/02-design.md](02-process/02-design.md) | 方案设计阶段 | 🟡 受控区 |
+| [02-process/03-implementation.md](02-process/03-implementation.md) | 编码实现阶段 | 🟡 受控区 |
+| [02-process/04-review.md](02-process/04-review.md) | 代码审查阶段 | 🟡 受控区 |
+| [02-process/05-testing.md](02-process/05-testing.md) | QA 测试阶段 | 🟡 受控区 |
+| [02-process/06-delivery.md](02-process/06-delivery.md) | 交付部署阶段 | 🟡 受控区 |
+
+### 03-guides/ — 能力指南
+
+| 分类 | 序号范围 | 文件数 | 进化分区 |
+|------|---------|--------|---------|
+| 核心协议 | 00-01 | 2 | 🔴 冻结区 |
+| 阶段执行 | 02-08 | 7 | 🟡 受控区 |
+| 审查技能 | 09-14 | 6 | 🟡 受控区 |
+| 测试执行 | 15-17 | 3 | 🟡 受控区 |
+| 进化支撑 | 18-22 | 5 | 🟢 自由区 |
+| 上下文/环境 | 23-29 | 7 | 🟡 受控区 |
+| AI 专项 | 30-41 | 12 | 🟡 受控区 |
+| 领域方法论 | 50-57 | 8 | 🟡 受控区 |
+| 其他 | 99 | 1 | 🟢 自由区 |
+
+完整文件列表见：[03-guides/](03-guides/)
+
+### 04-checklists/ — 检查清单
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [04-checklists/README.md](04-checklists/README.md) | 检查清单导航 | 🟡 受控区 |
+| [04-checklists/00-requirement.md](04-checklists/00-requirement.md) | 需求检查清单 | 🟡 受控区 |
+| [04-checklists/01-design.md](04-checklists/01-design.md) | 设计检查清单 | 🟡 受控区 |
+| [04-checklists/02-code.md](04-checklists/02-code.md) | 编码检查清单 | 🟡 受控区 |
+| [04-checklists/03-test.md](04-checklists/03-test.md) | 测试检查清单 | 🟡 受控区 |
+| [04-checklists/04-release.md](04-checklists/04-release.md) | 发布检查清单 | 🟡 受控区 |
+
+### 05-config/ — 配置文件
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [05-config/README.md](05-config/README.md) | 配置目录导航 | 🟡 受控区 |
+| [05-config/00-validation-patterns.yaml](05-config/00-validation-patterns.yaml) | 验证模式配置 | 🟡 受控区 |
+| [05-config/01-team-stage.yaml](05-config/01-team-stage.yaml) | 团队阶段配置（含触发器） | 🟡 受控区 |
+| [05-config/02-team-tasks.yaml](05-config/02-team-tasks.yaml) | 团队任务配置 | 🟡 受控区 |
+| [05-config/03-role-composition.yaml](05-config/03-role-composition.yaml) | 角色组合配置（含动态决策树） | 🟡 受控区 |
+| [05-config/04-role-extensions.yaml](05-config/04-role-extensions.yaml) | 角色扩展配置 | 🟡 受控区 |
+| [05-config/05-skill-compositions.yaml](05-config/05-skill-compositions.yaml) | 技能组合配置 | 🟡 受控区 |
+
+### 06-environment/ — 环境知识
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [06-environment/README.md](06-environment/README.md) | 环境衔接协议 | 🔵 环境知识区 |
+| [06-environment/00-template-registry.md](06-environment/00-template-registry.md) | 模板注册表 | 🔵 环境知识区 |
+| [06-environment/01-detection-patterns.yaml](06-environment/01-detection-patterns.yaml) | 检测模式 | 🔵 环境知识区 |
+
+### 09-templates/ — 文档模板
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [09-templates/README.md](09-templates/README.md) | 模板目录导航 | 🟡 受控区 |
+| [09-templates/13-middleware-knowledge.md](09-templates/13-middleware-knowledge.md) | 中间件知识模板 | 🔵 环境知识区 |
+| [09-templates/10-component-knowledge.md](09-templates/10-component-knowledge.md) | 组件知识模板 | 🔵 环境知识区 |
+
+### 07-standards/ — 标准规范
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [07-standards/README.md](07-standards/README.md) | 标准规范导航 | 🟡 受控区 |
+| [07-standards/00-coding-style.md](07-standards/00-coding-style.md) | 编码规范 | 🟡 受控区 |
+| [07-standards/01-code-review.md](07-standards/01-code-review.md) | 代码审查规范 | 🟡 受控区 |
+| [07-standards/02-data-consistency.md](07-standards/02-data-consistency.md) | 数据一致性规范 | 🟡 受控区 |
+| [07-standards/03-document-versioning.md](07-standards/03-document-versioning.md) | 文档版本化规范 | 🟡 受控区 |
+| [07-standards/04-risk-detection.md](07-standards/04-risk-detection.md) | 风险检测规范 | 🟡 受控区 |
+
+### 08-organization/ — 组织层
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [08-organization/README.md](08-organization/README.md) | 组织层导航 | 🟢 自由区 |
+| [08-organization/00-vision-mission.md](08-organization/00-vision-mission.md) | 愿景、使命、核心价值观 | 🟡 受控区 |
+| [08-organization/01-ai-native-culture.md](08-organization/01-ai-native-culture.md) | AI Native 团队文化手册 | 🟢 自由区 |
+| [08-organization/02-team-metrics.md](08-organization/02-team-metrics.md) | 团队度量体系 | 🟢 自由区 |
+| [08-organization/03-committee-structure.md](08-organization/03-committee-structure.md) | 治理委员会架构 | 🟢 自由区 |
+| [08-organization/04-governance-metrics.md](08-organization/04-governance-metrics.md) | 治理监测指标 | 🟢 自由区 |
+| [08-organization/05-improvement-process.md](08-organization/05-improvement-process.md) | 改进流程 | 🟢 自由区 |
+
+### 09-templates/ — 文档模板
+
+| 文件 | 说明 | 进化分区 |
+|------|------|---------|
+| [09-templates/README.md](09-templates/README.md) | 模板导航 | 🟡 受控区 |
+| [09-templates/00-requirement-proposal.md](09-templates/00-requirement-proposal.md) | 需求提案模板 | 🟡 受控区 |
+| [09-templates/01-architecture-design.md](09-templates/01-architecture-design.md) | 架构设计模板 | 🟡 受控区 |
+| [09-templates/02-api-design.md](09-templates/02-api-design.md) | API 设计模板 | 🟡 受控区 |
+| [09-templates/03-database-design.md](09-templates/03-database-design.md) | 数据库设计模板 | 🟡 受控区 |
+| [09-templates/04-product-design.md](09-templates/04-product-design.md) | 产品设计模板 | 🟡 受控区 |
+| [09-templates/05-business-glossary.md](09-templates/05-business-glossary.md) | 业务术语模板 | 🟡 受控区 |
+| [09-templates/06-business-rules.md](09-templates/06-business-rules.md) | 业务规则模板 | 🟡 受控区 |
+| [09-templates/07-business-flows.md](09-templates/07-business-flows.md) | 业务流程模板 | 🟡 受控区 |
+| [09-templates/08-test-design.md](09-templates/08-test-design.md) | 测试设计模板 | 🟡 受控区 |
+| [09-templates/09-evaluation-design.md](09-templates/09-evaluation-design.md) | 评测设计模板（AI/模型） | 🟡 受控区 |
+| [09-templates/10-component-knowledge.md](09-templates/10-component-knowledge.md) | 组件知识模板 | 🟡 受控区 |
+| [09-templates/11-best-practices.md](09-templates/11-best-practices.md) | 最佳实践模板 | 🟡 受控区 |
+| [09-templates/12-domain-model.md](09-templates/12-domain-model.md) | 领域模型模板 | 🟡 受控区 |
+
 ## 三层自进化体系
 
 | 层级 | 命令 | 目标 | 位置 |
 |------|------|------|------|
-| L1: Self-Evolve | `/self-evolve` | 框架自身的迭代升级 | `.claude/skills/self-evolve/` |
-| L2: Field-Evolve | `/autospec:field-evolve` | 从实战项目中学习和提炼 | `plugins/commands/autospec:field-evolve.md` |
-| L3: Project-Evolve | `/autospec:project-evolve` | 实战项目自身的优化 | `plugins/commands/autospec:project-evolve.md` |
+| L1: Self-Evolve | `/self-evolve` | 框架自身的迭代升级 | `.claude/commands/self-evolve.md` |
+| L2: Field-Evolve | `/autospec:field-evolve` | 从实战项目中学习和提炼 | `plugins/commands/field-evolve.md` |
+| L3: Project-Evolve | `/autospec:project-evolve` | 实战项目自身的优化 | `plugins/commands/project-evolve.md` |
 
 **基于评测驱动的进化**：实战流程 → Benchmarks 评测 → Field-Evolve 分析 → 提炼通用模板 → 更新框架能力
 
-## 目录结构
+## 快速导航
 
-```
-knowledge/
-├── principles/         # 原则层（宪法、进化规则、设计哲学）
-│   ├── constitution.md     # 宪法红线（不可违反的规则）- 冻结区
-│   ├── evolution.md        # 自进化机制 - 冻结区
-│   ├── core-principles.md  # 核心原则（44条方法论）
-│   └── design-philosophy.md # 设计哲学 - 冻结区/受控区
-├── process/            # 流程知识（6阶段 + 4种工作流）- 受控区
-│   ├── overview.md         # 迭代模式概览
-│   ├── ai-sdlc.md         # AI-Enhanced SDLC 规范
-│   ├── 01-requirement.md   # 需求分析阶段
-│   ├── 02-design.md        # 方案设计阶段
-│   ├── 03-implementation.md # 编码实施阶段
-│   ├── 04-review.md        # 审查阶段
-│   ├── 05-testing.md       # 测试阶段
-│   └── 06-delivery.md      # 交付阶段
-├── guides/             # 能力指南（阶段技能 + 支撑技能）- 受控区/自由区
-│   ├── stages/             # 阶段技能
-│   └── support/            # 支撑技能
-├── checklists/         # 检查清单 - 受控区
-│   ├── requirement.md      # 需求检查清单
-│   ├── design.md           # 设计检查清单
-│   ├── code.md             # 编码检查清单
-│   ├── test.md             # 测试检查清单
-│   └── release.md          # 发布检查清单
-├── environment/        # 环境知识（中间件、组件、检测模式）- 环境知识区
-│   ├── component-knowledge.md
-│   ├── middleware-knowledge.md
-│   ├── template-registry.md
-│   └── detection-patterns.yaml
-├── config/             # 配置知识 - 受控区
-│   ├── validation-patterns.yaml
-│   ├── team-triggers.yaml
-│   └── *.yaml
-├── domain/             # 业务知识（人类维护）- 人类层
-│   ├── glossary.md         # 术语表
-│   ├── rules.md            # 业务规则
-│   └── flows/              # 流程图
-├── templates/          # 文档模板
-│   ├── document-versioning.md
-│   ├── risk-detection.md
-│   └── ...                 # 各类设计模板
-└── organization/       # 组织知识（AI Native 团队文化）
-    ├── ai-native-team.md   # AI Native 团队文化手册
-    └── team-metrics.md     # 团队度量体系
-```
+### 按场景查找文档
 
-## 核心文件说明
+| 场景 | 查阅文档 |
+|------|---------|
+| **理解原则体系** | [01-principles/README.md](01-principles/README.md) - 原则体系总览 |
+| **原则追溯链** | [01-principles/00-principles-hierarchy.md](01-principles/00-principles-hierarchy.md) - L1→L2→L3→L4 完整追溯 |
+| **启动新任务** | [02-process/00-overview.md](02-process/00-overview.md) - 启动门禁 |
+| **需求分析** | [02-process/01-requirement.md](02-process/01-requirement.md) + [04-checklists/00-requirement.md](04-checklists/00-requirement.md) |
+| **方案设计** | [02-process/02-design.md](02-process/02-design.md) + [04-checklists/01-design.md](04-checklists/01-design.md) |
+| **编码实现** | [02-process/03-implementation.md](02-process/03-implementation.md) + [07-standards/00-coding-style.md](07-standards/00-coding-style.md) |
+| **代码审查** | [02-process/04-review.md](02-process/04-review.md) + [07-standards/01-code-review.md](07-standards/01-code-review.md) |
+| **测试** | [02-process/05-testing.md](02-process/05-testing.md) + [04-checklists/03-test.md](04-checklists/03-test.md) |
+| **交付部署** | [02-process/06-delivery.md](02-process/06-delivery.md) + [04-checklists/04-release.md](04-checklists/04-release.md) |
+| **遇到错误** | [01-principles/08-auto-fix-principles.md](01-principles/08-auto-fix-principles.md) + [01-principles/09-constitution.md](01-principles/09-constitution.md) |
+| **框架进化** | [01-principles/10-evolution-mechanism.md](01-principles/10-evolution-mechanism.md) |
+| **领域驱动设计** | [03-guides/42-apply-ddd.md](03-guides/42-apply-ddd.md) |
 
-| 文件/目录 | 说明 | 进化分区 | 详细文档 |
-|-----------|------|---------|---------|
-| `principles/constitution.md` | 宪法红线，不可违反的规则 | 🔴 冻结区 | 直接阅读 |
-| `principles/evolution.md` | 三层自进化体系，进化分区 + 安全护栏 | 🔴 冻结区 | 直接阅读 |
-| `principles/core-principles.md` | 44条核心方法论原则 | 🔴/🟡 冻结/受控区 | 直接阅读 |
-| `principles/design-philosophy.md` | 设计哲学和核心原则 | 🔴/🟡 冻结/受控区 | 直接阅读 |
-| `process/` | 6阶段研发流程定义 | 🟡 受控区 | [process/overview.md](process/overview.md) |
-| `process/ai-sdlc.md` | AI-Enhanced SDLC 规范 | 🟢 自由区 | [process/ai-sdlc.md](process/ai-sdlc.md) |
-| `guides/` | 可执行技能指南（做类 + 审类） | 🟡/🟢 受控/自由区 | [guides/stages/](guides/stages/) |
-| `checklists/` | 各阶段检查清单 | 🟡 受控区 | [checklists/](checklists/) |
-| `environment/` | 环境衔接协议 | 🔵 环境知识区 | [environment/README.md](environment/README.md) |
-| `config/` | 配置文件 | 🟡 受控区 | [config/README.md](config/README.md) |
-| `domain/` | 业务知识（术语、规则、流程） | 人类层 | [domain/README.md](domain/README.md) |
-| `templates/` | 文档模板 | 🟡 受控区 | [templates/](templates/) |
-| `organization/` | AI Native 团队文化 | 🟢 自由区 | [organization/ai-native-team.md](organization/ai-native-team.md) |
-
-### Benchmarks 评测相关
-
-| 文件/目录 | 说明 | 位置 |
-|-----------|------|------|
-| `../plugins/skills/benchmark-generator/SKILL.md` | Benchmarks 自动生成技能 | 自由区 |
-| `../plugins/skills/benchmark-executor/SKILL.md` | Benchmarks 执行技能 | 自由区 |
-| `../plugins/hooks/lib/benchmarks/` | 评测执行器、改动检测器 | 执行层 |
+### 原则速查
+
+完整的原则速查表和追溯链请参考：
+- [原则体系总览](01-principles/README.md#原则速查表)
+- [原则体系总纲](01-principles/00-principles-hierarchy.md)
+- [L1 第一性原则](01-principles/01-first-principles.md)
+- [L2 战略原则](01-principles/02-strategic-principles.md)
+- [L3 战术原则](01-principles/03-tactical-principles.md)
+- [L4 操作原则](01-principles/04-operational-principles.md)
 
 ## 设计原则
 
@@ -122,8 +351,10 @@ knowledge/
 1. **自闭环**：知识文件不依赖 `scripts/` 代码，可独立复制到用户项目
 2. **可扩展**：通过企业叠加层支持组织定制
 3. **可进化**：通过三层自进化体系（L1 Self-Evolve → L2 Field-Evolve → L3 Project-Evolve）实现持续改进
-4. **人机分离**：`domain/` 目录专门存放人类维护的业务知识
+4. **人机分离**：`guides/domain-*.md` 文件专门存放人类维护的业务知识
 5. **评测驱动**：通过 Benchmarks 评测量化进化效果，确保改进有据可依
+6. **统一原则层**：所有原则文档统一存放在 `01-principles/` 目录，便于查阅和追溯
+7. **序号优先级**：所有目录和文件按优先级添加序号前缀（01-09），便于快速定位
 
 ## 使用方式
 
@@ -142,3 +373,27 @@ autospec update
 - `evaluation/` - 基准案例（从成功/失败案例自动归档）
 - `evolution/` - 进化记录（practice-log、改进提案等）
 - `environment/` - 环境知识（自动检测生成）
+
+## 变更历史
+
+| 版本 | 日期 | 变更说明 |
+|------|------|---------|
+| v5.1 | 2026-03-28 | README 优化 - 添加快速导航索引，增强视觉层次 |
+| v5.0 | 2026-03-27 | 知识层全面重构 - 所有目录添加序号前缀，文件按优先级排序，统一动词开头命名 |
+| v4.0 | 2026-03-27 | organization 目录结构化改造 - 添加愿景使命文件，统一序号前缀命名 |
+| v3.0 | 2026-03-27 | 原则体系整合重构 - 统一 principles 目录，去掉 strategy/tactics 分层 |
+| v2.0 | 2026-03-27 | 原则体系分层重构 - 将 principles 拆分为 strategy（战略层）和 tactics（战术层） |
+| v1.0 | 2026-03-26 | 初始版本 - 统一 principles 目录存放所有原则文档 |
+
+---
+
+**维护者**: AutoSpec 团队
+**反馈渠道**: 知识库 Git 仓库 Issue
+**关联文档**:
+- [原则层](01-principles/README.md)
+- [流程层](02-process/README.md)
+- [组织层](08-organization/README.md)
+
+---
+
+⬆️ [返回项目根目录](../README.md) · 📖 [知识层总览](#)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chongyan/autospec",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "AI驱动的无人值守自动化产品研发流程 —— 从需求到交付的全流程自动化",
   "type": "module",
   "bin": {