@chongyan/autospec 1.0.1 → 1.0.2

package/plugins/commands/env-template.md

@@ -35,10 +35,10 @@ infrastructure middleware-knowledge.md                     env-knowledge/infrast
 **【强制】** 读取并展示指定模板的详细信息：
 
 ```
-📋 模板详情: middleware
+📋 模板详情：middleware
 
-来源: knowledge/environment/middleware-knowledge.md
-输出: .autospec/environment/env-knowledge/middleware/{name}.md
+来源：knowledge/09-templates/13-middleware-knowledge.md
+输出：.autospec/environment/env-knowledge/middleware/{name}.md
 
 必填章节:
   - 基本信息
@@ -78,146 +78,22 @@ infrastructure middleware-knowledge.md                     env-knowledge/infrast
 中间件知识:
   ✅ mysql.md
      - 必填章节完整
-     - 类型有效: relational-database
+     - 类型有效：relational-database
      - 环境变量表格完整
   ✅ redis.md
      - 必填章节完整
-     - 类型有效: cache
+     - 类型有效：cache
   ⚠️  kafka.md
-     - 缺少可选章节: 连接代码模板
-     - 类型有效: message-queue
+     - 缺少可选章节：连接代码模板
+     - 类型有效：message-queue
 
 组件知识:
   ✅ auth/component.md
      - 必填章节完整
-     - 类型有效: service-component
+     - 类型有效：service-component
   ✅ payment/component.md
      - 必填章节完整
-     - 类型有效: service-component
+     - 类型有效：service-component
 
-总计: 5 文件, 4 完全合规, 1 有警告
-```
-
-### 参数 --sync：同步模板注册表
-
-**【强制】** 将框架模板同步到本地：
-
-```
-🔄 同步模板注册表
-
-复制: knowledge/environment/template-registry.md
-      → .autospec/environment/template-registry.md
-
-缓存模板:
-  - middleware-knowledge.md
-  - component-knowledge.md
-  - detection-patterns.yaml
-
-✅ 同步完成
-```
-
-### 参数 --example <name>：显示模板示例
-
-**【强制】** 显示指定模板的完整示例：
-
-```
-📝 模板示例: middleware (MySQL)
-
-# MySQL 中间件知识
-
-## 基本信息
-
-| 字段 | 值 |
-|------|-----|
-| 名称 | mysql |
-| 类型 | relational-database |
-| 默认端口 | 3306 |
-| 知识版本 | v1.0 |
-
-## 环境变量
-
-### 必需变量
-
-| 变量名 | 说明 | 示例 |
-|--------|------|------|
-| MYSQL_HOST | 数据库主机地址 | db.example.com |
-| MYSQL_DATABASE | 数据库名称 | myapp_db |
-| MYSQL_USER | 用户名 | app_user |
-| MYSQL_PASSWORD | 密码 | - |
-
-### 可选变量
-
-| 变量名 | 默认值 | 说明 |
-|--------|--------|------|
-| MYSQL_PORT | 3306 | 数据库端口 |
-| MYSQL_POOL_SIZE | 10 | 连接池大小 |
-
-## 连接代码模板
-
-### Node.js
-
-```javascript
-const mysql = require('mysql2/promise');
-const pool = mysql.createPool({
-  host: process.env.MYSQL_HOST,
-  port: process.env.MYSQL_PORT || 3306,
-  database: process.env.MYSQL_DATABASE,
-  user: process.env.MYSQL_USER,
-  password: process.env.MYSQL_PASSWORD,
-});
-```
-
-### Python
-
-```python
-import pymysql
-pool = pymysql.connect(
-    host=os.environ['MYSQL_HOST'],
-    port=int(os.environ.get('MYSQL_PORT', 3306)),
-    database=os.environ['MYSQL_DATABASE'],
-    user=os.environ['MYSQL_USER'],
-    password=os.environ['MYSQL_PASSWORD'],
-)
-```
-
-## 最佳实践
-
-1. 使用连接池，不要在每次请求时创建新连接
-2. 设置合理的超时时间，避免连接泄漏
-3. 敏感信息使用环境变量，不要硬编码
-
-## 反模式清单
-
-| 反模式 | 风险 | 替代方案 |
-|--------|------|----------|
-| 直接拼接SQL字符串 | SQL注入风险 | 使用参数化查询 |
-| 在代码中硬编码密码 | 安全风险 | 使用环境变量 |
-
-## 健康检查
-
-```bash
-mysqladmin ping -h ${MYSQL_HOST} -u ${MYSQL_USER} -p${MYSQL_PASSWORD}
-```
-```
-
----
-
-## 产出物
-
-- 模板列表展示
-- 模板详情展示
-- 模板合规校验报告
-- 同步后的模板缓存
-- 模板示例展示
-
----
-
-## 参数说明
-
-| 参数 | 说明 |
-|------|------|
-| 无参数 | 显示模板列表 |
-| `--show <name>` | 显示指定模板详情 |
-| `--validate` | 校验知识文件模板合规 |
-| `--sync` | 同步模板注册表到本地 |
-| `--example <name>` | 显示模板示例 |
+总计：5 文件，4 完全合规，1 有警告
+```

package/plugins/commands/env-update.md

@@ -261,4 +261,4 @@ cp -r .autospec/environment/{path}/* {target}/
 
 **维护者**: AutoSpec 团队
 **进化分区**: 受控区
-**关联文档**: `knowledge/environment/README.md`, `plugins/commands/autospec:env-sync.md`
+**关联文档**: `knowledge/06-environment/README.md`, `plugins/commands/autospec:env-sync.md`

package/plugins/commands/env-validate.md

@@ -19,12 +19,12 @@ $ARGUMENTS
 **【强制】** 读取模板注册表和模板文件：
 
 1. **读取模板注册表**
-   - 读取 `knowledge/environment/template-registry.md`
+   - 读取 `knowledge/06-environment/00-template-registry.md`
    - 获取模板清单、类型枚举、必填章节定义
 
 2. **加载模板文件**
-   - 中间件模板：`knowledge/environment/middleware-knowledge.md`
-   - 组件模板：`knowledge/environment/component-knowledge.md`
+   - 中间件模板：`knowledge/09-templates/13-middleware-knowledge.md`
+   - 组件模板：`knowledge/09-templates/10-component-knowledge.md`
 
 ### Step 2: 扫描知识文件
 

package/plugins/commands/explore.md

@@ -12,11 +12,21 @@ $ARGUMENTS
 
 ---
 
+**【能力指南】**
+本命令执行时参考以下指南（由 Skill 层按需加载）：
+
+| 指南文件 | 用途 |
+|---------|------|
+| 02-analyze-requirement.md | 需求分析方法论 |
+| 09-review-requirement.md | 需求审查标准 |
+
+---
+
 ## 前置处理
 
 【前置】读取流程协议：
 > **【重要】执行本command前必须先读取流程协议**
-> 1. 读取 `knowledge/guides/support/pipeline-protocol.md` 中的「流程能力」章节
+> 1. 读取 `knowledge/03-guides/00-pipeline-protocol.md` 中的「流程能力」章节
 > 2. 执行以下步骤：
 >    - 解析命令与参数
 >    - 加载必要文件
@@ -33,6 +43,44 @@ $ARGUMENTS
 
 ### 探索阶段
 
+**【前置检查】** 检查执行模式：
+
+```
+检查清单：
+□ 读取 state.json 确认 executionMode
+□ 如果 executionMode 未设置，默认为 "interactive"
+□ 如果 executionMode === "interactive"，单命令模式，完成后暂停
+□ 如果 executionMode === "autonomous"，自动流转模式，完成后触发下一阶段
+```
+
+**【阻塞检查】** 在开始执行前，必须确认以下条件：
+
+```
+□ 已读取流程协议
+□ 已准备启动多 Agent 对抗分析
+□ 已准备使用 AskUserQuestion 进行澄清
+```
+
+**【跳过检测】** 以下行为将被检测并阻止：
+
+| 行为 | 检测方式 | 处理 |
+|------|----------|------|
+| 直接生成 requirement.md | 检查 clarifications.md | 阻止，返回执行对抗分析和澄清 |
+| 使用单个 Agent 模拟对抗 | 检查 Agent 调用记录 | 阻止，要求并行启动多 Agent |
+| 不使用 AskUserQuestion 澄清 | 检查问答记录 | 阻止，要求执行澄清 |
+
+**【前置】动态智能体团队组建（增强）：
+1. 读取 `knowledge/05-config/03-role-composition.yaml`
+2. 使用 project-evolve-scanner 检测技术栈
+3. 根据复杂度（simple/medium/complex）选择团队：
+   - 简单：CEO + PO
+   - 中等：+ TechLead
+   - 复杂：+ 关键 Engineer
+4. **AI Native 感知**：检测是否涉及 Prompt/RAG/Agent/模型
+   - 涉及AI → 标记，后续阶段强制加入 ai-engineer
+5. **数据感知**：检测是否涉及数据Schema/管道
+   - 涉及数据 → 标记，后续阶段强制加入 data-engineer
+
 **【强制执行】**：此阶段必须与人类进行深入交互，完成需求澄清后才能继续。
 
 **【重要】** 即使有详细的需求文档，也必须执行多Agent对抗分析和多轮澄清！需求文档是重要输入材料，澄清时要基于文档内容深入探讨，不能忽略文档中的信息。
@@ -67,10 +115,79 @@ $ARGUMENTS
 - 原：固定3轮澄清
 - 新：按复杂度动态调整（2-6轮）+ 用户可提前终止 + 强制 AskUserQuestion 交互
 
+### Step 2: 多角色对抗审查（team-orchestrator）
+
+**【强制】** 需求分析完成后，使用 team-orchestrator 进行多角色对抗审查：
+
+1. **读取配置文件**
+   - 读取 `knowledge/05-config/01-team-stage.yaml` 获取团队阶段
+   - 读取 `knowledge/05-config/03-role-composition.yaml` 获取角色组合（含动态决策树）
+
+2. **调用 team-orchestrator**
+   - 使用 Agent 工具，subagent_type=team-orchestrator
+   - 传入被审查文档：requirement.md
+   - 传入当前阶段：requirement
+   - 传入复杂度评估结果
+
+3. **处理审查结果**
+   - 审查通过 → 进入下一阶段
+   - 审查不通过 → 返回修正（最多3次）
+
+**质量红线（不可跳过）**：
+- 所有任务必须执行团队对抗审查
+- 安全敏感项目必须包含 safety-auditor
+- 涉及用户数据必须包含 security-engineer
+- 涉及AI功能必须包含 ai-engineer
+
+**角色优化（仍需执行审查）**：
+- 简单任务（复杂度≤3）：可使用最小团队配置（CEO + PO）
+- 中等任务：使用标准配置（+ TechLead）
+- 复杂任务：使用完整配置（+ 关键 Engineer）
+
+**【阶段门禁】** 需求分析完成后，必须通过以下检查：
+
+```
+门禁检查清单：
+□ team-orchestrator 调用记录存在（检查 execution-{date}.json）
+□ independent-reviewer 调用记录存在
+□ Layer 2 审查报告已生成
+```
+
+任何记录缺失 → 阻止进入下一阶段，返回补充执行
+
+**【阶段完成验证】** 探索阶段完成后，必须验证：
+
+```
+验证清单：
+□ clarifications.md 文件存在且完整
+□ requirement.md 已生成
+□ Layer1 验证通过（Schema校验 + 格式检查）
+□ Layer2 审查通过（independent-reviewer）
+```
+
+**验证失败处理**：
+- 缺少 clarifications.md → 返回执行对抗分析和澄清
+- Layer1/Layer2 不通过 → 执行修复循环
+
 探索阶段完成后：
 - 更新 `.autospec/runtime/state.json`
 - 记录阶段完成状态
 
+**【自动流转】** 阶段完成后，检查执行模式：
+
+1. **读取 state.json 确认 executionMode**
+   - 如果 executionMode === "autonomous"：
+     - **无需用户确认，立即触发下一阶段**
+     - 自动执行 `/autospec:propose` 命令
+   - 如果 executionMode === "interactive" 或未设置：
+     - 输出阶段完成报告
+     - 等待用户确认后进入下一阶段
+
+2. **自主模式特别说明**：
+   - 自主模式由 `/autospec:run` 触发，会自动设置 executionMode
+   - 单独调用 `/autospec:explore` 默认为交互模式
+   - 自主模式下禁止询问用户，直接执行下一阶段
+
 ---
 
 **继续执行**: `/autospec:propose`

package/plugins/commands/field-evolve.md

@@ -1,71 +1,69 @@
 ---
-description: "触发 AutoSpec 实战项目自进化：支持 quick/deep/full/report/distill/generate 模式，执行 benchmarks、评估分析、自动修复和技能蒸馏"
+description: "触发 AutoSpec 领域进化：从多个实战项目中提炼经验，回流到框架层"
 ---
 
-# AutoSpec Field-Evolve — 实战项目自进化
+# AutoSpec Field-Evolve — 领域进化（L2）
 
 ## 定位
 
-实战项目（Field Project）的自进化命令，与 `/self-evolve`（框架自我进化）形成对应关系。
+**领域级进化（L2）** — 从多个实战项目的实践中提炼经验，回流到框架层。
 
-| 命令 | 用途 | 目标 |
-|------|------|------|
-| `/self-evolve` | 框架自我进化 | AutoSpec 框架自身的迭代升级 |
-| `/autospec:field-evolve` | 实战项目进化 | 实战项目的质量提升和经验回流 |
+与 L1/L3 形成完整的三层进化体系：
+
+| 层级 | 命令 | 用途 | 目标 |
+|------|------|------|------|
+| L1 | `/self-evolve` | 框架自我进化 | AutoSpec 框架自身的迭代升级 |
+| **L2** | `/autospec:field-evolve` | **领域进化** | **从多个实战项目提炼经验回流框架** |
+| L3 | `/autospec:project-evolve` | 项目自我进化 | 单个实战项目的自我优化 |
 
 ## 用户输入
 
 ```
