SuperAPI AI 工具集

agents-md-ssot

智能体与模型

查看项目

更新于 10-16 09:44

技能介绍

用途:当用户想把 Claude Code 项目级上下文(CLAUDE.md 及可选 MEMORY/)重构为以 AGENTS.md 为单一真源(SSOT)、CLAUDE.md 退化为薄壳时使用本 skill。目标是一套真源同时供 Claude Code(经 CLAUDE.md → @AGENTS.md 引入)与原生读取 AGENTS.md 的 agent(如 Qoder)使用。

主要能力:生成工具无关的 AGENTS.md;把 @MEMORY/MEMORY.md 写入 AGENTS.md;将 MEMORY 正文去品牌化且不改目录结构与文件数;按需把触发式内容拆到 .qoder/rules/*.md;对原 CLAUDE.md 做快照并做覆盖率验证。改写遵循行宽约束,无法泛化的工具专属内容以逃生舱形式保留在 CLAUDE.md 薄壳尾部。

使用方式:在项目根(需含 CLAUDE.md)执行 python3 scripts/precheck.py <project-root> 做前置检查;Step 1 快照并分类段落;Step 2 生成 AGENTS.md;Step 3 可选拆分 .qoder/rules/;Step 4 改写 MEMORY;Step 5 生成 CLAUDE.md 薄壳;Step 6 执行 python3 scripts/coverage.py <project-root> 比对覆盖率并跑 markdownlint。

适用场景:从 Claude Code 迁移到 Qoder、双工具共存、让项目在 Qoder 中可用。

限制:不处理权限(.claude/settings.local.json)与 MCP 配置;不改 scripts/、references/、eval/;不删除 CLAUDE.md(彻底删除需用户显式确认);仅针对 Qoder 的 AGENTS.md 与 .qoder/rules/ 机制,其他 agent 约定不同;不杜撰 Qoder 未文档化的 frontmatter 字段;已有 AGENTS.md 时需用户确认后才覆盖。