用途:为 PR 变更完成端到端文档工作,串联已有的检查、编写、审查技能,并可选做截图验证。开始前按 ../shared/load-context.md 加载本地上下文(子技能会继承),并向用户获取一个或多个 PR 编号及目标分支信息。
主要能力分三步:第一步检查,运行 ../docs-pr-check/SKILL.md,输入用户提供的 PR 列表,输出分类表与按优先级排列的缺口摘要,需向用户展示表格并确认继续哪些 PR;第二步编写,运行 ../docs-pr-write/SKILL.md,输入被判定为“需要文档”或“需要更新文档”的 PR 及缺口说明和建议目标文件,输出更新后的文档文件、PR 与文档映射及待办项,需展示变更文件与摘要并等用户确认,不得自动继续;第三步审查,对第二步改动的文件运行 ../docs-review/SKILL.md,输入文件路径与写作中标记的不确定论断,输出覆盖风格指南、frontmatter、链接与准确性的审查报告。若审查在敏感数据扫描中发现真实(非示例)密钥,须停止,在用户于源头轮换或作废该值前不得提出创建 PR,因为它可能已留存于 git 历史。处理完反馈后询问用户是创建 PR 还是先在本地查看。可选截图验证:若第一步产出截图清单(涉及含截图的页面且有 UI 变更的 PR),可询问是否验证,用户须提供可用 URL,并直接传入该清单表。
交接约定:第一步到第二步传递 PR 编号、分类、缺口说明与建议目标文件,接收方需验证 PR 仍可访问(gh pr view 成功)且分类属于四种有效类别;第二步到第三步传递变更文件路径与未决事项或不确定论断,需验证每个路径存在且文件非空;第一步到截图检查传递截图清单(PR 编号、受影响文档页、截图数量、图片引用),需验证文档页存在且图片引用可解析。任何接收步骤在继续前都必须校验输入,若校验失败(PR 已删、文件缺失、路径变更)应停止并报告,不要基于过期数据操作。
选择建议:一个或多个 PR 需要端到端文档时用本流程;只检查 PR 是否有文档用独立的 docs-pr-check;已知写什么并有 PR 编号用 docs-pr-write;审查已有文档改动用 docs-review;与 PR 无关的全新文档用 docs-from-code(如可用)。
已知限制:步骤二与三在同一代理会话中运行,审查步骤评估的是同一代理刚写的内容,属于结构性自审,不应视为独立质量门槛;独立的验证发生在人类审查并合并目标仓库 PR 时。破坏性变更、安全相关文档或迁移指南等高影响变更,应考虑在单独代理会话运行 docs-review 或请其他成员审查后再建 PR。参考:../shared/docs-context-guide.md、../shared/style-guide.md、../shared/verification-checklist.md、screenshot-check(如可用)。
原文未说明具体安装命令、收费与价格、平台支持范围,这些信息暂未提供。