@chongyan/autospec 1.0.1 → 1.0.3

package/plugins/commands/README.en.md

@@ -1,96 +0,0 @@
-# Command Templates
-
-This directory contains slash command templates for AutoSpec. Each template is a Markdown file that defines a command's behavior.
-
-## Template Structure
-
-Each command template follows this structure:
-
-```markdown
----
-description: Command description shown in CLI
----
-
-# Command Title
-
-## User Input
-
-\`\`\`
-$ARGUMENTS
-\`\`\`
-
-## Execution Steps
-
-Step-by-step instructions for Claude to execute.
-```
-
-## Variable Replacement
-
-Templates use `{{variable}}` syntax for variables that are replaced at generation time:
-
-| Variable | Replacement | Example |
-|----------|-------------|---------|
-| `{{knowledge}}` | `.autospec/knowledge` | Framework directory path |
-
-## Available Commands
-
-### Main Entry Commands
-
-| Command | Template | Description |
-|---------|----------|-------------|
-| `/autospec:run` | `run.md` | Start/resume AutoSpec autonomous development workflow |
-| `/autospec:explore` | `explore.md` | Requirement exploration stage |
-| `/autospec:propose` | `propose.md` | Solution design stage |
-| `/autospec:apply` | `apply.md` | Implementation stage (coding + review + QA) |
-| `/autospec:archive` | `archive.md` | Delivery and archive stage |
-
-### Evolution Commands
-
-| Command | Template | Description |
-|---------|----------|-------------|
-| `/evolve` | `evolve.md` | Trigger self-evolution cycle |
-
-### Status Commands
-
-| Command | Template | Description |
-|---------|----------|-------------|
-| `/autospec:status` | `status.md` | View current AutoSpec process status |
-| `/autospec:validate` | `validate.md` | Run Layer1 deterministic validation |
-| `/autospec:review` | `review.md` | Review deliverables at each stage |
-
-### Environment Commands
-
-| Command | Template | Description |
-|---------|----------|-------------|
-| `/autospec:env` | `env.md` | View current environment configuration |
-| `/autospec:env-validate` | `env-validate.md` | Validate environment knowledge configuration |
-| `/autospec:env-sync` | `env-sync.md` | Initialize environment directory, sync knowledge from code, import org knowledge base |
-| `/autospec:env-export` | `env-export.md` | Export current project's knowledge base |
-| `/autospec:env-template` | `env-template.md` | View and manage environment knowledge templates |
-| `/autospec:env-update` | `env-update.md` | Submit local knowledge changes to knowledge source |
-
-## Adding New Commands
-
-1. Create a new `.md` file in this directory
-2. Add the `description` frontmatter
-3. Define the command behavior using the template structure
-4. Register the command in `src/core/config/commands.config.js`:
-
-```javascript
-export const COMMAND_DEFINITIONS = {
-  'my-command': {
-    name: 'my-command',
-    templateFile: 'my-command.md',
-    description: 'My new command'
-  }
-};
-```
-
-## Internal Commands
-
-Some commands are marked as `internal: true` in the configuration. These are only for AutoSpec's own use and are not generated for user projects.
-
-## Related Files
-
-- `src/core/config/commands.config.js` - Command definitions and configuration
-- `src/core/generators/commands.js` - Template processing and command generation

package/plugins/commands/README.md

