用途:为代码、API 和项目组件生成与维护文档。它作为文档编排器,协调多个视角并行产出文档,目标由参数 $ARGUMENTS 指定。
主要能力:按目标选择文档视角——文件或目录对应 Code,"api" 对应 API 与 Code,"readme" 对应 README,"audit" 对应 Audit,"capture" 对应 Capture,空或 "all" 则启用全部适用视角。先扫描目标中已有文档,识别缺口与过时内容,再合并更新而非重复创建。支持两种模式:Standard(默认,并行即发即忘的子代理)与 Agent Team(持久队友、共享任务列表与协调),当目标为 all 或 audit、视角不少于 3 个或代码库较大时推荐后者。Capture 视角使用 templates/ 下的 pattern-template.md、interface-template.md、domain-template.md 保持格式一致。
使用方式:技能会先分析范围,通过 AskUserQuestion 让用户选择生成全部、聚焦缺口、更新过时或查看分析;再选择模式;随后按视角启动文档任务;最后合成结果、检查风格一致性、解决视角间冲突并应用变更,再按 reference/output-format.md 输出摘要,并询问是否处理剩余缺口、审查过时文档或结束。
约束:所有文档任务必须委派给专业代理,不得自行撰写;必须同时启动适用的视角;必须先检查已有文档;需匹配项目文档风格与约定,并链接到实际文件路径与行号;不得创建重复文档。
参考材料:reference/perspectives.md、reference/output-format.md、reference/knowledge-capture.md 以及 examples/output-example.md。
限制:资料未提供具体安装命令、收费方式、支持平台或实际效果说明。