用途:改进既有 Terse SDK job,适用于用户想修复、优化或重构已构建的自动化任务。技能以 $ARGUMENTS 传入待改进的 job 名称。
参考文档:优先使用随附的 sdk-reference.md 离线覆盖常见路径;当超出参考范围或不确定时效时,先拉取文档索引 https://docs.useterse.ai/llms.txt,再按需查阅具体页面;命令权威来源为 https://docs.useterse.ai/reference/cli。若随附参考与实时文档冲突,以实时文档为准。
主要步骤:
- 在 src/terse.jobs.ts 与 src/terse.generated.ts 中定位目标 job,读取完整实现(触发、技能、filter、handler)。generated 文件是已连接集成、触发器、技能、资源与确定性包装的权威来源,不要直接编辑,也不要运行 terse integrate list;若缺失或过期,重跑 terse generate。
- 用 terse history 拉取生产运行历史,例如 terse history "<job-name>" --json --triggers --limit 20,或加 --status failed,cancelled 筛选失败,或 terse history --run-id <run-id> --json 查看完整对话;关注失败、重复模式、被浪费的运行与 agentic 越权。若命令返回 actionRequired 的错误信封或退出码 2,应停下并转达所需下一步或 URL。未部署则跳过,改用 terse test list 的样例事件。
- 从工具使用(已知参数用 toolbox 而非 generateText)、提示词质量(具体性、事件上下文、边界情况、输出格式、长度)、事件过滤(机器人事件、草稿、特定来源、成本)、错误处理、技能配置(缺失/多余技能与范围)逐项分析。
- 编辑 src/terse.jobs.ts(或配置的 --entry-file);新增集成后重跑 terse generate。
- 本地验证:terse replay <run-id> 重放失败生产运行,或用 terse test list/show/run 针对样例事件运行。
- 运行 pnpm exec tsc --noEmit 或项目对应方式做类型检查并修复错误。
- 说明改动原因,可引用历史运行与验证命令。
- 不要自动部署,先询问用户;同意后运行 terse deploy(会同步项目中所有 job,已删除的 job 会在远端被删除)。
限制:不得搜索或读取 node_modules;不得直接编辑生成文件;非交互式运行需显式指定 job 名称;terse test 裸命令仅用于手动交互会话。具体收费、平台支持与效果等资料未提供。