@@ -1,96 +0,0 @@
-# 命令模板目录
-
-本目录包含 AutoSpec 的斜杠命令模板。每个模板是一个 Markdown 文件，定义了命令的行为。
-
-## 模板结构
-
-每个命令模板遵循以下结构：
-
-```markdown
----
-description: 命令描述（显示在 CLI 中）
----
-
-# 命令标题
-
-## 用户输入
-
-\`\`\`
-$ARGUMENTS
-\`\`\`
-
-## 执行步骤
-
-Claude 执行的逐步指令。
-```
-
-## 变量替换
-
-模板使用 `{{variable}}` 语法进行生成时变量替换：
-
-| 变量 | 替换值 | 说明 |
-|------|--------|------|
-| `{{knowledge}}` | `.autospec/knowledge` | 框架目录路径 |
-
-## 可用命令
-
-### 主入口命令
-
-| 命令 | 模板 | 说明 |
-|------|------|------|
-| `/autospec:run` | `run.md` | 启动/恢复 AutoSpec 自主研发工作流 |
-| `/autospec:explore` | `explore.md` | 需求探索阶段 |
-| `/autospec:propose` | `propose.md` | 方案设计阶段 |
-| `/autospec:apply` | `apply.md` | 实施阶段（编码 + 审查 + QA） |
-| `/autospec:archive` | `archive.md` | 交付归档阶段 |
-
-### 进化命令
-
-| 命令 | 模板 | 说明 |
-|------|------|------|
-| `/evolve` | `evolve.md` | 触发自进化循环 |
-
-### 状态命令
-
-| 命令 | 模板 | 说明 |
-|------|------|------|
-| `/autospec:status` | `status.md` | 查看当前 AutoSpec 流程状态 |
-| `/autospec:validate` | `validate.md` | 运行 Layer1 确定性验证 |
-| `/autospec:review` | `review.md` | 审查各阶段交付物 |
-
-### 环境命令
-
-| 命令 | 模板 | 说明 |
-|------|------|------|
-| `/autospec:env` | `env.md` | 查看当前环境配置 |
-| `/autospec:env-validate` | `env-validate.md` | 校验环境知识配置 |
-| `/autospec:env-sync` | `env-sync.md` | 初始化环境目录、同步环境知识、导入组织知识库 |
-| `/autospec:env-export` | `env-export.md` | 导出当前项目的知识库 |
-| `/autospec:env-template` | `env-template.md` | 查看和管理环境知识模板 |
-| `/autospec:env-update` | `env-update.md` | 将本地知识变更提交到知识源 |
-
-## 添加新命令
-
-1. 在本目录创建新的 `.md` 文件
-2. 添加 `description` frontmatter
-3. 使用模板结构定义命令行为
-4. 在 `src/core/config/commands.config.js` 中注册命令：
-
-```javascript
-export const COMMAND_DEFINITIONS = {
-  'my-command': {
-    name: 'my-command',
-    templateFile: 'my-command.md',
-    description: '我的新命令'
-  }
-};
-```
-
-## 内部命令
-
-部分命令在配置中标记为 `internal: true`。这些命令仅供 AutoSpec 自身使用，不会为用户项目生成。
-
-## 相关文件
-
-- `src/core/config/commands.config.js` - 命令定义和配置
-- `src/core/generators/commands.js` - 模板处理和命令生成

package/plugins/commands/apply.md

