npm - @chongyan/autospec - Versions diffs - 1.0.2 → 1.0.4 - Mend

@chongyan/autospec 1.0.2 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (688) hide show

package/plugins/commands/status.md DELETED Viewed

@@ -1,183 +0,0 @@
----
-description: 查看当前 AutoSpec 流程的执行状态（支持多系统开发盯盘）
----
-# AutoSpec Status — 状态查看
-## 用户输入
-```
-$ARGUMENTS
-```
----
-## 执行指令
-### Step 1: 读取基础状态
-- 读取 `.autospec/runtime/state.json` - 流水线状态
-- 读取 `.autospec/runtime/metrics.json` - 质量指标
-- 读取 `.autospec/runtime/config.json` - 项目配置（含 subsystems）
-- 读取 `.autospec/environment/registry.json` - 环境知识注册表（如存在）
-### Step 2: 检查项目模式
-- **单系统模式**：`config.json` 无 `subsystems` 或长度为 0/1
-- **多系统模式**：`config.json` 中 `subsystems` 长度>1
-### 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}
-### 阶段进度
-| 阶段 | 状态 | Layer1 | Layer2 |
-|-----|------|--------|--------|
-| 01-需求分析 | ✅ 完成 | ✅ | ✅ |
-| 02-方案设计 | 🔄 进行中 | ⏳ | - |
-| ... | ... | ... | ... |
-### 质量指标
-- 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` | 手动触发覆盖检查 |
----
-## 相关命令
-- `/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 DELETED Viewed

@@ -1,389 +0,0 @@
----
-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/README.en.md DELETED Viewed

@@ -1,56 +0,0 @@
-# Hooks Scripts Directory
-This directory contains all Claude Code hooks scripts, which are copied to `.autospec/plugins/hooks/` during the init process.
-## Directory Structure
-```
-hooks/
-├── trace-initialization.js        # Trace ID initialization
-├── frozen-zone-guard.js           # Frozen zone protection
-├── scope-sentinel.js              # Scope drift prevention
-├── constitution-guard.js          # Constitution gate
-├── layer1-validator.js            # Layer 1 validation
-├── environment-manager.js         # Environment management
-├── ai-project-guard.js            # AI project security
-├── execution-tracker.js           # Execution tracking
-├── artifact-evaluation-hook.js    # Artifact evaluation
-├── pipeline-observer.js           # Pipeline observation
-├── lib/                           # Utility library
-│   ├── source-code-scanner.js
-│   ├── detection-pattern-loader.js
-│   ├── validation-patterns.js
-│   ├── hook-logger.js
-│   ├── hook-state-manager.js
-│   ├── trace-context.js
-│   ├── rollback-tracker.js
-│   ├── artifact-evaluator.js
-│   ├── execution-path.js
-│   └── metrics-analyzer.js
-└── README.md                      # This file
-```
-## Hook Trigger Timing
-| Hook | PreToolUse | PostToolUse | Stop |
-|------|------------|-------------|------|
-| trace-initialization | ✅ | | |
-| frozen-zone-guard | ✅ | | |
-| scope-sentinel | ✅ | | |
-| constitution-guard | ✅ | | |
-| layer1-validator | ✅ | ✅ | |
-| environment-manager | ✅ | | ✅ |
-| ai-project-guard | ✅ | ✅ | |
-| execution-tracker | | ✅ | |
-| artifact-evaluation-hook | | ✅ | |
-| pipeline-observer | | ✅ | ✅ |
-## Self-Contained Requirements
-Scripts in this directory must be self-contained, meeting the following requirements:
-1. **Only depend on Node.js built-in modules** (fs, path, etc.)
-2. **Only depend on `./lib/` local utility library**
-3. **Do not depend on any scaffolding code**
-This ensures they can run independently after being copied to `.autospec/plugins/hooks/`.

package/plugins/hooks/README.md DELETED Viewed

@@ -1,56 +0,0 @@
-# Hooks 脚本目录
-本目录包含所有 Claude Code hooks 脚本，随 init 过程复制到 `.autospec/plugins/hooks/` 目录。
-## 目录结构
-```
-hooks/
-├── trace-initialization.js        # Trace ID 初始化
-├── frozen-zone-guard.js           # 冻结区保护
-├── scope-sentinel.js              # 范围防漂移
-├── constitution-guard.js          # 宪法门禁
-├── layer1-validator.js            # Layer 1 检查
-├── environment-manager.js         # 环境管理
-├── ai-project-guard.js            # AI 项目安全
-├── execution-tracker.js           # 执行追踪
-├── artifact-evaluation-hook.js    # 产出物评测
-├── pipeline-observer.js           # 流程观察
-├── lib/                           # 工具库
-│   ├── source-code-scanner.js
-│   ├── detection-pattern-loader.js
-│   ├── validation-patterns.js
-│   ├── hook-logger.js
-│   ├── hook-state-manager.js
-│   ├── trace-context.js
-│   ├── rollback-tracker.js
-│   ├── artifact-evaluator.js
-│   ├── execution-path.js
-│   └── metrics-analyzer.js
-└── README.md                      # 本文件
-```
-## Hook 触发时机
-| Hook | PreToolUse | PostToolUse | Stop |
-|------|------------|-------------|------|
-| trace-initialization | ✅ | | |
-| frozen-zone-guard | ✅ | | |
-| scope-sentinel | ✅ | | |
-| constitution-guard | ✅ | | |
-| layer1-validator | ✅ | ✅ | |
-| environment-manager | ✅ | | ✅ |
-| ai-project-guard | ✅ | ✅ | |
-| execution-tracker | | ✅ | |
-| artifact-evaluation-hook | | ✅ | |
-| pipeline-observer | | ✅ | ✅ |
-## 自闭环要求
-本目录中的脚本必须自闭环，满足以下要求：
-1. **只依赖 Node.js 内置模块**（fs, path 等）
-2. **只依赖 `./lib/` 本地工具库**
-3. **不依赖任何脚手架代码**
-这样确保复制到 `.autospec/plugins/hooks/` 后可以独立运行。