工程交付工作流 v1.0.0 MIT

Shipping Engineering Work Skill

面向 Claude Code、Codex、OpenClaw、Hermes 等 AI Coding Agent 的通用工程交付技能，让 Agent 在真实代码库里先澄清、再检查、再小步实现、最后用证据验证。

#AI Coding Agent#Claude Code#Codex#OpenClaw#Hermes#Engineering Workflow
下载技能包
复制 shipping-engineering-work 文件夹到 ~/.codex/skills、Claude Code 配置的 skills 目录、~/.openclaw/skills 或 ~/.hermes/skills

这个 skill 解决什么问题

AI Coding Agent 真正进入工程项目后，常见问题不是“不会写代码”，而是工程交付动作不稳：

  • 需求还没澄清就开始改代码；
  • 一个小 bug 被改成大范围重构；
  • 看到日志就猜根因，没有复现和证据；
  • 没跑测试就说已经完成；
  • 多个 Agent 并行时互相覆盖文件；
  • 给开源社区提 PR 时范围太大，维护者很难 review。

shipping-engineering-work 的目标，是让 Agent 在真实代码库里按一套更像工程师的节奏工作。

核心方法

它会把一个非平凡工程任务压成一个小交付合同：

  • Goal：这次到底解决什么用户可见或维护者可见的问题。
  • Scope：改什么，不改什么。
  • Evidence：用哪些代码、日志、测试、issue 或行为证明判断。
  • Plan：下一步怎么做，而不是写一堆空泛路线图。
  • Verification：用什么命令或人工检查证明完成。
  • Handoff：人类、reviewer 或上游维护者下一步需要什么。

这套结构不追求仪式感，追求的是让 Agent 少猜、少飘、少大改。

适合哪些场景

  • 修复 bug；
  • 实现小功能；
  • 调试失败测试；
  • 做代码审查；
  • 准备上游开源 PR；
  • 回应维护者 review；
  • 多 Agent 协作；
  • Claude Code、Codex、OpenClaw、Hermes 之间做任务交接。

平台兼容

这份 skill 尽量不绑定某一个 Agent runtime 的工具名，而是描述通用能力：

  • 读文件；
  • 改文件；
  • 跑命令；
  • 查看 UI；
  • 追踪计划；
  • 检查 git 状态；
  • 准备 PR 和交接材料；
  • 做 fresh verification。

因此它适合在 Claude Code、Codex、OpenClaw、Hermes 这类 CLI-first coding agent 环境里复用。

安装方式

下载 skill 包：

下载 shipping-engineering-work-skill.zip

也可以直接从 GitHub 获取：

https://github.com/kunpeng-ai-lab/shipping-engineering-work

Codex

Copy-Item -Recurse .\shipping-engineering-work "$env:USERPROFILE\.codex\skills\shipping-engineering-work"

Claude Code / OpenClaw / Hermes

把 shipping-engineering-work 文件夹放到对应 runtime 配置的 skills 目录即可。不同工具的具体路径可能不同，但核心 SKILL.md 和 references 可以复用。

推荐提示词

Use shipping-engineering-work to debug this failing test and prepare a minimal verified fix.
Use shipping-engineering-work to review this PR before I send it upstream.
Use shipping-engineering-work to hand this task from Codex to Claude Code without losing context.

里面包含什么

  • SKILL.md：核心工作流和触发说明。
  • references/workflow-modes.md：Frame、Inspect、Design、Implement、Debug、Review、Upstream 等工作模式。
  • references/agent-platform-adapter.md：不同 Agent runtime 的能力映射。
  • references/contribution-readiness.md：面向开源社区贡献时的检查点。
  • examples/bug-fix.md：bug 修复压力测试。
  • examples/upstream-pr.md：上游 PR 压力测试。
  • examples/cross-agent-handoff.md：跨 Agent 交接压力测试。

相关阅读