@chongyan/autospec 1.0.1 → 1.0.2

package/plugins/commands/status.md

@@ -1,5 +1,5 @@
 ---
-description: 查看当前AutoSpec流程的执行状态
+description: 查看当前 AutoSpec 流程的执行状态（支持多系统开发盯盘）
 ---
 
 # AutoSpec Status — 状态查看
@@ -14,32 +14,62 @@ $ARGUMENTS
 
 ## 执行指令
 
-### Step 1: 读取状态
+### Step 1: 读取基础状态
 
-- 读取 state.json
-- 读取 metrics.json
+- 读取 `.autospec/runtime/state.json` - 流水线状态
+- 读取 `.autospec/runtime/metrics.json` - 质量指标
+- 读取 `.autospec/runtime/config.json` - 项目配置（含 subsystems）
+- 读取 `.autospec/environment/registry.json` - 环境知识注册表（如存在）
 
-### Step 2: 展示状态
+### Step 2: 检查项目模式
 
-- **单系统模式**：展示当前阶段、验证结果、假设追踪
-- **多系统模式**：展示各子系统状态表、效果指标
+- **单系统模式**：`config.json` 无 `subsystems` 或长度为 0/1
+- **多系统模式**：`config.json` 中 `subsystems` 长度>1
 
-### Step 3: 提供恢复建议
+### Step 3: 多系统覆盖检查（多系统模式）
 
-- 根据当前状态给出下一步建议
+- 从 `state.json` 读取当前阶段的 `subsystems` 数组
+- 计算覆盖率：已完成数 / 总数
+- 识别未开始、进行中、已完成的子系统
+
+### Step 4: 监控问题检查
+
+- 读取 `.autospec/monitoring-issues.json`
+- 统计各状态的问题数量
+- 按严重程度分类（critical, high, medium, low）
+
+### Step 5: 依赖包复用检查（可选）
+
+- 如用户传入 `--check-deps` 参数
+- 调用 `plugins/skills/project-evolve-scanner/scripts/dependency-reuse-checker.js`
+- 获取检查结果
+
+### Step 6: 展示状态
+
+根据模式展示不同详细程度：
+- **单系统模式**：基础状态 + 阶段进度 + 质量指标
+- **多系统模式**：基础状态 + 子系统覆盖矩阵 + 监控问题
+
+### Step 7: 提供建议
+
+- 根据覆盖情况给出下一步建议
+- 提示是否有子系统被遗漏
+- 建议是否需要触发监控检查
 
 ---
 
 ## 输出格式
 
+### 单系统模式
+
 ```markdown
 ## AutoSpec 状态
 
 ### 基本信息
-- 任务: {taskName}
-- 工作流: {workflow}
-- 当前阶段: {currentStage}
-- 执行模式: {executionMode}
+- 任务：{taskName}
+- 工作流：{workflow}
+- 当前阶段：{currentStage}
+- 执行模式：{executionMode}
 
 ### 阶段进度
 | 阶段 | 状态 | Layer1 | Layer2 |
@@ -49,14 +79,105 @@ $ARGUMENTS
 | ... | ... | ... | ... |
 
 ### 质量指标
-- Layer1 通过率: {layer1PassRate}%
-- Layer2 通过率: {layer2PassRate}%
-- 人工介入次数: {humanInterventions}
+- Layer1 通过率：{layer1PassRate}%
+- Layer2 通过率：{layer2PassRate}%
+- 人工介入次数：{humanInterventions}
+
+### 环境知识状态
+- 中间件：{middlewareCount} 个
+- 组件库：{componentCount} 个
+- 设计知识：{designKnowledgeCount} 份
+- 业务知识：{businessKnowledgeCount} 份
+- 测试知识：{testKnowledgeCount} 份
 
 ### 下一步建议
 {nextSteps}
 ```
 
