SuperAPI AI 工具集

agents-md

编程与开发

查看项目

更新于 11-18 09:39

技能介绍

用途

agents-md 用于在代码仓库中建立和维护智能体执行契约。当用户需要为仓库配置智能体、添加 AGENTS.md、审计 CLAUDE.md、让仓库对智能体友好、给智能体指令评分、精简冗长或过时的指令,或生成仅含指针的精简 AGENTS.md 时使用。该技能不适用于远程操作、凭据管理、付费、发布或部署等场景。

主要能力

  • 文件发现与可发现性调查:查找仓库中所有智能体指令文件(AGENTS.md、CLAUDE.md、CLAUDE.local.md),并调查 README、CI 配置、cursor rules、Copilot 指令等已可发现的内容,避免重复陈述。
  • 模式选择:根据仓库现状选择设置(Setup)、审计(Audit)、重构(Refactor)或精简(Lean)模式。
  • 审计评分:提供快速审计(12 项检查,目标 ≥10/12)和完整审计(49 项检查,分五类,目标 ≥91% 即 A 级),并包含自动失败判定和等级映射(A/B/C/D/F)。
  • 重构与精简:通过三项准入检查(不可从仓库文件发现、操作上重要、可执行)筛选每一行,删除通用建议、重复内容、过时命令和默认行为复述,重建根文件为严格顺序结构。
  • 从零编写:提供包含命令、陷阱、约定和引用的骨架,要求填入已验证的命令和真实陷阱,禁止原样交付骨架。
  • 工具适配:明确 AGENTS.md 为唯一事实来源,CLAUDE.md 仅在目标工具只读该文件时以符号链接方式存在;处理 @import 仅 Claude Code 支持的陷阱;推荐用 linter、git hook、CI 检查等机械手段替代散文规则。

使用方式

用户需提供仓库根路径(必需),可选提供目标工具集(默认 Claude Code、Codex、Cursor)、审计模式(quick 或 full)、目标等级、目标文件路径、范围限制和提交归属人。技能按发现文件、选择模式、设置、审计、重构、编写、提出最小差异的流程执行,所有变更需用户确认后应用,并支持通过恢复编辑前快照回滚。

适用场景

适用于需要为仓库建立智能体指令、审计现有指令质量、精简臃肿或过时文件、为多工具统一指令来源,以及为大型仓库建立分层模块级 AGENTS.md 的场景。

限制

仅进行本地可逆写入,不涉及远程、凭据、付费、发布、部署或版本控制变更。写入范围限于 AGENTS.md、CLAUDE.md(或符号链接)、CLAUDE.local.md、.claude/settings.json、.cursor/rules/*.mdc、Cursor hooks.json 及经用户确认的辅助指令文件。具体收费、价格、平台支持等事实暂未提供。