SuperAPI AI 工具集

repo-maintainer

编程与开发

查看项目

更新于 10-15 21:35

技能介绍

用途:在大型成熟仓库中维护或评估变更,让跨仓库后果在采纳、实现或宣布完成前可见。按语义风险而非 diff 大小安排审查与验证。

主要能力:支持四种操作——只读评估传入变更并建议采纳、调整、推迟或拒绝;实现维护(映射影响、做最小完整改动、验证 diff);审计既有工作(逐块审查、找遗漏与回归,除非用户要求修复否则先报告);准备发布(检查完整发布增量并阅读 references/verification.md 及仓库发布说明)。

使用方式:行动前先读仓库说明;涉及路由、提供方、客户端、安装器、凭据、网关、模型发布、桌面界面或发布时,还需读 references/codex-router-surfaces.md。从仓库根运行只读分析器:python3 <skill-dir>/scripts/repo_maintainer.py analyze --repo . --format markdown;加 --manifest PATH 可原子创建或替换指定 JSON 产物;已有提交范围用 --base REF --head REF,仅暂存改动用 --staged。其分类只是保守信号,非语义影响证明。实现前先声明可观察的验收结果,并识别受影响与明确不受影响的表面。

适用场景:跨模块、跨平台、多子系统、安全、协议、安装器、依赖、发布等变更;是否并行(fan-out)需先读 references/fanout.md,仅在独立审查或实现能提升信心或缩短时间时使用,且不得把子代理的完成声明当作验证。

限制:只读评估时不得 pull、merge、cherry-pick 或编辑;不得静默扩大维护请求范围;无授权不得运行消耗配额、生产、破坏性、依赖凭据或外部变更的检查;测试通过不等于仓库正确,只能声明证据支持的结果。修改本技能自身时运行 python3 -m unittest discover -s .agents/skills/repo-maintainer/tests -v 并用可用的 skill-creator 校验器验证。