mcpField
F
forge-app-builder

forge-app-builder

github.com/atlassian开发27513 次安装1 周前更新
代码仓库

关于 forge-app-builder

面向 Forge 应用开发者，用于规划、构建和验证 Atlassian Forge 应用的 skill。它按任务加载相关指南与能力门槛，并强调查阅当前文档、最小权限和安全发布边界。

主要功能

  1. 01按意图分流任务
  2. 02查询当前 Forge 文档
  3. 03按需加载能力参考
  4. 04迭代实施与验证
  5. 05授权和发布安全约束

适用场景

  1. 01规划新的 Forge 应用
  2. 02修改现有 Forge 应用
  3. 03发布前验证应用变更
  4. 04处理权限、存储或运行时决策

MCP 相关

Forge MCP 可用时，skill 优先用它获取当前平台指南，按目的发现能力并调用最相关的能力。MCP 不可用或内容不足时，则查询精确的官方文档。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/atlassian/forge-skills --skill forge-app-builder

安装后在 Claude Code 中输入/forge-app-builder确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
package-lock.json
package.json
README.md
agents/
openai.yaml
evals/
evals.json
evals/fixtures/existing-ui-kit-app/
manifest.yml
package.json
evals/fixtures/existing-ui-kit-app/src/
frontend.jsx
index.js
references/
apis-permissions-and-egress.md
backend-and-events.md
create-new-app.md
custom-ui.md
distribution-and-access.md
documentation-routing.md
environments-and-configuration.md
extend-existing-app.md
module-selection.md
plan-only.md
storage-and-residency.md
ui-kit.md
validation-and-release.md
scripts/
__init__.py
create_forge_app.py
deploy_forge_app.py
forge_env.py
list_templates.py
tests/
__init__.py
test_create_forge_app.py

详细介绍

Forge 应用构建器

让每个请求只经过其所需的分支和能力门控。保持平台事实实时更新，并让本地指导聚焦于安全决策。

保持这些不变量

  1. 在确定平台语法、模块、API、作用域、限制、运行时、包、生命周期状态或 CLI 标志之前，先检索当前官方 Forge 指导。
  2. 每个新的可部署应用都要用 forge create 注册；绝不要手工构建应用身份，也不要用未注册的脚手架替代失败的创建。
  3. 在规划或编辑现有应用及其仓库说明之前，先检查它们。保留无关的用户更改。
  4. 绝不要在聊天中请求或接受凭据。使用相关的交互式 CLI 或安全配置流程。
  5. 未经明确授权和确认目标，绝不接受 Forge 条款或计费同意、部署、安装、升级、提升、设置生产变量或更改线上站点。
  6. 对照准确的当前参考并使用 forge lint 验证每一处清单更改。
  7. 使用最小权限，并避免不必要的出口流量、特权后端操作和迁移。
  8. 为此技能运行的 Forge CLI 命令加上前缀 ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-app-builder；排除用户运行的 forge login 和 forge tunnel。

路由主要意图

在加载实现指导之前选择一个主要路由：

意图路由
仅限架构、可行性或实现计划阅读 references/plan-only.md；在变更前停止
创建可部署应用阅读 references/create-new-app.md
在现有应用中添加或更改行为阅读 references/extend-existing-app.md
已知错误、失败命令、空白 UI、日志或意外行为路由到 forge-debugger
广泛的部署前或发布就绪审查路由到 forge-app-review
深度安全审查或静态分析路由到 forge-security-review
成本或平台消耗优化路由到 forge-cost-optimizer
Teamwork Graph 连接器路由到 forge-connector

当诊断或审查只是当前构建工作的附带事项时，继续在此处进行。如果路由不明确，先检查工作区再询问用户。

为所选路由奠定基础

在需要当前平台细节时，阅读 references/documentation-routing.md。只要可用，就优先使用 Forge MCP。按用途发现其当前能力，而不是假设工具名称永久不变，并在依赖 Web 文档或记忆中的平台知识之前，调用最窄的相关能力。当 MCP 不可用、失败或缺乏所需的确切覆盖范围时，以及在进行关键验证时，使用有针对性的官方 Atlassian 文档。

当广泛的定向有用时，调用通用 Forge 开发指南。当任务只需要一个已知的叶子参考时，不要仅仅为了满足仪式而调用它。在依赖确切的模块、清单属性、端点、作用域或 CLI 页面之前，先检索它们。

按条件激活能力门控

仅加载所请求的结果和观察到的代码所涉及的参考文档：

触发条件阅读
选择或添加扩展点或模块references/module-selection.md
实现或更改 UI Kitreferences/ui-kit.md
实现或更改 Custom UI 或 Framereferences/custom-ui.md
添加解析器、函数、事件、调度、队列、Web 触发器、应用 REST API、实时或运行时服务references/backend-and-events.md
调用或公开 Atlassian、Forge 应用或外部 API；使用提供程序或远程；更改权限范围、授权或出口references/apis-permissions-and-egress.md
持久化数据或影响租户、生命周期、迁移或驻留references/storage-and-residency.md
配置环境、运行时变量、密钥或清单插值references/environments-and-configuration.md
更改跨产品兼容性、未授权访问、许可、共享或分发行为references/distribution-and-access.md
验证、部署、安装、升级或移交references/validation-and-release.md

对于无头应用，不要加载 UI 指南；对于无状态功能，不要加载存储指南；对于仅使用 UI Kit 的更改，不要加载 Custom UI 指南；在验证或授权发布变得相关之前，不要加载发布指南。

迭代地实现并验证

在进行非平凡编辑之前，先明确所请求的结果、受影响的 Forge 表面、有重大影响的设计选择，以及相称的验证方法。在实现之前，解决会影响授权、数据处理、兼容性、生命周期状态、成本或实时状态的决策。

以连贯的增量进行工作。每次有意义的更改之后，使用最相关的可用证据来评估它，例如针对性测试、类型检查、前端构建、处理器或资源检查，或 forge lint。根据风险、反馈成本和现有代码库选择增量大小和验证频率；当单独验证相关编辑几乎没有额外价值时，将它们合并处理。

当验证失败或与假设相矛盾时，找出原因，当涉及 Forge 行为时检索当前准确的文档，调整实现，然后再次验证。持续进行，直到所请求的行为和受影响的接线得到验证，或者进展需要用户输入或不可用的外部状态。

当有更强的本地验证可合理获得时，不要仅将成功的生成、编译或 lint 视为功能可用的证明。将机密和特权工作排除在前端代码之外。将显示条件视为展示控制，而非授权。除非需要迁移或明确授权，保留受支持的现有约定和不相关的更改。

安全地验证并停止

除非用户请求发布工作，否则在本地验证后停止。对于已授权的发布工作，在执行之前立即确认确切的 app、环境、站点、产品、版本或升级行为，以及预期范围或数据影响。

评论

支持 Markdown