用途:该技能通过多阶段迭代工作流对项目代码库进行分析,产出带 Mermaid 图表的架构报告、设计报告和方法分析报告,适合需要系统性整理项目结构文档的场景。
主要能力:报告类型分为 architecture(架构,5 个 Agent,聚焦系统结构、模块与依赖)、design(设计,4 个 Agent,聚焦模式、类与接口)、methods(方法,4 个 Agent,聚焦算法、关键路径与 API)以及 comprehensive(综合,合并以上全部)。流程包含六个阶段:需求发现生成 analysis-config.json;项目探索确定范围;并行 Agent 深度分析并直接写出 sections/section-*.md,仅返回状态、输出文件、摘要与交叉说明的简要 JSON;汇总阶段检查一致性、完整性、关联性与质量并输出 consolidation-summary.md、质量评分与问题列表;报告生成阶段合并 Executive Summary、sections 与质量附录为 {TYPE}-REPORT.md;迭代精修阶段循环发现问题、提问、修复与重新检查。
使用方式:技能按 phases 目录下的分阶段文档执行,依次读取 01-requirements-discovery.md 至 05-iterative-refinement.md,并参考 specs/quality-standards.md 与 specs/writing-style.md。输出目录为 .workflow/.scratchpad/analyze-{timestamp}/,包含 sections、consolidation-summary.md、最终报告与 iterations 目录。目录创建示例:Windows 使用 Bash(mkdir "${dir}\\sections")、Bash(mkdir "${dir}\\iterations");Unix/macOS 使用 Bash(mkdir -p "${dir}/sections" "${dir}/iterations")。
设计原则:Agent 直接输出 Markdown 以避免 JSON 转 MD 的上下文开销;Agent 只返回路径与摘要;由独立汇总 Agent 负责跨章节问题检测与质量评分;合并阶段读取文件而非在上下文中传递;采用段落式学术描述,禁止清单罗列。
适用场景与限制:适用于代码库架构梳理、设计文档与方法/API 文档生成。具体运行环境要求、安装命令、依赖版本、性能与费用等信息在现有资料中暂未提供。