Shortcut Automation

Shortcut Automation - Claude Code 项目管理自动化技能

技能概述

Shortcut Automation 让您在 Claude Code 中通过自然语言命令直接操作 Shortcut 工作区，实现 story 创建、任务管理、评论添加和批量操作，无需离开终端即可完成完整的项目管理工作流。

适用场景

1. Sprint 规划与需求管理

在迭代规划会议中快速创建多个 feature story、bug story 和 chore，支持批量添加估算、标签和任务清单，自动关联 epic 和迭代，大幅提升需求录入效率。

2. 日常工作流自动化

开发过程中通过命令行快速添加 story 评论、创建子任务、更新状态，无需切换到 Shortcut 网页界面，保持编码专注度的同时保持项目追踪同步。

3. 项目批量操作与维护

进行项目整理、story 批量迁移、标签统一管理等维护工作时，通过批量创建和批量更新 API 一次性处理多个 story，避免手动逐个操作的低效流程。

核心功能

1. Story 创建与管理

支持创建单个或批量创建 story，可配置 workflow 状态、story 类型（feature/bug/chore）、估算值、标签、负责人、截止日期等完整字段，同时支持内联添加任务清单和评论，实现一次 API 调用完成 story 的完整初始化。

2. 任务清单与评论管理

在 story 下创建任务（checklist）用于追踪子工作，支持分配任务负责人和完成状态；通过评论功能进行代码评审讨论、需求澄清和团队协作，支持线程式回复构建结构化对话。

3. 工作流与项目发现

提供 workflow 状态列表和项目列表查询功能，帮助您快速定位正确的 workflow_state_id（推荐）或 project_id，解决 story 创建时的 ID 定位问题，同时支持按项目列出所有 story 及其描述。

常见问题

Shortcut Automation 需要什么前置条件？

您需要配置 Rube MCP 服务器到 Claude Code，URL 为 https://rube.app/mcp，然后通过提供的连接链接完成 Shortcut 账户授权。配置完成后即可在 Claude Code 中通过自然语言命令操作 Shortcut 工作区。

workflow_state_id 和 project_id 有什么区别？

两者用于指定 story 创建位置，但只能使用其一。workflow_state_id 是推荐方式，因为它指向具体的 workflow 状态（如 Backlog、Ready for Development）；project_id 正在被 Shortcut 弃用，未来将仅支持 workflow-based 组织。创建 story 时务必只提供其中一个字段。

Shortcut 批量创建 story 有数量限制吗？

批量操作没有硬性限制，但单次请求创建过多 story 可能导致 API 超时。建议每次批量创建控制在 25 个 story 以内，超过数量可分多次执行。批量创建时每个 story 都需要至少提供 name 字段，其他字段可选。