@@ -1,191 +0,0 @@
----
-description: "开工，按单子做" — 实施阶段。包含编码实现 + 代码审查 + QA测试。
----
-
-# AutoSpec Apply — 编码实施
-
-## 用户输入
-
-```
-$ARGUMENTS
-```
-
----
-
-## 前置处理
-
-【前置】读取流程协议：
-> **【重要】执行本command前必须先读取流程协议**
-> 1. 读取 `knowledge/guides/support/pipeline-protocol.md` 中的「流程能力」章节
-> 2. 执行以下步骤：
->    - 解析命令与参数
->    - 加载必要文件
->    - 检查前置条件（确认方案设计已完成）
-> 3. 完成后继续执行本命令的具体逻辑
->
-> **【注意】日志追踪已启用**
-> - 执行日志会自动记录到 `.autospec/logs/execution-{date}.json`
-> - 关键步骤（skill加载、agent调用、产物生成、阶段完成）都会被追踪
-
----
-
-## 执行指令
-
-### Step 1: 编码实现
-
-- 检查上游依赖（确认方案设计已完成）
-- **【强制】读取并按照 code-implementer 执行**
-  - 使用 Read 工具读取 `knowledge/guides/stages/code-implementer.md`
-  - 搜索现有代码库识别可复用组件
-  - 按方案模块划分编码
-- **【强制】执行 Layer1 验证**
-  - 编译检查
-  - 单元测试
-  - Lint 检查
-  - 类型检查（如适用）
-- **【强制】Layer1通过才能进入下一步**
-
-### Step 2: 代码审查
-
-**【强制】必须调用 Layer2 审查**
-- 使用 Agent 工具，subagent_type=independent-reviewer
-- 传入审查标准：`knowledge/guides/stages/code-reviewer.md`
-- 传入被审查代码：变更文件列表
-- 等待审查完成后再继续
-
-**审查结果处理**：
-- 审查通过 → 进入 Step 2.5（安全审查）
-- 审查不通过 → 执行修复循环（最多3次）：
-  1. 提取 reviewer 的"必须修复（blocking）"清单
-  2. 读取 code-implementer.md 并执行修复
-  3. 重新执行 Layer1 验证
-  4. 重新调用 Layer2 审查
-  5. 达到3次上限仍不通过 → 记录问题，标记需要人工介入
-
-### Step 2.5: 安全审查【强制执行】
-
-**【强制】当代码包含Skill/Agent相关实现时必须执行**：
-- 使用 Agent 工具，subagent_type=independent-reviewer
-- 传入审查标准：`knowledge/guides/stages/security-reviewer.md`
-- 传入被审查代码：变更文件列表
-- 等待审查完成后再继续
-
-**审查结果处理**：
-- 审查通过 → 进入 Step 3
-- 审查不通过 → 执行修复循环（最多3次）
-
-### Step 3: 测试生成【强制执行】
-
-**【强制】必须按顺序执行：**
-
-1. **【强制】读取 test-context-analyzer.md**
-   - 使用 Read 工具读取 `knowledge/guides/stages/test-context-analyzer.md`
-   - 学习现有测试风格
-
-2. **【强制】读取并按照 test-generator 执行**
-   - 使用 Read 工具读取 `knowledge/guides/stages/test-generator.md`
-   - 生成测试用例和代码
-
-3. **【强制】调用 Layer2 测试审查**
-   - 使用 Agent 工具，subagent_type=test-coverage-reviewer
-   - 传入审查标准：`knowledge/guides/stages/test-reviewer.md`
-
-4. **【强制】审查结果处理**
-   - 审查通过 → 进入步骤4
-   - 审查不通过 → 执行修复循环（最多3次）：
-     1. 提取 reviewer 的"必须修复（blocking）"清单
-     2. 读取 test-generator.md 并执行修复
-     3. 重新执行 Layer1 验证
-     4. 重新调用 Layer2 审查
-     5. 达到3次上限仍不通过 → 记录问题，标记需要人工介入
-
-5. **【强制】执行 Layer1 验证**
-   - 运行测试，确认通过
-   - **【强制】覆盖率 < 70% → 补充测试**
-
-### Step 3.5: Agent 测试执行【强制执行】
-
-**【强制】使用 Agent 团队执行完整测试流程**：
-
-#### 3.5.1 并行执行单元测试
-- 使用 Agent 工具，subagent_type=general-purpose
-  ```
-  prompt: |
-    你是一个测试执行专家。请执行以下任务：
-
-    1. 读取 unit-test-runner skill 了解测试执行规范
-    2. 检测项目测试框架（pytest/Jest/JUnit等）
-    3. 执行单元测试并分析结果
-    4. 识别失败的测试并分析原因
-
-    项目目录：{project_path}
-  ```
-- 加载 unit-test-runner skill：`knowledge/guides/stages/unit-test-runner.md`
-- 并行执行多个测试文件（提升效率）
-- 等待所有单元测试完成
-
-#### 3.5.2 串行执行集成测试（单元测试通过后）
-- 使用 Agent 工具，subagent_type=general-purpose
-  ```
-  prompt: |
-    你是一个集成测试专家。请执行以下任务：
-
-    1. 读取 integration-test-runner skill 了解集成测试规范
-    2. 智能检测项目中的集成测试（不限于特定目录）
-    3. 分析测试文件，区分单元测试和集成测试
-    4. 执行集成测试并分析失败原因
-
-    项目目录：{project_path}
-  ```
-- 加载 integration-test-runner skill：`knowledge/guides/stages/integration-test-runner.md`
-- 智能检测项目中的集成测试（不限于特定目录）
-- 执行集成测试
-- 测试失败 → 修复循环（最多3次）
-
-#### 3.5.3 效果评测（如有AI/模型组件）
-- 使用 Agent 工具，subagent_type=general-purpose
-  ```
-  prompt: |
-    你是一个AI效果评测专家。请执行以下任务：
-
-    1. 读取 ai-effect-evaluator skill 了解评测规范
-    2. 加载评测数据集
-    3. 执行效果评测，计算指标
-    4. 生成评测报告，识别badcase
-
-    项目目录：{project_path}
-  ```
-- 加载 ai-effect-evaluator skill：`knowledge/guides/stages/ai-effect-evaluator.md`
-- 执行效果评测
-- 评测结果作为质量门禁
-
-**测试执行策略**：
-| 阶段 | 执行方式 | 理由 |
-|------|---------|------|
-| 单元测试 | 并行 | 独立无依赖，提升效率 |
-| 集成测试 | 串行 | 依赖单元测试通过，确保质量 |
-| 效果评测 | 串行 | 依赖完整环境，确保准确 |
-
-### Step 4: 效果评测【强制执行】（如有AI/模型组件）
-
-**【强制】必须执行：**
-- 读取 `knowledge/guides/support/ai-evaluation-planner.md`
-- 构建评测数据集
-- 开发评测脚本
-- 执行评测并生成报告
-
-### Step 5: 精准回退（如有失败）
-
-- Level 1: 内联重试
-- Level 2: 修正循环（最多3次）
-- Level 3: 升级人工
-
-### 更新 state.json
-
-**【强制】更新状态**
-- 记录阶段完成状态
-- 记录关键决策和验证结果
-
----
-
-**继续执行**: `/autospec:archive`

