@chongyan/autospec 1.0.1

package/README.md

@@ -0,0 +1,476 @@
+<div align="center">
+
+# AutoSpec
+
+**无人值守的自动化产品研发 —— AI驱动全流程，人只在关键决策点介入。**
+
+[English](./README.en.md) · [快速开始](#快速开始) · [运作机制](#运作机制) · [文档](#文档) · [参与贡献](./CONTRIBUTING.md)
+
+</div>
+
+---
+
+## 一句话价值
+
+AutoSpec 是一个 AI 驱动的全流程研发管线，自动完成从需求分析到交付部署的完整软件开发周期。它不是"让 AI 写代码更快"，而是"AI 自主完成完整 SDLC，人在关键节点介入（Human On the Loop）"。
+
+## 核心特性（5条）
+
+| 特性 | 说明 |
+|------|------|
+| **AI 自主研发** | 从需求到交付，AI 全流程自动执行 |
+| **三层验证** | 确定性验证 → AI 审查 → Benchmarks 评测 |
+| **做审分离** | 不同 AI 实例执行，信息隔离 |
+| **宪法安全** | 13 条红线，不可逆操作人工确认 |
+| **自进化** | 实战经验自动回流，持续优化 |
+
+## 快速开始
+
+```bash
+# 全局安装
+npm install -g @chongyan/autospec
+
+# 在项目中初始化
+cd your-project
+autospec init
+
+# 在 Claude Code 中启动全流程（已包含需求探索）
+/autospec:run
+/autospec:run 开发用户收藏夹功能，支持按分类筛选
+```
+
+> **注意**：`/autospec:run` 已包含完整的需求探索阶段（CEO 对齐 + 需求分析），无需提前执行 `/autospec:explore`。
+
+`autospec init` 会将知识层复制到 `.autospec/knowledge/`、插件层复制到 `.autospec/plugins/`，生成 Claude Code 斜杠命令、Skills（自动触发）、Agents（做审分离+CEO博弈+自主审批/安全审计/故障诊断）、Hooks（确定性守卫+质量监控+偏航检测）到 `.claude/` 目录，即装即用。
+
+**注意**：`autospec init` 只复制框架文件和生成命令/skills/hooks。`runtime/`、`evolution/`、`environment/` 目录在运行时自动创建，第一次执行 `/autospec:env-sync` 时会扫描代码并生成环境知识配置。
+
+## 运作机制
+
+### 研发流水线
+
+```
+[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 1 不过，不进 Layer 2；Layer 2 不过，不进 Layer 3。
+
+### CEO 探索机制（需求分析前置步骤）
+
+在需求分析之前，AutoSpec 使用双Agent对抗辩论来澄清需求：
+
+- **ceo**：从CEO/战略视角探索（商业价值、战略对齐）
+- **product-owner**：从产品落地角度挑战（可行性、用户体验、数据驱动）
+
+**自主模式**：Agent自动辩论 → 共识成为需求，分歧标记待确认
+
+**交互模式**：AI提出5个战略问题并附带推荐答案 → 用户确认
+
+### 两种执行模式
+
+| 模式 | 说明 | 场景 |
+|------|------|------|
+| **自主模式** | 全流程自动运行，AI自主决策 | 自动化研发、无人值守 |
+| **交互模式** | 分阶段执行，每步需人工确认 | 学习阶段、复杂项目、安全关键 |
+
+### 迭代模式（自主模式）
+
+| 模式 | 阶段 | 说明 | 场景 |
+|------|------|------|------|
+| **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 | 快速通道 | 紧急修复 |
+
+## 斜杠命令
+
+所有命令支持直接跟参数：`/autospec:run 开发收藏夹功能` — 参数作为本阶段的补充上下文，无参数时按正常流程交互。
+
+### 自主模式（推荐）
+
+| 命令 | 说明 | 参数 |
+|------|------|------|
+| `/autospec:run` | 全流程自主运行 + 迭代模式选择 | --workflow, --roles, --domain |
+
+**参数说明：**
+| 参数 | 简写 | 说明 | 可选值 |
+|------|------|------|--------|
+| `--workflow` | `-w` | 迭代模式 | `waterfall`, `agile`, `experiment`, `hotfix` |
+| `--roles` | `-r` | 角色 | `backend`, `frontend`, `data`, `ai`, `quality` |
+| `--domain` | `-d` | 领域（自由文本） | `fintech payment system`... |
+
+### 交互模式（分阶段命令）
+
+| 命令 | 中文 | 说明 |
+|------|------|------|
+| `/autospec:explore` | "我先想想" | CEO对齐 + 需求分析 |
+| `/autospec:propose` | "就这么干" | 方案设计 |
+| `/autospec:apply` | "开工，按单子做" | 编码 + 审查 + 测试 |
+| `/autospec:archive` | "做完了，收工" | 交付 + 进化归档 |
+
+### 工具命令
+
+| 命令 | 说明 |
+|------|------|
+| `/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                      │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## CLI 命令
+
+```bash
+# 初始化
+autospec init                              # 默认：瀑布迭代 + 通用领域
+autospec init -w hotfix -r backend         # 热修复流程 + 后端角色
+autospec init -w agile -r backend,ai       # 敏捷迭代 + 后端/AI角色
+autospec init -d "fintech payment" -r backend,data  # 金融支付领域 + 后端/数据角色
+
+# 状态和更新
+autospec status                            # 查看流程状态
+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 init` 自动扫描代码，识别 MySQL、Redis、Kafka、MongoDB、Elasticsearch、RabbitMQ、PostgreSQL 等中间件使用，生成知识配置并激活。详见 [环境衔接协议](knowledge/environment/README.md)。
+
+## 自进化
+
+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（项目自我进化）
+
+实战项目**自身**的代码、配置、文档优化：
+
+```
+代码扫描 → 问题检测 → 自动修复 → 质量提升
+    ↑                        ↓
+    └────── 持续巡航 ←───────┘
+```
+
+- 智能感知代码质量问题、测试缺口
+- 基于 benchmarks 评测指导优化方向
+
+### 进化分区
+
+| 分区 | 对应层级 | 内容 | 规则 |
+|------|---------|------|------|
+| **冻结区** | L1 核心 | 宪法、进化规则、核心原则 | 人工变更，不可自动修改 |
+| **受控区** | L1/L2 交界 | 阶段定义、通用技能、角色画像 | 自动提议，人工批准 |
+| **自由区** | L2 领域 | 业务技能、benchmarks、决策树 | 自动进化，验证器校验 |
+| **环境知识区** | L3 项目 | 环境配置、组件库、最佳实践 | 项目级自动优化 |
+
+**核心安全原则**：进化系统不可修改自己的评判标准（不可变评判器）。
+
+### 基于评测驱动的进化
+
+```
+实战流程执行
+    ↓
+自动生成 Benchmarks（基于项目特点）
+    ↓
+执行 Benchmarks 评测（Layer 1 + Layer 2 + Layer 3）
+    ↓
+生成评测报告 → Field-Evolve 分析 → 提炼通用模板 → 更新框架能力
+```
+
+### 企业适配
+
+```
+┌─────────────────────────────────┐
+│         企业叠加层               │  ← 企业特有（不上游合并）
+│  org-constitution.md            │
+│  org-skills/ + domain-knowledge │
+├─────────────────────────────────┤
+│         AutoSpec 核心框架        │  ← npm install（可升级）
+│  constitution.md                │
+│  process/ guides/ agents/ ...   │
+└─────────────────────────────────┘
+```
+
+通过 `autospec init --domain <domain>` 配置领域叠加层。叠加层追加领域特有规则和技能，**不分叉**核心框架。
+
+## 安全模型
+
+五层安全防护：
+
+1. **宪法门禁** — 13条不可违反的红线
+2. **权限控制** — 每个agent只能用它该用的工具
+3. **停线权** — 安全漏洞/数据丢失/3次修不好 → 立即停止
+   - **精准回退**：Level 1（内联重试）→ Level 2（修正循环，最多3次）→ Level 3（升级人工）
+4. **不可逆守卫** — DB迁移、部署、外部API → 必须人工确认
+5. **不可变评判器** — 进化系统不可修改自己的评判标准和宪法
+
+## 质量监控
+
+AutoSpec 通过确定性 Hook 自动采集流水线质量指标：
+
+| 指标 | 采集方式 | 用途 |
+|------|---------|------|
+| Layer 1 通过率 | `layer1-validator` | 代码质量基线 |
+| 回退次数 | `layer1-validator` | 流程顺畅度 |
+| 人工介入次数 | `layer1-validator` | 自主能力评估 |
+| 范围偏航事件 | `scope-sentinel` | 方案执行纪律 |
+| 错误模式 | `layer1-validator` | 进化优先级 |
+
+指标存储于 `.autospec/runtime/metrics.json`，交付时自动汇入 practice-log。
+
+## 认知增强
+
+AutoSpec 在每个流水线阶段注入 10 条认知增强原则（详见 `knowledge/principles/design-philosophy.md`）：
+
+- **CP1 合伙人模式** — 挑战假设、指出盲区（需求/审查/测试阶段重点）
+- **CP3 先问后做** — 不确定时先确认再行动（需求/设计阶段重点）
+- **CP5 置信度标注** — 不确定的判断必须标注置信度（全阶段）
+- **CP6 错误即信号** — 每次回退/纠正驱动进化（测试/进化阶段重点）
+- **CP8 偏航检测** — 三级递增提醒（编码/交付阶段重点）
+- **CP9 刚好够用** — 抵制过度设计（设计/编码阶段重点）
+- **CP10 自我质检** — 输出前自检清单（编码/测试/交付阶段重点）
+
+## 文档
+
+| 文档 | 说明 |
+|------|------|
+| [设计理念](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) | 中间件检测、知识管理、组织知识库导入 |
+
+## 项目结构
+
+### 人类-[skills]-创业团队-skills-领域知识分层
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  人类维护层 (Human-maintained)                                    │
+│  knowledge/domain/ - 业务知识（术语、规则、流程）                │
+│  由领域专家维护，AI 读取但不修改                                   │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓ 驱动
+┌─────────────────────────────────────────────────────────────────┐
+│  创业团队 Skills (AI Agent Roles)                                 │
+│  plugins/agents/roles/ - CEO、产品负责人、技术负责人、工程师等      │
+│  模拟创业团队对抗审查，多视角审视产出                              │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓ 执行
+┌─────────────────────────────────────────────────────────────────┐
+│  阶段 Skills (Stage Skills)                                       │
+│  plugins/skills/*-stage/ - 需求分析、方案设计、编码实现等           │
+│  驱动各阶段执行，产出标准化产物                                    │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓ 支撑
+┌─────────────────────────────────────────────────────────────────┐
+│  领域知识/规范分层 (Knowledge & Standards)                        │
+│  knowledge/ - 原则、流程、指南、检查清单                          │
+│  按冻结区/受控区/自由区分层管理                                    │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 目录结构
+
+```
+knowledge/             # 知识层（宪法、流程、原则、指南、环境知识）
+├── principles/         # 原则层（宪法、进化规则、设计哲学）
+├── process/            # 流程知识（6阶段 + 4种工作流）
+├── guides/             # 能力指南（阶段技能 + 支撑技能）
+├── checklists/         # 检查清单
+├── environment/        # 环境知识（中间件、组件、检测模式）
+├── config/             # 配置知识
+├── domain/             # 业务知识（术语、规则、流程图）- 人类维护
+└── templates/          # 文档模板
+
+plugins/               # 插件层（命令、智能体、技能、钩子）
+├── commands/           # 斜杠命令模板
+├── agents/             # 智能体定义（角色 + 支撑）
+│   ├── roles/          # 创业团队角色（CEO、产品负责人、工程师等）
+│   └── support/        # 支撑智能体（审查者、评估者等）
+├── skills/             # 技能触发器
+│   ├── *-stage/        # 阶段技能
+│   ├── benchmark-*/    # 评测相关技能
+│   └── evolution/      # 进化相关技能
+└── hooks/              # 生命周期钩子
+
+scripts/               # 执行层（CLI 工具、安装模块）
+├── cli/                # CLI 入口
+├── install/            # 安装生成器
+└── config/             # 配置管理
+```
+
+> **运行时目录**：`evaluation/`（基准案例）在流水线执行时自动生成
+
+### 环境衔接协议
+
+让 AutoSpec 能够快捷地与不同组织的中间件、组件、自定义框架、CI/CD环境等稳定安全高效衔接。
+
+**核心能力**：
+- **自动检测**：初始化时自动扫描代码，识别中间件使用（MySQL/Redis/Kafka/MongoDB/ES/RabbitMQ/PostgreSQL）
+- **知识管理**：支持极简格式（只需 name + envVars，AI 自动补全）和详细格式
+- **组织导入**：支持从 Git/npm/本地导入组织知识库
+- **自动激活**：检测到的知识自动注册并激活，后续流程自动注入上下文
+
+详见 [环境衔接协议文档](knowledge/environment/README.md)。
+
+## 设计哲学
+
+详见 [`knowledge/principles/design-philosophy.md`](knowledge/principles/design-philosophy.md)，包含18条设计原则（DP1–DP18），核心包括：
+
+- **DP1** 双层验证
+- **DP2** 做审分离
+- **DP6** 精准回退（不是全盘重来）
+- **DP7** 反模式接种
+- **DP8** CSO原则（强制完整加载skill）
+- **DP10** 安全与紧急停止
+- **DP12** 驯服非确定性
+- **DP16** 模板即约束（质量左移）
+- **DP17** 结构化澄清协议
+- **DP18** 跨产物一致性分析
+
+## 参与贡献
+
+欢迎贡献以下方面：
+- 流程管线和技能定义优化
+- 新领域角色画像和业务技能
+- CLI工具改进
+- 实际使用的实践记录
+- 企业适配经验
+- 文档和翻译
+
+详见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
+
+## License
+
+[MIT](./LICENSE)

package/bin/autospec.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../scripts/cli/index.js';

package/knowledge/README.md

@@ -0,0 +1,144 @@
+# AutoSpec 知识层
+
+本目录包含 AutoSpec 的核心知识文件，在 `autospec init` 时会复制到用户项目的 `.autospec/knowledge/` 目录。
+
+## 人类-[skills]-创业团队-skills-领域知识分层理念
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  人类维护层 (Human-maintained)                                    │
+│  domain/ - 业务知识（术语、规则、流程）                          │
+│  由领域专家维护，AI 读取但不修改                                   │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓ 驱动
+┌─────────────────────────────────────────────────────────────────┐
+│  创业团队 Skills (AI Agent Roles)                                 │
+│  ../plugins/agents/roles/ - CEO、产品负责人、技术负责人、工程师等   │
+│  模拟创业团队对抗审查，多视角审视产出                              │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓ 执行
+┌─────────────────────────────────────────────────────────────────┐
+│  阶段 Skills (Stage Skills)                                       │
+│  ../plugins/skills/*-stage/ - 需求分析、方案设计、编码实现等       │
+│  驱动各阶段执行，产出标准化产物                                    │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓ 支撑
+┌─────────────────────────────────────────────────────────────────┐
+│  领域知识/规范分层 (Knowledge & Standards)                        │
+│  本目录 - 原则、流程、指南、检查清单                              │
+│  按冻结区/受控区/自由区分层管理                                    │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## 三层自进化体系
+
+| 层级 | 命令 | 目标 | 位置 |
+|------|------|------|------|
+| 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` |
+
+**基于评测驱动的进化**：实战流程 → 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     # 团队度量体系
+```
+
+## 核心文件说明
+
+| 文件/目录 | 说明 | 进化分区 | 详细文档 |
+|-----------|------|---------|---------|
+| `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/` | 评测执行器、改动检测器 | 执行层 |
+
+## 设计原则
+
+知识层设计遵循以下原则：
+
+1. **自闭环**：知识文件不依赖 `scripts/` 代码，可独立复制到用户项目
+2. **可扩展**：通过企业叠加层支持组织定制
+3. **可进化**：通过三层自进化体系（L1 Self-Evolve → L2 Field-Evolve → L3 Project-Evolve）实现持续改进
+4. **人机分离**：`domain/` 目录专门存放人类维护的业务知识
+5. **评测驱动**：通过 Benchmarks 评测量化进化效果，确保改进有据可依
+
+## 使用方式
+
+```bash
+# 初始化项目（复制知识层到 .autospec/knowledge/）
+autospec init
+
+# 更新知识层（保留运行时状态）
+autospec update
+```
+
+## 运行时目录
+
+以下目录在运行时自动生成：
+
+- `evaluation/` - 基准案例（从成功/失败案例自动归档）
+- `evolution/` - 进化记录（practice-log、改进提案等）
+- `environment/` - 环境知识（自动检测生成）