@chongyan/autospec 1.0.1 → 1.0.2

package/knowledge/02-process/README.md

@@ -0,0 +1,186 @@
+# 流程层
+
+> **定位**: 产品研发全流程定义，覆盖 6 阶段执行流程
+>
+> **进化分区**: 🟡 受控区（自动提议 + 人工批准）
+
+---
+
+## 目录结构
+
+```
+02-process/
+├── README.md                     # 本文件（流程层导航）
+├── 00-overview.md                # 流程概览
+├── 01-requirement.md             # 需求分析阶段
+├── 02-design.md                  # 方案设计阶段
+├── 03-implementation.md          # 编码实现阶段
+├── 04-review.md                  # 代码审查阶段
+├── 05-testing.md                 # QA 测试阶段
+└── 06-delivery.md                # 交付部署阶段
+```
+
+---
+
+## 运行模式
+
+### 两种执行方式
+
+| 模式 | 说明 | 适用场景 |
+|------|------|---------|
+| **run** | 自动流程，用户选择迭代模式后全自动执行 | 无人值守、完整流程 |
+| **分阶段命令** | 手动流程，explore→propose→apply→archive 逐步执行 | 精细控制、阶段验证 |
+
+### 迭代模式
+
+| 模式 | 驱动方式 | 适用场景 |
+|------|---------|---------|
+| waterfall | 阶段驱动 | 需求稳定、项目明确 |
+| agile | 故事驱动 | 需求变化、增量交付 |
+| experiment | 假设驱动 | 探索性验证、A/B测试 |
+| hotfix | 问题驱动 | 紧急修复、快速响应 |
+
+### 动态智能体调度
+
+```
+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次修复循环 |
+| 安全制动 | 不可逆动作需人工确认 |
+| 阶段门禁 | 每阶段验证通过才能进入下一阶段 |
+
+---
+
+## 流程说明
+
+### 00-overview.md — 流程概览
+
+**内容**: 研发流程总览、启动门禁、执行模式
+
+**核心章节**:
+- 6 阶段流程框架
+- 启动门禁规则
+- 执行模式（自主模式/交互模式）
+- 迭代模式（瀑布/敏捷/实验/热修复）
+
+**位置**: [00-overview.md](00-overview.md)
+
+### 01-requirement.md — 需求分析阶段
+
+**内容**: 需求分析阶段执行指南
+
+**核心章节**:
+- 需求探索与澄清
+- 需求文档结构化
+- 验收标准定义
+- 需求检查清单
+
+**位置**: [01-requirement.md](01-requirement.md)
+
+### 02-design.md — 方案设计阶段
+
+**内容**: 方案设计阶段执行指南
+
+**核心章节**:
+- 架构设计
+- 接口设计
+- 数据模型设计
+- 技术选型
+- 设计检查清单
+
+**位置**: [02-design.md](02-design.md)
+
+### 03-implementation.md — 编码实现阶段
+
+**内容**: 编码实现阶段执行指南
+
+**核心章节**:
+- 编码规范
+- Layer 1 验证
+- 数据安全实践
+- 编码检查清单
+
+**位置**: [03-implementation.md](03-implementation.md)
+
+### 04-review.md — 代码审查阶段
+
+**内容**: 代码审查阶段执行指南
+
+**核心章节**:
+- 审查流程
+- 审查维度（架构/安全/性能/可维护性/逻辑）
+- 审查意见格式
+- 审查通过标准
+
+**位置**: [04-review.md](04-review.md)
+
+### 05-testing.md — QA 测试阶段
+
+**内容**: QA 测试阶段执行指南
+
+**核心章节**:
+- 测试策略
+- 测试用例设计
+- 集成测试
+- E2E 测试
+- 测试检查清单
+
+**位置**: [05-testing.md](05-testing.md)
+
+### 06-delivery.md — 交付部署阶段
+
+**内容**: 交付部署阶段执行指南
+
+**核心章节**:
+- 发布前检查
+- 部署流程
+- 回滚方案
+- 监控告警
+- 发布检查清单
+
+**位置**: [06-delivery.md](06-delivery.md)
+
+---
+
+## 使用方式
+
+流程文件在以下场景应用：
+
+1. **启动新任务**: 读取 `00-overview.md` 确认启动门禁
+2. **需求分析**: 遵循 `01-requirement.md` 执行
+3. **方案设计**: 遵循 `02-design.md` 执行
+4. **编码实现**: 遵循 `03-implementation.md` 执行
+5. **代码审查**: 遵循 `04-review.md` 执行
+6. **测试验证**: 遵循 `05-testing.md` 执行
+7. **交付部署**: 遵循 `06-delivery.md` 执行
+
+---
+
+## 与相关文档的关系
+
+| 文档 | 说明 |
+|------|------|
+| [../01-principles/](../01-principles/) | 原则层（流程设计的依据） |
+| [../03-guides/](../03-guides/) | 能力指南（阶段执行的详细技能） |
+| [../04-checklists/](../04-checklists/) | 检查清单（各阶段完成前的自检项） |
+
+---
+
+**维护者**: AutoSpec 团队
+**进化分区**: 🟡 受控区
+**版本**: v1.0
+**最后更新**: 2026-03-27

package/knowledge/{guides/support/pipeline-protocol.md → 03-guides/00-pipeline-protocol.md}

@@ -48,14 +48,14 @@ a. 核心文件（所有命令）：
    - .autospec/runtime/state.json → 流程状态（如有）
 
 b. 命令特定文件（按需加载）：
-   - run: pipeline/overview.md, 阶段Skills
-   - explore: pipeline/01-requirement.md, requirement-analyzer skill
-   - propose: pipeline/02-design.md, design-planner skill
-   - apply: pipeline/03-implementation.md ~ 05-testing.md, code-* skills
-   - archive: pipeline/06-delivery.md, release-checker skill
+   - run: knowledge/02-process/00-overview.md, 阶段Skills
+   - explore: knowledge/02-process/01-requirement.md, exploration-phase skill
+   - propose: knowledge/02-process/02-design.md, design-stage skill
+   - apply: knowledge/02-process/03-implementation.md ~ 05-testing.md, implementation-stage/testing-stage skills
+   - archive: knowledge/02-process/06-delivery.md, delivery-stage skill
    - status: 仅读取state.json
    - validate: 根据config确定验证策略
-   - evolve: evolution.md, skill-distiller skill
+   - evolve: knowledge/01-principles/10-evolution-mechanism.md, field-evolve-distiller skill
 ```
 
 #### 执行命令前置检查
