---
name: ecc-commands
description: 32 个 Slash 命令库，涵盖开发、研究、学习、多智能体、系统五大类。每个命令都有明确的触发条件、工作流步骤和成功标准。源自 everything-claude-code 的命令系统，针对 OpenCode 环境适配。
triggers:
  - slash命令
  - 命令库
  - /plan
  - /tdd
  - /learn
  - 工作流命令
features:
  - 开发命令
  - 研究命令
  - 学习命令
  - 多智能体命令
  - 系统命令
dangerLevel: low
---

# ECC Commands — OpenCode 命令库

> 32 个命令，覆盖软件开发全生命周期。每个命令都有明确的输入格式、工作流和输出标准。

## 使用方式

在 OpenCode 对话中直接输入 `/命令名` 触发，或在 Task 描述中引用。

---

## 一、开发命令（Development）

### /plan {需求描述}

**触发**：用户提出复杂需求（涉及 2+ 文件或多个功能点）

**工作流**：
1. 理解需求：澄清目标、约束、验收标准
2. 分解任务：按依赖关系排序，识别关键路径
3. 评估风险：技术难点、潜在坑点、需要用户决策的点
4. 生成计划：Markdown 格式，分阶段列出

**输出格式**：
```markdown
## 实施计划：{需求名}

### 阶段一：{名称}（预计 X 分钟）
- [ ] 子任务1
- [ ] 子任务2

### 风险点
⚠️ {风险描述} → 应对方案

### 需要确认
❓ {用户需要回答的问题}
```

**成功标准**：用户确认计划后再开始实施。

---

### /tdd {功能描述}

**触发**：开始一个新功能或修复一个 Bug

**工作流**：
1. **RED**：先写一个失败的测试，描述期望行为
2. **GREEN**：写最少量代码让测试通过
3. **IMPROVE**：重构代码，提高可读性和质量
4. **VERIFY**：运行完整测试套件，确保 80%+ 覆盖率

**输出**：测试文件 + 实现文件 + 覆盖率报告

**注意事项**：
- 测试文件先于实现文件
- 每个测试只测一个行为
- 遇到 build 错误用 `/fix-build`

---

### /fix-build {错误信息?}

**触发**：npm/pnpm build 失败，或用户报告编译错误

**工作流**：
1. 分析错误链（不只是表面错误，往上追溯根因）
2. 优先修复导致错误的根本原因
3. 每修复一个错误后重新 build，验证
4. 确认所有错误修复，给出总结

**关键原则**：
- 不一次性修复所有错误（容易引入新问题）
- 一次只修一个，验证后再下一个
- 编译错误修完后，立刻跑测试

---

### /code-review {范围?}

**触发**：代码写完后、提交前、需要审查时

**工作流**：
1. 确定审查范围（文件、目录、变更集）
2. 逐文件检查：可读性、安全性、可维护性、一致性
3. 识别问题：CRITICAL / HIGH / MEDIUM / LOW
4. 生成报告，提供修复建议

**输出格式**：
```markdown
## Code Review：{范围}

### 🔴 CRITICAL（立即修复）
- {文件}:{行号} — {问题}

### 🟠 HIGH（下次修复）
- {文件}:{行号} — {问题}

### 🟡 MEDIUM（可选优化）
- {建议}
```

**注意**：不在 Review 过程中直接修改代码（除非用户明确要求）。

---

### /refactor-clean {范围}

**触发**：代码库需要维护、用户要求清理、死代码过多

**工作流**：
1. 扫描：未使用的 import、重复代码、过长函数、magic numbers
2. 分类：安全可清理（不影响行为）vs 需要人工确认
3. 安全清理：自动删除无引用代码、统一命名
4. 确认清理：人工确认后再处理风险项

**安全边界**：
- ✅ 可自动处理：未使用的 import、重复代码片段、死函数
- ❌ 需人工确认：重命名（可能影响外部引用）、拆分函数（可能影响行为）
- ❌ 禁止：修改业务逻辑、删除有引用但未检测到的代码

---

### /test-coverage {范围}

**触发**：需要评估测试覆盖质量时

**工作流**：
1. 运行覆盖率工具（istanbul / vitest / pytest-cov）
2. 分析覆盖率报告：行覆盖 / 分支覆盖 / 函数覆盖
3. 识别低覆盖区域：找到高价值但未被测的代码
4. 生成建议：优先补充哪些测试

**成功标准**：
- 行覆盖率 ≥ 80%（生产代码）
- 核心业务逻辑覆盖率 ≥ 95%
- 每个公共 API 有至少一个测试

