atlassian-automation

atlassian-automation skill 概览

atlassian-automation 能做什么

atlassian-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行 Atlassian 相关操作。它适合这类工作流：agent 需要先发现当前 Atlassian tool schema，确认已有可用的 Atlassian connection，然后再执行 Jira 或其他 Atlassian 任务。相比只写一段普通 prompt，它能减少字段猜测和执行不确定性。

最适合的用户与任务

这个 skill 适合已经在使用 Atlassian 产品、并希望让 AI agent 协助处理运营类任务的团队，例如查询 issue、更新 ticket、维护项目，或执行基于工作流的 Atlassian 操作。它更适合愿意授权外部 MCP connection、并且需要可重复自动化流程的用户，而不是只想获得一次性文字建议的场景。

核心差异：先做 tool discovery

atlassian-automation skill 的主要价值，并不是提供一组固定写死的 Atlassian commands。它会指示 agent 先调用 RUBE_SEARCH_TOOLS，从 Rube MCP 获取当前 tool slugs、input schemas、execution plans 和 pitfalls。这个步骤很重要，因为 Composio 的 tool schemas 可能变化，而凭空猜字段是自动化失败的常见原因。

采用前需要考虑的事项

你需要在客户端中可用的 Rube MCP，并且需要通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit atlassian 建立一个处于 active 状态的 Atlassian connection。这个 skill 的仓库刻意保持精简：主要来源是 SKILL.md，没有额外 scripts、rules 或 reference files。当你需要一个轻量的 MCP 工作流模式时，可以安装它；如果你需要完整的 Atlassian 业务流程库，则不适合只依赖它。

如何使用 atlassian-automation skill

atlassian-automation 的安装场景

从 Composio skill collection 安装：

npx skills add ComposioHQ/awesome-claude-skills --skill atlassian-automation

然后在客户端配置中把 Rube MCP 添加为 server：

https://rube.app/mcp

这个 skill 需要 MCP capability rube。在期待它产出有用结果之前，先确认 RUBE_SEARCH_TOOLS 可以响应。接着使用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit atlassian；如果 connection 不是 ACTIVE，就完成返回的授权流程。

skill 需要哪些输入

像“update Jira”这样的弱 prompt 会留下太多未定义信息。你应该提供 Atlassian 产品范围、任务目标、标识符、约束条件，以及期望的安全行为。

更强的 prompt 模式：

Use the atlassian-automation skill. First call RUBE_SEARCH_TOOLS for the current schema. I need to update Jira issue PROJ-184 by changing status to In Progress, adding the comment “Backend investigation started,” and assigning it to [email protected]. Check the Atlassian connection before execution. If any field or transition is unavailable, stop and explain the missing requirement instead of guessing.

这样可以给 agent 足够上下文，用来发现正确 tools、校验 schemas，并避免不安全的假设。

更可靠的实际工作流

一个良好的 atlassian-automation 使用流程通常是：

1. 明确要求 agent 调用 atlassian-automation skill。
2. 在任何 Atlassian 操作前，要求先调用 RUBE_SEARCH_TOOLS。
3. 执行后续步骤时，复用 tool discovery 返回的 session ID。
4. 确认 Atlassian connection 是 ACTIVE。
5. 先执行最小且安全的操作，尤其是更新或批量变更场景。
6. 要求返回一段简短执行摘要，说明已变更的实体和未解决的事项。

对于只读任务，agent 通常可以在 schema discovery 之后继续执行。对于写操作，你需要说明它在修改 issues、comments、statuses、assignees 或 project data 之前，是否必须先请求确认。

优先阅读的仓库文件

先阅读 composio-skills/atlassian-automation/SKILL.md。它包含完整的操作模型：prerequisites、Rube MCP setup、tool discovery，以及核心工作流模式。这个 skill 文件夹中没有 README.md、rules/、resources/、references/ 或 helper scripts，因此不要期待有额外的本地示例。如果你需要更完整的 toolkit 细节，请使用 skill 中链接的 Composio Atlassian toolkit 文档。

atlassian-automation skill 常见问题

atlassian-automation 只适用于 Jira 吗？

这个 skill 通过 Rube MCP 面向 Composio 的 Atlassian toolkit，因此实际可用的操作取决于 RUBE_SEARCH_TOOLS 返回的 tools。很多用户会把它用于 Jira 风格的任务，但更稳妥的做法是在运行时发现可用的 Atlassian tools，而不是假定存在一份固定的产品列表。

它比普通 prompt 好在哪里？

普通 prompt 可能会编造 tool 名称，或使用已经过时的输入字段。atlassian-automation skill 会要求 agent 先发现当前 schemas，检查 connection 状态，并遵循返回的 execution plan。对于真实的 Atlassian 操作来说，field names、transitions 和 permissions 都很关键，因此这种方式更适合生产环境中的实际执行。

对新手友好吗？

如果你的组织已经配置好了 Rube MCP，它对新手是比较友好的。新用户需要知道：这不是一个独立的 Atlassian app，也不是一个无需授权的 automation bot。它依赖支持 MCP 的客户端、可用的 Rube，以及已经授权的 Atlassian connection。

什么时候不该使用这个 skill？

如果任务依赖 prompt 中没有表达的隐藏业务规则、涉及未经审查的批量破坏性变更，或所在环境不允许外部 MCP access，就不应使用它。如果你只是需要 Atlassian 策略建议，也不太适合；这个 skill 的价值主要体现在 agent 能实际调用 Rube MCP tools 的场景。

如何改进 atlassian-automation skill

改进 atlassian-automation prompts

更好的结果来自把业务意图转化为可执行约束。请包含 issue keys、project keys、target fields、allowed changes、confirmation rules 和 fallback behavior。例如，“move all stale tickets”风险很高；而“find issues in project OPS with status Blocked and no update in 14 days, then draft a proposed comment without posting it”更安全，也更容易验证。

避免常见失败模式

最常见的失败包括跳过 tool discovery、Atlassian connection 未激活、猜测 schemas、缺少 issue identifiers，以及写入权限不清晰。可以通过明确告诉 agent 来避免这些问题：“Search tools first, verify connection, do not infer required field values, and ask before making write changes.” 这与该 skill 的 Rube-first 设计直接一致。

根据第一次输出继续迭代

第一次运行后，询问使用了哪个 tool slug、关键 input fields、涉及哪些 entities，以及是否有被跳过的 actions。如果结果不正确，就用 RUBE_SEARCH_TOOLS 返回的具体 schema fields 或 tool recommendations 来细化下一次 prompt。对于重复性工作流，可以保存一个 prompt template，把你的 project keys、naming conventions 和 approval policy 放进去。

为团队使用扩展 skill

团队可以通过添加本地指导来改进 atlassian-automation skill，覆盖自身 Atlassian 工作流中的规则：status transition rules、required custom fields、ticket naming conventions、安全的批量上限，以及哪些情况必须人工审批。请将这些补充内容与 schema 假设分开，因为这个 skill 仍应依赖 Rube MCP discovery 来获取最新的 tool definitions。