メニュー
Use when asked to analyze a codebase, generate project documentation, understand architecture, or create CODEBASE_KNOWLEDGE files for a repository
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/caitengwei/my-skills --skill codebase-analyzerコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Use when starting feature work that needs isolation from the current workspace, or before executing an implementation plan in a separate git worktree
Use when receiving one or more code review comments before deciding whether to fix them, push back technically, or close the related review threads
Use when syncing this skills repository with upstream open-source repos (superpowers, obsidian-skills, Humanizer-zh) to pull the latest community updates via git subrepo
| name | codebase-analyzer |
| description | Use when asked to analyze a codebase, generate project documentation, understand architecture, or create CODEBASE_KNOWLEDGE files for a repository |
探索当前代码库，生成结构化知识文档，供开发者或 LLM 实现功能、修复 bug、安全重构。输出保存到 codebase-analysis-docs/。
阶段 1 探索： 目录结构 → README/配置文件 → 技术栈 → 核心模块清单
阶段 2 规划： 按代码量决定文档数量
| 规模 | 文档数 | 执行方式 |
|---|---|---|
| <1 万行 | 1–2 个 | 单 agent 完成 |
| 1–10 万行 | 3–5 个 | 单 agent 完成 |
| >10 万行 | 5–10 个 | 主 agent 规划，按模块边界拆分，用 superpowers:dispatching-parallel-agents 并行分析各模块后整合 |
阶段 3 编写： 按需读取源文件，提取关键代码片段，创建架构图（Mermaid）
阶段 4 校验：
## 1. 项目概述 — 目的、技术栈、主要功能
## 2. 架构设计 — 架构图、组件关系、数据流
## 3. 核心模块 — 模块说明、关键类/函数、代码示例
## 4. 使用指南 — 安装配置、API 使用、典型用例
## 5. 开发指南 — 扩展方法、调试技巧、常见陷阱
主 agent 负责阶段 1–2（探索 + 规划），识别模块边界后按以下方式拆分并行任务：
Dispatch 前：主 agent 须为每个 subagent 构造完整上下文（不让 subagent 重新探索整个仓库）：
每个 subagent 的任务结构：
MODULE_X.md，包含组件说明、关键接口、依赖关系主 agent 整合步骤（收到所有 subagent 结果后）：
CODEBASE_KNOWLEDGE.md 和 README.md 索引高：README、CHANGELOG、入口文件、核心模块
中：配置文件、测试文件、工具脚本
低：文档网站、示例代码、CI/CD 脚本
分层阅读：入口/配置 → 核心模块 → 关键实现细节。理解 80% 核心逻辑即可。
必需：
codebase-analysis-docs/CODEBASE_KNOWLEDGE.mdcodebase-analysis-docs/README.md（文档导航）可选（按项目特点）：
API_REFERENCE.md / ARCHITECTURE.md / DEPLOYMENT.md / TESTING.md / PERFORMANCE.md
产出文档可作为 superpowers:requesting-code-review 的 reviewer context 传入，帮助 code-reviewer subagent 快速建立代码库认知。