用途:这是一个 Jira 管理技能,用于运行两种有边界的 Jira 管理工作流:项目 Components 的调和/同步(components 模式),以及 Atlassian 实例迁移(instance-migration 模式)。
主要能力与用法:每次运行只选择一种模式,且只加载该模式的参考文件——components 对应 references/components.md,instance-migration 对应 references/instance-migration.md,两者绝不合并。模式由 $ARGUMENTS 的第一个 token 决定;若其匹配模式路由表中的模式,该 token 即模式,其余参数原样转发;无法匹配则必须先询问用户,不能根据“fix Jira”“sync Jira”等模糊请求自行推断。原来的 jira-components 与 jira-instance-migration 命令名仅作为触发短语保留。
操作约束:任何 Jira 操作前需先加载 /acli,仅当所选参考要求时才加载其他工具技能。缺少 MCP 或 Jira 凭据须硬停止,指明确切环境变量、指向 .env / .env.example,并要求重启 agent 会话,不得绕过或部分运行。每次变更前必须先读取实际状态,未获同一次运行中的用户明确批准,不得创建、应用、删除或重新指向任何内容。components 流程为:派生并检查 → 编写计划文件 → dry-run → 等待明确批准 → 才可 --apply。instance-migration 流程为:解析并确认两个实例 → 审计并验证可达性 → 等待明确批准 → 才可更改文件或 acli 会话。~
限制与注意:Atlassian 主机只应存在于 .agents/project.yaml 的 issue_tracker.atlassian_url,.env 或进程环境中陈旧的 ATLASSIAN_URL 应删除而非更新。acli 会话位于 ~/.config/acli 且为机器全局,重新登录会改写该主机上所有仓库的指向。若 project_name 为 null,说明是未接入的模板仓库,应保持 atlassian_url 与 project_key 为 null 并在报告中说明,不得伪造提交。只运行所选模式的验证步骤。关于具体费用、支持平台、完整步骤清单,资料暂未提供。