-$ARGUMENTS
+/autospec:field-evolve
 ```
 
-**参数支持**:
-- `--mode=quick|deep|full|report|distill|generate` - 执行模式（默认: quick）
-- `--benchmark=<name>` - 指定执行某个 benchmark
-- `--auto-fix` - 自动修复可修复的问题（仅 full 模式）
-- `--keep` - 保留临时目录用于调试
-
 ---
 
 ## 前置处理
 
 【前置】读取流程协议：
 > **【重要】执行本 command 前必须先读取流程协议**
-> 1. 读取 `knowledge/guides/support/pipeline-protocol.md` 中的「流程能力」章节
-> 2. 执行以下步骤：
->    - 解析命令与参数
->    - 加载必要文件
-> 3. 完成后继续执行本命令的具体逻辑
->
-> **【注意】日志追踪已启用**
-> - 执行日志会自动记录到 `.autospec/logs/execution-{date}.json`
-> - 关键步骤（skill 加载、agent 调用、产物生成、阶段完成）都会被追踪
+> 1. 读取 `knowledge/03-guides/00-pipeline-protocol.md` 中的「流程能力」章节
+> 2. 完成后继续执行本命令的具体逻辑
 
 ---
 
-## 执行模式
+## 执行指令
 
-### 模式对照表
+**【技能组合】** 领域进化由以下技能协作完成：
+- `field-evolve-scanner` - 扫描项目状态
+- `field-evolve-executor` - 执行 benchmark
+- `field-evolve-analyzer` - 分析评估结果
+- `field-evolve-fixer` - 自动修复问题
+- `field-evolve-verifier` - 验证修复效果
+- `field-evolve-learner` - 学习团队偏好
+- `field-evolve-distiller` - 蒸馏技能
 
-| field-evolve 模式 | 对应 self-evolve | 功能描述 |
-|-------------------|------------------|----------|
-| `quick` | `quick` | 快速验证 - 仅测试核心功能（编译、单元测试、lint） |
-| `deep` | `deep` | 深度测试 - 执行 benchmarks + 评估分析 |
-| `full` | `full` | 完整循环 - deep + 改进优化 + 技能蒸馏 + 自动修复 |
-| `report` | `report` | 仅报告 - 分析并生成报告，跳过修复和蒸馏 |
-| `distill` | - | 技能蒸馏 - 从 practice-log 提炼技能（field-evolve 特有） |
-| `generate` | - | 生成 benchmarks - 根据项目自动生成（field-evolve 特有） |
+### Step 1: 交互式选择模式
 
----
+**运行时让用户选择执行模式：**
 
-## 执行指令
+```
+请选择执行模式：
 
