@chongyan/autospec 1.0.1 → 1.0.2

package/README.md

@@ -2,9 +2,9 @@
 
 # AutoSpec
 
-**无人值守的自动化产品研发 —— AI驱动全流程，人只在关键决策点介入。**
+**无人值守的自动化产品研发 —— AI 驱动全流程，人只在关键决策点介入。**
 
-[English](./README.en.md) · [快速开始](#快速开始) · [运作机制](#运作机制) · [文档](#文档) · [参与贡献](./CONTRIBUTING.md)
+[English](./README.en.md) · [快速开始](#快速开始) · [核心思想](#核心思想) · [运作机制](#运作机制) · [知识层结构](#知识层结构) · [参与贡献](./CONTRIBUTING.md)
 
 </div>
 
@@ -14,93 +14,245 @@
 
 AutoSpec 是一个 AI 驱动的全流程研发管线，自动完成从需求分析到交付部署的完整软件开发周期。它不是"让 AI 写代码更快"，而是"AI 自主完成完整 SDLC，人在关键节点介入（Human On the Loop）"。
 
-## 核心特性（5条）
+## 核心特性
 
 | 特性 | 说明 |
 |------|------|
 | **AI 自主研发** | 从需求到交付，AI 全流程自动执行 |
-| **三层验证** | 确定性验证 → AI 审查 → Benchmarks 评测 |
+| **双层验证** | 确定性验证 → AI 审查 |
 | **做审分离** | 不同 AI 实例执行，信息隔离 |
-| **宪法安全** | 13 条红线，不可逆操作人工确认 |
+| **宪法安全** | 15 条红线，不可逆操作人工确认 |
 | **自进化** | 实战经验自动回流，持续优化 |
 
+---
+
+## 愿景使命
+
+### 愿景 (Vision)
+
+**让 AI 成为可靠的研发伙伴，释放人类创造力**
+
+我们相信 AI 不应该替代人类，而是成为人类最可靠的协作伙伴。通过承担重复性、确定性的研发工作，AI 让人类从繁琐的编码任务中解放出来，专注于真正需要创造力和战略思维的高价值工作。
+
+### 使命 (Mission)
+
+**构建无人值守的自动化产品研发框架，通过 AI 驱动完整 SDLC，人类专注于高价值决策**
+
+AutoSpec 的使命是实现"Human On the Loop"（人类在环上）而非"Human In the Loop"（人类在环内）的协作模式：
+- **AI 负责**: 需求分析、方案设计、编码实现、代码审查、测试验证、交付部署
+- **人类负责**: 方向决策、安全确认、价值判断、异常处理
+
+### 核心价值观 (Core Values)
+
+| 价值观 | 说明 |
+|--------|------|
+| **验证为王** | 确定性验证 > AI 审查 > AI 自审 |
+| **极简实用** | 能一个文件说清的不拆两个，5 分钟上手 |
+| **渐进自主** | 从"人审每步"到"人只管 harness" |
+| **安全优先** | 15 条宪法红线，不可逆操作人工确认 |
+| **持续进化** | 三层自进化体系，实战经验自动回流 |
+
+---
+
 ## 快速开始
 
+### 1. 安装
+
 ```bash
 # 全局安装
 npm install -g @chongyan/autospec
 
-# 在项目中初始化
+# 验证安装
+autospec --help
+```
+
+**环境要求**：Node.js >= 18.0.0
+
+### 2. 初始化项目
+
+```bash
 cd your-project
 autospec init
+```
+
+**初始化选项：**
+
+| 参数 | 简写 | 说明 | 可选值 |
+|------|------|------|--------|
+| `--workflow` | `-w` | 迭代模式 | `waterfall`（默认）, `agile`, `experiment`, `hotfix` |
+| `--roles` | `-r` | 角色 | `backend`, `frontend`, `data`, `ai`, `quality` |
+| `--domain` | `-d` | 领域（自由文本） | `fintech payment`, `ecommerce`... |
+
+```bash
+# 默认：瀑布迭代 + 通用领域
+autospec init
+
+# 热修复流程 + 后端角色
+autospec init -w hotfix -r backend
 
-# 在 Claude Code 中启动全流程（已包含需求探索）
+# 敏捷迭代 + 后端/AI 角色
+autospec init -w agile -r backend,ai
+
+# 金融支付领域 + 后端/数据角色
+autospec init -d "fintech payment" -r backend,data
+```
+
+### 3. 启动全流程
+
+在 Claude Code 中输入：
+
+```bash
 /autospec:run
 /autospec:run 开发用户收藏夹功能，支持按分类筛选
 ```
 
 > **注意**：`/autospec:run` 已包含完整的需求探索阶段（CEO 对齐 + 需求分析），无需提前执行 `/autospec:explore`。
 
-`autospec init` 会将知识层复制到 `.autospec/knowledge/`、插件层复制到 `.autospec/plugins/`，生成 Claude Code 斜杠命令、Skills（自动触发）、Agents（做审分离+CEO博弈+自主审批/安全审计/故障诊断）、Hooks（确定性守卫+质量监控+偏航检测）到 `.claude/` 目录，即装即用。
+### 执行模式
+
+| 模式 | 说明 | 场景 |
+|------|------|------|
+| **自主模式** | 全流程自动运行，AI 自主决策 | 自动化研发、无人值守 |
+| **交互模式** | 分阶段执行，每步需人工确认 | 学习阶段、复杂项目、安全关键 |
+
+**使用建议**：首次使用建议从交互模式开始，熟悉流程后再切换到自主模式。
+
+---
+
+## 核心思想
+
+### 三棱锥：第一性原则
+
+```
+        验证为王
+       /        \
+      /          \
+  极简实用 ———— 渐进自主
+```
+
+#### 验证为王（Verification-First）
+
+> "加速验证循环，而不是等待模型改进。" — Karpathy
+
+AI 的产出**本质上是非确定性的**。你不能信任它的"我做完了"，只能信任**可验证的证据**。
+
+AutoSpec 建立双层验证体系：
+- **Layer 1（确定性验证）**：编译、测试、lint、类型检查 — 机器判断，不可协商
+- **Layer 2（AI 审查）**：独立 AI 实例评审 — 出示结构化证据
+
+Layer 1 不过，Layer 2 不跑。
+
+#### 极简实用（Minimal Viable Process）
+
+> "使用者 5 分钟内能理解结构并开始使用。" — 设计铁律
+
+极简不是偷工减料，而是**不做不必要的事**：
+- 能一个文件说清的不拆两个
+- 能用 Markdown 定义的不写代码
+- 一种工作流不适合所有问题 — 按复杂度动态选择
+- 高频使用的提前建设，低频的用到再建
+
+#### 渐进自主（Progressive Autonomy）
+
+> "Human On the Loop — 不检查产出物，而是工程化 harness。" — Kief Morris
+
+信任是赚来的，不是默认给的：
+- **交互模式**：每阶段产出确认后才能进入下一阶段
+- **自主模式**：需求 + 设计 + 交付前确认，中间自主
 
-**注意**：`autospec init` 只复制框架文件和生成命令/skills/hooks。`runtime/`、`evolution/`、`environment/` 目录在运行时自动创建，第一次执行 `/autospec:env-sync` 时会扫描代码并生成环境知识配置。
+不满意产出时，**改 harness，不改产出**。
+
+### 核心设计原则
+
+详见 [`knowledge/01-principles/01-first-principles.md`](knowledge/01-principles/01-first-principles.md)
+
+| 原则 | 一句话 |
+|------|-------|
+| **DP1** 双层验证 | 确定性验证 + AI 审查，Layer 1 不过不进 Layer 2 |
+| **DP2** 做审分离 | 做和审由不同 AI 实例执行，信息隔离 |
+| **DP6** 精准回退 | 只重处理失败项，不全量重做 |
+| **DP8** CSO 原则 | Skill description 只写触发条件，迫使加载全文 |
+| **DP10** 安全与制动 | 四层安全模型 + 停线权 + 不可逆守卫 |
+| **DP16** 模板即约束 | 结构化模板约束输出，预防优于检测 |
+| **DP17** 结构化澄清 | 11 维扫描 + 最多 5 问 + AI 推荐答案 |
+| **DP18** 跨产物一致性 | 六维检测：重复/歧义/规格不全/宪法对齐/覆盖/术语漂移 |
+
+---
 
 ## 运作机制
 
 ### 研发流水线
 
 ```
-[Stage 0]  →  需求分析  →  方案设计  →  编码实现  →  代码审查  →  QA测试  →  交付部署
+[Stage 0]  →  需求分析  →  方案设计  →  编码实现  →  代码审查  →  QA 测试  →  交付部署
  环境就绪                                (含自测)    (独立实例)
                 ↓            ↓            ↓            ↓          ↓          ↓
             [Layer 1]    [Layer 1]    [Layer 1]    [Layer 1]  [Layer 1]  [Layer 1]
             [Layer 2]    [Layer 2]    [Layer 2]    [Layer 2]  [Layer 2]  [Layer 2]
-            [Layer 3]    [Layer 3]    [Layer 3]    [Layer 3]  [Layer 3]  [Layer 3]
 ```
 
-**三层验证体系**：
+**双层验证体系**：
 - **Layer 1（确定性）**：编译/测试/lint/类型检查 — 机器判断，不可协商
-- **Layer 2（AI审查）**：独立AI实例，结构化证据评审
-- **Layer 3（Benchmarks评测）**：自动生成阶段 benchmarks，综合评分指导优化
+- **Layer 2（AI 审查）**：独立 AI 实例，结构化证据评审
 
-Layer 1 不过，不进 Layer 2；Layer 2 不过，不进 Layer 3。
+Layer 1 不过，不进 Layer 2。
 
-### CEO 探索机制（需求分析前置步骤）
+### CEO 探索机制
 
-在需求分析之前，AutoSpec 使用双Agent对抗辩论来澄清需求：
+在需求分析之前，AutoSpec 使用双 Agent 对抗辩论来澄清需求：
 
-- **ceo**：从CEO/战略视角探索（商业价值、战略对齐）
+- **ceo**：从 CEO/战略视角探索（商业价值、战略对齐）
 - **product-owner**：从产品落地角度挑战（可行性、用户体验、数据驱动）
 
-**自主模式**：Agent自动辩论 → 共识成为需求，分歧标记待确认
+**自主模式**：Agent 自动辩论 → 共识成为需求，分歧标记待确认
 
-**交互模式**：AI提出5个战略问题并附带推荐答案 → 用户确认
+**交互模式**：AI 提出 5 个战略问题并附带推荐答案 → 用户确认
 
-### 两种执行模式
-
-| 模式 | 说明 | 场景 |
-|------|------|------|
-| **自主模式** | 全流程自动运行，AI自主决策 | 自动化研发、无人值守 |
-| **交互模式** | 分阶段执行，每步需人工确认 | 学习阶段、复杂项目、安全关键 |
-
-### 迭代模式（自主模式）
+### 迭代模式
 
 | 模式 | 阶段 | 说明 | 场景 |
 |------|------|------|------|
-| **Waterfall** | 01→02→03→04→05→06 | 完整6阶段 | 新功能、重大变更 |
+| **Waterfall** | 01→02→03→04→05→06 | 完整 6 阶段 | 新功能、重大变更 |
 | **Agile** | 01 + [02→03→04]×N + 05→06 | 故事驱动循环 | 迭代开发 |
-| **Experiment** | 01→02→03 + 效果评测 | 原型+AI评估 | 技术探索 |
-| **Hotfix** | 01→03→04→06 | 快速通道 | 紧急修复 |
+| **Experiment** | 01→02→03 + 效果评测 | 原型+AI 评估 | 技术探索 |
+| **Hotfix** | 需求→风险评估→实现→审查→部署 | 快速通道 | 紧急修复 |
+
+### 动态智能体调度
 
-## 斜杠命令
+AutoSpec 根据复杂度动态组织团队：
 
-所有命令支持直接跟参数：`/autospec:run 开发收藏夹功能` — 参数作为本阶段的补充上下文，无参数时按正常流程交互。
+```
+1. 读取 role-composition.yaml
+2. project-evolve-scanner 检测技术栈
+3. 根据复杂度选择团队：
+   - 简单：CEO + PO + TechLead
+   - 中等：+ Engineer
+   - 复杂：+ QA + Security + Data
+4. 涉及AI → 强制加入 ai-engineer
+5. 涉及数据 → 强制加入 data-engineer
+```
 
-### 自主模式（推荐）
+### 保障机制
 
-| 命令 | 说明 | 参数 |
-|------|------|------|
-| `/autospec:run` | 全流程自主运行 + 迭代模式选择 | --workflow, --roles, --domain |
+| 机制 | 说明 |
+|------|------|
+| 双层验证 | Layer1编译测试 + Layer2 AI审查 |
+| 做审分离 | 不同Agent实例，信息隔离 |
+| 精准回退 | 最多3次修复循环 |
+| 安全制动 | 不可逆动作需人工确认 |
+| 阶段门禁 | 每阶段验证通过才能进入下一阶段 |
+
+---
+
+## 命令系统
+
+### 斜杠命令（AI 驱动）
+
+#### 自主模式（推荐）
+
+| 命令 | 说明 |
+|------|------|
+| `/autospec:run` | 全流程自主运行 + 迭代模式选择 |
 
 **参数说明：**
 | 参数 | 简写 | 说明 | 可选值 |
@@ -109,111 +261,60 @@ Layer 1 不过，不进 Layer 2；Layer 2 不过，不进 Layer 3。
 | `--roles` | `-r` | 角色 | `backend`, `frontend`, `data`, `ai`, `quality` |
 | `--domain` | `-d` | 领域（自由文本） | `fintech payment system`... |
 
-### 交互模式（分阶段命令）
+#### 交互模式（分阶段命令）
 
 | 命令 | 中文 | 说明 |
 |------|------|------|
-| `/autospec:explore` | "我先想想" | CEO对齐 + 需求分析 |
+| `/autospec:explore` | "我先想想" | CEO 对齐 + 需求分析 |
 | `/autospec:propose` | "就这么干" | 方案设计 |
 | `/autospec:apply` | "开工，按单子做" | 编码 + 审查 + 测试 |
 | `/autospec:archive` | "做完了，收工" | 交付 + 进化归档 |
 
-### 工具命令
+#### 进化命令
+
+| 命令 | 层级 | 说明 |
+|------|------|------|
+| `/self-evolve` | L1 框架级 | AutoSpec 框架自身的迭代升级 |
+| `/autospec:field-evolve` | L2 领域级 | 从实战项目中学习和提炼能力 |
+| `/autospec:project-evolve` | L3 项目级 | 实战项目自身的代码、配置、文档优化 |
+
+#### 工具命令
 
 | 命令 | 说明 |
 |------|------|
 | `/autospec:status` | 查看流程进度 |
-| `/autospec:validate` | 运行 Layer 1 验证 |
-| `/self-evolve` | 自进化循环 |
-
-**迭代模式选择**：使用 `/autospec:run` 时，系统会智能推荐模式：
-- `--workflow=waterfall` 瀑布迭代（默认）
-- `--workflow=agile` 敏捷迭代
-- `--workflow=experiment` 实验模式（AI/ML）
-- `--workflow=hotfix` 热修复
-
-不指定模式时，AutoSpec 会根据任务描述自动推荐。
-
-### 命令输出示例
-
-#### `/autospec:run` 输出流程
-```
-┌─────────────────────────────────────────────────────────────┐
-│  AutoSpec 流水线                                          │
-├─────────────────────────────────────────────────────────────┤
-│  ✓ 阶段01: 需求分析     [Layer 1 ✓] [Layer 2 ✓]         │
-│  ✓ 阶段02: 方案设计     [Layer 1 ✓] [Layer 2 ✓]         │
-│  ✓ 阶段03: 编码实现     [Layer 1 ✓] [Layer 2 ✓]         │
-│  ✓ 阶段04: 代码审查     [Layer 1 ✓] [Layer 2 ✓]         │
-│  ✓ 阶段05: QA测试       [Layer 1 ✓] [Layer 2 ✓]         │
-│  ✓ 阶段06: 交付部署     [Layer 1 ✓] [Layer 2 ✓]         │
-├─────────────────────────────────────────────────────────────┤
-│  流水线执行成功！                                         │
-│  输出目录: .autospec/specs/{feature}/                     │
-└─────────────────────────────────────────────────────────────┘
-```
-
-#### `/autospec:status` 输出
-```
-┌─────────────────────────────────────────────────────────────┐
-│  AutoSpec 状态                                            │
-├─────────────────────────────────────────────────────────────┤
-│  当前阶段: 阶段03（编码实现）                              │
-│  进度: 3/6 阶段已完成                                    │
-│  工作流: waterfall                                       │
-│  最后更新: 2024-01-15 10:30:00                           │
-└─────────────────────────────────────────────────────────────┘
-```
-
-#### Layer 1 失败示例
-```
-┌─────────────────────────────────────────────────────────────┐
-│  Layer 1 验证失败                                         │
-├─────────────────────────────────────────────────────────────┤
-│  ✗ npm run build    → 退出码 1                           │
-│  ✗ npm test        → 3 个测试失败                        │
-│                                                                     │
-│  阻塞: 请先修复上述问题再进入 Layer 2                      │
-└─────────────────────────────────────────────────────────────┘
-```
+| `/autospec:test` | 统一测试命令（验证 + 修复 + 评测） |
+| `/autospec:memory` | 管理项目记忆系统 |
 
-## CLI 命令
+### CLI 命令
 
 ```bash
 # 初始化
 autospec init                              # 默认：瀑布迭代 + 通用领域
 autospec init -w hotfix -r backend         # 热修复流程 + 后端角色
-autospec init -w agile -r backend,ai       # 敏捷迭代 + 后端/AI角色
+autospec init -w agile -r backend,ai       # 敏捷迭代 + 后端/AI 角色
 autospec init -d "fintech payment" -r backend,data  # 金融支付领域 + 后端/数据角色
 
 # 状态和更新
-autospec status                            # 查看流程状态
+autospec list                              # 列出所有斜杠命令
 autospec update                            # 更新框架（保留状态）
 ```
 
-**Init 选项：**
-| 选项 | 简写 | 说明 | 可选值 |
-|------|------|------|--------|
-| `--workflow` | `-w` | 迭代模式 | `waterfall`, `agile`, `experiment`, `hotfix` |
-| `--domain` | `-d` | 业务领域（自由文本） | `fintech payment system`, `ecommerce`... |
-| `--roles` | `-r` | 角色 | `backend`, `frontend`, `data`, `ai`, `quality` |
-
 ### 环境衔接命令
 
 `autospec init` 会自动检测项目中的中间件和组件使用。环境知识管理命令：
 
 ```bash
-autospec env                      # 查看环境配置
-autospec env:sync                 # 从代码同步 + 自动激活
-autospec env:validate             # 验证配置完整性
-autospec env:import --git <url>   # 从 Git 导入组织知识库
-autospec env:import --npm <pkg>   # 从 npm 导入组织知识库
-autospec env:export <dir>         # 导出项目知识库
-autospec component                # 列出可用组件
-autospec component:add <name>     # 添加组件知识
+/autospec:env                      # 查看环境配置
+/autospec:env-sync                 # 从代码同步 + 自动激活
+/autospec:env-validate             # 验证配置完整性
+/autospec:env-export <dir>         # 导出项目知识库
+/autospec:component                # 列出可用组件
 ```
 
-**自动检测**：`autospec init` 自动扫描代码，识别 MySQL、Redis、Kafka、MongoDB、Elasticsearch、RabbitMQ、PostgreSQL 等中间件使用，生成知识配置并激活。详见 [环境衔接协议](knowledge/environment/README.md)。
+**自动检测**：`autospec init` 自动扫描代码，识别 MySQL、Redis、Kafka、MongoDB、Elasticsearch、RabbitMQ、PostgreSQL 等中间件使用，生成知识配置并激活。详见 [环境衔接协议](knowledge/06-environment/README.md)。
+
+---
 
 ## 自进化
 
@@ -221,68 +322,15 @@ AutoSpec 通过**三层自进化体系**持续自我完善，形成从项目实
 
 ### 三层自进化体系
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  L1: Self-Evolve (框架级)                                        │
-│  /self-evolve                                                    │
-│  目标: AutoSpec 框架自身的迭代升级                                  │
-│  产出: 框架技能、方法论、设计原则                                  │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 提炼
-┌─────────────────────────────────────────────────────────────────┐
-│  L2: Field-Evolve (领域级)                                        │
-│  /autospec:field-evolve                                          │
-│  目标: 框架从实战项目中学习和提炼能力                               │
-│  产出: 领域技能、最佳实践、benchmarks                              │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 应用
-┌─────────────────────────────────────────────────────────────────┐
-│  L3: Project-Evolve (项目级)                                      │
-│  /autospec:project-evolve                                        │
-│  目标: 实战项目自身的代码、配置、文档优化                          │
-│  产出: 代码质量提升、测试补全、文档完善                            │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-#### L1: Self-Evolve（框架自我进化）
-
-迭代 AutoSpec **自身**时，框架用自己的流程来完善自己（dogfooding）：
-
-```
-AutoSpec 自身改进需求 → 走 AutoSpec 流程 → practice-log → 框架进化
-                                              ↓
-                          同一次迭代既是产出，又是进化信号
-```
-
-- 通过 benchmark 评估进化效果，退化自动回滚
-- 框架越用越好，形成飞轮效应
-
-#### L2: Field-Evolve（领域进化）
-
-用 AutoSpec 驱动**其他项目**研发时，实践经验自动回流：
-
-```
-项目A研发 → practice-log → distiller提炼新skill → 框架变强
-项目B研发 → practice-log → extractor提炼methodology → 框架变强
-        ↓
-每个项目的经验都让下一个项目更顺畅
-```
-
-- 分析实战项目中的 benchmarks 评测数据，提炼有效模式
-- 通用的改进贡献回核心框架
-
-#### L3: Project-Evolve（项目自我进化）
-
-实战项目**自身**的代码、配置、文档优化：
-
-```
-代码扫描 → 问题检测 → 自动修复 → 质量提升
-    ↑                        ↓
-    └────── 持续巡航 ←───────┘
-```
+| 层级 | 命令 | 目标 | 产出 |
+|------|------|------|------|
+| **L1: Self-Evolve (框架级)** | `/self-evolve` | AutoSpec 框架自身的迭代升级 | 框架技能、方法论、设计原则 |
+| **L2: Field-Evolve (领域级)** | `/autospec:field-evolve` | 框架从实战项目中学习和提炼能力 | 领域技能、最佳实践、benchmarks |
+| **L3: Project-Evolve (项目级)** | `/autospec:project-evolve` | 实战项目自身的代码、配置、文档优化 | 代码质量提升、测试补全、文档完善 |
 
-- 智能感知代码质量问题、测试缺口
-- 基于 benchmarks 评测指导优化方向
+**数据流向**：
+- 向下流动：L1 → L2 → L3 是能力下发（框架升级 → 领域技能 → 项目应用）
+- 向上流动：L3 → L2 → L1 是经验回流（项目实践 → 领域提炼 → 框架升级）
 
 ### 进化分区
 
@@ -295,18 +343,6 @@ AutoSpec 自身改进需求 → 走 AutoSpec 流程 → practice-log → 框架
 
 **核心安全原则**：进化系统不可修改自己的评判标准（不可变评判器）。
 
-### 基于评测驱动的进化
-
-```
-实战流程执行
-    ↓
-自动生成 Benchmarks（基于项目特点）
-    ↓
-执行 Benchmarks 评测（Layer 1 + Layer 2 + Layer 3）
-    ↓
-生成评测报告 → Field-Evolve 分析 → 提炼通用模板 → 更新框架能力
-```
-
 ### 企业适配
 
 ```
@@ -323,18 +359,20 @@ AutoSpec 自身改进需求 → 走 AutoSpec 流程 → practice-log → 框架
 
 通过 `autospec init --domain <domain>` 配置领域叠加层。叠加层追加领域特有规则和技能，**不分叉**核心框架。
 
-## 安全模型
+---
 
-五层安全防护：
+## 安全与质量
 
-1. **宪法门禁** — 13条不可违反的红线
-2. **权限控制** — 每个agent只能用它该用的工具
-3. **停线权** — 安全漏洞/数据丢失/3次修不好 → 立即停止
-   - **精准回退**：Level 1（内联重试）→ Level 2（修正循环，最多3次）→ Level 3（升级人工）
-4. **不可逆守卫** — DB迁移、部署、外部API → 必须人工确认
+### 五层安全防护
+
+1. **宪法门禁** — 15 条不可违反的红线
+2. **权限控制** — 每个 agent 只能用它该用的工具
+3. **停线权** — 安全漏洞/数据丢失/3 次修不好 → 立即停止
+   - **精准回退**：Level 1（内联重试）→ Level 2（修正循环，最多 3 次）→ Level 3（升级人工）
+4. **不可逆守卫** — DB 迁移、部署、外部 API → 必须人工确认
 5. **不可变评判器** — 进化系统不可修改自己的评判标准和宪法
 
-## 质量监控
+### 质量监控
 
 AutoSpec 通过确定性 Hook 自动采集流水线质量指标：
 
@@ -348,123 +386,217 @@ AutoSpec 通过确定性 Hook 自动采集流水线质量指标：
 
 指标存储于 `.autospec/runtime/metrics.json`，交付时自动汇入 practice-log。
 
-## 认知增强
+---
+
+## 知识层结构
+
+AutoSpec 的知识层按优先级分为 9 个模块，每个模块独立维护并在 `knowledge/` 目录下有详细的 README 导航文件。
+
+### 概览
+
+| 序号 | 模块 | 进化分区 | 简介 |
+|------|------|---------|------|
+| **01** | [principles/](knowledge/01-principles/README.md) | 🔴 冻结区 | 原则层 — 宪法、进化规则、核心原则、设计哲学（4 层原则体系 L1-L4） |
+| **02** | [process/](knowledge/02-process/README.md) | 🟡 受控区 | 流程层 — 6 阶段执行流程 + 4 种工作流（waterfall/agile/experiment/hotfix） |
+| **03** | [guides/](knowledge/03-guides/README.md) | 🟡/🟢 混合 | 能力指南 — 51 个技能文件（阶段执行 + 审查 + 测试 + 进化 +AI 专项） |
+| **04** | [checklists/](knowledge/04-checklists/README.md) | 🟡 受控区 | 检查清单 — 各阶段检查项（需求/设计/编码/测试/发布） |
+| **05** | [config/](knowledge/05-config/README.md) | 🟡 受控区 | 配置文件 — 验证模式、团队触发器、角色配置（含动态决策树） |
+| **06** | [environment/](knowledge/06-environment/README.md) | 🔵 环境知识区 | 环境知识 — 中间件、组件、集成协议（自动检测 + 知识回流） |
+| **07** | [standards/](knowledge/07-standards/README.md) | 🟡 受控区 | 标准规范 — 编码/审查/数据一致性/文档版本化/风险检测 |
+| **08** | [organization/](knowledge/08-organization/README.md) | 🟢 自由区 | 组织知识 — 愿景使命、AI Native 文化、团队度量、治理委员会 |
+| **09** | [templates/](knowledge/09-templates/README.md) | 🟡 受控区 | 文档模板 — 标准化模板库（架构/API/数据库/产品/测试/评测） |
 
-AutoSpec 在每个流水线阶段注入 10 条认知增强原则（详见 `knowledge/principles/design-philosophy.md`）：
+### 01-principles/ — 原则层（宪法级）
 
-- **CP1 合伙人模式** — 挑战假设、指出盲区（需求/审查/测试阶段重点）
-- **CP3 先问后做** — 不确定时先确认再行动（需求/设计阶段重点）
-- **CP5 置信度标注** — 不确定的判断必须标注置信度（全阶段）
-- **CP6 错误即信号** — 每次回退/纠正驱动进化（测试/进化阶段重点）
-- **CP8 偏航检测** — 三级递增提醒（编码/交付阶段重点）
-- **CP9 刚好够用** — 抵制过度设计（设计/编码阶段重点）
-- **CP10 自我质检** — 输出前自检清单（编码/测试/交付阶段重点）
+> 详见：[knowledge/01-principles/README.md](knowledge/01-principles/README.md)
 
-## 文档
+原则层是 AutoSpec 的最高指导原则，包含 4 个层级（L1→L2→L3→L4）：
 
-| 文档 | 说明 |
+| 文件 | 说明 |
 |------|------|
-| [设计理念](docs/design-philosophy.md) | 为什么做 AutoSpec，核心原则，关键设计决策 |
-| [实现原理](docs/architecture.md) | 怎么实现的 — 流水线、验证、集成、进化 |
-| [实操手册](docs/getting-started.md) | 从安装到跑通第一个全流程的完整指南 |
-| [对比分析](docs/comparisons.md) | 与 OpenSpec、Spec Kit、autoresearch、Claude Code 的详细对比 |
-| [环境衔接协议](knowledge/environment/README.md) | 中间件检测、知识管理、组织知识库导入 |
+| [00-principles-hierarchy.md](knowledge/01-principles/00-principles-hierarchy.md) | 原则体系总纲（L1 第一性原则→L2 战略原则→L3 战术原则→L4 操作原则完整追溯） |
+| [01-first-principles.md](knowledge/01-principles/01-first-principles.md) | L1 第一性原则（三棱锥：验证为王、极简实用、渐进自主） |
+| [02-strategic-principles.md](knowledge/01-principles/02-strategic-principles.md) | L2 战略原则（S1 双层验证、S2 做审分离、S3 Harness 工程、S4 知情猜测） |
+| [03-tactical-principles.md](knowledge/01-principles/03-tactical-principles.md) | L3 战术原则（T1-T6：任务分解、上下文管理、精准回退等） |
+| [04-operational-principles.md](knowledge/01-principles/04-operational-principles.md) | L4 操作原则（O1-O4：编码规范级别） |
+| [09-constitution.md](knowledge/01-principles/09-constitution.md) | 项目宪法（15 条红线：安全/流程/决策/数据/运维） |
+| [10-evolution-mechanism.md](knowledge/01-principles/10-evolution-mechanism.md) | 自进化机制（三层进化体系 + 进化分区 + 自主修复） |
 
-## 项目结构
+### 02-process/ — 流程层
 
-### 人类-[skills]-创业团队-skills-领域知识分层
+> 详见：[knowledge/02-process/README.md](knowledge/02-process/README.md)
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  人类维护层 (Human-maintained)                                    │
-│  knowledge/domain/ - 业务知识（术语、规则、流程）                │
-│  由领域专家维护，AI 读取但不修改                                   │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 驱动
-┌─────────────────────────────────────────────────────────────────┐
-│  创业团队 Skills (AI Agent Roles)                                 │
-│  plugins/agents/roles/ - CEO、产品负责人、技术负责人、工程师等      │
-│  模拟创业团队对抗审查，多视角审视产出                              │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 执行
-┌─────────────────────────────────────────────────────────────────┐
-│  阶段 Skills (Stage Skills)                                       │
-│  plugins/skills/*-stage/ - 需求分析、方案设计、编码实现等           │
-│  驱动各阶段执行，产出标准化产物                                    │
-└─────────────────────────────────────────────────────────────────┘
-                              ↓ 支撑
-┌─────────────────────────────────────────────────────────────────┐
-│  领域知识/规范分层 (Knowledge & Standards)                        │
-│  knowledge/ - 原则、流程、指南、检查清单                          │
-│  按冻结区/受控区/自由区分层管理                                    │
-└─────────────────────────────────────────────────────────────────┘
-```
+流程层定义 AutoSpec 的 6 阶段执行流程和 4 种工作流：
 
-### 目录结构
+| 文件 | 说明 |
+|------|------|
+| [00-overview.md](knowledge/02-process/00-overview.md) | 流程概览、启动门禁、执行模式 |
+| [01-requirement.md](knowledge/02-process/01-requirement.md) | 需求分析阶段 |
+| [02-design.md](knowledge/02-process/02-design.md) | 方案设计阶段 |
+| [03-implementation.md](knowledge/02-process/03-implementation.md) | 编码实现阶段 |
+| [04-review.md](knowledge/02-process/04-review.md) | 代码审查阶段 |
+| [05-testing.md](knowledge/02-process/05-testing.md) | QA 测试阶段 |
+| [06-delivery.md](knowledge/02-process/06-delivery.md) | 交付部署阶段 |
 
-```
-knowledge/             # 知识层（宪法、流程、原则、指南、环境知识）
-├── principles/         # 原则层（宪法、进化规则、设计哲学）
-├── process/            # 流程知识（6阶段 + 4种工作流）
-├── guides/             # 能力指南（阶段技能 + 支撑技能）
-├── checklists/         # 检查清单
-├── environment/        # 环境知识（中间件、组件、检测模式）
-├── config/             # 配置知识
-├── domain/             # 业务知识（术语、规则、流程图）- 人类维护
-└── templates/          # 文档模板
+### 03-guides/ — 能力指南
 
-plugins/               # 插件层（命令、智能体、技能、钩子）
-├── commands/           # 斜杠命令模板
-├── agents/             # 智能体定义（角色 + 支撑）
-│   ├── roles/          # 创业团队角色（CEO、产品负责人、工程师等）
-│   └── support/        # 支撑智能体（审查者、评估者等）
-├── skills/             # 技能触发器
-│   ├── *-stage/        # 阶段技能
-│   ├── benchmark-*/    # 评测相关技能
-│   └── evolution/      # 进化相关技能
-└── hooks/              # 生命周期钩子
-
-scripts/               # 执行层（CLI 工具、安装模块）
-├── cli/                # CLI 入口
-├── install/            # 安装生成器
-└── config/             # 配置管理
-```
+> 详见：[knowledge/03-guides/README.md](knowledge/03-guides/README.md)
+
+能力指南包含 51 个技能文件，覆盖核心协议、阶段执行、审查技能、测试执行、进化支撑、AI 专项等：
+
+| 分类 | 序号范围 | 文件数 |
+|------|---------|--------|
+| 核心协议 | 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 |
+
+### 04-checklists/ — 检查清单
+
+> 详见：[knowledge/04-checklists/README.md](knowledge/04-checklists/README.md)
+
+各阶段的检查清单，确保质量左移：
+
+| 文件 | 说明 |
+|------|------|
+| [00-requirement.md](knowledge/04-checklists/00-requirement.md) | 需求检查清单 |
+| [01-design.md](knowledge/04-checklists/01-design.md) | 设计检查清单 |
+| [02-code.md](knowledge/04-checklists/02-code.md) | 编码检查清单 |
+| [03-test.md](knowledge/04-checklists/03-test.md) | 测试检查清单 |
+| [04-release.md](knowledge/04-checklists/04-release.md) | 发布检查清单 |
+
+### 05-config/ — 配置文件
+
+> 详见：[knowledge/05-config/README.md](knowledge/05-config/README.md)
+
+验证模式、团队触发器、角色配置等配置文件：
+
+| 文件 | 说明 |
+|------|------|
+| [00-validation-patterns.yaml](knowledge/05-config/00-validation-patterns.yaml) | 验证模式配置 |
+| [01-team-stage.yaml](knowledge/05-config/01-team-stage.yaml) | 团队阶段配置（含触发器） |
+| [02-team-tasks.yaml](knowledge/05-config/02-team-tasks.yaml) | 团队任务配置 |
+| [03-role-composition.yaml](knowledge/05-config/03-role-composition.yaml) | 角色组合配置（含动态决策树） |
+
+### 06-environment/ — 环境知识
+
+> 详见：[knowledge/06-environment/README.md](knowledge/06-environment/README.md)
+
+环境衔接协议，让 AutoSpec 能够与不同组织的中间件、组件、自定义框架等稳定安全高效衔接：
+
+| 文件 | 说明 |
+|------|------|
+| [00-template-registry.md](knowledge/06-environment/00-template-registry.md) | 模板注册表 |
+| [01-detection-patterns.yaml](knowledge/06-environment/01-detection-patterns.yaml) | 检测模式配置 |
+
+模板资源（已整合到 09-templates）：
 
-> **运行时目录**：`evaluation/`（基准案例）在流水线执行时自动生成
+| 文件 | 说明 |
+|------|------|
+| [13-middleware-knowledge.md](knowledge/09-templates/13-middleware-knowledge.md) | 中间件知识模板 |
+| [10-component-knowledge.md](knowledge/09-templates/10-component-knowledge.md) | 组件知识模板 |
+
+### 07-standards/ — 标准规范
+
+> 详见：[knowledge/07-standards/README.md](knowledge/07-standards/README.md)
+
+编码/审查/数据一致性等标准规范：
+
+| 文件 | 说明 |
+|------|------|
+| [00-coding-style.md](knowledge/07-standards/00-coding-style.md) | 编码规范 |
+| [01-code-review.md](knowledge/07-standards/01-code-review.md) | 代码审查规范 |
+| [02-data-consistency.md](knowledge/07-standards/02-data-consistency.md) | 数据一致性规范 |
+| [03-document-versioning.md](knowledge/07-standards/03-document-versioning.md) | 文档版本化规范 |
+| [04-risk-detection.md](knowledge/07-standards/04-risk-detection.md) | 风险检测规范 |
 
-### 环境衔接协议
+### 08-organization/ — 组织知识
 
-让 AutoSpec 能够快捷地与不同组织的中间件、组件、自定义框架、CI/CD环境等稳定安全高效衔接。
+> 详见：[knowledge/08-organization/README.md](knowledge/08-organization/README.md)
 
-**核心能力**：
-- **自动检测**：初始化时自动扫描代码，识别中间件使用（MySQL/Redis/Kafka/MongoDB/ES/RabbitMQ/PostgreSQL）
-- **知识管理**：支持极简格式（只需 name + envVars，AI 自动补全）和详细格式
-- **组织导入**：支持从 Git/npm/本地导入组织知识库
-- **自动激活**：检测到的知识自动注册并激活，后续流程自动注入上下文
+AI Native 团队文化、愿景、治理相关：
 
-详见 [环境衔接协议文档](knowledge/environment/README.md)。
+| 文件 | 说明 |
+|------|------|
+| [00-vision-mission.md](knowledge/08-organization/00-vision-mission.md) | 愿景、使命、核心价值观（验证为王、极简实用、渐进自主、安全优先、持续进化） |
+| [01-ai-native-culture.md](knowledge/08-organization/01-ai-native-culture.md) | AI Native 团队文化手册（四原则、工作模式、角色转变） |
+| [02-team-metrics.md](knowledge/08-organization/02-team-metrics.md) | 团队度量体系（AI 能力、流程效率、质量、团队健康） |
+| [03-committee-structure.md](knowledge/08-organization/03-committee-structure.md) | 治理委员会架构（技术/质量/战略委员会 + 治理 Agent） |
+| [04-governance-metrics.md](knowledge/08-organization/04-governance-metrics.md) | 治理监测指标（DORA/Layer1/Layer2/Benchmarks 通过率） |
+| [05-improvement-process.md](knowledge/08-organization/05-improvement-process.md) | 改进流程（改进来源/流程/分类/与自进化联动） |
+
+### 09-templates/ — 文档模板
+
+> 详见：[knowledge/09-templates/README.md](knowledge/09-templates/README.md)
 
-## 设计哲学
+标准化文档模板库（按优先级排序）：
 
-详见 [`knowledge/principles/design-philosophy.md`](knowledge/principles/design-philosophy.md)，包含18条设计原则（DP1–DP18），核心包括：
+| 文件 | 说明 |
+|------|------|
+| [01-architecture-design.md](knowledge/09-templates/01-architecture-design.md) | 架构设计模板 |
+| [02-api-design.md](knowledge/09-templates/02-api-design.md) | API 设计模板 |
+| [03-database-design.md](knowledge/09-templates/03-database-design.md) | 数据库设计模板 |
+| [04-product-design.md](knowledge/09-templates/04-product-design.md) | 产品设计模板 |
+| [05-business-glossary.md](knowledge/09-templates/05-business-glossary.md) | 业务术语模板 |
+| [06-business-rules.md](knowledge/09-templates/06-business-rules.md) | 业务规则模板 |
+| [07-business-flows.md](knowledge/09-templates/07-business-flows.md) | 业务流程模板 |
+| [08-test-design.md](knowledge/09-templates/08-test-design.md) | 测试设计模板 |
+| [09-evaluation-design.md](knowledge/09-templates/09-evaluation-design.md) | 评测设计模板（AI/模型） |
+| [10-component-knowledge.md](knowledge/09-templates/10-component-knowledge.md) | 组件知识模板 |
+| [11-best-practices.md](knowledge/09-templates/11-best-practices.md) | 最佳实践模板 |
+| [12-domain-model.md](knowledge/09-templates/12-domain-model.md) | 领域模型模板 |
+
+---
 
-- **DP1** 双层验证
-- **DP2** 做审分离
-- **DP6** 精准回退（不是全盘重来）
-- **DP7** 反模式接种
-- **DP8** CSO原则（强制完整加载skill）
-- **DP10** 安全与紧急停止
-- **DP12** 驯服非确定性
-- **DP16** 模板即约束（质量左移）
-- **DP17** 结构化澄清协议
-- **DP18** 跨产物一致性分析
+## 插件层结构
+
+```
+plugins/               # 插件层（命令、智能体、技能、钩子）
+├── commands/           # 斜杠命令模板
+├── agents/             # 智能体定义（角色 + 支撑）
+│   ├── roles/          # 创业团队角色（CEO、产品负责人、工程师等）
+│   └── support/        # 支撑智能体（审查者、评估者、阶段门禁等）
+├── skills/             # 技能触发器
+│   ├── *-stage/        # 阶段技能（requirement/design/implementation/testing/delivery）
+│   ├── *-iteration/    # 迭代技能（waterfall/agile/experiment/hotfix）
+│   ├── field-evolve-*/ # 领域进化技能（scanner/executor/analyzer/fixer/verifier/learner/distiller）
+│   ├── project-evolve-*/ # 项目进化技能（scanner/generator/analyzer/fixer/reviewer/verifier/learner）
+│   └── benchmark-*/    # 评测相关技能
+└── hooks/              # 生命周期钩子（冻结区守卫/范围哨兵/Layer1 验证器/执行追踪器/环境管理器）
+```
+
+### 最新技能列表
+
+**领域进化技能（L2 Field-Evolve）**：
+- `field-evolve-scanner` - 扫描实践日志，识别模式
+- `field-evolve-executor` - 执行进化流程
+- `field-evolve-analyzer` - 分析进化效果
+- `field-evolve-fixer` - 修复进化问题
+- `field-evolve-verifier` - 验证进化结果
+- `field-evolve-learner` - 学习进化经验
+- `field-evolve-distiller` - 蒸馏通用技能
+
+**项目进化技能（L3 Project-Evolve）**：
+- `project-evolve-scanner` - 扫描项目代码质量
+- `project-evolve-generator` - 生成优化方案
+- `project-evolve-analyzer` - 分析项目问题
+- `project-evolve-fixer` - 修复项目问题
+- `project-evolve-reviewer` - 审查修复结果
+- `project-evolve-verifier` - 验证修复效果
+- `project-evolve-learner` - 学习项目经验
+
+---
 
 ## 参与贡献
 
 欢迎贡献以下方面：
 - 流程管线和技能定义优化
 - 新领域角色画像和业务技能
-- CLI工具改进
+- CLI 工具改进
 - 实际使用的实践记录
 - 企业适配经验
 - 文档和翻译
@@ -473,4 +605,4 @@ scripts/               # 执行层（CLI 工具、安装模块）
 
 ## License
 
-[MIT](./LICENSE)
+[MIT](./LICENSE)