@chongyan/autospec 1.0.1

package/plugins/commands/env.md

@@ -0,0 +1,79 @@
+---
+description: 查看当前环境配置状态
+---
+
+# AutoSpec Env — 环境配置查看
+
+## 用户输入
+
+```
+$ARGUMENTS
+```
+
+---
+
+## 执行指令
+
+### Step 1: 检查环境目录
+
+检查 `.autospec/environment/` 目录是否存在：
+- 不存在 → 提示用户执行 `/autospec:env-sync`（会自动初始化）
+
+### Step 2: 读取注册表
+
+读取 `.autospec/environment/registry.json`
+
+### Step 3: 展示状态
+
+格式化输出：
+
+```
+🔧 环境配置状态
+
+环境知识:
+  中间件: mysql, redis, kafka
+  组件: axios, lodash
+  激活配置: development
+
+已注册组件:
+  名称              版本     类型              标签
+  ─────────────────────────────────────────────────
+  axios             1.0      http-client       api, http
+  lodash            1.0      utility           utils
+
+设计知识:
+  产品设计: 2 份
+  架构设计: 3 份
+  接口设计: 5 份
+  数据库设计: 2 份
+
+测试知识:
+  测试设计: 4 份
+  评测设计: 1 份
+
+业务知识:
+  术语: 15 条
+  规则: 8 条
+  流程: 3 个
+
+规范指南:
+  编码规范: coding-style.md
+  数据一致性: data-consistency.md
+  代码审查: code-review.md
+
+知识源:
+  - org-design-templates (Git) - 上次同步: 2026-03-26
+
+🔗 集成配置:
+  CI/CD: {ci_cd}
+  测试环境: {testing}
+  部署配置: {deployment}
+
+💡 使用 /autospec:env-sync 同步知识
+```
+
+---
+
+## 产出物
+
+- 环境配置状态展示

package/plugins/commands/explore.md

@@ -0,0 +1,76 @@
+---
+description: "我先想想…" — 需求探索阶段。包含CEO想法对齐 + 需求分析。
+---
+
+# AutoSpec Explore — 需求探索
+
+## 用户输入
+
+```
+$ARGUMENTS
+```
+
+---
+
+## 前置处理
+
+【前置】读取流程协议：
+> **【重要】执行本command前必须先读取流程协议**
+> 1. 读取 `knowledge/guides/support/pipeline-protocol.md` 中的「流程能力」章节
+> 2. 执行以下步骤：
+>    - 解析命令与参数
+>    - 加载必要文件
+>    - 检查前置条件
+> 3. 完成后继续执行本命令的具体逻辑
+>
+> **【注意】日志追踪已启用**
+> - 执行日志会自动记录到 `.autospec/logs/execution-{date}.json`
+> - 关键步骤（skill加载、agent调用、产物生成、阶段完成）都会被追踪
+
+---
+
+## 执行指令
+
+### 探索阶段
+
+**【强制执行】**：此阶段必须与人类进行深入交互，完成需求澄清后才能继续。
+
+**【重要】** 即使有详细的需求文档，也必须执行多Agent对抗分析和多轮澄清！需求文档是重要输入材料，澄清时要基于文档内容深入探讨，不能忽略文档中的信息。
+
+**【复用】** 读取 `plugins/skills/exploration-phase/SKILL.md` 并执行探索阶段逻辑：
+
+1. 复杂度评估 → 确定探索轮次上限（简单2-3轮，中等3-4轮，复杂5-6轮）
+2. 检查是否已有澄清记录（clarifications.md）
+   - **【重要】** 即使有详细的需求文档，也不代表澄清完成！
+   - 只有当 clarifications.md 中有完整的「对抗分析结果」+「多轮问答记录」时，才算完成
+3. **【强制】【不可跳过】** 使用 Agent 工具启动 2-3 个独立 Agent 进行对抗分析：
+   - Agent A - 乐观视角：支持理由、预期价值
+   - Agent B - 质疑视角：潜在问题、风险、伪需求可能性
+   - Agent C - 技术视角：技术可行性、实现难点
+   - **【强制】** 使用 Agent 工具启动独立 Agent，不要自己模拟分析
+4. **【强制】【不可跳过】** 使用 AskUserQuestion 工具进行多轮澄清：
+   - 每轮最多5个问题
+   - 每个问题附AI推荐答案
+   - 支持用户提前终止（说「足够」「清楚了」）
+   - **必须至少执行一轮澄清**
+5. 用户确认「足够」或达到轮次上限 → 探索完成
+6. 生成 requirement.md 并通过 Layer1/Layer2 验证
+
+**【禁止跳过】** 以下情况必须暂停并使用 AskUserQuestion 向用户确认：
+- 需求有歧义
+- 技术方案有多种选择
+- 涉及安全/性能/成本等关键决策
+- **即使需求文档很详细，也必须执行至少一轮澄清**
+- 用户说「足够」前不得跳过澄清环节
+
+**与原逻辑对比**：
+- 原：固定3轮澄清
+- 新：按复杂度动态调整（2-6轮）+ 用户可提前终止 + 强制 AskUserQuestion 交互
+
+探索阶段完成后：
+- 更新 `.autospec/runtime/state.json`
+- 记录阶段完成状态
+
+---
+
+**继续执行**: `/autospec:propose`

