Community编程与开发github.com

FlintSH/delivery

从头到尾完成软件任务,从独立工作树到实现、验证和交付,并支持可恢复的交接。适用于重大功能、缺陷修复或重构工作,尤其是在用户交接任务且期望无需监督即可获得已完成、已验证结果时。

delivery 是什么?

此技能为AI代理(如Claude Code、Codex)提供了端到端执行软件任务的标准化流程。它从创建独立Git工作树开始,确保任务隔离,然后引导代理通过实现、验证和交付阶段,同时遵循仓库规则和用户指令。该技能支持通过pstack插件集成工程手册,并保留自动化构建和测试,同时明确限制并发资源(如子代理上限为3个)。其关键价值在于将复杂的软件变更分解为结构化步骤:建立任务、实现和验证(包括与目标平台版本兼容性检查)、以及完成(包括提交、发布和上下文交接,如HANDOFF.md)。它优先使用仓库已有的测试和构建命令,并要求对行为变更提供回归覆盖,确保交付成果是经过验证且可恢复的。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/FlintSH/tinderbox/tree/HEAD/plugins/tinderbox/skills/delivery

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

交付

用户给出目标和约束条件,然后期望获得一个已完成、已验证的结果,无需监督。当前指令和仓库规则优先于以下所有内容。用户的全局指令可能添加个人细节(机器限制、产品、审查机器人、语音);请遵循它们。

建立任务

  1. 读取仓库的 AGENTS.md/CLAUDE.md、相关架构、包清单和锁定文件以及当前 Git 状态。在编辑之前,检查任务的实际分支、基准、议题和任何现有的工作树。
  2. 确定可观察的验收标准:行为、配置、兼容性、UI 打磨、测试证据以及请求的交付方式。做出合理的可逆选择;仅询问有关重大歧义的问题。
  3. 独立的重大任务需要隔离的 Git 工作树。重用任务框架已为此任务创建的工作树。不要切换或重置共享检出。如果多个代理有意共享一个工作树,则需就文件所有权和一个 Git 写入者达成一致。先前的推到主分支请求不授权新的推送。

实现和验证

  • 保持产品的身份。打磨现有界面,除非任务要求重新设计,否则不要重新设计它们。
  • 在使用新的 API 之前,检查已安装的框架和 API 版本。对于不熟悉或对版本敏感的行为,请查阅当前官方文档,如果安装了 Context7,也请查阅该文档。
  • 对于平台目标(游戏服务器、移动操作系统版本、浏览器引擎、运行时),请对照构建的实际目标和官方 API 检查兼容性。永远不要使用生产环境代替开发实例进行测试。
  • 优先使用仓库的测试和构建命令。为行为变更添加有意义的回归覆盖,然后测试受影响的集成。对于 UI 工作,无需提醒即可使用 visual-qa。
  • 在有益的情况下,并行进行独立的研究和编辑,并明确所有权。根据机器调整并发度:在运行超过一个繁重构建或渲染,或超过两个浏览器会话之前,检查 CPU 和内存。不要累积后台服务器或启动冗余的代理集群。

工程手册(pstack)

此技能保持为路由器。当安装了 Lauren Tan 的 pstack 插件时,请在任务内部使用其工程方法手册。大多数 pstack 技能仅限手动使用,因此请通过路径 <pstack>/skills/<名称>/SKILL.md 直接读取,而不是等待它们加载。在遵循任何 pstack 文件之前,每会话为您的框架读取一次适配器;它映射了 Cursor 工具、模型和路径名称。

为您的框架解析 <pstack>:

  • Claude Code:ls -d ~/.claude/plugins/cache/cursor-plugins/pstack/*/ | sort -V | tail -1。 适配器 <pstack>/docs/harness/claude-code.md。模型表 ~/.claude/rules/pstack-models.md,自动加载。
  • Codex:ls -d ~/.codex/plugins/cache/tinderbox-pstack/pstack/*/ | sort -V | tail -1。 适配器 <pstack>/docs/harness/codex.md。模型表 ~/.codex/pstack-models.md;在生成角色模型之前读取它。

如果两个路径都不存在,则表示未安装 pstack:无需它进行工作。

任务形态读取并遵循
报告的缺陷skills/poteto-mode/playbooks/bug-fix.md
测量到的缓慢,或需要推进的一个指标perf-issue.md, hillclimb.md
泄漏、旋转或闪烁;已捕获的分析数据runtime-forensics.md, trace-forensics.md
新行为;仅结构变更feature.md, refactoring.md
经验性设计分支使用 prototype.md 而不是询问用户
只读的“如何/为什么/我们确定吗”investigation.md, skills/how, skills/why
影响范围不明确的变更在编辑之前使用 skills/blast-radius
基准测试或加速声明在报告之前使用 skills/benchmark-checklist
没有可重复应用证明的项目skills/create-verification-skill(询问一次)
PR 标题、正文、发布说明在起草完成后使用 skills/unslop

手册路径位于 <pstack>/skills/poteto-mode/playbooks/ 下。在应用手册引用的每个 principle-* 叶子节点之前,先阅读它。

在 pstack 有差异的地方,以下规则胜出:

  • 交付。 PR 创建、CI 和审查保留给 pr-follow-through 和 file-pr。pstack 的 opening-a-pr、babysit 和 shipping 手册仅作为参考资料。其自主部分不授权提交、推送、合并、外部消息或超出当前请求范围的部署。
  • 资源。 arena、swarm、interrogate 和 architect 的扇出上限为三个子代理,除非用户要求更多。编写代码的通道获得自己的工作树(Claude Code 中为 isolation: "worktree",Codex 中为 git worktree add)。跳过 autopilot-full 和 orchestrate,除非用户明确要求它们。
  • 模型。 模型表将 pstack 的角色映射到框架可以访问的模型。跨提供商的审查保留给 council。
  • 缺失的 Cursor 组件。 未安装 cursor-team-kit。对于 /deslop,请在可用时使用 pr-review-toolkit:code-simplifier;对于 control-ui,使用 visual-qa 和 playwright-cli;对于 control-cli,直接运行 CLI。按照适配器的说明,用一句话跳过 Bugbot、Cursor 自动化和云代理步骤。
  • 语气。 可以按原样使用 pstack 的回复规则(短句,无长破折号,证据标签)。将其首次消息的目标重述限制为两个句子。

完成

  • 当请求包含 PR 或审查修复时,使用 pr-follow-through。
  • 仅当当前任务授权该操作时,才进行提交、推送、创建发布或合并。首先检查仓库的发布自动化;不要假设发布是如何切割的。
  • 报告实际结果:URL、测试场景、证据链接、失败以及任何真正需要用户操作的事项。未经检查,不要声明预览、平台构建、发布或审查已通过。
  • 在上下文重置或长时间等待之前,在跟踪源之外留下简洁的交接说明,例如任务的 .agent-artifacts/HANDOFF.md。包括分支/工作树、目标、已完成的更改、命令/结果、PR/头 SHA、阻塞项、拥有的文件、资源/会话名称以及确切的下一个操作。切勿包含令牌。
  • 仅停止您拥有的服务器和浏览器会话。保留有用的证据,避免删除不相关的工作树、缓存或用户工作。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能