SuperAPI AI 工具集

external-resource-context

编程与开发

查看项目

更新于 10-16 09:27

技能介绍

用途:帮助 Codex 在设计与实现工作中发现所需外部资源、记录稳定的访问方式,并在设计、规划、实现和评审时复用已记录的上下文。覆盖资源包括设计来源、设计系统、指南、视觉验证环境、数据库结构来源、迁移历史、密钥存储位置、API 架构来源、模拟环境、IaC 来源和环境配置。

主要能力:按领域加载参考文件(前端 references/frontend.md、后端或数据 references/backend.md、API 契约 references/api.md、基础设施或部署 references/infra.md,全栈加载各自相关领域)。当 docs/project-context/external-resources.md 不存在时对相关领域执行完整听证;已存在时询问保留当前轴、刷新全部轴或刷新选定轴。听证分两阶段:结构化听证按领域参考逐轴询问,收集访问或引用方式(MCP 服务器名、URL、文件路径、命令、仓库内来源、项目约定、人工确认路径或既有实现);自我声明阶段收集结构化轴之外的额外资源。

使用方式:听证完成后按 references/template.md 构建项目层内容,写入 docs/project-context/external-resources.md(必要时创建 docs/project-context/ 目录);当目标 UI Spec 或 Design Doc 存在时,更新其 External Resources Used 章节。写入失败时返回错误和预期路径,完成状态保持未决,并向调用工作流报告触及的文件路径。查找顺序:先读项目层文件,再读目标文档的 External Resources Used 章节获取功能级标识符,最后用项目层访问方法获取或检查资源。

单一来源规则:项目层掌握 URL、MCP 服务器名、文件路径、命令、密钥存储位置等环境事实;功能层列出设计节点 id、API 路径、架构名称、IaC 模块名等功能级标识符并引用项目层标签。

限制与注意:记录访问方法与功能标识符,消费方在使用时检查资源的当前内容;Codex 自定义智能体在省略 mcp_servers 时继承父级配置,需保留该继承,仅对刻意收窄的服务器级允许列表使用 MCP enabled_tools。质检清单包括各相关轴有存在指示与访问方法或标记 N/A、完成自我声明、项目层含环境事实、功能层含功能标识符与项目层标签、写入前确认已有项目层更新。官方页面未提供其它安装或收费信息。