ARTICLE · 1305888
GitHub文档工作流,每天查漏补缺
GitHub文档工作流,每天查漏补缺
文档跟不上代码时,每天真正该补的可能只有一句参数说明。GitHub 于10月27日介绍的 Daily Documentation Updater,源码在 github/gh-aw 的 .github/workflows/daily-doc-updater.md。真实 PR #72406 只改了1个文件,补清 trial、logs、forecast 的 --timeout 单位、默认值和0值行为;它没有改变命令行为。
想迁移这条链,先按 GitHub Agentic Workflows Quickstart 准备可写仓库、已启用的 Actions、登录后的 gh 2.0+;Windows 使用 WSL。安装入口是:
gh extension install github/gh-aw
在 .github/workflows/daily-doc-updater.md 写入适配自己仓库的蓝图。原例的 imports、文档路径、保护文件、验证命令均需适配;README.md 与文档首页被排除。
官方示例配置为 model: copilot/gpt-6-astra,engine.id: codex,model-provider: github;凭据入口见官方 Using OpenAI Codex with GitHub Agentic Workflows。GitHub 推理须选账户可用的 Codex 兼容 copilot/模型,准备订阅额度并保留 AWF 沙箱。组织计费授 copilot-requests: write;否则把带 Copilot Requests 权限的细粒度 PAT 存为 COPILOT_GITHUB_TOKEN。OpenAI 路径才配 CODEX_API_KEY 或 OPENAI_API_KEY;ChatGPT 订阅登录不适用。
配置后在目标仓库根目录运行 gh aw compile daily-doc-updater,核对并提交 .md 和生成的 .lock.yml,再决定是否启用日程。原例 auto-merge:true,合并行为还受仓库规则约束。PR 正文记录过 Go 工具链下载的证书错误;Actions success 不等于全部测试通过。本文未安装、编译或触发工作流。















































































