用途:本技能针对 Make App 宿主中集成、升级、调试或审查 @qfei-design/make-ai-assistant 的场景,负责宿主集成契约,而非包内 UI 或状态机。
主要能力:指导读取 references/package-integration.md 等参考文档,完成包解析、公共类型与 React props 对接;通过宿主认证的 AuthenticatedTransport 创建公共 /client,分页发现唯一当前 App 的 app_internal Agent,并调用 createMakeAppAssistantTransport({ client, agentId, signal })。SDK 负责 v1 DTO、解码、重试、上传、SSE 与 UI 传输映射。仅暴露 18 个 Make App v1 Service 操作,转发前校验 App 范围、方法/路径/查询/正文、同源 Origin、大小与上游目标。使用公开导入并只导入一次 styles.css。
使用方式:先检查宿主包管理器、认证 shell 与身份、共享认证适配器、UI/Service 路由、权限、运行时源、测试与既有集成,保留稳定调用链。新装或升级时查询 registry,安装最新发布包并核对锁文件精确版本、导出映射与声明。采用 TDD:先写失败契约/行为测试,最小实现,再重构。运行静态审计命令:node skills/make-ai-assistant/scripts/audit-make-ai-assistant-project.mjs <project-root> --expected-package-version=<resolved-exact-version>,期望版本为实际安装解析结果而非范围。
限制:浏览器请求使用同源 /api/make/app/ai/v1/,SDK 自动追加 /v1,勿重复;本地预览上游为 make_api_origin + /api/make/app/ai/v1/,发布 Service 为配置的 Make Gateway origin + /make/app/ai/v1/**。不得添加独立 Agent Gateway origin、token 或硬编码 Agent ID。Selected App Agent 须 agentType === "app_internal" 且 appKey 精确当前值;零个或多个匹配须失败。当前适配器不携带 Artifact,不要承诺 Artifact UI。面板关闭是本地 UI 状态,非远程运行取消。静态预检通过不能证明 18 个操作、运行时正确性或部署就绪。包版本与技能版本独立;后端契约核对不可用时应报告运行时兼容性未验证。