@@ -216,9 +216,9 @@ c. 环境检查（适用于 run/apply）:
 | propose | `plugins/commands/propose.md` |
 | apply | `plugins/commands/apply.md` |
 | archive | `plugins/commands/archive.md` |
-| self-evolve | `plugins/skills/self-evolve/SKILL.md` |
-| field-evolve | `plugins/skills/field-evolve/SKILL.md` |
-| project-evolve | `plugins/skills/project-evolve/SKILL.md` |
+| self-evolve | `.claude/commands/self-evolve.md` |
+| field-evolve | `plugins/commands/field-evolve.md` |
+| project-evolve | `plugins/commands/project-evolve.md` |
 
 **不适用本协议的命令**：validate、status、env系列、component系列
 
@@ -227,7 +227,7 @@ c. 环境检查（适用于 run/apply）:
 ## AI 增强 Pipeline
 
 > 本章节定义如何利用 AI 增强 Pipeline 自动化能力。
-> 与 `knowledge/process/ai-sdlc.md` 互补。
+> 与 `knowledge/03-guides/43-run-ai-sdlc.md` 互补。
 
 ### 1. AI 驱动的 Pipeline 能力
 

package/knowledge/{guides/support/team-orchestrator.md → 03-guides/01-team-orchestrator.md}

@@ -12,9 +12,14 @@ type: support
 ## 配置文件依赖
 
 本协调器依赖以下配置文件：
-- `${KNOWLEDGE}/config/team-stage.yaml` - 团队阶段配置
-- `${KNOWLEDGE}/config/role-composition.yaml` - 角色组合规则
-- `${KNOWLEDGE}/config/team-tasks.yaml` - 团队任务分配
+- `${KNOWLEDGE}/05-config/01-team-stage.yaml` - 团队阶段配置
+- `${KNOWLEDGE}/05-config/03-role-composition.yaml` - 角色组合规则（含动态决策树、效率优化和质量红线）
+- `${KNOWLEDGE}/05-config/02-team-tasks.yaml` - 团队任务分配
+
+**动态阵型组织**：
+- 基于 `03-role-composition.yaml` 中的 `decision_tree` 动态选择角色
+- 根据项目特征（AI/数据/安全）、复杂度、强制触发规则自动组织阵型
+- 默认配置已足够好，模型根据配置原则动态组织阵型
 
 ## 输入
 - 被审查文档路径
@@ -76,23 +81,38 @@ type: support
 
 ## 执行步骤
 
