关于 atlassian
为可能已有 Atlassian 凭据的环境提供 Jira 和 Confluence 操作指引,适合需要安全执行 API 请求的任务。强调先检查凭据、优先只读查询,并在写入前确认目标与变更。
主要功能
- 01检查环境变量是否已设置
- 02针对 Jira 执行定向 REST 请求
- 03针对 Confluence 执行定向 REST 请求
- 04写入前确认目标与变更
- 05报告访问状态及最少证据
适用场景
- 01查询 Jira 问题状态与摘要
- 02搜索 Confluence 页面或空间
- 03在确认后更新问题或页面
- 04判断访问受认证、权限或网络阻碍
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ i9wa4/ dotfiles --skill atlassian安装后在 Claude Code 中输入/atlassian确认已加载。
附带文件references/api-token.mdreferences/usage.md
详细介绍
Atlassian
当任务要求使用 Jira 或 Confluence,且环境中可能已包含 Atlassian 凭据时,使用此技能。只有在确认所需变量均已设置后,才将凭据视为可用。
发送经过身份验证的 Atlassian 请求前,请阅读 用法。
1. 必需的环境变量
ATLASSIAN_SITE:Atlassian Cloud 站点 URL。ATLASSIAN_EMAIL:用于 API token 身份验证的账户邮箱。ATLASSIAN_API_TOKEN:Atlassian API token。ATLASSIAN_CLOUD_ID:Confluence API 要求 cloud id 时使用,可选。
如果缺少 ATLASSIAN_API_TOKEN,请参阅
API Token。
检查变量是否存在,而非变量值。使用参考命令或等效命令,仅输出 set 或 missing。切勿输出凭据值、授权标头、Cookie 或 shell 跟踪信息。
2. 工作流
- 访问前确认必需的环境变量已设置。不要根据 URL 推断是否有访问权限。
- Jira:针对问题、搜索、评论、状态转换或元数据使用定向 REST 调用;检查访问权限时,请求
summary,status等最少字段。 - Confluence:针对页面、搜索、评论或空间使用定向 REST 调用;只请求任务所需的正文表示形式。
- 优先先进行只读检查。进行写入操作前,确认具体的问题或页面,并概述拟执行的更改。
3. 报告
说明访问状态是可读取、被身份验证阻止、被权限阻止、被网络阻止,还是未找到。只提供最少的证据,例如 Jira 问题键/标题/状态,或 Confluence 页面 ID/标题/状态,以及 HTTP 结果。
评论
支持 Markdown