ship-cli
连接Linear任务管理与jj版本控制的AI编程代理工作流CLI工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ship-cli。 它的用途是：连接Linear任务管理与jj版本控制的AI编程代理工作流CLI工具。 完整的 Skill 内容见：https://321skill.com/skills/ship-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我开始处理下一个优先级最高的开发任务。”，它会调用`ship task ready`找到无阻塞的任务，然后通过`ship task start`和`ship stack create`为你创建好对应的工作区和代码分支。或者，当你完成一个功能模块后，
对AI说：“提交我当前的修改并关联到任务BRI-123。”，它会执行`ship stack submit`和`ship task done`，自动完成代码推送、PR创建及任务状态更新。
介绍
Ship旨在解决AI编程代理（如OpenCode）在开发过程中缺乏结构化任务上下文和版本控制协同的问题。它将Linear（或Notion）的任务管理系统与jj版本控制工具深度集成，为AI代理提供清晰的工作指令，明确告知接下来该做什么、修改如何与任务关联，以及如何处理依赖关系。
使用Ship时，开发者或AI代理通过简单的CLI命令即可驱动整个开发循环：从ship task ready查看无阻塞任务，到ship task start标记开始，ship stack create创建独立工作区进行编码，再到ship stack sync同步主干变更，ship stack submit提交代码，最后ship task done标记任务完成。整个过程实现了任务状态与代码变更的自动关联。
Ship非常适合依赖AI代理进行辅助编码的开发者团队，尤其是那些已经使用Linear进行项目管理并希望引入更高效、自动化编码工作流的团队。它帮助团队规范AI代理的行为，确保代码修改始终围绕明确的任务目标展开。
使用前需确保已安装Node.js、jj以及配置好Linear（或Notion）账户。建议团队先熟悉其核心工作循环，并利用其隔离工作区特性来支持多个AI代理并行处理不同任务，避免冲突。
核心特点
与其它单纯管理任务或版本控制的工具不同，Ship的核心区别在于专为AI编程代理设计，强制将Linear任务与jj的堆叠式变更（stacked diffs）绑定，并通过`ship task ready`等命令确保AI代理只处理无依赖阻塞的任务，实现了任务管理与代码提交流程的深度、自动化集成。
注意事项
不适合未使用Linear/Notion进行任务管理或未采用jj作为版本控制工具的项目团队。
常见问题
Ship支持哪些任务管理工具？
默认支持Linear，也支持Notion作为任务管理后端。
Ship必须配合jj使用吗？
是的，其堆叠变更（stacked changes）和独立工作区等核心功能依赖于jj版本控制系统。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ship-cli/raw/index.md 读取 ship-cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ship-cli/raw/index.md（查看排版版本）