@chongyan/autospec 1.0.1

package/plugins/commands/README.en.md

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

@@ -0,0 +1,96 @@
+# 命令模板目录
+
+本目录包含 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

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

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

@@ -0,0 +1,79 @@
+---
+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` 清单文件