SuperAPI AI 工具集

forge-app-review

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:对 Atlassian Forge 应用做通用发布就绪审查,是广泛应用审查的入口,不替代安全、成本或调试专项技能。

主要能力:检查 manifest/module/resource/function 接线、架构与可维护性、运行时与依赖/包/脚本合理性、测试与部署准备、运维卫生,并标记明显的安全、成本、可靠性隐患以触发专项深入。

边界:深度安全审计、SAST、授权、密钥、租户隔离、可利用性、CVSS 报告应转 forge-security-review;成本优化、调用次数、GB-seconds、存储/日志量、触发频率、内存调优应转 forge-cost-optimizer;已知故障、报错、空白 UI、部署/安装失败、resolver 损坏、应用缺失、日志/隧道诊断应转 forge-debugger。广泛审查发现深层安全/成本/调试问题时,作为转交建议而非重复专项流程。

审查规则:先审计,除非用户明确要求应用修复,否则不修改应用文件;先读代码再下结论;优先给出具体文件/行证据;聚焦 bug、发布阻塞、实质风险与缺失验证;不运行完整 SAST 或成本工具;不把推测性安全或成本观察报告为已确认漏洞或节省。

模块与能力路由:检测 manifest.yml 或包依赖中声明的模块并加载对应审查指南。若应用声明 graph:connector、teamwork-graph-connector 或导入 @forge/teamwork-graph,则按 ./modules/connector-review.md 评估。

工作流:读取 manifest.yml 或 manifest.yaml;识别模块、资源、函数、resolver 绑定、触发器、web 触发器、remotes、权限、运行时与内存设置;验证引用的 handler/resource 存在;读取 package.json 检查 Forge 包适配、脚本、运行时假设、直接依赖及明显未用/缺失包;检查源码(后端/resolver 的 resolver.define、handler 导出、产品 API 调用、存储、外部请求、日志、错误处理;前端的 UI Kit 或 Custom UI 入口、invoke() 模式、bridge、加载/错误状态);检查测试与项目文档,仅在行为风险需要时指出缺失测试;产出按优先级排序的就绪报告。

检查项:发布阻塞(manifest 引用缺失 handler/资源路径/模块键、前端调用的 resolver 名与 resolver.define() 不匹配、实际 API/fetch 缺少所需 scope 或 egress 权限、运行时/包版本/模块语法可能导致 forge lint、build、deploy、install 失败、应用无明确方式走通主用户流程);架构与可维护性(模块类型匹配预期 UX 面、resolver 边界合理不过度单体、敏感或特权逻辑留在后端、UI 格式化不无谓走后端、用户流程错误处理充分、代码组织符合项目风格);轻量安全信号(宽泛/写/管理 scope 无可见用途、用户触发 resolver 中 api.asApp() 无明确授权检查、硬编码凭据或类 token 字面量、外部 fetch 无 manifest egress 条目、web 触发器无可见认证策略、完整 payload/请求日志可能暴露用户/租户/密钥数据);轻量成本信号(resolver 仅返回静态数据或产品上下文、页面加载时多次独立 invoke()、定时触发器像广泛轮询、产品触发器无过滤或 ignoreSelf、热路径完整 payload/API 响应日志、每次调用都写存储);轻量可调试性信号(异步 UI 路径缺加载/错误状态、重要失败处日志过噪或缺失、README 或脚本未说明如何 lint/build/deploy/test、除 forge lint 外无明确本地验证命令)。

输出格式:返回简洁 Markdown 报告,发现项必须用表格而非编号列表,每项含 Source 列。Source 取值:manifest、resolver、frontend、dependencies、tests、general,或模块专属标签(如 connector)。位置规则:始终引用精确 path:line 或 path:start-end,并在 Location 单元格包含产生信号的代码摘录,用 <pre><code>...</code></pre> 包裹,摘录通常不超过 15 行;缺失项展示最近的外层片段并在 Description 说明缺什么。报告含 Summary(就绪状态、最高风险领域、检查文件、专项转交)、Findings 表(Severity、Source、Finding、Location、Description、Doc、Fix,按 Critical→Warning→Info 排序)、Clean Areas、Suggested Next Step。若无发现,说明从通用审查看应用已就绪,并列出有意排除的专项审查。

限制:本技能不执行完整 SAST 或成本工具,不修改文件,不确认推测性安全/成本问题;具体命令、文档锚点与 URL 需以实际资料为准,暂未提供。