用途:以仓库自身代码与配置为事实来源,审阅并更新 GitHub 仓库的 About 描述和 topics;README、文档和现有 GitHub 元数据仅作弱提示,若与代码库不符则不采信。
主要能力:读取当前远端元数据并推断一条简洁的仓库描述和一组聚焦的 topics,基于实际语言、框架、领域与工具链。读取命令为 gh repo view --json nameWithOwner,description,repositoryTopics,homepageUrl,url。
使用方式:先收集仓库事实,然后预览当前值、建议值以及确切的 gh repo edit 命令,仅在用户明确确认后才执行。预览格式包括当前描述、建议描述、当前 topics、建议 topics,以及带 --description、--add-topic、--remove-topic 参数的确切命令。
规范:只改 GitHub 描述与 topics,除非用户明确要求,不改 homepage 或其他仓库设置;描述优先单句并符合仓库真实目的,鼓励加 emoji 前缀;topics 使用小写 kebab-case,优先准确、具体、稳定,而非宽泛热词;应移除过时 topics 而非只追加。
限制:绝不盲目应用;若认证或权限失败,应报告命令与失败信息,而不是猜测替代方案。