CLI-Anything HARNESS.md 七阶段流水线：把 GUI 软件转成 Agent 可操作 CLI 的完整指南

CLI-Anything HARNESS.md 七阶段流水线把 GUI 软件转成 Agent 可操作 CLI 的完整指南【免费下载链接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-AnythingCLI-Anything 是一个把界面软件系统转成 AI Agent 可操作命令行接口的开源仓库核心是一份方法论文档HARNESS.md规定了从代码库分析到 PyPI 发布的完整路径。本文讲清楚这套规范如何保证生成 CLI 的质量要守什么原则、走哪些阶段、过哪些验证关口。初次接触该项目的读者可以按文中步骤完成自己的第一个 harness。 场景Agent 不开 GUI 完成一次真实导出HARNESS.md 流水线的价值在一个导出场景里看得最直观Agent 需要拼一份文档并产出真实 PDF。GUI 自动化依赖截图与坐标点击分辨率或语言一变就失效自研排版引擎则与真实软件行为脱节。跑完/cli-anything命令后流水线交给 Agent 一个可 pip 安装的cli-anything-libreoffice无参数进入交互 REPL加--json输出机器可读结果最终 PDF 由libreoffice --headless渲染产出。规范要解决的不是如何写一个 CLI而是如何让任何软件都通过同一质量标准。⚙️ 三条铁律HARNESS.md 不妥协的地方规范在进入各阶段之前先立下三条不可改动的前提。真实软件是硬依赖。渲染与导出必须走真实应用的命令行subprocess.run([libreoffice, --headless, --convert-to, pdf, odf_path])依赖缺失时报错并给出安装指引。理由用 Python 重写渲染得到的是扛不住真实负载、行为与正式软件脱节的玩具。原生项目文件即数据层。解析并修改应用自己的格式ODF、MLT XML、.blend、SVG生成合法中间文件交给真实软件渲染。CLI 是软件的结构化入口不是替代品。没有报错不等于验收。每次导出都要程序化校验魔数、ZIP 结构、抽帧依赖缺失时 E2E 测试直接失败而不是跳过。理由输出可信Agent 才能自我纠偏。️ 执行路线把七个阶段压缩成五个检查点HARNESS.md 的七阶段可归并为五个检查点每个检查点都有明确的输入、产出与通过标准。代码库分析输入软件源码产出后端引擎、GUI 动作到 API 的映射、数据模型与软件自带工具melt、ffmpeg清单。标准能列出每个待暴露命令对应的原生格式与后端命令。架构设计产出 REPL 加子命令双模式、按应用逻辑域划分的命令组、JSON 会话状态模型与人类/机器双可读输出。标准每个命令组都对应应用的清晰逻辑域。实现顺序固定——数据层、内省命令info/list/status、变更命令、utils/software_backend.py、导出管线、会话管理交互层复制插件的repl_skin.py统一皮肤。标准pip install -e .后命令上 PATH无参数进入 REPL。测试先写TEST.md计划模块清单、预计数量、工作流场景再实现测试代码最后把结果追加回 TEST.md。标准见下文质量关口。技能与发布生成SKILL.md编写setup.py以共享cli_anything命名空间发布。标准能与其他cli-anything-*包并行安装技能文件随 pip 打包。 交付物标准harness 最终必须长成的目录形态一个完成的 harness 就是一个agent-harness/目录分析文档、打包配置、命名空间包与测试全部就位README.md 与 TEST.md 为强制文件缺一项即不算交付。software/agent-harness/ ├── SOFTWARE.md # 分析与 SOP ├── setup.py # 命名空间包配置 └── cli_anything/ # 无 __init__.py └── software/ ├── README.md # 安装运行指南强制 ├── software_cli.py ├── core/ # 每个领域一个模块 ├── utils/ │ ├── software_backend.py # 调用真实软件 │ └── repl_skin.py └── tests/ ├── TEST.md # 计划结果强制 ├── test_core.py └── test_full_e2e.py✅ 质量关口如何验证输出是正确的四层测试各自回答一个不同的疑问。单元测试用合成数据验证函数正确性E2E 中间文件层验证 CLI 生成的项目文件结构合法E2E 真实后端层必须调用真实软件产出最终工件校验存在、大小大于 0、魔数如%PDF-与预期内容并打印工件路径供人工检查CLI 子进程层通过subprocess.run调用已安装命令走完整工作流。CI 里用环境变量强制走已安装命令CLI_ANYTHING_FORCE_INSTALLED1 python3 -m pytest cli_anything/software/tests/ -v -s另有两项验收往返测试把 CLI 生成的项目用 GUI 打开确认无损与 Agent 测试让 AI 仅靠 CLI 完成一次真实任务。⚠️ 陷阱清单四个最常见的质量翻车点实际交付中出现的质量问题大多集中在下面四处。渲染缺口效果静默丢失。现象滤镜已写入项目文件输出却和输入一模一样。根因渲染时简单工具读取原始媒体忽略全部项目级效果。对策按 原生渲染器 → 效果转换层项目语法转渲染工具语法→ 手动渲染脚本 的优先级兜底注册表中每个滤镜必须有渲染映射或明确标注 project-only。测试跳过伪造通过。现象报告全绿上线后命令因找不到软件报错。根因测试带优雅降级依赖缺失时 mock 结果。对策软件是硬依赖缺失必须让测试失败不允许 skip。非整帧率漂移。现象29.97fps 视频时长偏差几帧且随时长累积。根因浮点帧用int()截断。对策帧转换用round()时间码显示用整数算术往返测试接受 ±1 帧容差。命名空间包被一个__init__.py破坏。现象安装第二个cli-anything-*包后互相冲突。根因cli_anything/出现__init__.py不再是 PEP 420 命名空间包。对策顶层目录保持无__init__.py各子包保留自己的。 启动清单拿到仓库后先做五件事git clone https://gitcode.com/GitHub_Trending/cl/CLI-Anything通读核心规范文档。对照libreoffice/agent-harness/样例确认目录形态与强制文件齐备。在 Agent 中执行/cli-anything 软件路径走完五个检查点。手动验证一次导出跑一条 export 命令用真实软件打开产物确认效果确实生效。用CLI_ANYTHING_FORCE_INSTALLED1跑一遍完整测试套件并确认cli_anything/无__init__.py、与已装包共存。HARNESS.md 把如何让 CLI 被 Agent 可靠使用从个人经验变成了一份可执行清单。真实软件做后端、原生文件做数据层、输出必须验证——三道关口都通过产出物才是真接口而非仿真。【免费下载链接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考