package/plugins/commands/archive.md

@@ -1,76 +0,0 @@
----
-description: "做完了，收工归档" — 交付归档阶段。包含交付部署 + 自进化归档。
----
-
-# AutoSpec Archive — 交付归档
-
-## 用户输入
-
-```
-$ARGUMENTS
-```
-
----
-
-## 前置处理
-
-【前置】读取流程协议：
-> **【重要】执行本command前必须先读取流程协议**
-> 1. 读取 `knowledge/guides/support/pipeline-protocol.md` 中的「流程能力」章节
-> 2. 执行以下步骤：
->    - 解析命令与参数
->    - 加载必要文件
->    - 检查前置条件（确认QA测试已完成）
-> 3. 完成后继续执行本命令的具体逻辑
->
-> **【注意】日志追踪已启用**
-> - 执行日志会自动记录到 `.autospec/logs/execution-{date}.json`
-> - 关键步骤（skill加载、agent调用、产物生成、阶段完成）都会被追踪
-
----
-
-## 执行指令
-
-### Step 1: 检查上游依赖
-
-- 确认QA测试已完成（检查 state.json）
-- 未完成 → 阻断并提示先执行 apply
-
-### Step 2: 交付部署
-
-**【强制】必须执行：**
-
-1. **【强制】执行跨产物一致性检查**
-   - 使用 Agent 工具，subagent_type=consistency-checker
-   - 检查需求→设计→代码→测试的一致性
-
-2. **【强制】执行安全审计**（如有不可逆动作）
-   - 使用 Agent 工具，subagent_type=safety-auditor
-   - 不可逆动作需人工确认后才能执行
-
-### Step 3: 自进化归档
-
-**【强制】必须执行：**
-
-1. **【强制】记录 practice-log**
-   - 读取 `.autospec/runtime/state.json`
-   - 收集执行度量（Layer1/2通过率、回退次数、人工介入次数）
-   - 写入 `.autospec/evolution/practice-log/{NNN}-{feature}.md`
-
-2. **【强制】触发 skill-distiller**
-   - 读取 `knowledge/guides/support/skill-distiller.md`
-   - 检查是否有可沉淀的新技能
-
-3. **【强制】触发 methodology-extractor**
-   - 读取 `knowledge/guides/support/methodology-extractor.md`
-   - 检查是否有可提取的新方法论
-
-### Step 4: 标记流程完成
-
-**【强制】更新状态**
-- 更新 `.autospec/runtime/state.json` 标记为完成
-- 记录完成时间戳
-
----
-
-**流程结束** 🎉

package/plugins/commands/env-export.md

@@ -1,79 +0,0 @@
----
-description: 导出当前项目的知识库
----
-
-# AutoSpec Env Export — 知识导出
-
-## 用户输入
-
-```
-$ARGUMENTS
-```
-
----
-
-## 执行指令
-
-### Step 1: 收集知识文件
-
-收集 `.autospec/environment/` 下的所有文件
-
-### Step 2: 生成清单
-
-创建 `manifest.json`：
-
-```json
-{
-  "name": "{知识库名称}",
-  "version": "{版本号}",
-  "description": "{描述}",
-  "generatedAt": "2024-01-15T10:30:00Z",
-  "includes": {
-    "middleware": [
-      { "name": "redis", "version": "1.0" },
-      { "name": "mysql", "version": "1.0" }
-    ],
-    "components": [
-      { "name": "axios", "version": "1.0" }
-    ],
-    "bestPractices": [],
-    "detectionPatterns": true
-  }
-}
-```
-
-### Step 3: 打包输出
-
-```bash
-# 创建目标目录
-mkdir -p {target-dir}
-
-# 复制文件
-cp -r .autospec/environment/* {target-dir}/
-
-# 写入清单
-cp manifest.json {target-dir}/
-```
-
-### Step 4: 输出结果
-
-```
-✅ 导出完成
-
-知识库: {name} (v{version})
-路径: {target-dir}
-
-包含:
-  中间件: redis, mysql
-  组件: axios
-  检测模式: ✅
-
-可以分享此目录或发布到 npm/Git 供其他项目使用。
-```
-
----
-
-## 产出物
-
-- 导出的知识库目录
-- `manifest.json` 清单文件