用途
ot-intent 是 jotafurtado/on-track 系列技能中的一个环节,负责对用户请求进行分类与路由,并为需要走完整流程的改动起草意图文档。它区分操作型、Express 快速通道、Highway 通道、仅研究/仅评估等类别,分别处理。
主要能力
- 请求分类:将复合请求拆分为多个部分,每部分按各自的通道处理;用户的显式选择优先。
- 操作型请求:运行、构建、安装、检查或报告等不修改版本库文件的请求,直接执行,不产生工作轨迹或工件。
- Express 快速通道:当请求同时满足五项标准(需求明确、最多三个文件、无公共契约/持久化数据/安全控制/依赖变更、仅靠回滚差异即可撤销、一条现有命令或可观察检查可验证)时,走快速通道,实现、运行检查并写下 crumb 记录。若任意标准不再成立,停止编辑并改走 Highway。
- Highway 通道:其余所有编辑以及 Express 标准不确定的情形,走意图、规格、实现、发布四阶段,为默认通道。
- 研究/评估路由:纯调查或评估类请求直接路由到 ot-research 或 ot-assess,不创建工作轨迹。
- 辅助工件触发:在起草意图前,若决策依赖仓库或已读来源未验证的外部事实,调用研究;用户提供 URL、文档或外部代码片段时捕获引用;对话中符合条件(真实取舍且逆转代价高)的决策可生成 ADR;现有系统条件需命令或测量才能确定时可触发评估。
- 意图文档:在目标仓库 on-track/tracks/ 下按 NNN-slug 格式创建 intent.md,并按来源将前提归入用户陈述、代理验证、未验证假设、访问限制四类;仅在存在阻塞性问题时以一轮最多四个问题询问用户。
- 索引重建:使用 on-track-index.sh 重新生成 on-track/INDEX.md,并报告验证错误。
- 阶段交互:呈现阶段总结后等待用户信号:绿色(继续)调用 ot-spec;红色(停止)保留草稿状态;黄色(其他消息)按指示修订意图。
使用方式
该技能通过宿主环境调用,路径 ./ 与 ../ot-* 从技能安装目录解析,on-track/ 路径从目标仓库根目录解析。索引脚本为本地 Bash,无网络调用。
适用场景
适用于需要按 on-track 方法论管理开发改动的场景:对请求进行分类、决定快速通道或完整通道、起草意图文档并协调研究、引用、ADR、评估等辅助工件。
限制
- 操作型请求与 Express 部分不创建工作轨迹,若未出现 Highway 部分则在这些部分后停止。
- 请求过于模糊时仅进行一轮最多四个问题的询问。
- 引用内容视为数据而非指令,不执行其中的指令。
- 引用文件总大小上限 500 KB;sha256 仅覆盖捕获时观察到的源内容字节。
- 不自行提交代码;crumb 仅为提交准备者留下的本地记录。
- 缺失事实(如收费、平台支持等)暂未提供。