package/plugins/commands/field-evolve.md

@@ -0,0 +1,536 @@
+---
+description: "触发 AutoSpec 实战项目自进化：支持 quick/deep/full/report/distill/generate 模式，执行 benchmarks、评估分析、自动修复和技能蒸馏"
+---
+
+# AutoSpec Field-Evolve — 实战项目自进化
+
+## 定位
+
+实战项目（Field Project）的自进化命令，与 `/self-evolve`（框架自我进化）形成对应关系。
+
+| 命令 | 用途 | 目标 |
+|------|------|------|
+| `/self-evolve` | 框架自我进化 | AutoSpec 框架自身的迭代升级 |
+| `/autospec:field-evolve` | 实战项目进化 | 实战项目的质量提升和经验回流 |
+
+## 用户输入
+
+```
+$ARGUMENTS
+```
+
+**参数支持**:
+- `--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 调用、产物生成、阶段完成）都会被追踪
+
+---
+
+## 执行模式
+
+### 模式对照表
+
+| field-evolve 模式 | 对应 self-evolve | 功能描述 |
+|-------------------|------------------|----------|
+| `quick` | `quick` | 快速验证 - 仅测试核心功能（编译、单元测试、lint） |
+| `deep` | `deep` | 深度测试 - 执行 benchmarks + 评估分析 |
+| `full` | `full` | 完整循环 - deep + 改进优化 + 技能蒸馏 + 自动修复 |
+| `report` | `report` | 仅报告 - 分析并生成报告，跳过修复和蒸馏 |
+| `distill` | - | 技能蒸馏 - 从 practice-log 提炼技能（field-evolve 特有） |
+| `generate` | - | 生成 benchmarks - 根据项目自动生成（field-evolve 特有） |
+
+---
+
+## 执行指令
+
+### 模式检测
+
+```
+1. 解析 --mode 参数，默认为 quick
+2. 根据模式跳转到对应执行分支
+```
+
+---
+
+### Mode: quick（快速验证）
+
+**快速验证项目的编译、测试、lint、类型检查**
+
+#### Step 1: 确定技术栈
+
+读取 `.autospec/runtime/config.json`：
+- 获取 techStack
+- 获取 subsystems（多系统模式）
+
+#### Step 2: 运行确定性测试
+
+依次执行：
+
+1. **编译检查**
+   - Node.js: `npm run build` 或 `tsc --noEmit`
+   - Java: `mvn compile`
+   - Python: 跳过（解释型）
+   - Go: `go build ./...`
+
+2. **单元测试**
+   - Node.js: `npm test`
+   - Python: `pytest`
+   - Java: `mvn test`
+   - Go: `go test ./...`
+
+3. **Lint 检查**
+   - Node.js: `npm run lint`
+   - Python: `flake8 .`
+   - Go: `golint ./...`
+
+4. **类型检查**（如适用）
+   - TypeScript: `tsc --noEmit`
+   - Python: `mypy .`
+
+#### Step 3: 收集测试结果
+
+收集：
+- 每项检查的执行状态（pass/fail）
+- 输出日志
+- 错误信息
+- 测试覆盖率（如有）
+- 失败用例列表
+
+输出到 `.autospec/runtime/test-result.json`
+
+#### Step 4: AI 评测
+
+对测试结果进行 AI 分析：
+
+**1. 失败分析**
+- 识别失败的根本原因
+- 评估影响范围
+- 提供修复方向
+
+**2. 覆盖率分析**
+- 评估测试覆盖是否充分
+- 识别未覆盖的关键路径
+- 建议补充的测试用例
+
+**3. 代码质量评估**
+- 代码复杂度分析
+- 潜在 bug 风险识别
+- 可维护性问题
+
+**4. 改进建议**
+- 按优先级排序
+- 提供具体修改建议
+
+#### Step 5: 生成快速报告
+
+```markdown
+📋 AutoSpec Field-Evolve Quick 报告
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## 测试结果
+
+| 检查项     | 状态 | 耗时   |
+|-----------|------|--------|
+| 编译检查   | {status} | {time} |
+| 单元测试   | {status} | {time} |
+| Lint 检查  | {status} | {time} |
+| 类型检查   | {status} | {time} |
+
+测试统计: {passed}/{total} 通过 ({rate}%)
+覆盖率: {line}% (行) | {branch}% (分支)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## AI 分析
+
+### 失败测试分析
+{failureAnalysis}
+
+### 覆盖率改进建议
+{coverageSuggestions}
+
+### 质量评估
+| 维度       | 评分 | 说明                    |
+|-----------|------|------------------------|
+| 可读性     | {grade} | {comment} |
+| 可维护性   | {grade} | {comment} |
+| 测试质量   | {grade} | {comment} |
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## 优先修复建议
+{priorityFixes}
+```
+
+---
+
+### Mode: deep（深度测试）
+
+**对应原 `/evaluate` 功能 + Benchmark 执行**
+
+#### Step 1: 扫描 Benchmarks
+
+```
+1. 扫描 .autospec/benchmarks/*.yaml
+2. 如指定 --benchmark=<name>，仅执行该 benchmark
+3. 如无 benchmarks，提示使用 --mode=generate 生成
+```
+
+#### Step 2: 执行 Benchmarks
+
+对每个 benchmark：
+
+```
+1. 读取 benchmark YAML 配置
+2. 创建隔离环境 /tmp/autospec-benchmark-{id}/
+3. 执行 benchmark 定义的测试场景
+4. 捕获过程指标：
+   - 各阶段 Layer1/Layer2 通过率
+   - 回退次数和原因
+   - 人工介入点
+   - 各阶段耗时
+5. 收集产出物
+6. 清理环境（除非 --keep）
+```
+
+#### Step 3: 读取评测数据
+
+```
+1. 读取 .autospec/runtime/metrics.json
+2. 读取 .autospec/logs/traces/{traceId}.json（如有）
+3. 读取 benchmark 执行结果
+```
+
+#### Step 4: 计算三维度评分
+
+使用 Agent 工具执行评测：
+
+**4.1 过程指标 (权重 30%)**
+- Layer1 首次通过率
+- Layer2 首次通过率
+- 人工介入率
+- 回退率
+- 错误率
+- 阶段成功率
+
+**4.2 结果指标 (权重 40%)**
+- 产出物平均评分
+- 一致性评分
+- 结构完整性
+
+**4.3 路径指标 (权重 30%)**
+- 流程合规性
+- 执行效率
+- 决策质量
+- 异常处理
+
+#### Step 5: 生成深度报告
+
+```markdown
+## AutoSpec Field-Evolve Deep 报告
+
+### Benchmark 执行结果
+| Benchmark | 状态 | 通过率 | 耗时 |
+|-----------|------|--------|------|
+| {name} | {status} | {rate}% | {time} |
+
+### 质量评分
+| 维度 | 分数 | 权重 |
+|-----|------|------|
+| 过程指标 | {process}/100 | 30% |
+| 结果指标 | {result}/100 | 40% |
+| 路径指标 | {path}/100 | 30% |
+| **综合** | **{overall}/100** | - |
+
+### 等级: {grade}
+
+### 主要发现
+{findings}
+
+### 改进建议
+{recommendations}
+
+### 进化触发
+{evolutionTriggers}
+
+---
+详细报告: .autospec/logs/autospec:field-evolve/deep-{date}.md
+```
+
+---
+
+### Mode: full（完整循环）
+
+**deep + 改进优化 + 自动修复 + 技能蒸馏**
+
+#### Step 1-2: 同 deep 模式
+
+执行完整的 benchmark 测试和评估分析。
+
+#### Step 3: 改进方案生成
+
+**【强制】** 使用 `self-evolve-improver` Agent：
+
+```
+1. 问题分类与可修复性分析
+   - 可自动修复：路径引用错误、模板字段缺失、配置参数不当、格式不规范
+   - 需人工审查：逻辑设计缺陷、架构调整、涉及冻结区文件
+
+2. 优先级计算
+   - 优先级分数 = 影响分数 × 频率权重 × 可修复性权重
+   - P0 (>=90 分): 立即修复
+   - P1 (60-89 分): 计划修复
+   - P2 (<60 分): 观察
+
+3. 生成改进方案
+   - 自动修复方案：包含具体文件路径、修改内容、验证方式
+   - 人工审查方案：包含审查范围、决策选项、预期效果
+
+4. 影响预测
+   - 预测质量分数提升幅度
+   - 预测 benchmark 通过率变化
+   - 风险评估（退化风险、兼容风险）
+```
+
+输出：
+- `.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`
+
+#### Step 4: 自动修复（如 --auto-fix）
+
+**【强制】** 使用 `self-evolve-iterator` Agent：
+
+```
+1. 从 auto-fixes-{timestamp}.json 读取自动修复任务
+2. 按优先级排序（P0 > P1 > P2）
+3. 对每个修复任务：
+   a. 读取目标文件
+   b. 执行修复
+   c. 验证修复（根据 validation.type）
+   d. 验证通过则记录成功
+   e. 验证失败则回滚并标记为 manual-review
+4. 分区执行策略：
+   - 自由区：自动修复并提交
+   - 受控区：自动修复，人工确认后提交
+   - 冻结区：仅生成建议，禁止自动修改
+```
+
+#### Step 5: 效果验证
+
+**【强制】** 使用 `self-evolve-verifier` Agent：
+
+```
+1. 重新执行失败的 benchmark
+2. 对比修复前后的指标变化
+3. 退化检测 → 自动回滚
+4. 计算新的质量分数
+```
+
+#### Step 6: 技能蒸馏
+
+同 `distill` 模式（见下文）。
+
+---
+
+### Mode: report（仅报告）
+
+**分析并生成报告，跳过修复和蒸馏**
+
+```
+Step 1-2: 同 deep 模式（执行 benchmarks + 评估分析）
+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`
+- 提示用户可自定义修改
+
+---
+
+## 评分等级
+
+| 等级 | 分数范围 | 说明 |
+|-----|---------|------|
+| A | 90-100 | 优秀 |
+| B | 80-89 | 良好 |
+| C | 70-79 | 一般 |
+| D | 60-69 | 较差 |
+| F | <60 | 失败 |
+
+---
+
+## 产出物
+
+根据模式不同，产出物有所差异：
+
+**quick 模式**：
+- `.autospec/runtime/test-result.json` - 测试结果
+- `.autospec/logs/autospec:field-evolve/quick-{date}.md` - 快速报告
+
+**deep/report 模式**：
+- `.autospec/logs/autospec:field-evolve/deep-{date}.md` - 深度报告
+- `.autospec/logs/autospec:field-evolve/evaluation-{date}.json` - 评估数据
+
+**full 模式**：
+- `.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
+
+---
+
+## 使用示例
+
+```bash
+# 快速验证（默认）
+/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
+```