---

### /e2e {用户流程描述}

**触发**：需要端到端验证关键用户流程时

**工作流**：
1. 理解流程：从入口到终点的完整路径
2. 编写 Playwright 测试：模拟用户真实操作
3. 运行测试：捕获截图、视频（失败时）
4. 分析失败：是真 Bug 还是测试不稳定（flaky）

**适用范围**：
- 用户注册/登录流程
- 核心业务操作
- 跨多页面交互
- API 集成验证

---

### /update-docs {范围}

**触发**：代码变更后需要同步更新文档时

**工作流**：
1. 识别变更范围对应的文档
2. 分析变更对文档的影响（新增 / 修改 / 删除）
3. 更新文档：保持风格一致
4. 检查文档中的代码示例是否仍然有效

**优先级**：
1. README.md 的快速开始部分
2. API 文档的签名变更
3. 变更日志（CHANGELOG）
4. 示例代码

---

## 二、研究命令（Research）

### /search-first {问题}

**触发**：用户提问但你不确定答案，或需要结合外部信息时

**工作流**：
1. **不猜测**：明确告诉用户你会先去查
2. **搜索**：多引擎并行（ddg / 百度 / 专业文档）
3. **综合**：整理多个来源，给出置信度评估
4. **承认局限**：不确定的地方明确标注

**成功标准**：答案有引用来源，不确定的地方承认不确定性。

---

### /deep-research {主题}

**触发**：需要系统性研究一个主题（比 search-first 更深入）

**工作流**：
1. 制定研究框架：背景 → 现状 → 方案 → 风险 → 结论
2. 多维度搜索：官方文档 / 学术论文 / 社区讨论 / 实际案例
3. 交叉验证：多个来源对比，识别共识和分歧
4. 输出报告：带结构、有引用、可执行

---

### /market-research {主题}

**触发**：用户需要了解市场、竞品、用户研究

**工作流**：
1. 确定研究范围：市场规模、竞品分析、用户画像、政策环境
2. 多源搜索：官方数据、第三方报告、社交媒体评论
3. 整理发现：优势、劣势、机会、威胁（SWOT）
4. 输出洞察：可操作的建议而非单纯数据

---

## 三、学习命令（Learning）

### /learn {模式描述}

**触发**：完成一个任务后，发现了有效的模式，想记录下来

**工作流**：
1. 提取模式：从当前会话中归纳出通用方法
2. 写成 Instinct：触发条件 + 模式内容 + 证据
3. 保存到 `~/.opencode/instincts/`
4. 更新置信度（基于本次成功使用）

**使用时机**：
- 找到一个反复有效的沟通方式
- 发现一个工具的某个技巧
- 纠正了之前的错误认知

---

### /learn-eval {模式描述}

**触发**：`/learn` 的增强版，在保存前先评估模式质量

**工作流**：
1. 提取模式候选
2. 搜索现有 Instinct，检查是否重复
3. 评估：是否足够通用、是否有证据支撑
4. 保存（通过评估）或标记为"待验证"（证据不足）

---

### /instinct-status

**触发**：想查看当前 Instinct 库的状态

**输出**：
```markdown
## Instinct Library

| Category | Count | Avg Confidence | High Priority |
|----------|-------|---------------|-------------- |
| workflow | 12 | 3.2 | 5 |
| security | 8 | 4.1 | 3 |

### Ready to Evolve（置信度 ≥ 4）
- [ ] workflow/先规划后编码 (4.5)
- [ ] security/凭证管理规范 (5.0)
```

---

### /evolve {category?}

**触发**：某个领域的 Instinct 积累足够多（≥5 个高置信度）

**工作流**：
1. 聚类分析：找出同一领域的高置信度 Instinct
2. 去重合并：合并相似模式，保留最优表述
3. 生成 SKILL.md 草稿：结构化为完整技能文档
4. 人工审核：确认无误后保存到 skills 目录

---

### /checkpoint

**触发**：完成一个重要里程碑，需要保存验证状态时

**工作流**：
1. 记录当前状态：已完成、未完成、进行中
2. 验证清单：功能验证 + 测试通过 + 文档更新
3. 保存 checkpoint：时间戳 + 状态摘要
4. 输出恢复指令：如果后续需要从这里恢复

---

### /verify {checkpoint?}

**触发**：验证当前状态是否与 checkpoint 一致，或在继续前检查环境

**工作流**：
1. 读取 checkpoint 状态
2. 运行验证检查：依赖版本、配置正确性、关键文件存在
3. 报告差异：缺少的、错误的、过时的
4. 建议修复步骤

