SuperAPI AI 工具集

agent-instructions

智能体与模型

查看项目

更新于 10-16 05:53

技能介绍

用途:为指定编码智能体生成最小集合的指令文件,使其在仓库中安全、准确地工作。先阅读仓库事实,再提问;区分已执行命令与仅在文档中发现的命令。

任务类型:创建不存在的指令;改进单个已有文件;整合重复或冲突的指令文件;为某个包或子树添加作用域指令;将共享仓库事实翻译给多个智能体运行时。按请求和现有惯例推断目标,仅在影响安装范围或运行时行为时询问,用户未要求时不创建并行厂商文件。

目标原生形式:AGENTS.md 用于遵循目录作用域 AGENTS 指令的智能体;CLAUDE.md 用于 Claude Code 项目记忆;.cursor/rules/*.mdc 或仓库既有 Cursor 惯例;仅当子树需要明显不同的命令、归属或边界时使用嵌套文件。

盘点作用域:写入前用 rg --files 查找 AGENTS.md、CLAUDE.md、.cursor/**、README*、CONTRIBUTING*、Makefile、justfile、package.json、pyproject.toml、Cargo.toml、go.mod,记录目录、运行时、继承范围与冲突,遵循最近作用域指令,不在每个嵌套文件重复根指引。

证据映射:读取建立项目目的、语言、框架、运行时版本、工作区边界、安装/开发/构建/lint/类型检查/测试/发布命令、入口与领域逻辑位置、生成文件/迁移/凭据/部署配置等高风险区域、命名与测试格式约定、所需服务与环境变量端口及启动顺序。优先清单、脚本、CI 与可执行配置;来源冲突时报告并采用控制实际执行的来源。不粘贴完整目录树,仅在影响导航、编辑或验证时列出路径。

命令验证分级:已执行、部分验证、仅文档记录、过时或冲突。可行时运行安全相关检查,不为升级标签启动长期服务、变更外部系统、安装依赖或执行破坏性命令。

输出契约:交付所需指令文件、说明其管辖目录与运行时的范围摘要、带验证标签的命令表、已解决/保留/待决策的冲突、因未验证或易变而有意省略的事实。保持文件可快速扫读。

验证:重读每个适用文件确认优先级一致;确认路径、脚本名、包名、端口、环境变量名均有仓库证据;重跑安全验收命令或准确标注;确认嵌套文件仅含作用域差异且不与继承规则矛盾;对照现有有效文件、已安装校验器或当前官方运行时文档检查语法,否则标注为未验证。报告验证结果与局限,不把仅文档记录的命令称为已测试。

限制:本技能依赖仓库证据与可执行环境,具体命令、冲突与验证结果取决于实际仓库;关于收费、价格、平台等信息资料暂未提供。