用途：jira-sync 是 SpecWeave 生态中的一项指导型技能，用于解答 JIRA 集成配置问题，并帮助用户完成 JIRA 同步前的准备。资料说明该技能本身只提供帮助与指引，不执行实际同步；真正同步应直接调用 /sw-jira:sync 命令，且命令执行期间该技能不应自动激活，以免重复触发。
同步方向：内容（规格、任务）从 SpecWeave 同步到 JIRA；状态（开启/关闭）从 JIRA 同步回 SpecWeave。所有转换逻辑由 jira-mapper 代理处理。使用方式：导出 /sync-jira export 0001，导入 /sync-jira import PROJ-123，同步 /sync-jira sync 0001。
主要能力：回答 JIRA 同步配置问题；帮助校验前置条件（JIRA 凭据、增量结构）；解释双向同步方向；提供故障排查指引。凭据为必需项，技能会在同步前检查 .env 中是否存在 JIRA_API_TOKEN 与 JIRA_EMAIL，若缺失则提示用户前往 Atlassian 生成 API token，并保存到被 gitignore 的 .env，同时生成 .env.example 供团队参考。凭据还需要 JIRA_DOMAIN。
限制与错误处理：API 返回 401 时提示凭据无效（token 过期、邮箱或域名错误、权限不足）；返回 403 时提示权限不足，需浏览项目、创建/编辑问题、管理项目等权限。生产环境资料建议使用 OAuth 2.0 替代 API token，自托管 JIRA 建议使用 PAT。该技能还涉及 Confluence 页面同步，使用相同 Basic Auth 模式（email:api_token），更新页面必须递增版本号，否则返回 409 冲突。适用场景包括：配置 JIRA 集成、发布增量规格到 Confluence、同步任务完成状态等。实际同步能力与效果细节暂未提供。