SuperAPI AI 工具集

to-tickets

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:读取规格说明(spec),将其拆分为薄的端到端切片,每个切片可独立验证、可并行领取,并输出符合 Ticket Envelope v1 契约的工单文件。它只负责工单信封产出与 tracer-bullet 切片,不负责排期、实现、审计,也不维护单独的 Markdown schema。

主要能力:把工作切成端到端垂直切片而非横向的 schema/API/UI/测试批次;为每个切片标注 AFK 或 HITL 模式,显式声明无环依赖;把 spec 的 ## Gates 复制进每个工单,未回答的 gate 视为 open 并使工单成为 HITL;生成 docs/tickets/<spec-slug>/<NN>-<ticket-slug>.md,按确定性依赖顺序创建;每个工单正文包含 Artifact Graph(稳定 Artifact ID、Role: ticket、一个 Parent 链接),并在同一次变更中更新所属 spec 或 map 的反向 Children 链接。

使用方式:默认 skills-only 通道使用 scripts/ticket-contract.py emit|parse 的纯序列化器与解析器;Autopilot 通道使用绝对技能根下的 $TICKET_AUTOPILOT_ROOT/scripts/ticket-autopilot.py ticket-emit 原子化输出,命令为 python3 -B "$TICKET_AUTOPILOT_ROOT/scripts/ticket-autopilot.py" ticket-emit <envelope.json> <body.md> --output <ticket.md>。输出后用规范解析器回读校验信封、正文、唯一 ID、依赖链接与反向图边。Autopilot 通道在整批工单全部输出并通过校验后,只调用一次批后边界:python3 -B "$TO_TICKETS_ROOT/scripts/finalize_batch.py" <project-root> <ticket-folder> <ticket-path>...,可通过 --wiki-root <path> 传入已配置 wiki,否则使用 wiki-sync-v1 有界发现。

限制:不得手工序列化 front matter,旧输入需显式 migrate 命令;skills-only 通道止于校验后的批次交接,不隐式调用 finalize_batch.py 或启动 wiki/provider 工作,wiki 同步默认报告为 deferred;wayfinder 不拥有也不调用该钩子。资料未提供收费、价格、平台与效果信息。