agentleFS
PeiiiiPeiiii/nextclaw/.agents/skills/development-delivery/SKILL.md

development-delivery

Skill263 starsChanged 37 days agoMITView on GitHub

通用开发生命周期的「交付、发布与部署」阶段 owner;当结果已经达到交付条件,或用户明确要求提交、发布、部署时使用,负责授权边界、结果交接和专项发布路由,不负责实现或 Review。

The file

Files
SKILL.md

Development Delivery

目标

每个任务都交接结果;commit、push、PR、release、deploy 和不可逆操作须用户明确授权,或有当前项目可核对的既有明确授权。

进入门

进入时确认:

  • 可观察目标和交付范围;
  • 适用验证已经通过且证据未因后续修改失效;
  • 适用 Review 已无未关闭 findings;
  • 工作区中的用户或其它任务改动已经隔离;曾切换 worktree 时,已取得草稿迁移及源区查漏证据,规则、文档和复盘也已纳入本次交付范围;
  • 外部动作的对象、范围和授权明确。
  • active contract 存在时,本次交付对应 stable acceptance IDs 已明确且证据当前有效。

前置条件不成立则返工,不在 Delivery 修代码或设计。

轻量交付

用户可操作的产品变化默认执行用户验收交付,不等用户索要链接;取得当前范围有效 AI 验收结论后,按该合同交齐入口、操作与预期、验证边界和状态。未发布不是省略验收入口的理由。

没有外部发布授权时也要完成:

  • 汇报结果、证据、未验证链路、主观确认项和残余风险;
  • 判断生成物保留及项目已有的变更说明、版本记录和迭代记录是否适用;
  • 判断已形成稳定证据的用户可见结果是否需要项目内容材料;
  • 明确 commit、push、release 和 deploy 已因未授权跳过。

专项路由

提交范围、版本说明、产品发布、文档部署和 Git 主线协调以当前项目的明确合同为准。每个决策只读取当前需要的一个项目专项方法;项目没有发布合同,不把“提交成功”或“产物构建成功”称为完整发布。维护发布机制或修复发布失败时读取版本演进门。专项 owner 只完成自己的发布或交付子目标,不重新编排上游开发阶段。

博客候选门

项目有内容发布 owner,且适用 Validation/Review 已形成稳定证据时,按项目合同判断是否准备内容材料;内容发布仍遵守独立授权。

发布语义

  • 发布前明确对象、版本、环境、授权范围和可观察完成点;自然语言宏只按项目权威登记解释。
  • 外部等待只在完成点、风险、失败或需决策时更新;状态未变不发心跳。重试遵守 owning workflow 的幂等与恢复合同。
  • 一次发布按项目合同核对产物、部署、可用性和回滚或恢复;已成功的不可逆步骤不重复执行。
  • 上下文不能确定发布对象时只问一个短问题;存在“只、仅、不包含”等限制词时以更窄授权为准。

外部动作

  • 用户只要求“提交”时,只在当前任务分支精确 stage/commit;是否合并、推送及目标分支按用户授权和项目 Git 合同判断。禁止混入无关 WIP 或把隔离分支报告为主线完成。
  • 发布使用仓库既有 release flow,不以零散原子命令伪装完整闭环。
  • 发布完成必须覆盖授权范围内适用的产物、说明、部署后验证和分支状态。
  • 可恢复分叉、并行 WIP 或隔离分支只是中间状态;合入主线的任务按项目合同安全集成,不污染活跃区或要求用户手工处理本可由系统恢复的步骤。
  • 部分发布或外部失败优先进入专项恢复分支;不得重复发布已经成功的不可逆步骤。
  • active contract 下只返回 acceptance_updates 与 parent_status;artifact、版本或 release 不能完成 parent-goal,交回 lifecycle 执行 completion gate。

输出

报告范围、证据、授权与执行结果、缺口、恢复入口及残余 WIP;验收交付一次给齐入口、步骤和预期。有 active contract 时报告 stable ID 更新并返回 parent;不得把部分完成表述成全部完成。完整开发或授权发布的 Delivery 完成时,返回 parent_status=ready-for-retrospective 与交付证据,由 Lifecycle 路由复盘后再做整体完成判断;仅授权发布而直接进入 Delivery 的任务也要完成这一交接。外部发布成功、长时间等待结束或用户催促均不跳过;纯调查、设计或 Review 的限定单阶段产物不因此扩大范围。

本阶段不修改产品实现、不关闭 Review findings,也不把内部工程记录直接拼成用户 release notes。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.