@chongyan/autospec 1.0.1 → 1.0.3

package/plugins/commands/env.md

@@ -1,79 +0,0 @@
----
-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

@@ -1,76 +0,0 @@
----
-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

@@ -1,536 +0,0 @@
----
-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
-```