Help

general · First seen 2026-05-22 · Last seen 2026-10-28 · 253 mentions

Overview

Help 在开发者语境中通常指命令行工具的 --help 输出,是程序内置的使用说明入口。随着 AI 编程智能体的普及,这一传统交互方式正被赋予新角色——它不仅面向人类用户,也成为智能体理解和使用工具的重要信息源。

--help 在智能体时代的近期进展

  • Simon Willison:让 --help 输出同时作为 agent 技能:开发者 Simon Willison 提出让 --help 输出直接兼作智能体的技能说明文档,使人类与 AI 共用同一份工具说明,减少文档维护成本。
  • Google 发布 Gemini API CLI:给现有智能体调用的命令行工具:Google 面向智能体场景推出命令行工具,将 API 能力封装为可直接被现有 agent 调用的形态,此类工具的设计中,自描述式帮助信息是关键接口。
  • OpenAI 发布开源 Codex Security CLI 可 npm 安装:OpenAI 开源了可通过 npm 安装的安全审计 CLI,这类面向开发者的命令行工具通常依赖 --help 与内置文档完成上手引导。
  • Claude Code v2.1.183 更新:增强安全与稳定性修复:命令行智能体产品如 Claude Code 也在持续迭代,其 v2.1.183 版本聚焦安全与稳定性,帮助信息与内置指令的准确性直接影响智能体行为。
  • 当前焦点与观察点

    这一波讨论的核心在于:当调用工具的主体从人变成智能体,Help 的形态是否需要重新设计。传统 --help 面向熟练用户,强调参数罗列;而智能体更需要结构化、可机读的使用说明。Simon Willison 的做法提供了一种低成本路径——一份文档服务两类读者。

    值得观察的几点:一是主流 CLI 是否会逐步形成面向智能体的帮助信息规范;二是工具调用失败时,智能体能否可靠地从 Help 文本中自行纠错;三是这种“人类与 AI 共享文档”的模式会不会催生新的文档标准。短期内,让 --help 同时服务人类与智能体,仍是工程实践中务实的选择。

    Coverage

    10 on file