SuperAPI AI 工具集

daily-docs-audit

写作与研究

查看项目

更新于 10-16 00:32

技能介绍

用途:每日无人值守地审计 microsoft/vscode 仓库近期合并的 PR,识别需要文档跟进的变更,并在 microsoft/vscode-docs 仓库创建去重 issue。

主要能力:以用户给定回看窗口或 ISO 8601 起始时间为准,默认检查最近 30 小时合并的 PR(含 6 小时重叠,因此必须去重);收集 PR 编号、标题、URL、正文、标签、作者、合并时间、变更文件与 diff、关联 issue 及评论;结合源码验证可用性、默认值、设置与命令标识、UI 标签、平台约束和功能开关;检索 vscode-docs 既有内容、issue 与 PR,判断文档缺失或不准确;按同一用户可见功能合并多个来源 PR,创建一个 issue,并使用标记 <!-- vscode-docs-update:vscode-pr-<PR_NUMBER> --> 去重。

使用方式:用户提供回看窗口或起始时间,未提供时默认最近 30 小时。技能不提问、不直接编辑文档,仅通过 gh CLI 查询与创建 issue。标题格式为 Document <user-facing feature or behavior>;正文包含产品变更、文档需更新原因、建议文档、需核实细节与验收标准。文档不准确时用 doc-bug,缺失时用 doc-enhancement 并加 triage-needed,仅使用已有标签。

适用场景:面向 microsoft/vscode 面向用户或扩展作者的变更,如功能、工作流、UI 操作、设置、命令、键绑定、默认值、配置格式、稳定 API、贡献点、策略、认证流程、平台要求、安装、无障碍、远程开发、排障、迁移、弃用或移除等;AI 相关变更若涉及 docs/copilot/ 或 docs/agents/,需额外应用 docs-product-alignment 的事实性与术语要求。

限制:通常排除重构、测试、依赖更新、构建变化、遥测、清理、内部 API、仅恢复已记录行为的修复、内部实验、仅 dogfooding 或未公开的 proposed API、已被现有文档或 issue/PR 覆盖的变更、仅发布说明更新。不编辑生成文件 enterprise/policies.md。若创建 issue 失败,需报告错误并继续评估其余候选;只有 gh issue create 返回 URL 才能声称创建成功。未提供:具体安装命令、费用与价格、运行环境依赖、完整实现代码等。