SuperAPI AI 工具集

conventions

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:为自然语言编程产物定义跨工具通用约定基线,无论产物面向 Claude Code、Codex CLI 还是 Antigravity,评分或撰写时均适用。工具专属叠加层(conventions-claude、conventions-codex、conventions-antigravity)加载在此通用基线之上。

主要能力:

  1. SKILL.md 跨工具开放标准。由 Agentic AI Foundation 托管,权威参考 https://agentskills.io/specification。必填 frontmatter:name(1-64 字符,小写加连字符,须与父目录同名)、description(1-1024 字符)。可选:license、compatibility(最多 500 字符)、metadata、allowed-tools。正文建议不超过 500 行,含范围说明并用 plugin:skill 交叉引用;规范对正文无格式限制,不应因缺少 ## Output 等分节而扣分。支持目录 scripts/、references/、assets/,采用渐进式披露。
  2. AGENTS.md 作为规范通用记忆文件。Codex CLI 原生读取;Antigravity/Gemini CLI 通过 context.fileName 数组读取;Claude Code 以一行的 CLAUDE.md 写 @AGENTS.md 导入。多工具项目推荐根目录放 AGENTS.md 作为规范内容。
  3. 通用提示工程:分层顺序(角色/上下文/任务/约束/输出格式)、少样本示例、正向表述、明确输出格式。
  4. 模糊量词 R01:惩罚 appropriate、relevant、as needed 等无界量词;有可衡量标准、命名范围或同一产物先前定义的选择规则时可豁免。
  5. 通用命名约定:文件名 kebab-case,技能引用 plugin-name:skill-name,环境变量 SCREAMING_SNAKE,端口径引用用插件根环境变量(Claude 为 ${CLAUDE_PLUGIN_ROOT},Codex 为 ${PLUGIN_ROOT}),避免硬编码绝对路径。
  6. 规则覆盖文件(如 .claude/nlpm.local.md):frontmatter 支持 strictness、score_threshold、rule_overrides,覆盖类型包括 suppress、enabled、max_penalty、threshold、min_examples、vocabulary_skill。
  7. MCP 工具命名 mcp__<server-name>__<tool-name>。

适用场景:跨工具评估或撰写 SKILL.md、AGENTS.md、命令、智能体与提示词产物。

限制:不涵盖工具专属模式、惩罚表、反模式目录及 NL 编程产物之外的通用软件工程约定;智能体工作流程序(agent workflow program)尚无专属惩罚规则;Antigravity 覆盖文件路径截至 2026-06-18 待定。