refac-cli-push-down

用途：识别智能体提示词中嵌入的机械计算，并将其“下沉”到经过测试的 CLI 命令中，从而降低提示词复杂度、提升可靠性和可测试性。核心原则是：需要理解含义的工作留在智能体；机械变换则交给 CLI 命令。\n\n适合下沉的内容包括解析与校验（URL、格式、路径）、数据提取（JSON/YAML、过滤）、确定性操作（文件查询、转换）、减少 token（压缩、预过滤）；应保留在智能体中的包括语义分析（总结、命名）、内容生成、复杂推理、决策与规划。\n\n识别信号：提示词中出现内联 bash 解析 JSON 或构造命令、多步 shell 管道、markdown 中的条件分支、字符串操作、数据转换、跨命令重复的机械序列，或程序性步骤超过约 100 行。\n\n使用步骤：定位机械段落；设计 JSON 契约（顶层含 success: bool，失败含 error，并包含后续步骤所需数据）；用项目 CLI 框架（Click、argparse、Typer 等）编写子命令并输出 JSON；先写测试，覆盖正常、错误和边界情况并 mock 外部依赖；在 CLI 组中注册；把提示词中的机械块替换为一次 CLI 调用；对比前后行数验证 token 减少。\n\n限制与反模式：不要过度下沉成大量零散小命令（逻辑少于约 30 行且只被一处调用时可考虑合并）；输出不要过于简陋，应包含下一步决策所需全部数据；不要下沉需要语义判断的工作；不要忽略 JSON 契约。命令与代码示例保持原始形式，例如 @click.command()、mytool pr-triage --repo {{repo}} --json。具体框架适配细节和完整实现需参考原始资料。