cli-docslisted
Install: claude install-skill raystyle/project-evo
# cli-docs - CLI 对外面双标准:README 与 agent 面
> 仓无关标准件:人类面(README)与 agent 面(手册、协议、帮助面、自省、裸调用)各一套可拷改配方。发现通道与 token 经济学设计面在同插件 code-kit 的 tool-cli-agents(互引不重述),编译打包发布流水线在 build-release。正文与模板零私有名,实现出处只在仓内 diary 留档。
## 一、意图路由
| 你要做的事 | 入口 |
| --- | --- |
| 写或改 CLI 的 README(结构与写法) | `references/readme-standard.md` 加 `references/templates.md` 第一节 |
| 给 CLI 配 --llms 手册面 | `references/agent-face.md` 第一节加 `references/templates.md` 第二节 |
| 定旗标全家与信封协议(类型化 CTA) | `references/agent-face.md` 第二节加 `references/templates.md` 第三节与第四节双语言模板 |
| 定默认帮助面(节序与对齐与同源) | `references/agent-face.md` 第三节加 `references/templates.md` 第四节帮助输出示例 |
| 做命令自省与漂移守卫 | `references/agent-face.md` 第四节加 `references/templates.md` 第五节 |
| 定裸调用面(无参进入形) | `references/agent-face.md` 第五节加 `references/templates.md` 第三节裸调用示例 |
| 发现通道怎么选(--llms 与 mcp 与市场) | 同插件 code-kit 的 tool-cli-agents |
## 二、双面速览
**甲面 README 四节骨架**(研究四标杆定稿):项目介绍(定位加特性加演示)到部署(全平台安装)到配置(配置文件加环境变量)到使用(教程式示例加集成);可选尾节排障与开发与许可
**乙面 agent 五件**:
1. `--llms` 手册面:裸出 markdown 紧凑手册至多 120 行,`--llms --json` 出机器形,`--llms-full` 全量变体可选;活命令树渲染禁手维护
2. 输出协议:**必选旗标七件**(--filter-output、--format、--full-output、--help/-h、--llms、--json、--schema)加可选扩展件(llms-full、mcp、token 三件、update、version、config)按需显式裁剪;信封 `{ok, data|error, meta}`;**类型化 CTA** 进 meta(字符串或 command/args/options/description 折算,CLI 名自动前缀),人读渲染 `Suggested commands:` 块同源;错误 stderr 单行 JSON,退出码 0/1/2
3. **默认帮助面**:节序定稿(头行 name@version、Usage synopsis、Arguments、Options、Examples、Global Options 字典序枚举全值默认后缀弃用前缀、Environment Variable