该技能记录一种减少提示词复杂度、提升可靠性并使智能体工作流可测试的模式:需要理解含义的内容保留在智能体中,机械性转换则下沉到 CLI 命令。适合编写或审查嵌入 bash 的斜杠命令,或当技能/命令变得过于复杂时使用。
用途与适用场景:识别提示词中的机械计算并迁移到代码,如解析/校验(URL、格式、路径)、数据提取(JSON/YAML、过滤)、确定性操作(文件查询、转换)、令牌压缩与预过滤等;而语义分析、内容生成、复杂推理、规划与决策等应保留给智能体。
主要能力与理由:令牌减少,可将提示词缩小 50%–70%;可测试性,CLI 命令可单元测试并覆盖边界;可靠性,具备类型安全、结构化 JSON 输出与确定性行为;可组合性,逻辑可被多个技能复用。
使用方式:先定位机械段,再定义 JSON 契约(顶层含 success 布尔值,失败含 error,并包含后续所需数据),然后用项目 CLI 框架编写子命令,输出 JSON 到 stdout,编写测试并注册到命令组,最后用单次 CLI 调用替换提示词中的机械块并验证令牌减少。必要命令保持原样,如 gh pr list --repo {{repo}} --json number,title,state,headRefName。
限制与注意事项:避免过度拆分导致命令泛滥(若逻辑不足约 30 行且仅一处调用,可考虑合并);输出应完整,避免后续额外调用;不要下沉语义工作;必须遵守一致的 JSON 契约;示例未提供具体安装命令与平台信息,暂未提供。