SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场agent-md-refactor

agent-md-refactor

智能体与模型

查看项目

更新于 10-15 12:25

技能介绍

用途

Agent MD Refactor 用于重构臃肿的智能体指令文件（AGENTS.md、CLAUDE.md、COPILOT.md 等），使其遵循渐进式披露原则——把最核心的内容保留在根文件中，其余内容整理为分类清晰、通过链接引用的独立文件。

当出现以下需求时可使用该技能：

  • “重构我的 AGENTS.md” / “重构我的 CLAUDE.md”
  • “拆分我的智能体指令”
  • “整理我的 CLAUDE.md 文件”
  • “我的 AGENTS.md 太长了”
  • “为我的指令做渐进式披露”
  • “清理我的智能体配置”

主要能力（五阶段流程）

阶段 动作 输出
1. 分析 找出相互矛盾的指令 待解决的冲突清单
2. 提取 识别核心要点 根文件所需的核心指令
3. 分类 对剩余指令分组 逻辑分类
4. 结构化 创建文件层级 根文件 + 链接文件
5. 精简 标记待删除内容 冗余/含糊的指令

阶段 1：找出矛盾

识别彼此冲突的指令，例如：矛盾的风格指南（“使用分号”与“不使用分号”）、冲突的工作流指令、不兼容的工具偏好、互斥的模式。对每个矛盾，输出类似：

## Contradiction Found

**Instruction A:** [quote]
**Instruction B:** [quote]

**Question:** Which should take precedence, or should both be conditional?

在继续之前请用户裁定。

阶段 2：识别核心要点

只提取应放在根智能体文件中的内容。根文件应尽量精简，只包含适用于每一项任务的信息。

应保留在根文件中的核心内容：项目描述（一句话）、包管理器（仅当不是 npm 时）、非标准命令（自定义构建/测试/类型检查命令）、关键覆盖项（必须覆盖默认值的内容）、通用规则（适用于 100% 的任务）。

不应保留在根文件（应移入链接文件）的内容：语言特定约定、测试指南、代码风格细节、框架模式、文档标准、Git 工作流细节。

阶段 3：对其余内容分组

将剩余指令整理为逻辑分类。常见分类包括：typescript.md（TS 约定、类型模式、严格模式规则）、testing.md（测试框架、覆盖率、mock 模式）、code-style.md（格式、命名、注释、结构）、git-workflow.md（提交、分支、PR、评审）、architecture.md（模式、目录结构、依赖）、api-design.md（REST/GraphQL 约定、错误处理）、security.md（认证模式、输入校验、密钥）、performance.md（优化规则、缓存、懒加载）。

分组规则：每个文件对其主题应自包含；目标为 3–8 个文件（既不过于细碎也不过于宽泛）；文件名清晰，采用 {topic}.md；只包含可执行的指令。

阶段 4：创建文件结构

输出结构示例：

project-root/
├── CLAUDE.md (or AGENTS.md)     # Minimal root with links
└── .claude/                      # Or docs/agent-instructions/
    ├── typescript.md
    ├── testing.md
    ├── code-style.md
    ├── git-workflow.md
    └── architecture.md

根文件模板：

# Project Name

One-sentence description of the project.

## Quick Reference

- **Package Manager:** pnpm
- **Build:** `pnpm build`
- **Test:** `pnpm test`
- **Typecheck:** `pnpm typecheck`

## Detailed Instructions

For specific guidelines, see:
- [TypeScript Conventions](.claude/typescript.md)
- [Testing Guidelines](.claude/testing.md)
- [Code Style](.claude/code-style.md)
- [Git Workflow](.claude/git-workflow.md)
- [Architecture Patterns](.claude/architecture.md)

每个链接文件模板：

# {Topic} Guidelines

## Overview
Brief context for when these guidelines apply.

## Rules

### Rule Category 1
- Specific, actionable instruction
- Another specific instruction

### Rule Category 2
- Specific, actionable instruction

## Examples

### Good
\`\`\`typescript
// Example of correct pattern
\`\`\`

### Avoid
\`\`\`typescript
// Example of what not to do
\`\`\`

阶段 5：标记待删除内容

识别应彻底移除的指令。删除标准：冗余（如 .ts 项目中的“使用 TypeScript”，智能体已知）、过于含糊（“写干净的代码”，不可执行）、过于显然（“不要引入 bug”，浪费上下文）、默认行为（“使用描述性变量名”，标准做法）、过时（引用已废弃 API，不再适用）。

输出格式：

## Flagged for Deletion

| Instruction | Reason |
|-------------|--------|
| "Write clean, maintainable code" | Too vague to be actionable |
| "Use TypeScript" | Redundant - project is already TS |
| "Don't commit secrets" | Agent already knows this |
| "Follow best practices" | Meaningless without specifics |

使用方式

按上述五个阶段依次执行，并对照执行清单：

  • [ ] 阶段 1：所有矛盾已识别并解决
  • [ ] 阶段 2：根文件只包含核心要点
  • [ ] 阶段 3：所有剩余指令已分类
  • [ ] 阶段 4：文件结构已创建且链接正确
  • [ ] 阶段 5：冗余/含糊指令已移除
  • [ ] 验证：每个链接文件自包含
  • [ ] 验证：根文件少于 50 行
  • [ ] 验证：所有链接可用

适用场景

适用于智能体指令文件（AGENTS.md、CLAUDE.md、COPILOT.md 等）过长、内容混杂、存在矛盾或需要按主题拆分整理的场景。

限制与注意事项

应避免的反模式：把所有内容都留在根文件（臃肿、难维护，应拆分为链接文件）；分类过多（碎片化，应合并相关主题）；含糊指令（浪费 token、无价值，应具体化或删除）；重复默认值（智能体已知，仅在需要覆盖时才写）；过深嵌套（难以导航，应使用带链接的扁平结构）。

重构后需验证：根文件精简（少于 50 行，仅通用信息）、链接可用（所有引用文件存在）、无矛盾（指令一致）、内容可执行（每条指令具体）、覆盖完整（除被标记删除外无指令丢失）、文件自包含（每个链接文件可独立成立）。

关于该技能的收费、价格、平台支持范围等具体信息，资料中暂未提供。