메뉴
深度项目分析工具。用于在现有 docs 不足、代码链路复杂、需要梳理系统架构、模块数据流、时序或性能风险时进行只读取证和结构化分析。常与 `project-docs-workflow` 配套使用，作为其升级步骤；也可在用户明确要求架构分析、数据流分析、时序图、调用链梳理或性能排查时直接使用。默认应落文档：优先新建或更新 `docs/` 下合适文档，不再停留在仅终端输出的 analysis-only 模式。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | project-analysis |
| description | 深度项目分析工具。用于在现有 docs 不足、代码链路复杂、需要梳理系统架构、模块数据流、时序或性能风险时进行只读取证和结构化分析。常与 `project-docs-workflow` 配套使用，作为其升级步骤；也可在用户明确要求架构分析、数据流分析、时序图、调用链梳理或性能排查时直接使用。默认应落文档：优先新建或更新 `docs/` 下合适文档，不再停留在仅终端输出的 analysis-only 模式。 |
本技能是项目的深度分析层。
它不负责每次开发前后的通用 docs 编排；那由 project-docs-workflow 负责。它的职责是：在现有文档不足、链路复杂或用户明确需要时，做只读取证、调用链梳理、图表整理和性能观察，并把结果整理进项目文档。
默认行为：创建或更新 docs。 不再使用 analysis-only。当用户没有明确指定时，应优先判断是新建文档还是更新现有文档，并实际写入 docs/ 或调用方指定的长期文档落点。
强制要求：凡是输出 Mermaid 图表，必须在同一位置紧跟对应的 ASCII/TUI 预览图，方便用户在终端和代码评审中直接审查结构。不得省略，不得标记为可选。
本技能可用于以下分析主题：
architecture：系统架构、模块边界、依赖关系、外部服务dataflow：模块数据流、调用链、关键数据变换、外部 I/Osequence：主流程时序、跨层交互、关键分支performance-risk：性能热点、放大点、瓶颈候选、风险链路仅保留两种模式，且默认优先写文档：
当分析结果适合沉淀为一篇新的长期文档时使用。这也是未明确指定模式时的默认选择。
适用场景：
docs/ 中没有合适文档可承接输出：
docs/feature-* / docs/reference-*）当已有 feature-* / reference-* / OVERVIEW.md 能承接本次分析结果时使用。
适用场景：
project-docs-workflow 升级调用并提供候选文档路径输出：
feature-* / reference-* / OVERVIEW.md 的增量更新模式选择规则：
update-doc 是否可行：若存在合适承接文档，优先更新而不是平行新建new-docanalysis-onlystandalone-report 作为独立模式；用户若要求独立报告，按 new-doc 处理并创建合适的新文档先明确：
architecture / dataflow / sequence / performance-risk 哪类分析new-doc / update-doc优先检查：
docs/OVERVIEW.mddocs/feature-*.mddocs/reference-*.md如果调用方（如 project-docs-workflow）已经提供候选文档路径，优先读取这些文档；如果没有，再自行扫描 docs/。
这些文档只能作为半可信上下文：
进入分析后，必须在写文档前完成模式判断：
update-docnew-doc如 docs/ 中存在旧式分析文档、frontmatter 元数据或需要做补充检索，可选使用 metadata 扫描脚本作为辅助：
python3 <skills-root>/skills/project-analysis/scripts/scan_docs_metadata.py <项目根目录>/docs
它不是主判断依据。主判断依据应是：
docs/OVERVIEW.mddocs/feature-*.mddocs/reference-*.md在正式读代码前，先把分析拆成 2-4 个边界清晰、只读、可并行的子任务。
拆分原则：
推荐拆分方式：
使用 Agent 工具启动 SubAgent 并行执行子任务。
执行要求：
主 agent 汇总各 subagent 的结果后，再统一形成分析输出。
主 agent 负责：
写入前至少检查：
feature-* / reference-* / OVERVIEW.md）docs/OVERVIEW.md如发现更适合沉淀到规则层的经验，只负责识别并提示调用方；不要默认直接修改 CLAUDE.md。
完成后，向用户汇报：
new 还是 update默认优先维护这一套长期项目文档：
docs/feature-*.mddocs/reference-*.mddocs/OVERVIEW.md优先规则：
feature-*reference-*docs/OVERVIEW.md仅在下列情况才生成独立分析文档：
注意：独立文档仍属于 new-doc，不是单独的第三种执行模式。
| 分析类型 | 文件名格式 |
|---|---|
| 系统架构 | architecture.md |
| 数据流 | dataflow-{功能}.md |
| 时序图 | sequence-{流程}.md |
注意：这类文件不是默认长期落点。优先仍是 feature-* / reference-* / OVERVIEW.md。
如果本技能由 project-docs-workflow 升级调用，调用方应尽量提供：
new-doc / update-docdocs/feature-xxx.md、docs/reference-xxx.md）收到这些信息时，本技能应：
references/mode-architecture.mdreferences/mode-dataflow.mdreferences/output-spec.mdreferences/mermaid-templates.md