SuperAPI AI 工具集

fix-atx-datapath-errors

编程与开发

查看项目

更新于 11-12 00:43

技能介绍

当 AWS Transform 作业的“Discover data paths”步骤对 COBOL、copybook、BMS、JCL 制品报告提取错误或警告时,可使用该技能定位根因、修复可安全修复的问题、移除无法修复的内容并生成报告。

所需输入(缺失时需向用户索取):工作区 input/ 下需有 bre_transform_debug_*.zip(从 AWS Transform 控制台作业的 Artifacts 页签下载 artifact-slicing 产物,保持原样,不得重新压缩或修改内部路径)以及提交给 AWS Transform 作业的原始源码 zip(包含相同的 COBOL/copybook/BMS/JCL/PROC 目录结构);仅有调试包不足以继续。

使用方式:脚本位于技能 scripts/ 目录(仅依赖 Python 3 标准库),需在工作区根目录运行,输出写入 output/。先将 SKILL 设为包含 SKILL.md 的目录绝对路径,然后依次运行:parse_debug_bundle.py 解析调试包生成 findings.json;correlate_with_source.py 将 COPY 展开后的行号映射回真实文件/行,并按可扩展的模式库分类;apply_fixes.py 执行安全的机械式修复并写出 target_fixed.zip 与 changelog.json(可带 --remove-unfixable);generate_report.py 生成 report.md;可选的 capture_learnings.py 记录人工或 LLM 分诊经验,生成 learnings.jsonl 与 learnings_summary.md。学习日志写入工作区而非技能目录,因为已安装的插件/技能目录可能只读且更新时会被替换;如需共享经验,通过 pull request 回馈到源仓库。

交付物为 output/report.md、output/target_fixed.zip 以及供机器读取的 output/changelog.json;若发生过人工分诊,应在结束前运行第 5 步。

扩展或手工修复前应阅读 references/error_taxonomy.md,其中包含已知模式的示例、COPY 展开行号陷阱及新增匹配器的方法。

限制与注意事项:ATX 行号指向 COPY 展开后的源码而非原始文件,切勿按原始行号编辑;不要“修复”级联误报(如标签已存在或注明无功能影响的提示),应修复真正的上游问题;不得猜测业务逻辑,自动修复仅限纯格式调整(移动已有字符),需要判断的问题转人工审核;无法修复时优先移除文件而非冒险猜测;技能自身文件与学习日志中不得嵌入客户源码、程序名或业务数据;根因是开放式的,出现大量“需人工审核”属正常,不要强行归入现有类别;将经验提升为 PATTERN_LIBRARY/AUTO_FIX_CATEGORIES 须经评审的代码变更,绝不自动进行,也绝不针对改变业务逻辑的修复。