用途:作为 GitHub Codespaces 效率工作的轻量入口,检查仓库、识别浪费,并按需加载参考资料。若仓库尚无 .devcontainer/,先加载 references/codespaces.md 建立基线。
适用场景:用户希望加快 Codespaces 启动或降低开销;仓库已有 .devcontainer/ 或存在明确配置问题;需要 devcontainer 优化、机器规格、预构建策略或空闲超时建议;首次搭建 Codespaces 或从零创建 .devcontainer/。
核心流程:先测量,运行 find .devcontainer -maxdepth 2 -type f、gh codespace list、repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner)、gh api "/repos/$repo/codespaces/machines"。若 gh 认证失败或缺少仓库管理权限,则改为静态分析 .devcontainer/ 文件,并将机器类型与预构建建议标记为未验证。关注点包括镜像超过 2 GB 或特性超过 10 个、机器规格超出用量数据支持、缺少 devcontainer-lock.json、预构建范围过宽、空闲超时与使用模式不匹配。
护栏规则:不删除团队日常使用的工具;不假设越小越好;不把 devcontainer 变成生产镜像;优先增量修改;仓库改动与组织设置分开建议。
从六个候选中选出最多 3 项有审计证据且通过护栏的修复,按预计月度成本节省排序:精简 devcontainer、调整机器规格、限定预构建范围、调整空闲超时、移除未用扩展或端口转发规则、减小镜像并改进层缓存。
验证:启动测试 Codespace 确认构建与启动正常;有遥测时验证机器规格,否则标记未验证;构建或启动异常视为真实缺陷。
输出需包含:浪费来源、建议修复、验证状态、影响(启动时间、月度开销、资源利用率)。参考资料为 references/codespaces.md 与 references/review-rubric.md(仅评审时加载)。