Menu
Deeply Understand (codemap) — 持久化代码图谱 + 变更影响分析 + 理解地图。接手遗留项目 Day-1 / PR 影响分析 / 解释陌生代码 / PRD·ADR 前现状理解时用。编排 tools/codemap/ 的 codemap CLI
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when an execution-layer dev (frontend-dev / backend-dev / ai-agent-dev / ml-engineer / miniapp-dev) has finished feature code + Unit tests and is about to enter code-review. Provides the SIT scope, environment, AC-driven integration walk, and evidence sink (progress/<role>.md). SIT is now a dev-owned step, not a separate QA stage.
Use when apple-dev has finished feature code + Unit tests (Swift Testing) and is about to enter code-review. Provides the Apple SIT scope (xcodebuild test + simulator per declared target), the AC-driven integration walk, APIProtocol-mock discipline, and evidence sink (progress/apple-dev.md). SIT is dev-owned; apple-code-reviewer audits the evidence.
Use when product-lead is about to run a release retrospective after a successful MAJOR or MINOR release push (PATCH skipped). Provides applicability gate, pre-conditions, 7-step execution sequence, anti-patterns, and the verification gate before commit. Pairs with template docs/reviews/retro-_TEMPLATE.md and slash /agf-release-retro.
Use when wiring up or switching between China-domestic LLM providers (DeepSeek, Doubao/Volc Ark, Qwen/DashScope, MiniMax). Provides OpenAI-compatible adapter pattern, env-var contracts, fallback strategy, cost guardrails, and minimum verifications before declaring integration done.
Use when tech-lead is about to record an architecture decision (new tech stack member, deviation from baseline, deployment / observability / auth scheme choice). Provides ADR structure, version-audit appendix format, and "what NOT to ADR" guidance. Replaces ad-hoc copy from ADR-000.
Use when qa-engineer (or miniapp-qa-engineer) is about to publish an E2E or UAT report. Provides the report skeleton, evidence-quality bar, verdict criteria, and hand-off rules. SIT is now dev-owned and lives in progress/<role>.md (see agf-running-sit-tests skill) — this skill does NOT cover SIT reports.
| name | agf-code-map |
| description | Deeply Understand (codemap) — 持久化代码图谱 + 变更影响分析 + 理解地图。接手遗留项目 Day-1 / PR 影响分析 / 解释陌生代码 / PRD·ADR 前现状理解时用。编排 tools/codemap/ 的 codemap CLI |
ADR-021 Deeply Understand 代码理解引擎的 AGF 入口。Python 原生（tools/codemap/），SQLite 持久图谱 + tree-sitter 多语言 + 反向 BFS 影响分析 + 静态 HTML dashboard。替换 agf-understand（M8 验证后删 agf-understand.js）。
codemap build + onboard + dashboardcodemap diff（→ code-reviewer 审查清单）codemap explaincodemap understand（接管 agf-understand 的理解地图）uv run codemap <subcmd>）build [path] — 全量建图 → .agf/code-map.dbupdate — 增量（git diff + 双指纹）diff [--base <ref>] [--hop N] — 变更影响分析（反向 import BFS + 风险评分）explain <target> — 节点深度解释（邻居 + 源码片段）onboard — 项目概览 + 复杂度热点 + 高扇入understand [topic] — 理解地图（目录子系统 + 核心依赖 + 风险点）context "<query>" — 相关子图（给 agent 注入）search "<query>" — 检索（默认 FTS5 关键词；跑过 embed 后自动启用 semantic 余弦，三态降级）embed — 生成节点 embedding 存 .agf/code-map.db（需 uv sync --extra semantic；jina-code-v2，首次下载 ~90MB + torch；未装/未跑则 search 自动降级 FTS，功能不中断）dashboard [--out <path>] — 静态 HTML 图（cytoscape，浏览器 open）首发 7 语言：Python / TS / JS / SQL / YAML / JSON / Java（04 设计）。Swift/WXML 诚实缺口（04 §6）。
docs/specs/ / docs/adr/ / docs/design/DESIGN.md / OpenAPI 契约.agf/* gitignored（派生缓存，可重建）；消费层报告落 docs/reviews/