+### 多系统模式
+
+```markdown
+## AutoSpec 状态（多系统开发）
+
+### 基本信息
+- 任务：{taskName}
+- 工作流：{workflow}
+- 当前阶段：{currentStage}
+- 执行模式：{executionMode}
+- 子系统数量：{count}
+
+### 阶段进度
+| 阶段 | 状态 | Layer1 | Layer2 |
+|-----|------|--------|--------|
+| 01-需求分析 | ✅ 完成 | ✅ | ✅ |
+| 02-方案设计 | ✅ 完成 | ✅ | ✅ |
+| 03-编码实现 | 🔄 进行中 | ⏳ | - |
+
+### 子系统覆盖矩阵
+| 子系统 | 类型 | 状态 | Layer 1 | Layer 2 | 变更文件 | 最后变更 |
+|--------|------|------|---------|---------|---------|---------|
+| backend | 后端 | completed | ✅ pass | - | 15 | 2026-03-27 10:30 |
+| frontend | 前端 | in_progress | ⏳ pending | - | 8 | 2026-03-27 11:15 |
+| ai | AI/模型 | pending | - | - | 0 | - |
+
+### 覆盖率统计
+- 总计：{total} 个子系统
+- 已完成：{completed} 个 ({percentage}%)
+- 进行中：{inProgress} 个
+- 待开始：{pending} 个
+
+### 监控问题
+| 级别 | 问题 | 子系统 | 状态 |
+|------|------|--------|------|
+| HIGH | 依赖包未复用 | backend | open |
+| MEDIUM | 长时间无变更 | frontend | acknowledged |
+
+### 环境知识状态
+| 类别 | 数量 | 最后更新 |
+|------|------|----------|
+| 中间件 | {middlewareCount} | {lastEnvUpdate} |
+| 组件库 | {componentCount} | {lastEnvUpdate} |
+| 设计知识 | {designKnowledgeCount} | {lastEnvUpdate} |
+| 业务知识 | {businessKnowledgeCount} | {lastEnvUpdate} |
+| 测试知识 | {testKnowledgeCount} | {lastEnvUpdate} |
+
+### 未开始子系统
+{列出未开始的子系统，如无则填"无"}
+
+### 下一步建议
+{根据状态给出建议}
+```
+
+---
+
+## 命令参数
+
+| 参数 | 说明 |
+|------|------|
+| `--detail` | 显示详细信息（包括变更文件列表） |
+| `--json` | 以 JSON 格式输出（供脚本使用） |
+| `--check-deps` | 执行依赖包复用检查 |
+| `--check-coverage` | 手动触发覆盖检查 |
+
+---
+
 ## 相关命令
 
-- `/evaluate` — 生成完整评测报告
+- `/autospec:validate` — 执行 Layer 1 验证
+- `/autospec:review` — 审查各阶段交付物
+- `/autospec:archive` — 交付归档
+
+---
+
+## 内部模块调用
+
+本命令内部调用以下检查器模块：
+
+1. **子系统覆盖检查**：`plugins/skills/project-evolve-scanner/scripts/subsystem-coverage.js`
+   - 用于获取详细的覆盖报告
+
+2. **依赖包复用检查**：`plugins/skills/project-evolve-scanner/scripts/dependency-reuse-checker.js`
+   - 用于检测重复造轮子
+
+3. **监控问题读取**：直接从 `.autospec/monitoring-issues.json` 读取
+   - 无需调用外部脚本

package/plugins/commands/test.md

