SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场ticket-driven-development

ticket-driven-development

编程与开发

查看项目

更新于 10-16 02:11

技能介绍

用途

Ticket-Driven Development 是一个面向 AI 编码智能体的工作流技能。它把一份已批准的、带依赖关系的 Markdown 工单（ticket）目录，执行成一个经过测试的集成分支。技能本身扮演控制器（controller）角色，负责调度、集成、状态与最终验收，同时为每个指导、实现或审查工作者分配一个有边界的任务，避免不必要地扩大工作者的上下文。

主要能力

  • 依赖图调度：把工单视为依赖图而非列表，只派发阻塞项已通过所需检查点的工单。
  • 有界并行：仅对确信相互独立的工单并行执行；并发写入者获得独立检出。
  • 隔离集成：始终在一个隔离的集成分支上工作，用户的主分支和脏检出保持原样。
  • 角色分工：中高风险实现工单采用“资深指导者规划 + 初级实现者执行”的配对模式；审查层级随风险变化。
  • 持久状态：以 state.json 和只追加的 ledger.md 作为运行数据库，对话记忆不被视为持久。
  • 完成佐证：来源状态声称的完成只是声明而非证据，必须对照仓库进行佐证；已佐证的工作不会被重新派发。
  • 确定性集成：使用确定性 Git 命令进行干净集成，仅在 Git 显示冲突后才启用冲突代理。
  • 修复上限：工单修复最多两轮，之后停止、拆分、升级或请求决策。

使用方式

技能以控制器身份运行，主要流程包括：

  1. 预检：要求已批准的规格或实质性请求、一个包含每工单一 Markdown 文件的本地目录，以及一个 Git 仓库。检查仓库安全（记录仓库根、当前分支、HEAD、工作树列表、脏状态），验证环境能实际运行配置的检查点，选择被忽略的运行目录（如 .scratch/<feature>/runs/<run-id>/）并用 git check-ignore 验证。
  2. 规范化与校验工单：运行 python3 <skill-dir>/scripts/index_tickets.py <ticket-dir> --output <run-dir>/ticket-index.json。遇到重复 ID、缺失字段、未解析阻塞项、依赖环或零工单索引时停止。
  3. 佐证完成声明并计算未完成工作：运行 scripts/corroborate.py --repo <repo> --index <run-dir>/ticket-index.json [--since <base-sha>] 作为脚本化首轮；控制器只裁决 needs_review 和 uncorroborated 的工单。若佐证后没有未完成工单，则停止并把该目录报告为历史记录。
  4. 创建集成分支与工作树：使用 python3 <skill-dir>/scripts/make_worktree.py --repo <repo> --path <integration-worktree> --branch agent/<feature>/integration --start <base-sha> --metadata <run-dir>/workspaces/integration.json。
  5. 初始化持久状态：按 references/recovery.md 运行 scripts/run_state.py init。
  6. 计算并分类就绪前沿：仅当所有阻塞项已集成且所需检查点通过时工单才就绪。选择顺序或并行执行，并按 references/verification-policy.md 的门槛分类配对。可用 python3 <skill-dir>/scripts/render_graph.py <run-dir>/ticket-index.json --output <run-dir>/ticket-graph.md 渲染依赖图。
  7. 派发有界指导者与实现者：配对工单先派发只读资深指导者，渲染 templates/guide-prompt.md；指导者返回 PLAN_READY、NEEDS_CONTEXT、NEEDS_SPLIT 或 BLOCKED。PLAN_READY 后派发初级实现者。使用 scripts/render_brief.py 渲染 templates/implementer-prompt.md；学徒通道工单渲染 templates/apprentice-prompt.md。工作者可以 COMPLETE、BLOCKED、NEEDS_CONTEXT、NEEDS_SPLIT 或 FAILED 结束。

技能包含按需读取的参考文档：references/ticket-format.md（解析或修复工单、准备工作者简报）、references/scheduling.md（多个就绪工单、波次规划、集成冲突）、references/verification-policy.md（风险分类、配对门槛、审查深度、服务预检、修复）、references/recovery.md（启动、恢复、协调或清理运行）、references/adapters.md（把编排映射到当前环境）。

适用场景

适用于已有已批准规格或实质性请求、并已把工作拆分为带依赖关系的 Markdown 工单目录的软件工程任务。技能负责执行工单，工单的塑造发生在技能之前；若工单缺失或实质不完整，应停止并请求工单塑造。

限制

  • 需要 Git 仓库、已批准的规格或实质性请求，以及每工单一 Markdown 文件的本地目录。
  • 工单缺失或实质不完整时停止，不自行塑造工单。
  • 工单修复最多两轮，之后停止、拆分、升级或请求决策。
  • 指导者角色有一个硬预检依赖：i-have-adhd 技能文件；未解析的依赖会在任何派发前停止运行。
  • codegraph-cli 技能是软预检依赖，缺失时不会停止运行，grep/find 仍作为回退。
  • 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。