菜单
Code relationship graph and temporal intelligence via abyss CLI. Provides caller tracing, impact analysis, hotspot detection, and file-level context gathering. Agent automatically runs abyss before modifying code to check impact. Works with any agent that has shell access.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Checks code quality metrics including complexity, duplication, naming conventions, and function length. Use when running quality gates, reviewing code smells, or checking lint rules. Automatically triggered on complex modules or post-refactor.
End-to-end change-shipping closed loop for non-trivial work — research → proposal doc → phased guarded implementation → PR self-review → harden → merge. Use when taking a substantial change from idea to merged PR, when a task needs a written proposal before code, when implementing in reversible phases behind a guarded commit chain (assert + test + verify, all green before commit), or when self-reviewing your own PR. Complements automating-devops (which is the git/CI/release knowledge reference); this skill is the orchestration spine that sequences a change from zero to merged.
AI-automated hardware product pipeline: from requirements to manufacturable Gerber + compiled firmware + cross-platform app. Orchestrates system design, ESP-IDF firmware, KiCad PCB, UniApp client, and release packaging in a zero-human-touch flow.
KiCad EDA orchestration via kicad-mcp MCP server. Routes 17 tools for schematic creation, PCB layout, autorouting, DRC, and Gerber export. Enforces serialized PCB ops, library-first lookup, and autoroute-only routing.
Systematically reduce AIGC detection rates in academic papers (Chinese/English). Analyzes detection reports, identifies high-impact sections, applies multi-layer rewriting strategies preserving formatting/footnotes, and verifies results. Supports 维普/知网/Turnitin platforms.
AI agent and LLM system engineering reference covering single-agent dev (ReAct, tool calling, plan-execute), multi-agent coordination (swarm, role decomposition, file locking), LLM security (prompt injection, jailbreak defense, output filtering), RAG architecture (chunking, hybrid retrieval, rerank), and prompt engineering / evaluation (RAGAS, LLM-as-Judge). Use when building AI agents, designing RAG pipelines, orchestrating multi-agent workflows, hardening LLM apps, or writing prompts.
| name | indexing-code |
| description | Code relationship graph and temporal intelligence via abyss CLI. Provides caller tracing, impact analysis, hotspot detection, and file-level context gathering. Agent automatically runs abyss before modifying code to check impact. Works with any agent that has shell access. |
| user-invocable | false |
| allowed-tools | Bash, Read |
不是搜索工具，是代码的调用图 + 时间智能。通过 shell 调用
abyssCLI。
进入项目时，检查并初始化索引：
command -v abyss >/dev/null && [ ! -f .code-abyss/index.db ] && abyss index
abyss context即将修改任何代码文件时，先获取该文件的完整上下文（不需要知道函数名）：
abyss context <要修改的文件路径> --json
返回：该文件所有函数的外部调用方、依赖的类型和函数、热点评分、耦合文件。
根据返回结果：
abyss impact <func> --json 深入分析| 场景 | 命令 |
|---|---|
| 初识项目架构 | abyss map --json |
| 追查 bug 来源 | abyss history <file> --symbol <func> --json |
| 搜索代码（比 grep 好） | abyss search "关键词" --json |
--json 输出结构化 JSON，agent 直接解析。不加 --json 输出人类可读文本。
{
"symbols_with_external_callers": [
{ "symbol": "SetError",
"external_callers": [
{ "file": "handler.go", "line": 42, "caller": "HandleRequest",
"confidence": 0.95, "is_test": false }
],
"possible_callers": []
}
],
"dependencies": [{ "name": "Account", "file": "types.go", "kind": "type_ref" }],
"hotspot": { "score": 5200, "changes_30d": 12, "complexity": 433 },
"coupled_files": [{ "file": "gateway.go", "co_changes": 13, "coupling": "65%" }]
}
external_callers：confidence ≥ 0.7 的可信调用方，按解析档位标注（1.0 同文件 / 0.95 同包 / 0.9 import 限定 / 0.8 全局唯一）possible_callers：confidence < 0.7 的歧义匹配——参考线索，不是事实，勿据此改调用方{
"direct_callers": 17,
"transitive_callers": 521,
"uncovered_paths": ["handler.go:DoSomething"],
"risk_score": 8.5,
"risk_factors": ["high blast radius", "319 paths without test coverage"]
}
abyss index # 建索引（~5s）
abyss context <file> [--json] # 文件完整上下文（改代码前用这个）
abyss callers <symbol> [--json] # 谁调了这个函数（默认隐藏 confidence < 0.7）
abyss callers <symbol> --min-confidence 0 # 连歧义匹配一起看
abyss impact <symbol> [--json] # 改了会影响什么（低置信边被排除时会在 risk_factors 标注）
abyss hook pre-edit # agent hook：stdin 读 tool JSON，增量刷新索引后输出警告
abyss hook post-edit # agent hook：编辑后增量刷新索引
abyss search "query" [--json] # 搜索代码
abyss map [--json] # 项目热点+耦合
abyss history <file> [--symbol X] # 变更历史
abyss stats # 索引统计
Hook 注入按 host 分两条路径（hybrid 切割架构，2026-06-25 锁定）：
claude / codex / gemini — 由 abyss CLI 的 attach 子命令负责（production 主入口，abyss v0.5.20+）：
abyss attach claude # → ~/.claude/settings.json
abyss attach codex # → ~/.codex/config.toml（Codex 0.125+ 数组表）
abyss attach gemini # → ~/.gemini/settings.json（SessionStart/BeforeTool/AfterTool）
abyss attach all # 三平台一次完成
幂等，重跑覆盖旧 shape，不污染其它键。
二进制查找顺序：PATH → ~/.code-abyss/bin/abyss。两处都没有时 hook 静默停用，后装 abyss 即生效，无需重装。
v4.8.x → v4.9 deprecation 期变更
--with-hooks对 claude/codex/gemini 仍写入 hook，但 install.js 打印 warning 引导改用abyss attach <host>；v5.0 移除该路径（openclaw/pi/hermes 的--with-hooks永久保留并改造为 spawn install-hooks.sh）--with-abyss下载 abyss 二进制到~/.code-abyss/bin/进入 deprecation，引导用户改用curl -fsSL https://raw.githubusercontent.com/telagod/abyss/main/install.sh | bash；v5.0 移除--with-mcp注册 abyss MCP 进入 deprecation，引导用户改用abyss mcp客户端自配；v5.0 移除
openclaw / pi / hermes — 由 code-abyss npm 包负责（abyss CLI 不接管这三平台，见 abyss src/attach/mod.rs 注释）：
npx code-abyss --target openclaw --with-hooks # 自动 spawn install-hooks.sh
npx code-abyss --target pi --with-hooks
npx code-abyss --target hermes --with-hooks
或脱离安装器直接跑脚本：
bash skills/indexing-code/hooks/common/install-hooks.sh auto # 自动检测平台
自动检测平台并注入对应 hook 配置（幂等，JSON 合并用 node）：
| 平台 | Hook 事件 | 配置位置 |
|---|---|---|
| Claude Code | PreToolUse(Edit|Write) | .claude/settings.json |
| Codex CLI | PreToolUse(Bash|shell|apply_patch|Edit|Write) | ~/.codex/config.toml |
| Gemini CLI | BeforeTool(write_file|replace) | ~/.gemini/settings.json |
| Pi Agent | tool_call(edit_file|write_file) | ~/.pi/agent/settings.json |
| Hermes | pre_tool_call | ~/.hermes/config.yaml 或 plugin |
| OpenClaw | before_tool_call | plugin api.on() |
统一入口是 abyss hook pre-edit（shell 脚本只是带存在性守卫的薄壳）：自动识别各平台 stdin JSON 形状、增量刷新索引（警告反映文件当前状态而非旧索引）、输出生产调用方 / 歧义引用 / 热点警告。编辑后可挂 abyss hook post-edit 保持索引新鲜。agent 无需手动调用。