SuperAPI AI 工具集

surface

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:让软件对智能体更可发现、可理解、可调用、可恢复并可被评测。该技能面向产品侧、框架中立,改善的是智能体接触现有软件的接口,而非你所构建智能体的内部架构;智能体内部架构(编排、记忆、模型路由、RAG)不在本技能范围,参见 /docs/agents 与 /docs/agent-retrieval。

三条路径:Guide 讲解概念、标准与实现模式;Audit 检测项目接触面、评分并产出发现与改造计划(plan、transform 属于 Audit 模式);Scaffold 创建或扩展接触面(发现文件、API/CLI/MCP 接触面、工具契约、检索端点)及验证用的评测框架。应先读取现有项目文件,优先沿用项目自身约定。

用法要点:明确要直接产物时不必强制全量审计,可做窄范围检测后生成并说明跳过的审计范围。审计前读 references/audit-workflow.md,按需加载维度参考(api-surface、cli-design、mcp-servers、discovery-aeo、authentication、error-handling、tool-design、context-files、testing、retrievability);涉及智能体商务再加 agentic-commerce。评分每维度 0-3,N/A 仅用于确实无法暴露该接触面时;满分 30 分并据此换算评级;只评现状而非路线图。脚手架前读 references/scaffold-workflow.md;包含 init、api、cli、mcp、tool、test-harness 模式;输出遵循 AGENTS.md、public/llms.txt、.mcp.json、.well-known/* 等默认位置。

限制与注意:身份不应作为工具或 API 参数,须在服务端由认证上下文解析;认证、破坏性、生产操作属高风险,执行前需明确确认;不得覆盖已有 AGENTS.md、CLAUDE.md、llms.txt、MCP 文件,需读取合并。审计报告默认记为 Linear issue,不写入仓库。MCP 工具描述与注解仅为提示,非授权策略;检索与评分细节本资料未完整给出,具体格式以对应参考文件为准。