菜单
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.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/telagod/code-abyss --skill indexing-code命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Scans code for security vulnerabilities, detects dangerous patterns, and ensures security decisions are documented. Use when running security scans, auditing code, or checking for OWASP issues, injection risks, or sensitive data leaks. Automatically triggered on new modules, security-related changes, or post-refactor.
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.
Distills AI agent voice patterns from conversation into a Persona Voice Card v1.0 (self/user/language/register/emoji_policy/flourish only — no judgment-shaped fields), validates schema + content safety + differentiation, and routes contributions through the existing submission portal. Use when the user wants to crystallize a recurring voice/tone, fork an existing persona, or share one with the community.
基于 SOC 职业分类
正在显示 SKILL.md
| 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"
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已移除（Agent OS v5.1）。请用curl -fsSL https://raw.githubusercontent.com/telagod/abyss/main/install.sh | bash；claude/codex/gemini graph hooks 用abyss attach <host>--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 无需手动调用。