make-ai-assistant
Use when integrating, upgrading, debugging, or reviewing @qfei-design/make-ai-assistant in a Make App: restricted Agent discovery, sessions, streaming, queue/stop/questions, file/image input, authenticated Service routes, and package-owned UI. Does not own Agent configuration, model behavior, generic dialogs, auth/permission policy, DSL, or deployment.
How do I install this agent skill?
npx skills add https://github.com/qfeius/make-platform-skills --skill make-ai-assistantIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides comprehensive documentation and specialized auditing tools for integrating the '@qfei-design/make-ai-assistant' library into corporate Make Apps. The included scripts perform local static analysis, verify API contracts against OpenAPI schemas, and validate UI component behavior using JSDOM. No malicious patterns, prompt injections, or data exfiltration attempts were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Make AI Assistant
本 Skill 面向 Make App 宿主。基线是正式 npm 包 0.4.6 与 Agent Public API v1(合同提交 1238c719e70ed80fd26976aedbc174bdff7998b4),Skill 版本与 npm 版本独立。旧的私有 Chat 协议不再作为新接入依据。
接入流程
- 同批安装时优先读取本技能仓库/安装根下的关联技能;若本机旧副本仍指导旧私有协议,先报告版本差异并更新对应技能,不混用。确认当前 App、认证身份、包管理器、UI → Service → Gateway 调用链及平台侧 Agent/应用内渠道配置。保留存量运行时,不因接入助手迁移 Node、包管理器或登录。
- 读 包契约,在实际消费包的 UI、Service workspace 安装并锁定官方
0.4.6,核对公开导出与类型。未来升级需重新核对契约;不得仅提高版本号或照抄其他 App。 - 读 宿主接线,在认证后的稳定 Shell 挂载
MakeAppAssistantEntry。使用/agent的createAgentClient与AgentAuthenticatedTransport;由包负责受限发现和内部 UI。宿主不再自行分页挑 Agent 或回退管理接口。 - 先更新宿主 API 文档,再按 Service 协议 和 操作清单 实现同源显式代理。完整 App 数据面为 23 项,另有 Agent Get/List 共 25 项组合;不是开放整个控制面。
- 文件/图片或流式问题读 流与附件,布局与手机入口读 UI 边界。只修负责该问题的一层,包内缺陷交由包修复,不在宿主复制状态机或 CSS。
- 按 验证与交付 做 TDD;可移植工具提供编译器 API 兼容、独立终态通知和公开 UI 夹具。运行审计、宿主 UI/Service 测试、类型检查、构建和经授权的已登录 Dev 验收,分别报告各项结果。
- 维护本 Skill 的协议或流程时,完成独立 fresh-agent forward test;缺少证据就明确记录,不能称为发布就绪。
从本 Skill 实际安装目录运行(路径可有中文与空格):
node scripts/audit-make-ai-assistant-project.mjs "<project-root>" --expected-package-version=0.4.6
UI 审计通过具备所需 API 的消费工作区编译器或显式工具工作区分析公开导入绑定,支持命名别名、namespace import 及未重新赋值的默认参数工厂;缺少能力明确失败,不要求降级 TypeScript 7 或安装全局解析器。只做静态预检,不能证明动态工厂的所有调用来源、25 项操作、身份隔离、流式恢复或模型识图。按可移植工具分别执行基础包合同、终态通知、公开 UI 及文档示例检查;一项通过不能替代其他门禁。独立测试原始合同与离线准备命令见验证与交付。
运行时消费必须在本 workspace 的 dependencies 声明 SDK;dev/peer 声明不能替代。显式纯类型引用(包括 /react)可保留原类型依赖方式,不触发 UI 接线检查;审计用现有 TypeScript 确认,无法证明纯类型时明确失败。源码按最近的 package.json 归属,父子 workspace 的依赖与 UI 绑定分别检查。已声明生产依赖且没有 /react 引用的 Service 不额外要求解析器。
消费声明检查覆盖根入口及包子路径,包括反引号动态导入;SDK 名称前缀明确的计算型模板按运行时引用处理。只引用根类型或旧 /client 不能作为新 Agent 公共合同的接入依据。解析器可用时按语法核对引用,否则仅做字面量路径预检,不声称证明动态模块来源。
必须保持的边界
- 浏览器
/api/make/app/agent/v1/**→ App Service → 已有 Make Gateway。SDK 默认是直接 Gateway 路径,Service-fronted App 必须显式设置 包含/v1的basePath;不能沿用旧版自动追加版本的假设。 MakeAppAssistantEntry负责agents.list({view:"webchat"}):0 个不展示,唯一入口打开,多个入口提示冲突;403、部署不可用、依赖失败保留错误,不伪装成无入口。入口不额外调用管理详情,不读agentType推断。- App key、资源 ID、显示名各自使用。
context.app.id是真实 App ID;不能用 appKey、Agent ID 或显示名代替。Agent key 不等于资源 agentId。 - 宿主共享认证层提供有界的原始字节传输,保持 Cookie 会话、状态、响应头、AbortSignal。只设一个 retryOwner;multipart、SSE、下载不进入普通业务 JSON 解析器。Trace 通过 Header 传递。
- 普通路由切换和关闭助手保留 client;App/租户/用户切换释放旧 client,阻止迟到结果。关闭界面不停止服务端 Task;停止、排队、追加、回执恢复由包负责。
- 只使用公开 props、launcher 插槽、主题与 styles.css。包不支持的能力不要在宿主伪造;发现包问题记录版本、最小复现、影响与责任,不自行补丁或改 node_modules。
- make-app-auth 负责登录与窄范围字节桥;make-app-service 负责路由/范围/安全错误;make-app-permission 负责 App 授权;make-app-observability 负责 Trace;makeui 负责外围 Shell;make-app-runtime 负责发布构建与 origin;make-env-setup 负责安装技能;makecli 负责获授权的平台检查与发布。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/qfeius/make-platform-skills/make-ai-assistant">View make-ai-assistant on skillZs</a>