---

## 四、多智能体命令（Multi-Agent）

### /orchestrate {任务描述}

**触发**：任务可分解为多个独立子任务，需要协调执行时

**工作流**：
1. 分解任务：识别可并行的子任务
2. 分配 Agent：为每个子任务选择合适的 Agent 类型
3. 并行执行：同时运行不相互依赖的子任务
4. 汇总结果：合并各 Agent 输出，处理依赖顺序
5. 最终整合：输出统一结果

---

### /multi-plan {需求}

**触发**：复杂系统设计需要多角度分析时

**工作流**：
1. 分解为多个分析维度（架构 / 安全 / 性能 / UX）
2. 并行启动专业分析
3. 汇总各维度发现
4. 生成综合方案

---

### /multi-execute {计划}

**触发**：多任务并行执行计划已制定，需要执行时

**工作流**：
1. 解析执行计划
2. 并行启动任务（最多 3 个并发）
3. 监控进度，处理失败
4. 收集结果，报告完成状态

---

## 五、系统命令（System）

### /sessions

**触发**：想查看、恢复或清理历史会话时

**工作流**：
1. 列出最近会话：按时间、主题、结果排序
2. 选择会话：查看摘要或恢复上下文
3. 可选：清理低价值会话

---

### /eval {任务} {标准}

**触发**：需要根据明确标准评估输出质量时

**工作流**：
1. 明确评估标准（用户定义或标准库）
2. 逐项检查：符合 / 部分符合 / 不符合
3. 打分：pass / partial / fail
4. 提供改进建议

---

### /cost

**触发**：用户关心 token 消耗时

**工作流**：
1. 读取当前会话的 token 统计
2. 分析消耗分布：对话 / 工具调用 / 编译
3. 提供优化建议：哪些操作消耗最多

---

### /compact-strategy

**触发**：上下文快满时，需要选择最优压缩策略

**工作流**：
1. 分析上下文结构：哪些内容冗余
2. 评估压缩影响：压缩后对后续工作的影响
3. 给出建议：精确压缩（指定保留内容）vs 模糊压缩（百分比）
4. 用户确认后执行

---

### /setup-pm {package-manager}

**触发**：项目需要配置包管理器时

**工作流**：
1. 检测环境：已有 lock 文件 / 无 lock / 混合
2. 询问偏好：npm / pnpm / yarn / bun
3. 配置项目设置
4. 验证：运行一次 install

---

### /security-scan {范围?}

**触发**：需要安全审计时（对应 `openclaw-security-audit` 技能）

**工作流**：
1. 扫描凭证：检查 API key、token、密码硬编码
2. 检查权限：文件权限、目录访问控制
3. 分析依赖：已知漏洞的包
4. 生成报告：CRITICAL / HIGH / MEDIUM / LOW

---

## 命令索引

| 命令 | 类别 | 触发关键词 |
|------|------|---------|
| /plan | 开发 | 复杂需求、不知道怎么做 |
| /tdd | 开发 | 新功能、bug、测试驱动 |
| /fix-build | 开发 | build 失败、编译错误 |
| /code-review | 开发 | 代码审查、PR、提交前 |
| /refactor-clean | 开发 | 清理、死代码、重构 |
| /test-coverage | 开发 | 覆盖率、测试质量 |
| /e2e | 开发 | 端到端、用户流程 |
| /update-docs | 开发 | 文档同步、代码变更后 |
| /search-first | 研究 | 不确定答案、需要查资料 |
| /deep-research | 研究 | 系统研究、深度分析 |
| /market-research | 研究 | 市场、竞品、用户 |
| /learn | 学习 | 记录模式、提取经验 |
| /learn-eval | 学习 | 评估后再保存 |
| /instinct-status | 学习 | 查看模式库状态 |
| /evolve | 学习 | 进化为完整 Skill |
| /checkpoint | 学习 | 保存里程碑状态 |
| /verify | 学习 | 验证当前状态 |
| /orchestrate | 多智能体 | 多任务协调 |
| /multi-plan | 多智能体 | 多角度并行分析 |
| /multi-execute | 多智能体 | 多任务并行执行 |
| /sessions | 系统 | 会话管理 |
| /eval | 系统 | 质量评估 |
| /cost | 系统 | token 消耗 |
| /compact-strategy | 系统 | 上下文压缩策略 |
| /setup-pm | 系统 | 包管理器配置 |
| /security-scan | 系统 | 安全审计 |