Shortcut Automation

Shortcut Automation skill 概览

Shortcut Automation 能做什么

Shortcut Automation 是一个用于 Claude Code 的技能，可通过自然语言配合 Rube MCP server 管理 Shortcut 项目工作。它可以帮助你创建 stories、批量创建工作项、添加 tasks 和 comments、列出现有 stories，并在不离开开发环境的情况下处理 Shortcut workflow states。

最适合项目管理团队使用

Shortcut Automation skill 最适合已经在使用 Shortcut、并希望通过 Claude Code 更快完成项目管理操作的工程师、技术负责人、产品经理和交付团队。尤其适用于把规划笔记、bug 报告、sprint 目标或实现决策转换成结构化的 Shortcut stories，并补充 estimates、labels、epics、iterations 和 workflow states。

它与通用 prompt 的区别

通用 prompt 可以帮你起草 ticket 文案，但无法可靠地在 Shortcut 里执行操作。这个技能围绕 Shortcut 的具体动作设计，例如 SHORTCUT_CREATE_STORY，并支持 workflow_state_id、story_type、estimate、epic_id、iteration_id 和 labels 等参数。它的核心价值不只是写出更好的 tickets，而是通过已认证的 MCP 连接，把自然语言转换为可执行的 Shortcut 操作。

如何使用 Shortcut Automation skill

Shortcut Automation 安装与设置上下文

要使用 Shortcut Automation，请先在你的 Claude skills 环境中安装该技能，例如：

npx skills add ComposioHQ/awesome-claude-skills --skill "Shortcut Automation"

然后配置所需的 MCP 依赖。该技能需要 Rube MCP server，因此需要将 https://rube.app/mcp 添加到你的 Claude Code MCP 配置中，并在提示时认证你的 Shortcut 账号。如果认证未完成，Claude 可能能理解你的请求，但在创建或读取 Shortcut 数据时会失败。

为了可靠执行，技能需要哪些输入

使用 Shortcut Automation 时，提供结构化的 Shortcut 信息会比只给一个模糊目标更可靠。创建 story 时，尽量提供 title、story type、workflow state、description、estimate、labels、epic 和 iteration。上游技能建议优先使用 workflow_state_id 而不是 project_id，因此在让 Claude 创建正式工作项之前，先收集好你的 workspace 使用的相关 ID。

较弱的 prompt：

Create tickets for the onboarding work.

更强的 prompt：

Use Shortcut Automation to create three feature stories for onboarding. Put them in workflow_state_id 500000001, estimate each at 3 points, label them "onboarding" and "frontend", and attach them to epic_id 12345. Include acceptance criteria for each story.

首次使用时的建议流程

在一次性创建大量记录之前，先从只读或低风险操作开始。如果你的 MCP 设置支持，可以让 Claude 列出或检查现有 Shortcut stories，然后创建一个标题和 label 都很清晰的测试 story。确认输出进入了正确的 workflow state 后，再进行批量创建。对于较大的规划会话，建议先让 Claude 用 markdown 起草拟创建的 stories，人工检查名称和 estimates 后，再指示它在 Shortcut 中创建。

建议先阅读的仓库文件

这个技能本身很精简：关键文件是 composio-skills/shortcut-automation/SKILL.md。先阅读 Setup 部分，了解 Rube MCP 的要求；再阅读 Core Workflows 部分，查看支持的 Shortcut 操作和示例表达方式。当前 skill 文件夹中没有额外的 rules/、resources/、references/ 或 scripts，因此大多数实现预期都直接来自 SKILL.md 以及其中链接的 Composio Shortcut toolkit 文档。

Shortcut Automation skill 常见问题

Shortcut Automation 是用于项目管理还是写代码？

Shortcut Automation for Project Management 是它的主要使用场景。它不会自己编写应用代码，也不会自行管理你的代码仓库。它的作用是把规划和交付决策转换为 Shortcut records、comments、tasks、estimates、labels、workflow movement，以及相关的项目跟踪操作。

我需要 Shortcut 管理员权限吗？

你需要拥有一个具备相应操作权限的 Shortcut 账号。创建 stories、添加 comments 或更改 workflow 位置，都取决于你的 Shortcut workspace 权限以及已认证的 Rube MCP 连接。如果 Claude 无法完成某个操作，请检查账号权限、MCP 认证状态，以及提供的 ID 是否确实存在于该 workspace 中。

什么时候不应该使用这个技能？

不要把它作为大型 backlog 变更、敏感 roadmap 调整或可能影响线上 Shortcut workspace 的批量更新的唯一审核步骤。对于影响较大的操作，先让 Claude 起草计划，手动核对 story 列表，然后再分小批创建或更新项目。

它比手动编写 Shortcut tickets 好在哪里？

对于一次性的工作，手动录入 ticket 往往更稳妥；但对于重复性规划，它会更慢。Shortcut Automation 最适合有大量相关 stories、统一 label 规则、固定 workflow states，或需要把会议纪要快速转换为结构化 Shortcut 工作项的场景。

如何改进 Shortcut Automation skill

用更充分的上下文提升 Shortcut Automation 效果

提升 Shortcut Automation 输出质量最快的方法，是提供你的 workspace 约定。包括有效的 workflow state IDs、label names、epic IDs、iteration IDs、estimate scale、story-type 规则，以及符合团队风格的优秀 story 示例。Claude 可以推断格式，但不应该在正式工作中猜测 ID 或 ownership 规则。

避免常见失败模式

常见问题包括缺少 workflow state IDs、story types 含糊、重复 tickets、labels 错误，以及批量创建范围过大。降低这些风险的方法，是在执行前让 Claude 先总结将要进行的 Shortcut 变更。例如：Before creating anything, show a table with title, type, estimate, labels, epic_id, iteration_id, and workflow_state_id.

基于第一次输出继续迭代

Claude 起草或创建 stories 后，需要检查 acceptance criteria、dependencies 和 scope boundaries。可以继续追问，例如：Split any story larger than 5 points、Add QA tasks to each bug、Rewrite descriptions using Given/When/Then acceptance criteria，或 Move backend-only items to the backend label。这些迭代比试图在一个 prompt 里一次性得到完美 tickets，更能提升项目清晰度。

按团队工作流扩展这个技能

如果你的团队高度依赖 Shortcut，可以考虑补充本地化的团队指南，例如命名规范、默认 labels、估算规则和安全的批量上限。一个轻量的团队专用 wrapper prompt 可以让 Shortcut Automation 指南更可靠：告诉 Claude 哪些 workflow states 是安全的、哪些 epics 正在使用，以及在修改现有工作项前什么时候必须先请求确认。