diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 55e7870f..953ca6ba 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -3,13 +3,6 @@ name: CI on: pull_request: branches: [ main, develop ] - paths-ignore: - - '**/*.md' - - '**/*.txt' - - 'specs/**' - - 'docs/**' - - 'scripts/**' - - 'LICENSE' workflow_dispatch: concurrency: diff --git a/docs/sdk.md b/docs/sdk.md index 3307d84f..fc568de4 100644 --- a/docs/sdk.md +++ b/docs/sdk.md @@ -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} diff --git a/docs/vsce.md b/docs/vsce.md index 23545bed..e3292777 100644 --- a/docs/vsce.md +++ b/docs/vsce.md @@ -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 实现了自定义的工具提示组件。当用户将鼠标悬停在图标或特定元素上时,会显示功能说明文案。