@@ -0,0 +1,389 @@
+---
+description: "统一测试命令：执行测试 → 问题分析 → 自动修复 → 效果评测"
+---
+
+# AutoSpec Test — 统一测试命令
+
+## 用户输入
+
+```
+$ARGUMENTS
+```
+
+---
+
+## 执行指令
+
+### Step 1: 解析参数
+
+解析用户输入，提取：
+- 目标路径：本地目录或 git 仓库（默认当前目录）
+- 分支名称：--branch <name>（git 仓库时）
+- 测试范围：--scope unit|integration|all|evaluation（默认 unit）
+- 子系统：--subsystem <名称>（多系统项目）
+- 修复模式：--fix（发现问题时自动修复）
+- 深度分析：--deep
+- 重试次数：--max-retries <n>（默认 3）
+- 输出路径：--output <path>
+
+**参数格式**：
+```
+[target] [--branch <name>] [--scope unit|integration|all|evaluation]
+        [--subsystem <name>] [--fix] [--deep] [--max-retries <n>]
+        [--output <path>]
+```
+
+**示例**：
+```
+/autospec:test                              # 当前项目，仅验证
+/autospec:test --fix                        # 当前项目，验证+修复
+/autospec:test ./my-project                 # 指定目录
+/autospec:test https://github.com/user/repo --branch main  # git仓库
+/autospec:test --scope=integration --fix    # 集成测试+修复
+/autospec:test --scope=evaluation           # AI效果评测
+/autospec:test --subsystem=backend          # 指定子系统
+```
+
+### Step 2: 处理目标路径
+
+**规则 1：如果 target 未指定**
+- 默认使用当前项目目录（`.`）
+
+**规则 2：如果 target 是本地目录**
+- 直接在指定目录执行测试
+
+**规则 3：如果 target 是 git URL**
+1. 判断是否为 git 仓库（以 http://、https://、git@ 开头）
+2. 确定目标目录：`/tmp/autospec-test-{repo-name}-{branch}`
+3. 执行克隆：`git clone --depth 1 [-b <branch>]`
+4. 在克隆目录执行测试
+
+### Step 3: 执行 Layer 1 测试
+
+**【复用】** 参考 `plugins/skills/layer1-validation/SKILL.md`：
+
+#### 3.1 确定模式
+
+读取 `.autospec/runtime/config.json`，检查 `subsystems` 字段：
+- **无 subsystems 或长度为1** → 单系统模式
+- **有 subsystems 且长度>1** → 多系统模式
+
+#### 3.2 单系统模式
+
+执行验证：
+
+1. **编译检查** — 项目能否成功编译/构建
+   - Node.js: `npm run build` 或 `tsc --noEmit`
+   - Java: `mvn compile`
+   - Python: 跳过（解释型）
+   - Go: `go build ./...`
+
+2. **测试执行** — 按 --scope 参数执行
+   - unit: 只执行单元测试
+   - integration: 执行集成测试
+   - all: 执行全部测试
+   - evaluation: 执行效果评测（AI项目）
+
+3. **Lint 检查** — 代码风格和静态分析
+   - Node.js: `npm run lint` 或 `npx eslint .`
+   - Python: `flake8 .` 或 `ruff check .`
+   - Go: `golint ./...`
+
+4. **类型检查** — TypeScript/类型系统检查（如适用）
+   - TypeScript: `tsc --noEmit`
+   - Python: `mypy .`
+
+#### 3.3 多系统模式
+
+对 config.json 中的每个 subsystem 执行验证：
+
+```
+for subsystem in config.subsystems:
+  1. {subsystem.build} — 构建检查（如有）
+  2. {subsystem.test} — 测试执行（如有）
+  3. {subsystem.lint} — Lint检查（如有）
+  4. {subsystem.typeCheck} — 类型检查（如有）
+```
+
+**验证顺序**：按依赖顺序执行，通常为 backend → frontend → mobile
+
+**指定子系统**：如果使用了 `--subsystem` 参数，只验证指定子系统
+
+#### 3.4 AI/模型项目（--scope=evaluation）
+
+当子系统类型为 `ai` 或使用 `--scope=evaluation`：
+
+**【复用】** 参考 `plugins/skills/experiment-evaluator/SKILL.md`：
+
+1. 执行效果评测脚本
+2. 收集评测指标
+3. 与目标阈值对比
+4. 生成评测报告
+
+#### 3.5 测试结果处理
+
+- **全部通过** → 输出通过报告 → 结束
+- **存在失败且无 --fix** → 输出失败报告 → 结束
+- **存在失败且有 --fix** → 进入 Step 4
+
+### Step 4: 问题分析
+
+**【复用】** 参考 `.claude/skills/self-evolve-analyzer/SKILL.md`：
+
+#### 4.1 收集失败信息
+
+- 失败的测试用例
+- 错误类型（断言失败、超时、异常等）
+- 错误位置（文件、行号）
+
+#### 4.2 根因识别
+
+**测试代码问题**：
+- 断言条件错误
+- Mock数据过时
+- 测试环境依赖缺失
+
+**被测代码问题**：
+- 业务逻辑错误
+- 边界条件未处理
+- API变更未同步
+
+**配置/环境问题**：
+- 依赖版本不兼容
+- 配置参数过期
+- 环境变量缺失
+
+#### 4.3 优先级计算
+
+```
+优先级分数 = 影响分数 (40%) + 频率分数 (30%) + 修复难度分数 (30%)
+```
+
+| 优先级 | 分数 | 处理策略 |
+|--------|------|---------|
+| P0 | >= 80分 | 立即修复 |
+| P1 | 60-79分 | 计划修复 |
+| P2 | < 60分 | 观察记录 |
+
+#### 4.4 保存分析结果
+
+保存到 `.autospec/logs/test/analysis-{timestamp}.json`
+
+### Step 5: 修复分类
+
+**【应用精准回退机制 DP6】** 对问题进行分类：
+
+#### AUTO-FIX（自动修复）
+
+以下类型问题自动修复，无需确认：
+
+- **断言更新**：业务逻辑变更后的断言调整
+- **导入修复**：路径变更、模块重命名
+- **类型补全**：TypeScript 类型定义缺失
+- **Mock更新**：接口变更后的Mock同步
+- **代码格式**：Lint 错误
+- **配置更新**：过期配置参数
+
+#### AUTO-DECIDE（自动决策）
+
+存在多种修复方案，自动选择最优方案：
+
+- 多种修复策略可选
+- 需要在性能/可读性间权衡
+- 涉及API兼容性决策
+
+#### REQUIRE-REVIEW（需人工审查）
+
+以下类型问题需要人工确认：
+
+- 需求歧义导致测试失败
+- 架构设计问题
+- 涉及核心业务逻辑
+- 修复影响范围大于单个文件
+
+### Step 6: 执行修复
+
+**【复用】** 参考 `.claude/skills/self-evolve-iterator/SKILL.md`：
+
+#### 6.1 修复前验证（必须通过）
+
+1. **语法评测**：修改内容语法正确
+   - YAML/JSON 格式正确
+   - 代码语法无误
+   - 不通过 → 禁止修复，记录为 syntax-error
+
+2. **语义评测**：修复逻辑自洽
+   - 修复逻辑合理
+   - 与现有代码无明显冲突
+   - 不通过 → 标记为 needs-review
+
+3. **一致性评测**：不与冻结区/受控区冲突
+   - 检查是否误修改冻结区文件
+   - 检查是否与宪法原则冲突
+   - 不通过 → 禁止修复，标记为 zone-conflict
+
+4. **安全评测**：无危险操作
+   - 无删除关键文件
+   - 无引入安全漏洞
+   - 不通过 → 禁止修复，标记为 security-risk
+
+**只有通过全部4项评测，才允许执行修复**
+
+#### 6.2 按优先级执行修复
+
+```
+for problem in P0 → P1 → P2:
+  1. 记录修复前状态（用于回滚）
+  2. 执行修复
+  3. 验证修复效果（运行相关测试）
+  4. 验证通过 → 记录成功 → 继续下一个
+  5. 验证失败 → 回滚 → 记录失败 → 升级处理
+```
+
+#### 6.3 多系统项目处理
+
+按依赖顺序执行修复：
+1. backend 修复
+2. frontend 修复
+3. mobile 修复
+4. 集成测试验证
+
+#### 6.4 保存修复记录
+
+保存到 `.autospec/logs/test/fixes-{timestamp}.json`
+
+### Step 7: 效果验证
+
+**【复用】** 参考 `.claude/skills/self-evolve-verifier/SKILL.md`：
+
+#### 7.1 重新执行失败测试
+
+- 执行之前失败的测试用例
+- 记录修复前后的对比
+
+#### 7.2 退化检测
+
+以下任一条件满足即判定为退化：
+
+- 之前通过的测试现在失败
+- 新增编译错误
+- 覆盖率下降 > 5%
+
+**检测到退化 → 自动回滚相关修复**
+
+#### 7.3 质量分数计算
+
+```
+修复有效率 = 修复后通过的问题数 / 修复的问题总数 × 100
+
+综合质量分数 =
+  测试通过率 × 40% +
+  覆盖率得分 × 30% +
+  修复有效率 × 30%
+```
+
+#### 7.4 重试循环
+
+- 未通过且 retry_count < max_retries → 返回 Step 6
+- 达到最大重试次数 → 升级人工
+
+### Step 8: 生成报告
+
+输出到 `.autospec/logs/test/report-{timestamp}.md`（或用户指定路径）：
+
+```markdown
+## AutoSpec Test 报告
+
+### 执行摘要
+- 执行时间: {timestamp}
+- 目标路径: {target}
+- 测试范围: {scope}
+- 总测试数: {total}
+- 通过: {passed}
+- 失败: {failed}
+
+### 验证结果
+| 验证项 | 状态 | 执行命令 | 结果 |
+|--------|------|---------|------|
+| 编译 | ✅/❌ | npm run build | ... |
+| 测试 | ✅/❌ | npm test | ... |
+| Lint | ✅/❌ | eslint . | ... |
+
+### 问题分析（如有失败）
+| 优先级 | 问题类型 | 数量 | 可自动修复 |
+|--------|---------|------|----------|
+| P0 | {type} | {count} | {yes/no} |
+| P1 | {type} | {count} | {yes/no} |
+
+### 修复执行（--fix 模式）
+| 问题ID | 类型 | 状态 | 耗时 |
+|--------|------|------|------|
+| {id} | {type} | ✅修复成功 / ❌需人工 | {time} |
+
+### 验证结果（--fix 模式）
+- 修复后测试通过率: {rate}%
+- 覆盖率变化: {before}% → {after}%
+- 质量分数: {score}
+- 是否存在退化: {yes/no}
+
+### 建议后续处理
+{下一步建议}
+```
+
+---
+
+## 使用示例
+
+```bash
+# 仅验证（原 validate 行为）
+/autospec:test
+/autospec:test ./my-project
+/autospec:test https://github.com/user/repo --branch main
+
+# 验证 + 自动修复
+/autospec:test --fix
+
+# 指定测试范围
+/autospec:test --scope=integration
+/autospec:test --scope=all --fix
+
+# 多系统项目 - 指定子系统
+/autospec:test --subsystem=backend --fix
+
+# AI项目 - 效果评测
+/autospec:test --scope=evaluation
+/autospec:test --scope=evaluation --fix
+
+# 深度分析
+/autospec:test --deep --fix
+
+# 指定输出路径
+/autospec:test --output ./test-report.md
+
+# 指定重试次数
+/autospec:test --fix --max-retries=5
+```
+
+---
+
+## 产出物
+
+```
+.autospec/
+├── logs/
+│   └── test/
+│       ├── report-{timestamp}.md       # 测试报告
+│       ├── analysis-{timestamp}.json   # 问题分析详情（--fix 模式）
+│       ├── fixes-{timestamp}.json      # 修复记录（--fix 模式）
+│       └── verification-{timestamp}.md # 验证报告（--fix 模式）
+└── validation/                         # 原 validate 目录（兼容）
+    └── validation-{timestamp}.md
+```
+
+---
+
+## 相关命令
+
+- `/autospec:review` — Layer 2 独立审查
+- `/autospec:status` — 查看流程状态
+- `/autospec:field-evolve` — 领域进化

package/plugins/hooks/constitution-guard.js

@@ -94,7 +94,7 @@ async function main() {
           `[AutoSpec Constitution Guard] ⚠️ CONSTITUTION ALERT (DP6)\n` +
           `Development activity detected but no state.json found.\n` +
           `Startup gate protocol may not have been followed:\n` +
-          `  1. Read framework/pipeline/overview.md → 确定迭代模式\n` +
+          `  1. Read knowledge/02-process/00-overview.md → 确定迭代模式\n` +
           `  2. Read framework/constitution.md → 确认红线\n` +
           `  3. 向用户确认任务范围\n` +
           `Consider using /autospec:run to properly start the workflow.`