用途
Forge App Debugger 用于诊断和修复 Atlassian Forge 应用中的各类问题。它是一份按顺序执行的排查清单，目标是尽快定位根因并直接修复，避免在找到根因后继续浪费 token 和上下文。
主要能力
该技能覆盖以下故障类型：
- 部署期错误（forge deploy 失败）
- 运行时错误（应用崩溃、resolver 报错、返回错误数据）
- 可见性问题（应用已部署但不显示）
- 空白 UI / Custom UI 不渲染
- 开发环境正常但生产环境失败
- 权限拒绝 / 403
- 410 Gone / 端点废弃
- 处理器路径 lint 错误
- resolver 返回 undefined 但无报错
- 多重故障（部署错误 + 运行时错误）
它内置了一张“常见错误模式”对照表，将错误信息或症状直接映射到根因与修复方式，命中后可直接应用修复，无需进一步排查。
使用方式
技能按步骤推进：
- 分类错误：先判断是部署期、运行时还是可见性问题，并给出快速路由表。
- 版本检查：运行
forge --version与npm show @forge/cli version，若落后于最新主版本则升级。 - Lint：运行
forge lint，先修复所有错误再继续；manifest 相关报错优先 lint。 - Custom UI 构建检查：若存在 static/ 目录，检查
static/build/是否在最近部署前构建，必要时执行cd static && npm run build && cd ..后重新部署。 - 部署状态：运行
forge deploy -e development --verbose确认部署成功。 - 日志：运行
forge logs -e development --limit 100读取日志；若无日志，在 resolver 入口添加调试日志后重新部署并触发。 - 生产问题：询问受影响的 Atlassian 站点，运行
forge logs -e production --site <customer-site> --limit 100；注意生产日志可能延迟最多 2 分钟。 - 清理：移除调试语句与 verbose 标志，最后再跑一次
forge lint，必要时重新部署。
技能要求执行者自行运行诊断与修复命令，而不是把命令交给用户；唯一例外是需要交互式终端的命令（forge login、forge tunnel）必须由用户在自己的终端运行。自行运行的 forge 命令需加上前缀 ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-debugger。若无法全局安装 forge CLI，可用 npx @forge/cli 作为替代。
适用场景
适用于使用 Forge CLI 开发 Atlassian 云应用（如 Jira、Confluence）的开发者，在遇到部署失败、运行时异常、界面空白、权限或端点废弃等问题时使用。
限制
- 需要交互式终端的命令（
forge login、forge tunnel）必须由用户自行运行。 - 生产日志可能延迟最多 2 分钟。
- 若以上步骤均无法解决，需运行
forge logs -e development --verbose --limit 200获取扩展输出，查阅 Forge changelog 中的已知问题，或记录日志中的 traceId 提交给 Atlassian 支持。 - 认证失败时需用户在 https://id.atlassian.com/manage/api-tokens 创建 API token 并在自己的终端运行
forge login。 - 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。