-### Step 1: 读取配置文件
+### Step 1: 读取配置文件 + 确定阵型
 
 **【强制】** 读取团队阶段配置和角色组合配置：
 
 ```
-1. 读取 ${KNOWLEDGE}/config/team-stage.yaml
+1. 读取 ${KNOWLEDGE}/05-config/01-team-stage.yaml
    - 获取当前团队阶段配置（seed/growth/mature）
    - 默认使用 growth 阶段
 
-2. 读取 ${KNOWLEDGE}/config/role-composition.yaml
+2. 读取 ${KNOWLEDGE}/05-config/03-role-composition.yaml
    - 获取当前阶段、当前复杂度对应的角色组合
    - 获取 AI Native 关注点
+   - 获取动态决策树（decision_tree）
+   - 获取效率优化配置和质量红线
+
+3. 应用动态决策树
+   - 根据项目特征（AI/数据/安全）添加角色
+   - 根据复杂度确定角色数量
+   - 检查强制触发规则
 
-3. 读取 ${KNOWLEDGE}/config/team-tasks.yaml（如适用）
+4. 读取 ${KNOWLEDGE}/05-config/02-team-tasks.yaml（如适用）
    - 如果是特定任务（环境衔接、技术分析等），获取任务配置
 ```
 
+**动态阵型选择逻辑**：
+```
+如果项目类型是 AI/ML → 使用 ai-focused 阵型
+如果项目涉及安全敏感 → 使用 security 阵型
+如果复杂度 ≤ 2 → 可考虑 simple 阵型
+否则 → 使用 standard 阵型
+```
+
 ### Step 2: 确定参与角色
 
 根据配置文件确定角色列表：
@@ -243,7 +263,7 @@ compositions:
 
 ## 效率优化策略
 
-### 1. 并行执行
+### 1. 并行执行（默认开启）
 所有角色Agent并行运行，不串行等待：
 ```
 启动时间：T0
@@ -269,6 +289,31 @@ compositions:
   只重新审查差异部分
 ```
 
+### 4. 快速模式（条件触发）
+满足以下条件时，可减少角色数量：
+- 复杂度评分 ≤ 3
+- 无安全敏感内容
+- 历史审查通过率 > 80%
+
+### 5. 跳过非必要审查（需记录）
+时间紧迫时，可跳过非关键审查，但必须：
+- 记录跳过理由
+- 保持可追溯性
+- 后续可补
+
+## 质量红线（不可逾越）
+
+以下场景必须执行对应检查，不能跳过：
+
+| 场景 | 必须触发的Agent |
+|------|---------------|
+| 安全敏感项目 | safety-auditor |
+| 交付归档阶段 | consistency-checker |
+| 修复循环失败3次 | failure-diagnostician |
+| 阶段完成时 | stage-gate-evaluator |
+
+**原则**：效率优化不能牺牲质量，该有的审查必须有，只是可以更智能地选择角色组合。
+
 ## 反模式清单
 
 1. **串行执行**：一个一个启动Agent。检测：必须并行启动

package/knowledge/{guides/stages/requirement-analyzer.md → 03-guides/02-analyze-requirement.md}