-### 模式检测
+  1. quick   - 快速验证：仅测试核心功能（编译、单元测试、lint）
+  2. deep    - 深度测试：执行 benchmarks + 评估分析
+  3. full    - 完整循环：deep + 改进优化 + 技能蒸馏 + 自动修复
+  4. report  - 仅报告：分析并生成报告，跳过修复和蒸馏
 
+请输入选项编号（1-4）：
 ```
-1. 解析 --mode 参数，默认为 quick
-2. 根据模式跳转到对应执行分支
-```
+
+**模式说明**：
+- **quick**: 快速验证 - 仅测试核心功能（编译、单元测试、lint）
+- **deep**: 深度测试 - 执行 benchmarks + 评估分析
+- **full**: 完整循环 - deep + 改进优化 + 技能蒸馏 + 自动修复（含 distill）
+- **report**: 仅报告 - 分析并生成报告，跳过修复和蒸馏
 
 ---
 
@@ -191,16 +189,18 @@ $ARGUMENTS
 ```
 1. 扫描 .autospec/benchmarks/*.yaml
 2. 如指定 --benchmark=<name>，仅执行该 benchmark
-3. 如无 benchmarks，提示使用 --mode=generate 生成
+3. 如无 benchmarks，需要先创建 benchmark 配置
 ```
 
 #### Step 2: 执行 Benchmarks
 
