@chongyan/autospec 1.0.2 → 1.0.3

package/README.md

@@ -1,608 +1,54 @@
-<div align="center">
-
-# AutoSpec
-
-**无人值守的自动化产品研发 —— AI 驱动全流程，人只在关键决策点介入。**
-
-[English](./README.en.md) · [快速开始](#快速开始) · [核心思想](#核心思想) · [运作机制](#运作机制) · [知识层结构](#知识层结构) · [参与贡献](./CONTRIBUTING.md)
-
-</div>
-
----
-
-## 一句话价值
-
-AutoSpec 是一个 AI 驱动的全流程研发管线，自动完成从需求分析到交付部署的完整软件开发周期。它不是"让 AI 写代码更快"，而是"AI 自主完成完整 SDLC，人在关键节点介入（Human On the Loop）"。
-
-## 核心特性
-
-| 特性 | 说明 |
-|------|------|
-| **AI 自主研发** | 从需求到交付，AI 全流程自动执行 |
-| **双层验证** | 确定性验证 → AI 审查 |
-| **做审分离** | 不同 AI 实例执行，信息隔离 |
-| **宪法安全** | 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
-
-# 敏捷迭代 + 后端/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`。
-
-### 执行模式
-
-| 模式 | 说明 | 场景 |
-|------|------|------|
-| **自主模式** | 全流程自动运行，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
-
-信任是赚来的，不是默认给的：
-- **交互模式**：每阶段产出确认后才能进入下一阶段
-- **自主模式**：需求 + 设计 + 交付前确认，中间自主
-
-不满意产出时，**改 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 测试  →  交付部署
- 环境就绪                                (含自测)    (独立实例)
-                ↓            ↓            ↓            ↓          ↓          ↓
-            [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 1（确定性）**：编译/测试/lint/类型检查 — 机器判断，不可协商
-- **Layer 2（AI 审查）**：独立 AI 实例，结构化证据评审
-
-Layer 1 不过，不进 Layer 2。
-
-### CEO 探索机制
-
-在需求分析之前，AutoSpec 使用双 Agent 对抗辩论来澄清需求：
-
-- **ceo**：从 CEO/战略视角探索（商业价值、战略对齐）
-- **product-owner**：从产品落地角度挑战（可行性、用户体验、数据驱动）
-
-**自主模式**：Agent 自动辩论 → 共识成为需求，分歧标记待确认
-
-**交互模式**：AI 提出 5 个战略问题并附带推荐答案 → 用户确认
-
-### 迭代模式
-
-| 模式 | 阶段 | 说明 | 场景 |
-|------|------|------|------|
-| **Waterfall** | 01→02→03→04→05→06 | 完整 6 阶段 | 新功能、重大变更 |
-| **Agile** | 01 + [02→03→04]×N + 05→06 | 故事驱动循环 | 迭代开发 |
-| **Experiment** | 01→02→03 + 效果评测 | 原型+AI 评估 | 技术探索 |
-| **Hotfix** | 需求→风险评估→实现→审查→部署 | 快速通道 | 紧急修复 |
-
-### 动态智能体调度
-
-AutoSpec 根据复杂度动态组织团队：
-
-```
-1. 读取 role-composition.yaml
-2. project-evolve-scanner 检测技术栈
-3. 根据复杂度选择团队：
-   - 简单：CEO + PO + TechLead
-   - 中等：+ Engineer
-   - 复杂：+ QA + Security + Data
-4. 涉及AI → 强制加入 ai-engineer
-5. 涉及数据 → 强制加入 data-engineer
-```
-
-### 保障机制
-
-| 机制 | 说明 |
-|------|------|
-| 双层验证 | Layer1编译测试 + Layer2 AI审查 |
-| 做审分离 | 不同Agent实例，信息隔离 |
-| 精准回退 | 最多3次修复循环 |
-| 安全制动 | 不可逆动作需人工确认 |
-| 阶段门禁 | 每阶段验证通过才能进入下一阶段 |
-
----
-
-## 命令系统
-
-### 斜杠命令（AI 驱动）
-
-#### 自主模式（推荐）
-
-| 命令 | 说明 |
-|------|------|
-| `/autospec:run` | 全流程自主运行 + 迭代模式选择 |
-
-**参数说明：**
-| 参数 | 简写 | 说明 | 可选值 |
-|------|------|------|--------|
-| `--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` | "做完了，收工" | 交付 + 进化归档 |
-
-#### 进化命令
-
-| 命令 | 层级 | 说明 |
-|------|------|------|
-| `/self-evolve` | L1 框架级 | AutoSpec 框架自身的迭代升级 |
-| `/autospec:field-evolve` | L2 领域级 | 从实战项目中学习和提炼能力 |
-| `/autospec:project-evolve` | L3 项目级 | 实战项目自身的代码、配置、文档优化 |
-
-#### 工具命令
-
-| 命令 | 说明 |
-|------|------|
-| `/autospec:status` | 查看流程进度 |
-| `/autospec:test` | 统一测试命令（验证 + 修复 + 评测） |
-| `/autospec:memory` | 管理项目记忆系统 |
-
-### 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 list                              # 列出所有斜杠命令
-autospec update                            # 更新框架（保留状态）
-```
-
-### 环境衔接命令
-
-`autospec init` 会自动检测项目中的中间件和组件使用。环境知识管理命令：
-
-```bash
-/autospec:env                      # 查看环境配置
-/autospec:env-sync                 # 从代码同步 + 自动激活
-/autospec:env-validate             # 验证配置完整性
-/autospec:env-export <dir>         # 导出项目知识库
-/autospec:component                # 列出可用组件
-```
-
-**自动检测**：`autospec init` 自动扫描代码，识别 MySQL、Redis、Kafka、MongoDB、Elasticsearch、RabbitMQ、PostgreSQL 等中间件使用，生成知识配置并激活。详见 [环境衔接协议](knowledge/06-environment/README.md)。
-
----
-
-## 自进化
-
-AutoSpec 通过**三层自进化体系**持续自我完善，形成从项目实践到框架升级的完整闭环。
-
-### 三层自进化体系
-
-| 层级 | 命令 | 目标 | 产出 |
-|------|------|------|------|
-| **L1: Self-Evolve (框架级)** | `/self-evolve` | AutoSpec 框架自身的迭代升级 | 框架技能、方法论、设计原则 |
-| **L2: Field-Evolve (领域级)** | `/autospec:field-evolve` | 框架从实战项目中学习和提炼能力 | 领域技能、最佳实践、benchmarks |
-| **L3: Project-Evolve (项目级)** | `/autospec:project-evolve` | 实战项目自身的代码、配置、文档优化 | 代码质量提升、测试补全、文档完善 |
-
-**数据流向**：
-- 向下流动：L1 → L2 → L3 是能力下发（框架升级 → 领域技能 → 项目应用）
-- 向上流动：L3 → L2 → L1 是经验回流（项目实践 → 领域提炼 → 框架升级）
-
-### 进化分区
-
-| 分区 | 对应层级 | 内容 | 规则 |
-|------|---------|------|------|
-| **冻结区** | L1 核心 | 宪法、进化规则、核心原则 | 人工变更，不可自动修改 |
-| **受控区** | L1/L2 交界 | 阶段定义、通用技能、角色画像 | 自动提议，人工批准 |
-| **自由区** | L2 领域 | 业务技能、benchmarks、决策树 | 自动进化，验证器校验 |
-| **环境知识区** | L3 项目 | 环境配置、组件库、最佳实践 | 项目级自动优化 |
-
-**核心安全原则**：进化系统不可修改自己的评判标准（不可变评判器）。
-
-### 企业适配
-
-```
-┌─────────────────────────────────┐
-│         企业叠加层               │  ← 企业特有（不上游合并）
-│  org-constitution.md            │
-│  org-skills/ + domain-knowledge │
-├─────────────────────────────────┤
-│         AutoSpec 核心框架        │  ← npm install（可升级）
-│  constitution.md                │
-│  process/ guides/ agents/ ...   │
-└─────────────────────────────────┘
-```
-
-通过 `autospec init --domain <domain>` 配置领域叠加层。叠加层追加领域特有规则和技能，**不分叉**核心框架。
-
----
-
-## 安全与质量
-
-### 五层安全防护
-
-1. **宪法门禁** — 15 条不可违反的红线
-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 的知识层按优先级分为 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/数据库/产品/测试/评测） |
-
-### 01-principles/ — 原则层（宪法级）
-
-> 详见：[knowledge/01-principles/README.md](knowledge/01-principles/README.md)
-
-原则层是 AutoSpec 的最高指导原则，包含 4 个层级（L1→L2→L3→L4）：
-
-| 文件 | 说明 |
-|------|------|
-| [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/ — 流程层
-
-> 详见：[knowledge/02-process/README.md](knowledge/02-process/README.md)
-
-流程层定义 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) | 交付部署阶段 |
-
-### 03-guides/ — 能力指南
-
-> 详见：[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）：
-
-| 文件 | 说明 |
-|------|------|
-| [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/ — 组织知识
-
-> 详见：[knowledge/08-organization/README.md](knowledge/08-organization/README.md)
-
-AI Native 团队文化、愿景、治理相关：
-
-| 文件 | 说明 |
-|------|------|
-| [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)
-
-标准化文档模板库（按优先级排序）：
-
-| 文件 | 说明 |
-|------|------|
-| [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) | 领域模型模板 |
-
----
-
-## 插件层结构
-
-```
-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 工具改进
-- 实际使用的实践记录
-- 企业适配经验
-- 文档和翻译
-
-详见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
-
-## License
-
-[MIT](./LICENSE)
+# AutoSpec
+
+AutoSpec is a shared protocol and runtime layout for AI coding workflows.
+
+## Quick Start
+
+### Install
+
+```bash
+npm install -g @chongyan/autospec
+autospec --help
+```
+
+Requires `Node.js >= 18`.
+
+### Initialize a Project
+
+```bash
+cd your-project
+autospec init
+```
+
+`autospec init` is interactive:
+- choose `Claude Code`
+- choose `Codex`
+- or choose `All adapters`
+
+Project options still support:
+- `-r, --roles`
+- `-d, --domain`
+
+### Use the Installed Adapter
+
+If `claude-code` is installed:
+
+```text
+/path/to/project/.claude/CLAUDE.md
+/atsx:list
+/atsx:run
+/atsx:dashboard
+```
+
+If `codex` is installed:
+
+```bash
+/path/to/project/AGENTS.md
+plugins/autospec/.codex-plugin/scripts/autospec-cli.sh status
+plugins/autospec/.codex-plugin/scripts/autospec-cli.sh plan
+plugins/autospec/.codex-plugin/scripts/autospec-cli.sh code "task-1"
+plugins/autospec/.codex-plugin/scripts/autospec-cli.sh learn
+plugins/autospec/.codex-plugin/scripts/autospec-cli.sh knowledge
+```
+
+More documentation: https://github.com/chenjianzeng0604/autospec