메뉴
扫描代码库结构 → mermaid 图 + 模块清单 + 关键依赖矩阵，写入 .context/codebase-map.md。当用户提到代码库结构 / 项目地图 / mermaid 图 / 模块依赖 / 大型 brownfield / 陌生代码库时使用。建议在 /ccg:init 之前运行。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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