@@ -77,7 +77,7 @@ downstream: [DES-{feature}-001]
 | BR-01 | （规则名） | （描述） | requirement.md#章节 |
 ```
 
-如规则未在 `knowledge/domain/rules.md` 中定义，需同步新增。
+如规则未在 `knowledge/09-templates/06-business-rules.md` 中定义，需同步新增。
 
 #### 第五章：边界定义
 
@@ -110,8 +110,8 @@ downstream: [DES-{feature}-001]
 
 #### 附录
 
-- **术语引用**：引用 `knowledge/domain/glossary.md` 中的术语
-- **流程引用**：引用 `knowledge/domain/flows/` 中的流程图
+- **术语引用**：引用 `knowledge/09-templates/05-business-glossary.md` 中的术语
+- **流程引用**：引用 `knowledge/09-templates/07-business-flows.md` 中的流程图
 
 ### 自查清单（嵌入式）
 

package/knowledge/{guides/stages/ai-effect-evaluator.md → 03-guides/08-evaluate-ai-effect.md}

@@ -1,14 +1,21 @@
 ---
 name: ai-effect-evaluator
-description: 当需要执行AI/模型组件的效果评测、验证任务完成质量时触发
+description: 当需要执行 AI/模型组件的效果评测、验证任务完成质量时触发
 type: execute
 ---
 
+> ⚠️ **已整合** - 本指南内容已整合到 [评测设计模板](../09-templates/09-evaluation-design.md)
+>
+> **版本**: v1.0
+> **最后更新**: 2026-03-26
+> **状态**: 已废弃（内容整合到模板）
+> **替代文档**: [09-evaluation-design.md](../09-templates/09-evaluation-design.md)
+
 ## 定位
 
-效果评测执行阶段的"执行"类skill。负责加载评测数据集、执行评测、计算指标。
+效果评测执行阶段的"执行"类 skill。负责加载评测数据集、执行评测、计算指标。
 
-> **使用场景**：项目包含AI/模型组件，需要验证效果是否满足要求。
+> **使用场景**：项目包含 AI/模型组件，需要验证效果是否满足要求。
 
 ## 输入
 
@@ -31,7 +38,7 @@ type: execute
 
 ### Step 3: 执行评测
 
-1. 初始化被评测的AI/模型组件
+1. 初始化被评测的 AI/模型组件
 2. 对每个测试用例执行推理
 3. 收集预测结果
 
@@ -52,7 +59,7 @@ type: execute
 
 1. 汇总各项指标
 2. 与目标值对比
-3. 识别badcase
+3. 识别 badcase
 
 ## 输出格式
 
@@ -70,7 +77,7 @@ type: execute
 | ... | ... | ... | ✅/❌ |
 
 ### Badcase 分析
-| 用例ID | 输入 | 预期输出 | 实际输出 | 问题描述 |
+| 用例 ID | 输入 | 预期输出 | 实际输出 | 问题描述 |
 |--------|------|----------|----------|----------|
 | ... | ... | ... | ... | ... |
 
@@ -90,4 +97,4 @@ type: execute
 
 - 适用：AI/模型组件需要验证效果
 - 不适用：普通功能无需效果评测
-- 对应做类skill：test-generator（生成测试）
+- 对应做类 skill：test-generator（生成测试）

package/knowledge/{guides/support/skill-distiller.md → 03-guides/19-distill-skill.md}

@@ -1,5 +1,5 @@
 ---
-name: skill-distiller
+name: field-evolve-distiller
 description: 当全流程完成或practice-log积累到一定量、需要从执行轨迹或业务知识中提炼新的可执行skill时触发
 type: produce
 ---
@@ -36,7 +36,7 @@ type: produce
    - **编写CSO格式的description**
    - **编写反模式清单**
 4. **验证**：调用skill-validator检查
-5. **归档**：归入 skills/stages/ 或 skills/support/
+5. **归档**：归入 skills/ 或 plugins/skills/
 
 ### 场景B：业务蒸馏（向外看）
 
@@ -86,6 +86,6 @@ type: produce
 - 测试知识蒸馏：测试模式出现3次以上、测试失败模式重复出现
 
 ## 示例
-**场景A示例**：跑了5次需求分析后发现"需求冲突检测"是独立能力 → 蒸馏为 `skills/stages/req-conflict-detector.md`
+**场景A示例**：跑了5次需求分析后发现"需求冲突检测"是独立能力 → 蒸馏为 `skills/req-conflict-detector/SKILL.md`
 **场景B示例**：商机项目拓客提示词经5轮调优趋于稳定 → 蒸馏为 `skills/domain/b2b-lead-discovery.md`
 **场景C示例**：项目中多次使用 Testcontainer 启动 MySQL 测试 → 提炼为 `environment/integration/testing/mysql-testing.md`

package/knowledge/{guides/support/skill-updater.md → 03-guides/20-update-skill.md}

@@ -35,7 +35,7 @@ type: produce
 
 ## 适用场景与边界
 - 适用：skill执行效果不达标、practice-log中同类问题出现3次以上、methodology更新导致skill需同步
-- 不适用：skill本身没问题但使用者没按skill执行；需要全新skill而非升级（用skill-distiller）
+- 不适用：skill本身没问题但使用者没按skill执行；需要全新skill而非升级（用field-evolve-distiller）
 
 ## 示例
 **触发**：code-reviewer skill连续3次在"安全审查"维度漏判SQL注入问题

package/knowledge/{guides/support/methodology-extractor.md → 03-guides/22-extract-methodology.md}

@@ -7,7 +7,7 @@ type: produce
 ## 定位
 让方法论从实践中自然生长，而非空想。识别实践中的有效模式和认知，沉淀为可复用的原则和方法论。
 
-> 与skill-distiller的区别：distiller提取**可执行的skill**，extractor提取**认知性的方法论**（原则、检查项、决策树）。
+> 与field-evolve-distiller的区别：distiller提取**可执行的skill**，extractor提取**认知性的方法论**（原则、检查项、决策树）。
 
 ## 输入
 - 必须输入：practice-log中状态为"待处理"的条目
@@ -46,7 +46,7 @@ type: produce
 
 ## 适用场景与边界
 - 适用：全流程完成后的自动扫描、practice-log积累到5条以上时、老板要求复盘时
-- 不适用：提取的是可执行skill（用skill-distiller）、与已有methodology冲突需人工裁决的
+- 不适用：提取的是可执行skill（用field-evolve-distiller）、与已有methodology冲突需人工裁决的
 
 ## 示例
 **实践**：连续3个项目在设计阶段都因为"没考虑缓存策略"被打回

package/knowledge/{guides/support/complexity-assessor.md → 03-guides/24-assess-complexity.md}

@@ -12,8 +12,8 @@ type: support
 ## 配置文件依赖
 
 本评估器依赖以下配置文件：
-- `${KNOWLEDGE}/config/team-stage.yaml` - 团队阶段配置（获取角色触发规则）
-- `${KNOWLEDGE}/config/role-composition.yaml` - 角色组合规则
+- `${KNOWLEDGE}/05-config/01-team-stage.yaml` - 团队阶段配置（获取角色触发规则）
+- `${KNOWLEDGE}/05-config/03-role-composition.yaml` - 角色组合规则（含动态决策树）
 
 ## 输入
 - 任务描述
@@ -97,12 +97,14 @@ aiNative:                   # AI Native 相关评估
 **【强制】** 读取团队阶段配置：
 
 ```