+**【强制】执行项目级 benchmark：**
+
 对每个 benchmark：
 
 ```
-1. 读取 benchmark YAML 配置
-2. 创建隔离环境 /tmp/autospec-benchmark-{id}/
+1. 读取 .autospec/benchmarks/ 中的 benchmark YAML 配置
+2. 创建隔离环境 /tmp/autospec-field-benchmark-{id}/
 3. 执行 benchmark 定义的测试场景
 4. 捕获过程指标：
    - 各阶段 Layer1/Layer2 通过率
@@ -347,7 +347,7 @@ $ARGUMENTS
 
 #### Step 6: 技能蒸馏
 
-同 `distill` 模式（见下文）。
+技能蒸馏已包含在 full 模式中（自动执行）。
 
 ---
 
@@ -361,113 +361,11 @@ Step 3: 生成详细报告
    - 问题分析
    - 改进建议（区分 auto-fixable/manual-review）
    - 预期效果预测
-   - 不执行修复和蒸馏
+   - 不执行修复
 ```
 
 ---
 
-### Mode: distill（技能蒸馏）
-
-**对应原 `/evolve` 功能，从 practice-log 提炼技能**
-
-#### Step 1: 读取进化规则
-
-- 读取 `knowledge/principles/evolution.md`
-
-#### Step 2: 收集进化信号
-
-- 收集 Pending 的 practice-log（`.autospec/evolution/practice-log/`）
-
-#### Step 3: 分析与提炼
-
-- 读取 `knowledge/guides/support/skill-distiller.md` 并执行
-- 读取 `knowledge/guides/support/methodology-extractor.md` 并执行
-
-#### Step 4: 确认进化分区
-
-- 自由区：自动执行
-- 受控区：提案等待审批
-- 冻结区：标记禁止修改
-
-#### Step 5: 执行进化
-
-- 自由区：自动执行变更
-- 受控区：生成提案
-- 冻结区：标记需要人工处理
-
-#### Step 6: 验证进化效果
-
-- 执行验证确保变更有效
-
-#### Step 7: 实战反馈回流（可选）
-
-```
-如配置回流到 AutoSpec：
-1. 将提炼的技能复制到 .autospec/evolution/distilled-skills/
-2. 生成回流提案（PR 模板）
-3. 提示用户提交到 AutoSpec 项目
-```
-
-**安全底线**：绝不修改 constitution.md / evolution.md
-
----
-
-### Mode: generate（生成 benchmarks）
-
-**根据项目自动生成 benchmarks**
-
-#### Step 1: 检测项目类型
-
-```
-检测文件 → 项目类型：
-- package.json → Node.js
-- pom.xml/build.gradle → Java
-- go.mod → Go
-- requirements.txt/pyproject.toml → Python
-```
-
-#### Step 2: 生成 Benchmarks
-
-根据项目类型生成：
-
-```yaml
-# .autospec/benchmarks/project-generated.yaml
-version: "1.0"
-name: "{project-name}-benchmark"
-description: "自动生成的基础 benchmark"
-
-generatedFrom:
-  projectType: "{detected-type}"
-  files: ["{detected-files}"]
-
-testScenarios:
-  quick:
-    - name: "compile-check"
-      command: "{compile-command}"
-      expected: "success"
-    - name: "unit-test"
-      command: "{test-command}"
-      expected: "pass"
-    - name: "lint-check"
-      command: "{lint-command}"
-      expected: "no-errors"
-
-  pipeline:
-    - name: "basic-flow"
-      stages: ["exploration", "requirement", "design"]
-      input: "实现一个简单的功能"
-      expectedArtifacts:
-        - "requirement.md"
-        - "design.md"
-```
-
-#### Step 3: 保存生成的 Benchmarks
-
-- 保存到 `.autospec/benchmarks/project-generated.yaml`
-- 提示用户可自定义修改
-
----
-
 ## 评分等级
 
 | 等级 | 分数范围 | 说明 |
