Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 0 additions & 7 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,6 @@ name: CI
on:
pull_request:
branches: [ main, develop ]
paths-ignore:
- '**/*.md'
- '**/*.txt'
- 'specs/**'
- 'docs/**'
- 'scripts/**'
- 'LICENSE'
workflow_dispatch:

concurrency:
Expand Down
64 changes: 64 additions & 0 deletions docs/sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -1074,6 +1074,70 @@ await agent.triggerWorktreeRemoveHook('/path/to/worktree');

**限制**:循环任务 7 天后自动过期;最多支持 50 个定时任务。

### simplify — 代码简化与清理 {#skill-simplify}

审查已变更代码,从代码复用、代码质量和执行效率三个维度进行深度分析,并直接应用优化修改。

- **名称**: `simplify`
- **使用方式**: `/simplify`
- **特性**: 专注代码质量提升与重构,**不用于寻找功能性 Bug**(寻找 Bug 请使用 `/code-review`)

#### 执行阶段

1. **识别变更** — 通过 `git diff`(或 `git diff HEAD`)获取当前修改。若无 git 变更,则审查最近编辑过的文件。
2. **并行子代理审查** — 并行启动 3 个专用子代理:
- **代码复用代理 (Code Reuse Review)**:搜索现有工具函数、公共模块或相邻逻辑,标记重复实现的新函数和可使用已有工具的内联逻辑。
- **代码质量代理 (Code Quality Review)**:检查冗余状态、参数膨胀、复制粘贴变体、抽象泄漏、硬编码字符串、无意义的 JSX 嵌套和无效注释(仅保留解释 "WHY" 的非直观注释)。
- **执行效率代理 (Efficiency Review)**:检查重复计算、多余文件 I/O、缺失并发、热路径膨胀、无保护的轮询更新、TOCTOU 反模式、内存/事件监听泄漏以及过度读取。
3. **自动修复** — 聚合 3 个子代理的建议并直接应用修改,最后向用户简要汇报修复成果(或确认代码已经很干净)。

### code-review — 代码审查 {#skill-code-review}

对当前分支的变更执行多维度的正确性 Bug 与代码质量审查,并自动将结果提交为 PR/MR 评论。

- **名称**: `code-review`
- **使用方式**: `/code-review [effort]`
- **选项**:
- `low`:启动 2 个代理,可信度阈值 90(仅输出几乎确定的发现,噪声最少)
- `medium`(默认):启动 3 个代理,可信度阈值 80
- `high`:启动 4 个代理,可信度阈值 70
- `max`:启动 5 个代理,可信度阈值 60(覆盖面最广,可能含有较低可信度的发现)

#### 执行阶段

1. **收集上下文** — 获取 `git status`、自 `main` 合并基点以来的修改文件列表、提交日志和完整 diff 内容。若无变更则停止。
2. **并行审查** — 依据 `effort` 级别并行分发任务给子代理:
- **Bug 扫描代理**(全级别):浅层扫描,专注于大型、明显的功能 Bug,避免细枝末节。
- **AGENTS.md 规范审计代理**(全级别):审计变更是否符合仓库根目录及修改文件所在目录的 `AGENTS.md` 规范。
- **Git 历史代理**(中级及以上):结合 `git blame` 与修改行的历史上下文,评估代码变更带来的隐患。
- **代码复用与质量代理**(高级及以上):审查重复工具代码、参数膨胀、抽象泄漏、多余注释等质量坏味道。
- **效率审查代理**(仅限 `max`):深入评估性能损耗、缺失的并发和内存泄漏等。
3. **可信度评分 (Confidence Scoring)** — 为发现的每个缺陷启动独立代理,对照 PR diff 和 `AGENTS.md` 给出 0-100 的置信度评分(0=几乎肯定是误报;100=绝对确定且会高频触发)。评分同时过滤历史遗留缺陷、类型系统/编译器能自动捕获的问题、非修改行的缺陷等干扰项。
4. **结果交付** — 过滤低于阈值的分数。优先通过 GitHub CLI (`gh pr comment`) 或 GitLab CLI (`glab mr note`) 将审查意见以 **PR/MR 评论** 形式发表;若 CLI 不可用或无对应 PR/MR,则直接在对话中输出。

### deep-research — 深度主题调研 {#skill-deep-research}

全自动深度主题研究工作流,通过并行网页搜索、源文件抓取、对抗式论点校验与去重,最终生成带有引用的高可信度报告。

- **名称**: `deep-research`
- **使用方式**: 直接向 Agent 提问复杂调研需求,或明确要求深度研究
- **特性**: 通过 Workflow 工具编排多阶段流水线。若用户问题不够具体,运行前会先询问 2-3 个澄清问题以锁定调研范围。

#### 执行阶段

1. **拆解 (Scope)** — 将研究问题分解为 5 个不同的搜索维度(如背景概述、技术细节、最新进展、反面观点、实际应用等)。
2. **并行检索 (Search)** — 并行启动 5 个搜索代理,分别针对每个维度检索网络,提取关键发现与源 URL。
3. **抓取分析 (Fetch)** — 汇总并去重所有 URL,取前 15 个顶级源并行抓取,使用 AI 提取可证伪的核心论点(falsifiable claims)并附带引用来源。
4. **对抗性校验 (Verify)** — 对每个核心论点进行 3 票制对抗性校验。3 个独立 skeptical 代理专门寻找反驳证据,超过 2 票反驳的论点被剔除,其余判定为 Confirmed(确认)或 Contested(有争议)。
5. **综合报告 (Synthesize)** — 合并语义重复的论点,按可信度排序,生成结构化深度报告:
- 执行摘要 (Executive summary)
- 按可信度排序且带引用的核心结论 (Key findings with citations)
- 争议结论与前置条件 (Contested findings with caveats)
- 不确定性区域 (Areas of uncertainty)
- 总结 (Conclusion)

运行后可通过 `/workflows` 跟踪工作流进度。

## 13. 内置 Subagents {#builtin-subagents}

### Bash — 命令执行 {#subagent-bash}
Expand Down
11 changes: 2 additions & 9 deletions docs/vsce.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,21 +6,14 @@ Wave 代码智聊是一款集成在 VS Code 中的 AI 辅助编程扩展,旨

## 1. 核心聊天体验 {#core-chat-experience}

### 1.1 欢迎界面 {#welcome-interface}

当用户首次打开 Wave 代码智聊时,会看到亲切的欢迎信息,引导用户开始对话。

![欢迎界面](/screenshots/spec-welcome.png)
_欢迎界面_

### 1.2 基础对话 {#basic-chat}
### 1.1 基础对话 {#basic-chat}

支持 Markdown 格式的文本交互,能够生成带有语法高亮的代码块,方便用户直接阅读和复制。

![基础对话](/screenshots/spec-basic-chat.png)
_基础对话_

### 1.3 工具提示 (Tooltips) {#tooltips}
### 1.2 工具提示 (Tooltips) {#tooltips}

为了提供一致且可靠的用户体验,Wave 实现了自定义的工具提示组件。当用户将鼠标悬停在图标或特定元素上时,会显示功能说明文案。

Expand Down