⚡

Shortcut项目管理自动化Skill ShortcutAutomation

Shortcut自动化技能用于通过自然语言命令自动化Shortcut项目管理流程，包括创建故事、管理任务、添加评论和批量处理，提高团队协作效率和便捷性。关键词：Shortcut自动化、项目管理、自然语言命令、MCP工具、工作流程自动化、敏捷开发、任务管理。

项目管理 0 次安装 0 次浏览 更新于 3/12/2026

name: Shortcut Automation description: “在Shortcut中自动化项目管理流程——通过自然语言命令创建故事、管理任务、追踪史诗和组织工作流程。” requires: mcp: - rube

Shortcut Automation

在Claude Code中直接自动化您的Shortcut项目管理操作。创建和列出故事、添加任务和评论、批量创建故事以及导航工作流程——所有这些都无需离开终端。

工具包文档： composio.dev/toolkits/shortcut

设置

  1. 将Rube MCP服务器添加到您的Claude Code配置中，URL：https://rube.app/mcp
  2. 当提示时，通过提供的连接链接验证您的Shortcut账户
  3. 开始使用自然语言自动化您的项目管理流程

核心工作流程

1. 创建故事

向您的Shortcut工作区添加新故事，并支持完整配置。

工具： SHORTCUT_CREATE_STORY

在流程状态500000001中创建一个名为“添加深色模式支持”的功能故事，估计点数为5，标签为“前端”

SHORTCUT_CREATE_STORY的关键参数：

  • name（必需）——故事标题
  • workflow_state_id——将故事放置的流程状态ID（推荐使用，而不是project_id）
  • story_type——"feature"、"bug"或"chore"
  • description——故事正文/描述
  • estimate——数值点估计（或null表示未估计）
  • epic_id——与史诗关联
  • iteration_id——与迭代关联
  • labels——标签对象数组，包含name（以及可选的color、description）
  • owner_ids——分配给成员UUID的数组
  • deadline——截止日期，ISO 8601格式
  • tasks——内联任务数组，包含description和可选的complete、owner_ids
  • comments——内联评论数组，包含text
  • story_links——链接故事，使用verb（"blocks"、"duplicates"、"relates to"）

重要： 必须提供workflow_state_id或project_id之一，但不能同时提供。推荐使用workflow_state_id，因为Shortcut正在逐步淘汰项目。

2. 批量创建故事

在单个API调用中创建多个故事。

工具： SHORTCUT_CREATE_MULTIPLE_STORIES

创建3个错误故事：“登录页面500错误”、“购物车总计舍入问题”和“搜索结果空状态损坏”
  • 需要stories数组，其中每个元素遵循与SHORTCUT_CREATE_STORY相同的架构
  • 数组中的每个故事都需要name
  • 适用于批量导入、冲刺计划或基于模板的故事创建

3. 列出项目中的故事

检索特定项目内的所有故事。

工具： SHORTCUT_LIST_STORIES

列出项目42中的所有故事及其描述
  • 需要project__public__id（整数项目ID）
  • 可选includes_description: true以在响应中包含故事描述
  • 返回所有故事及其属性（状态、类型、估计等）

4. 管理故事任务

在故事中创建任务（清单）以跟踪子工作。

工具： SHORTCUT_CREATE_TASK

向故事12345添加一个任务“为深色模式切换编写单元测试”

关键参数：

  • story__public__id（必需）——父故事ID
  • description（必需）——任务描述
  • complete——布尔值，默认为false
  • owner_ids——分配任务的成员UUID数组
  • external_id——如果是从外部工具导入的ID

5. 添加故事评论

在故事上发布评论，用于讨论和文档化。

工具： SHORTCUT_CREATE_STORY_COMMENT

向故事12345添加评论：“已审查实现——看起来不错，但需要无障碍测试”

关键参数：

  • story__public__id（必需）——故事ID
  • text（必需）——评论正文
  • author_id——成员UUID（默认为API令牌所有者）
  • parent_id——用于线程回复的父评论ID

6. 工作流程和项目发现

列出工作流程和项目，以解析故事创建的ID。

工具： SHORTCUT_LIST_WORKFLOWS、SHORTCUT_LIST_PROJECTS

显示我们Shortcut工作区中的所有工作流程，以便我找到正确的流程状态ID
  • SHORTCUT_LIST_WORKFLOWS返回所有工作流程及其状态（ID、名称、类型）
  • SHORTCUT_LIST_PROJECTS返回所有项目及其属性
  • 在创建故事之前，使用这些工具来发现有效的workflow_state_id和project_id值

已知陷阱

  • workflow_state_id vs project_id： SHORTCUT_CREATE_STORY需要其中一者。提供两者或两者都不提供会导致拒绝。推荐使用workflow_state_id，因为项目正在被逐步淘汰。
  • 项目正在被逐步淘汰： Shortcut正在弃用项目，转向基于工作流程的组织。对新故事使用workflow_state_id。
  • 标签是内联创建的： labels数组中的标签如果不存在则会即时创建。每个标签对象的name字段是必需的。
  • 故事类型默认： 如果省略story_type，它默认为"feature"。对于错误和杂务，总是明确设置它。
  • 批量限制： SHORTCUT_CREATE_MULTIPLE_STORIES在单个请求中处理所有故事。非常大的批处理可能会超时——保持批处理在25个故事以下。
  • 故事/项目的整数ID： 故事和项目ID是整数，不是UUID。成员和组ID是UUID。混合这些格式会导致错误。
  • move_to定位： move_to字段（"first"或"last"）在流程状态内移动故事，而不是跨状态。

快速参考

工具标识 描述
SHORTCUT_CREATE_STORY 创建单个故事（需要name + workflow_state_id或project_id）
SHORTCUT_CREATE_MULTIPLE_STORIES 批量创建多个故事（需要stories数组）
SHORTCUT_LIST_STORIES 列出项目中的故事（需要project__public__id）
SHORTCUT_CREATE_TASK 在故事中创建任务（需要story__public__id、description）
SHORTCUT_CREATE_STORY_COMMENT 向故事添加评论（需要story__public__id、text）
SHORTCUT_CREATE_STORY_FROM_TEMPLATE 从模板创建故事
SHORTCUT_LIST_WORKFLOWS 列出所有工作流程及其状态
SHORTCUT_LIST_PROJECTS 列出所有项目

由 Composio 提供支持