-1. 读取 ${KNOWLEDGE}/config/team-stage.yaml
+1. 读取 ${KNOWLEDGE}/05-config/01-team-stage.yaml
    - 获取当前团队阶段（seed/growth/mature）
    - 默认使用 growth 阶段
+   - 获取 mandatoryTriggers（强制触发规则）
 
-2. 读取 ${KNOWLEDGE}/config/role-composition.yaml
+2. 读取 ${KNOWLEDGE}/05-config/03-role-composition.yaml
    - 获取角色组合规则
+   - 获取 decision_tree（动态决策树）
 ```
 
 ### Step 2: 收集信息

package/knowledge/{guides/support/tech-stack-analyzer.md → 03-guides/26-analyze-tech-stack.md}

@@ -130,7 +130,7 @@
 当发现新的框架或工具时，建议将其添加到配置文件：
 
 ```yaml
-# 添加到 knowledge/environment/detection-patterns.yaml
+# 添加到 knowledge/06-environment/01-detection-patterns.yaml
 frameworks:
   javascript:
     - deps: [astro]

package/knowledge/{guides/domain-driven-design.md → 03-guides/42-apply-ddd.md}

@@ -342,4 +342,4 @@ class Order {
 
 **维护者**: AutoSpec 团队
 **进化分区**: 🟡 受控区
-**关联文档**: `knowledge/templates/domain-driven-design.md`
+**关联文档**: `knowledge/09-templates/12-domain-model.md`

package/knowledge/{process/ai-sdlc.md → 03-guides/43-run-ai-sdlc.md}

@@ -1,7 +1,7 @@
 # AI-Enhanced SDLC 规范
 
 > 本文档定义 AI Native 团队在软件开发生命周期（SDLC）中如何利用 AI 增强各阶段效率。
-> 与 `knowledge/process/overview.md` 互补，基础流程规范在此同样生效。
+> 与 `knowledge/02-process/00-overview.md` 互补，基础流程规范在此同样生效。
 
 ## 概述
 

package/knowledge/{guides/knowledge-management.md → 03-guides/44-manage-knowledge.md}

@@ -62,7 +62,7 @@
 
 ### 定位
 
-业务文档（`knowledge/domain/`）描述"业务是什么"，不描述"技术怎么实现"。
+业务文档（`knowledge/03-guides/domain-*.md`）描述"业务是什么"，不描述"技术怎么实现"。
 
 ### 内容范围
 
@@ -195,7 +195,7 @@
 ### 示例结构
 
 ```
-knowledge/domain/product/
+knowledge/03-guides/domain-product/
 ├── README.md              # 产品业务通用规则
 ├── purchase.md            # 购买特有规则
 ├── redeem.md              # 赎回特有规则
@@ -365,5 +365,5 @@ description: {业务域} 领域知识，当用户提到 {关键词} 时加载
 ## 参考资料
 
 - [template-registry](../environment/template-registry.md)
-- [design-philosophy - 渐进式披露](../principles/design-philosophy.md#核心设计模式)
-- [design-philosophy - 上下文精确管理](../principles/design-philosophy.md#dp4-上下文精确管理)
+- [design-philosophy - 渐进式披露](../principles/01-first-principles.md#核心设计模式)
+- [design-philosophy - 上下文精确管理](../principles/01-first-principles.md#dp4-上下文精确管理)