CLI-Anything

使用该技能操作工作区中本地的 CLI-Anything/ 仓库，并将其方法论转化为 OpenClaw 中可直接调用的能力。

该技能的用途

适用于以下三种常见场景：

1. 评估可行性 — 检查目标应用/仓库，判断 CLI-Anything 是否适配；
2. 复用现有 harness — 使用仓库中已预构建的 agent-harness 示例之一；
3. 封装为 OpenClaw 能力 — 将 CLI-Anything 的指导方案或已有 harness 转化为 OpenClaw 技能/工作流。

本地事实源

预期仓库路径为：

• /root/.openclaw/workspace/CLI-Anything

必要时请优先阅读以下文档：

• CLI-Anything/README.md — 平台总览与示例说明
• CLI-Anything/cli-anything-plugin/HARNESS.md — 生成方法论与质量标准
• CLI-Anything/cli-anything-plugin/README.md — 插件行为规范及预期输出结构

如需快速了解所有内置示例，可查阅 references/bundled-harnesses.md。

核心工作流

1) 对用户请求进行分类

判断适用路径：

• 方法论类请求：用户希望整体理解或应用 CLI-Anything 方法论
• 现有 harness 类请求：用户希望使用或演示内置示例（如 GIMP 或 LibreOffice）
• 封装类请求：用户希望获得基于 CLI-Anything 衍生的 OpenClaw 技能或 ClawHub 包

2) 检查前提条件

在承诺执行前，请确认以下事项：

• Python 3.10+
• 若使用真实 harness 后端，则需确认目标软件已安装
• 明确请求类型属于：
  • 构建 harness
  • 运行生成的 CLI
  • 封装/发布

3) 优先复用已有 harness，而非从头生成

若仓库中已存在匹配的 /agent-harness/ 目录，请以其为基准，无需假装必须从零开始生成。

4) 面向 OpenClaw 封装时，须分离方法与实现

CLI-Anything 本身并非原生 OpenClaw 技能包。在适配过程中需注意：

• OpenClaw 的 SKILL.md 应聚焦于何时使用及如何导航本地仓库
• 将大段方法论内容移至参考资料中
• 除非已实际完成集成，否则不得声称 /plugin 或 /cli-anything 等 slash 命令可在 OpenClaw 内直接调用

实践指南

当用户希望使用现有内置 harness 时

1. 定位 /agent-harness/ 目录
2. 阅读其 setup.py、包结构及本地 README/SOP 文件
3. 识别对真实软件后端的硬性依赖
4. 仅按需安装或验证 Python 依赖项
5. 校验 CLI 入口点及一个最小可用命令

当用户希望将新应用改造为 agent-native 时

将 CLI-Anything 视为方法论，而非魔法：

1. 分析后端引擎、数据模型及现有 CLI/API 接口
2. 定义命令分组与状态模型
3. 新建或完善 agent-harness/
4. 添加测试用例及 TEST.md
5. 将生成的包安装至 PATH
6. 验证真实后端执行效果，而非仅限 mock 行为

当用户希望获得 OpenClaw 技能时

推荐两种输出形式：

• 方法类技能：指导 OpenClaw 如何在本地仓库中使用 CLI-Anything
• Harness 类技能：封装某一个已生成的 CLI 或某一具体软件目标

除非用户明确要求单一应用工作流，否则默认采用方法类技能。

规则

• 除非你已创建对应封装，否则不得声称 CLI-Anything 已是原生 OpenClaw 技能。
• 在验证 CLI 入口点及真实后端依赖前，不得承诺生成的 CLI 可正常运行。
• 将第三方生成的代码视为可审查输出，而非自动可信输出。
• 对外发布前，须获得用户明确意图授权。
• 若面向 ClawHub 封装，请保持技能轻量，通过引用本地文档替代将大量说明直接粘贴至 SKILL.md 中。

实用脚本

使用 scripts/inspect_cli_anything.py 快速检查本地仓库并枚举所有内置 harness。该脚本以 JSON 格式输出以下信息：

• 仓库是否存在
• 已发现的 harness 列表
• 每个 harness 是否包含 setup.py、包目录、README 及端到端测试

执行命令：

python3 /root/.openclaw/workspace/skills/cli-anything/scripts/inspect_cli_anything.py

使用 scripts/recommend_harness.py 对内置 harness 进行排序，并推荐适合首次验证的目标。

执行命令：

python3 /root/.openclaw/workspace/skills/cli-anything/scripts/recommend_harness.py

常用本地路径

• 仓库根目录：/root/.openclaw/workspace/CLI-Anything
• 插件文档目录：/root/.openclaw/workspace/CLI-Anything/cli-anything-plugin
• 示例 harness 目录：/root/.openclaw/workspace/CLI-Anything/*/agent-harness

参考文件

• references/bundled-harnesses.md — 内置示例速查索引
• references/openclaw-adaptation-notes.md — 将 CLI-Anything 思路封装为 OpenClaw 技能的方法说明
• references/validated-example-gimp.md — 首个经本地验证可运行的示例