用途:在 microsoft/apm 的 PR 打开、重开或同步时,判断文档语料是否需要改动、改动影响范围,并输出一条补丁就绪的咨询评论。
主要能力:采用分类器加面板加合成器的流程。分类器是成本闸门,约 70% 的 PR 会短路为无需变更,仅约 1 次 LLM 调用。需要展开时,各代理只读取有界上下文(约 10 KB),不读完整语料。面板角色包括分类器、定位器、架构师、写作者、验证者、编辑、增长与合成器。
使用方式:由工作流触发,分两档运行模式:Rung 1 由 PR 上的 docs-sync 标签触发,维护者主动选择;Rung 2 在每个 pull_request_target 事件上默认触发,需经影子验证后启用。技能主体在两档下相同。
限制:该技能是咨询性的,不阻断合并、不应用裁决标签、不推送到贡献者 fork。每次运行最多 15 次 LLM 调用,硬性上限,超出则停止并输出部分结果。只有编排器可写,每次运行仅一条评论,使用 gh pr comment --edit-last 原地编辑。配套文档 PR 仅在结构裁决且经人工监督的后续步骤中考虑,且需新的负责人范围确认,默认只建议补丁而不开 PR。
其他细节:分类器与架构师读取 .apm/docs-index.yml 而非语料本身;python-architect 验证者必须运行真实命令验证文档声明。重复推送时不应重跑,需重新应用触发标签。