메뉴
Deeply Understand (codemap) — 持久化代码图谱 + 变更影响分析 + 理解地图。接手遗留项目 Day-1 / PR 影响分析 / 解释陌生代码 / PRD·ADR 前现状理解时用。编排 tools/codemap/ 的 codemap CLI
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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/