Menu
扫描代码库结构 → mermaid 图 + 模块清单 + 关键依赖矩阵，写入 .context/codebase-map.md。当用户提到代码库结构 / 项目地图 / mermaid 图 / 模块依赖 / 大型 brownfield / 陌生代码库时使用。建议在 /ccg:init 之前运行。
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
CCG Skills - Quality gates, documentation generator, and multi-agent orchestration. Auto-installed by CCG workflow system.
变更校验关卡。分析代码变更，检测文档同步状态，评估变更影响范围。当用户提到变更检查、文档同步、代码审查、提交前检查、diff分析时使用。在设计级变更、重构完成时自动触发。
模块完整性校验关卡。扫描目录结构、检测缺失文档、验证代码与文档同步。当用户提到模块校验、文档检查、结构完整性、README检查、DESIGN检查时使用。在新建模块完成时自动触发。
代码质量校验关卡。检测复杂度、重复代码、命名规范、函数长度等质量指标。当用户提到代码质量、复杂度检查、代码异味、重构建议、lint检查、代码规范时使用。在复杂模块、重构完成时自动触发。
安全校验关卡。自动扫描代码安全漏洞，检测危险模式，确保安全决策有文档记录。当用户提到安全扫描、漏洞检测、安全审计、代码安全、OWASP、注入检测、敏感信息泄露时使用。在新建模块、安全相关变更、攻防任务、重构完成时自动触发。
从近期开发会话中萃取可复用的模式 / 决策 / 教训。当用户提到提取教训 / 复盘 / lessons learned / 知识沉淀 / 经验萃取 / 提炼模式时使用。会扫 .context/ 决策日志 + git log 提交语义。
| name | map-codebase |
| description | 扫描代码库结构 → mermaid 图 + 模块清单 + 关键依赖矩阵，写入 .context/codebase-map.md。当用户提到代码库结构 / 项目地图 / mermaid 图 / 模块依赖 / 大型 brownfield / 陌生代码库时使用。建议在 /ccg:init 之前运行。 |
| license | MIT |
| user-invocable | true |
| disable-model-invocation | false |
| allowed-tools | Read, Glob, Grep, Bash, Write |
| argument-hint | [--fast] [focus-area] |
为陌生项目 / 大型 brownfield 项目快速画一张"地图"：哪些模块、模块间怎么依赖、关键技术栈、入口点在哪。输出三件套：
写入 .context/codebase-map.md，作为 /ccg:init / /ccg:plan / /ccg:team 的预读材料。
/ccg:map-codebase # 完整扫描（默认）
/ccg:map-codebase --fast # 快扫，只输出顶层模块图，不深入
/ccg:map-codebase frontend # 聚焦某子领域（不影响其他区域生成清单）
/ccg:init 关心 CLAUDE.md 索引文档（人类阅读的项目档案）/ccg:map-codebase 关心 结构化机器可读地图（mermaid + 表格，给 AI 后续命令读）/ccg:map-codebase 再 /ccg:init，init 可引用 map 产物并行：
# 顶层入口
ls package.json tsconfig.json Cargo.toml go.mod pyproject.toml 2>/dev/null
# 主要源码目录
ls src/ lib/ pkg/ app/ packages/ apps/ 2>/dev/null
# CI/部署
ls .github/workflows/ .gitlab-ci.yml Dockerfile docker-compose.yml 2>/dev/null
按"含 index 文件 / 单独 package.json / 子目录有大量 .ts/.js" 三个启发式找出顶层模块。每个模块产出：
find 计数）对每对模块跑 grep -rl "from.*<other-module>" 或 grep -rl "import.*<other-module>"。命中即建立 A→B 边。
从 package.json dependencies、Cargo.toml [dependencies]、go.mod require 选出：
输出到 .context/codebase-map.md：
# Codebase Map
**生成时间**: <ISO>
**项目类型**: TypeScript / Node ESM
**入口**: bin/ccg.mjs → src/cli.ts
## 模块依赖图（mermaid）
\`\`\`mermaid
graph TD
cli["src/cli.ts"]
cli --> commands["src/commands/*"]
commands --> utils["src/utils/installer*"]
utils --> templates["templates/"]
\`\`\`
## 模块清单
| 模块 | 入口 | 文件数 | 职责 |
|------|------|--------|------|
| ...
## 关键依赖
| A | B | 通过什么 |
|---|---|--------|
| commands/init.ts | utils/installer.ts | installWorkflows() |
## 技术栈
- Web: 无（CLI 工具）
- 测试: vitest
- ...
跳过 Step 3 的 grep 联动，只输出顶层模块的 placeholder 边（不画依赖箭头）。适合 1k+ 文件的大库初次扫描。
.context/codebase-map.md