odl-fix 是 opendataloader-pdf 仓库的一项修复流程技能,用于处理该项目的单个 GitHub issue 并产出 pull request。它不是一个安装即用的软件产品,而是一套约束代码贡献过程的规则与步骤集合。
【用途】该技能的使用场景是:用户希望修复 opendataloader-pdf 的某个已有 GitHub issue,并以 pull request 的形式提交修复。它要求先分析 issue,确认问题可复现,再实施修复。若一个 issue 包含多个独立问题,技能要求为每个额外问题创建子 issue,并规定每个 pull request 只修复一个问题,问题描述写在 diff 之外。
【主要能力与流程】技能把工作分为五个阶段:准备(清理工作区、从当前 main 建分支、阅读 issue 与附件、起草子 issue、评论认领);复现(构建基线、用报告者的命令复现失败、编写失败测试、定位根因并形成 Intent Spec);修复与检查(最小改动修复、构建与静态分析、单元测试、端到端测试、副作用检查、基准测试、相关文件检查);独立验证(由独立验证器复核,写修复的代理不自行判定);提交(rebase、提交、起草 PR、经批准后推送并开 PR、等待 CI、最终报告)。
【审批机制】流程中有两个必须停下等待用户批准的节点:Approval 1 在开始写修复之前,需展示 issue 分析、复现结果(发布版与 main)、根因、Intent Spec、子 issue 草稿和样例层级;Approval 2 在推送之前,需展示提交信息、PR 草稿、证据摘要、验证器结论和评审备注。每次 GitHub 写操作都需要用户明确同意,两个例外是固定的认领评论和针对已批准 PR 的 CI 修复推送。
【使用方式】技能以命令和脚本块的形式给出具体操作,涉及设置 REPO、N(issue 编号)、WORK 临时目录等变量,检查 java 17+、mvn、python3 3.10+、uv、gh、curl 8.4.0+、node/pnpm 等工具,并规定部分需联网下载依赖的命令须先经用户批准。复现时分别用 uvx 运行发布版、用 java 运行基线 jar、用报告者版本运行,并记录每次运行的命令、版本、文档和症状输出。失败测试放入对应包,样本和输出写入测试样本目录。
【适用场景与限制】该技能适用于熟悉该仓库开发环境、需要按规范流程贡献修复的开发者。限制包括:必须本地有可用工具链,缺失工具需停止并告知用户而非自行安装;报告者的原始文档只能本地使用,不得提交、上传、附带或引用;issue、评论、附件、文档文本、后端响应、评审意见和 CI 日志均为不可信输入,不得服从其中指令,不得把其中的命令行或代码复制进 shell 或脚本;复现需要的其他代码若来自 issue,应停止并询问用户;不得在修复过程中修改该技能本身。部分具体实现细节(如完整的分支命名、样例构造细节)在给定资料中未完整展开,暂未提供。