cli-anything

Codex 的 CLI-Anything

当用户希望 Codex 像 CLI-Anything 构建器一样工作时，请使用此技能。

先阅读完整方法论

在实现之前，请使用完整方法论的权威来源：

1. 阅读相对于此技能目录的 references/HARNESS.md。
2. 阅读 references/commands/ 下匹配的模式规范。
3. 仅当 references/guides/ 下引用的文件适用于目标时，才阅读它们。
4. 如果已安装的资源不可用，且此技能是从 CLI-Anything 仓库检出中使用，请阅读 ../cli-anything-plugin/HARNESS.md 及其周边资源。
5. 如果两个本地来源都不可用，请克隆或下载 https://github.com/HKUDS/CLI-Anything 并使用 cli-anything-plugin/HARNESS.md。
6. 仅当所有完整方法论来源都不可用时，才遵循下面的精简规则。

安装程序会将 cli-anything-plugin/ 中的规范资源内置到此技能中，因此正常的 Codex 安装是自包含的。

资源映射

路径	用途
references/HARNESS.md	完整的方法论和质量规则
references/commands/cli-anything.md	构建模式规范
references/commands/refine.md	精炼模式规范
references/commands/test.md	测试模式规范
references/commands/validate.md	验证清单
references/commands/list.md	已安装/已生成的 harness 发现
references/guides/	按需的实现指导
scripts/repl_skin.py	复制到生成的 harness 中作为 utils/repl_skin.py
scripts/preview_bundle.py	复制到支持预览的 harness 中作为 utils/preview_bundle.py
scripts/skill_generator.py	生成规范的和打包的 CLI 技能
scripts/templates/SKILL.md.template	skill_generator.py 使用的技能生成模板
references/docs/PREVIEW_PROTOCOL.md	共享预览包协议

阅读内置文档时，请应用以下路径重映射，而不是针对当前工作目录解析插件路径：

文档引用	已安装技能路径
guides/...	references/guides/...
cli-anything-plugin/repl_skin.py	scripts/repl_skin.py
cli-anything-plugin/preview_bundle.py	scripts/preview_bundle.py
cli-anything-plugin/skill_generator.py	scripts/skill_generator.py
templates/SKILL.md.template	scripts/templates/SKILL.md.template
docs/PREVIEW_PROTOCOL.md	references/docs/PREVIEW_PROTOCOL.md

输入

接受以下任意一种：

• 本地源路径，例如 ./gimp 或 /path/to/software
• GitHub 仓库 URL

如有需要，在克隆后从本地目录名派生软件名称。

模式

构建

阅读 references/commands/cli-anything.md。通过源分析、架构设计、实现、测试规划、测试实现、测试文档、CLI 特定的 SKILL.md 生成以及本地安装，构建完整的 harness。

精炼

阅读 references/commands/refine.md。盘点当前的命令和测试，将其与目标软件进行比较，然后增量添加高影响力的能力，除非用户要求破坏性变更，否则不要移除现有命令。

测试

阅读 references/commands/test.md。针对真实后端运行 harness 测试，验证已安装命令的子进程覆盖，并仅用通过的结果更新 TEST.md。

验证

阅读 references/commands/validate.md。根据完整的目录、实现、测试、文档、打包和代码质量清单验证 harness。

列表

阅读 references/commands/list.md。发现已安装和已生成的 CLI-Anything 工具，并按需支持人类可读或 JSON 输出。

精简后备规则

仅当无法获取完整方法论时使用这些规则。

Harness 结构

生成：

<software>/
└── agent-harness/
    ├── <SOFTWARE>.md
    ├── setup.py
    └── cli_anything/
        └── <software>/
            ├── README.md
            ├── __init__.py
            ├── __main__.py
            ├── <software>_cli.py
            ├── core/
            ├── utils/
            └── tests/

必需行为

• 优先使用真实的软件后端，而非重新实现。
• 提供一次性 Click 子命令和默认 REPL 模式。
• 支持 --json 机器可读输出。
• 在目标支持的情况下，添加带撤销/重做的会话状态。
• 自动保存一次性会话变更，并支持 --dry-run。
• 使用加锁的会话文件写入，避免并发 JSON 损坏。
• 复制并使用统一的 ReplSkin。
• 为具有有意义视觉或检查状态的软件添加真实的预览命令。
• 同时生成规范的和打包的 CLI 专用 SKILL.md 文件。

测试

• 在测试代码之前编写 TEST.md。
• 保留 test_core.py 用于单元覆盖。
• 保留 test_full_e2e.py 用于真实文件工作流和真实后端验证。
• 以编程方式验证渲染/导出的输出，而不仅仅是进程退出代码。
• 通过 _resolve_cli() 测试已安装的 cli-anything-<software> 命令。
• 使用 CLI_ANYTHING_FORCE_INSTALLED=1 运行发布验证。

打包

• 使用 find_namespace_packages(include=["cli_anything.*"])。
• 将 cli_anything/ 保留为命名空间包，不带顶层 __init__.py。
• 通过 console_scripts 暴露 cli-anything-<software>。
• 包含打包的 CLI 专用 skills/SKILL.md。

输出预期

在报告进度或最终结果时，包括：

• 目标软件和源路径
• 添加或更改的文件
• 运行的验证命令
• 未解决的风险或后端限制