@@ -496,41 +394,19 @@ testScenarios:
 - `.autospec/logs/autospec:field-evolve/improvements-{timestamp}.md` - 改进方案
 - `.autospec/logs/autospec:field-evolve/auto-fixes-{timestamp}.json` - 自动修复任务
 - `.autospec/logs/autospec:field-evolve/manual-reviews-{timestamp}.json` - 人工审查任务
-
-**distill 模式**：
-- `.autospec/evolution/distilled-skills/` - 提炼的技能
-- `.autospec/logs/autospec:field-evolve/distill-{date}.md` - 蒸馏报告
-
-**generate 模式**：
-- `.autospec/benchmarks/project-generated.yaml` - 生成的 benchmark
+- `.autospec/evolution/distilled-skills/` - 提炼的技能（自动生成）
 
 ---
 
 ## 使用示例
 
 ```bash
-# 快速验证（默认）
+# 执行 field-evolve（运行时选择模式）
 /autospec:field-evolve
-/autospec:field-evolve --mode=quick
-
-# 深度测试
-/autospec:field-evolve --mode=deep
-
-# 完整循环（测试 + 评估 + 修复 + 蒸馏）
-/autospec:field-evolve --mode=full --auto-fix
-
-# 仅生成报告
-/autospec:field-evolve --mode=report
-
-# 技能蒸馏
-/autospec:field-evolve --mode=distill
-
-# 生成 benchmarks
-/autospec:field-evolve --mode=generate
-
-# 指定 benchmark
-/autospec:field-evolve --mode=deep --benchmark=waterfall
 
-# 保留临时目录用于调试
-/autospec:field-evolve --mode=deep --keep
+# 选择模式：
+# 1. quick   - 快速验证
+# 2. deep    - 深度测试
+# 3. full    - 完整循环
+# 4. report  - 仅报告
 ```