用途:将缺乏文档的代码库转成新开发者可快速理解的状态,通过侦察、结构解析、架构文档生成、功能清单、操作流追踪与新功能指南等阶段推进。
主要能力:分析代码结构与依赖;用 C4 模型等多层抽象绘图;生成并拆分维护文档;加速 onboarding。核心产物包括 docs/README.md(目录)、00_overview.md、01_frontend.md、02_backend.md、03_domain_model.md、04_feature_inventory.md、05_user_flows/、06_onboarding.md、07_tech_debt.md、08_add_feature_guide.md;不存在的领域不生成对应文件,编号连续。每份文档头部含生成技能、目标仓库、生成日期与提交号。
使用方式:提出如“分析此代码库并输出 docs”“只生成 C4 与架构文档”“列出功能”“追踪 F-002 的操作流程”“生成新增功能步骤”等请求。先扫描仓库实际结构,再决定文档组成;能自行判断时不提问,必要时确认预期读者、重点模块或输出格式。
适用场景:接手陌生仓库、团队知识沉淀、新人培训、技术债梳理与架构评审准备。
限制:需对目标仓库有读取访问权限;产出为 Markdown 与 Mermaid 等文档,不自动修复代码;推测性内容需标注或列为“要调查”;未提供具体命令、依赖安装方式与运行步骤,需以实际仓库为准。