agentsight-code-review
对当前分支的变更执行 AgentSight 专属代码审查。覆盖 6 个维度:硬性规则合规、eBPF 安全、FFI 边界、Footprint Ladder、流水线测试覆盖、文档同步。输出编号的 findings 列表,每条包含文件路径和行号。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 665
- Forks
- 195
01 前言 Front Matter
- name
- agentsight-code-review
- description
- 对当前分支的变更执行 AgentSight 专属代码审查。覆盖 6 个维度:硬性规则合规、eBPF 安全、FFI 边界、Footprint Ladder、流水线测试覆盖、文档同步。输出编号的 findings 列表,每条包含文件路径和行号。
03 SKILL.md 正文
AgentSight Code Review
目标
对当前分支相对于 main 的全部变更执行代码审查,输出所有 findings。
触发时自动执行
步骤 1:收集变更
git diff origin/main..HEAD
git diff --stat origin/main..HEAD
git log --oneline origin/main..HEAD
步骤 2:按维度审查
对 diff 中每个变更文件,依次检查以下 5 个维度。不要在发现第一个问题后停止,必须遍历全部文件和全部维度。
维度 1:硬性规则合规
对照 AGENTS.md ## 0. 硬性规则:
- 非测试代码中是否使用了
unwrap()/expect()/dbg!() - 是否添加了
#[allow(clippy::...)]但没有注释说明 - 单个模块是否超过 500 行(不含测试),超过 2000 行的文件是否有拆分计划
- PR diff 是否超过 800 行,复杂逻辑变更是否超过 500 行
维度 2:eBPF 安全
仅当 diff 涉及 src/bpf/ 或 src/probes/ 时检查:
- BPF 程序是否兼容 kernel >= 5.8(不使用高版本才有的 helper)
- ring buffer 大小是否合理(参考现有探针配置)
- uprobe attach 的符号名是否正确,是否处理了符号不存在的情况
- BPF map 的 key/value 类型是否与 Rust 侧定义一致
维度 3:FFI 边界
仅当 diff 涉及 src/ffi.rs 或 cbindgen.toml 时检查:
- 新增/修改的
extern "C"函数是否在cbindgen.toml的after_includes中同步声明 - FFI 类型是否标注了
#[repr(C)] - 是否有 panic 可能穿越 FFI 边界(缺少
catch_unwind) - 指针参数是否做了 null check
维度 4:Footprint Ladder
对照 AGENTS.md ## 3. 代码表面增长控制:
- 新增文件 → 是否可以通过扩展现有模块实现(级别 1-2)
- 新增 eBPF 探针 → 是否附带架构影响说明(级别 4)
- 新增 FFI 导出 → 是否附带架构影响说明(级别 5)
维度 5:流水线测试覆盖
仅当 diff 涉及 src/parser/、src/aggregator/、src/analyzer/、src/genai/、src/storage/ 时检查:
- 流水线逻辑变更是否包含集成测试
- 跨模块行为是否优先用集成测试而非单元测试
- 测试代码是否放在
*_tests.rs或#[cfg(test)] mod tests中
维度 6:文档同步
检查代码变更是否需要同步更新以下文档(根据变更内容自行判断):
AGENTS.md— 导航总览(Module Map、CLI、API、eBPF Probes、Configuration 等)CLAUDE.md— 构建命令、CLI 用法、配置说明src/FFI_AGENTS.md— FFI 层边界规则src/UNIFIED_AGENTS.md— 主编排器边界规则src/storage/AGENTS.md— 存储层边界规则docs/PITFALLS.md— 常见踩坑记录docs/adr/— 架构决策记录(涉及架构选型变更时需新增 ADR)docs/ARCHITECTURE.md— 架构设计文档docs/DEVELOPMENT.md— 开发指南docs/design-docs/— 模块设计文档
步骤 3:输出 Findings
使用编号列表输出,每条 finding 必须包含:
N. [维度名] 文件路径:行号 — 问题描述
建议:具体修复方式
示例:
1. [硬性规则] src/storage/sqlite/token.rs:142 — 非测试代码使用了 unwrap()
建议:改为 .map_err(|e| anyhow::anyhow!("..."))? 或 .unwrap_or_default()
2. [eBPF] src/bpf/gotls.bpf.c:87 — bpf_loop() 需要 kernel >= 5.17,不兼容 5.8
建议:改用 bounded for 循环
3. [Footprint Ladder] src/newmodule/mod.rs — 新增模块文件(级别 3),未说明为何不能扩展现有模块
建议:在 PR 描述中补充为什么级别 1-2 不够
无问题时
如果所有维度检查通过且自动检查全绿,输出:
✓ 全部 6 个维度检查通过,未发现问题。
04 同仓库更多 Skills
ws-ckpt
Linux 工作区快照(ws-ckpt)。用户想保存或备份工作区当前状态("保存一下"、"留个底"、"先备份"), 想撤销或恢复文件改动("回滚"、"撤销"、"改回去"、"恢复到之前"、"刚才那版"), 想查看、对比或删除历史版本,或要开启/关闭每回合自动快照、定时快照、快照保留策略时使用。 用户没提"快照"、只表达保存或恢复工作区文件的意图时同样适用;用户点名 git 操作(commit、branch、reset 到某提交)时不适用。
skillfs-mount
Help users configure, mount, and unmount a skillfs FUSE virtual filesystem on their local machine (e.g. for openclaw). Covers analyzing existing skill usage to suggest view configuration, generating skillfs-views.toml, mounting, and graceful unmount. Use this skill when the user asks to: set up skillfs, configure skill views, mount or unmount skillfs, check if skillfs is running, or get help organizing their skills directory (especially for openclaw users).
test-skill
A test skill used in integration tests.
storage-resize
Linux 磁盘扩容技能(RPM 包管理系统),实现云盘扩容后自动完成分区调整和文件系统扩容。支持系统盘/数据盘在线扩容,适配 XFS/EXT4/Btrfs 文件系统。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)。
ktuner
内核参数自动调优。分析系统配置,输出调优建议并可一键应用,支持自动回滚。使用场景:系统性能优化、安全加固、内核参数诊断。
backup-restore
处理所有备份与恢复任务,覆盖四个层面:工作区(项目/数据库/代码)、用户数据(家目录/dotfiles/密钥)、操作系统(全量系统/磁盘镜像/LVM 快照)、阿里云快照(云盘快照/自动策略/跨地域复制/整机镜像)。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)纯命令行环境,使用 yum 包管理器。当用户提到备份、恢复、快照、归档、回滚、克隆、迁移、容灾等任何涉及数据保存或恢复的请求时触发此技能,即使请求看起来很简单也应使用。