agents-md-refactor
重构已有 AGENTS.md 与相关文档,使其符合渐进披露原则、仓库事实和中文输出要求。适用于用户要求优化、精简、拆分、合并或重写现有 agent 指南时。默认保留真实有效的信息,移除模板化、过时或无证据内容,并确保根 AGENTS.md 简洁可导航。
- License 许可
- MIT
- 最近更新
- 2026-10-04
- Stars
- ★ 39
- Forks
- 4
01 前言 Front Matter
- name
- agents-md-refactor
- description
- 重构已有 AGENTS.md 与相关文档,使其符合渐进披露原则、仓库事实和中文输出要求。适用于用户要求优化、精简、拆分、合并或重写现有 agent 指南时。默认保留真实有效的信息,移除模板化、过时或无证据内容,并确保根 AGENTS.md 简洁可导航。
03 SKILL.md 正文
重构 AGENTS.md
将现有 AGENTS.md 按渐进披露原则重构为精简根文件 + 独立详情文件。
执行步骤
1. 查找矛盾
读取现有 AGENTS.md 以及它指向的相关文档,识别彼此冲突的指令。对每一处矛盾,先询问用户希望保留哪个版本,再继续。
2. 识别核心内容
只保留应放在根目录 AGENTS.md 中的内容:
- 一句话项目描述
- 包管理器(如果不是 npm)
- 非标准的构建/类型检查命令
- 真正与每一项任务都相关的全局约定
3. 标记可删除内容
识别并建议删除以下类型的指令:
- 冗余:agent 已知的通用知识(如"编写干净的代码")
- 模糊:无法执行或缺少上下文
- 过时:与仓库实际代码不符
逐一列出,等待用户确认后再删除。
4. 分组其余内容
将剩余指令按逻辑类别组织(如 TypeScript 约定、测试模式、API 设计、Git 工作流),为每个分组创建独立 Markdown 文件。
5. 创建文件结构
输出以下文件:
AGENTS.md # 极简根文件,含指向各详情文件的链接
docs/
├── backend.md # 后端架构与约定
├── frontend.md # 前端架构与约定
└── ... # 按实际分组决定
根 AGENTS.md 模板:
# AGENTS.md
[一句话项目描述]
## 关键约定
- 包管理器:[uv/npm/...]
- [其他全局约定]
## 详细文档
- [后端架构与约定](docs/backend.md)
- [前端架构与约定](docs/frontend.md)
输出语言
所有生成内容使用中文。
04 同仓库更多 Skills
triage
让 issue 和外部 PR 走过一个由分诊角色构成的状态机——分类、验证、必要时刨根问底地追问,并撰写可供 agent 使用的简报(brief)。
to-tickets
把一份计划、规格或当前对话拆解成一组曳光弹式工单,每个工单声明其阻塞边(blocking edge),发布到已配置的 tracker——本地形式下把边作为文本写进每个工单一个文件,在真实 tracker 上则用原生阻塞链接。
to-spec
把当前对话变成一份规格(spec),并将其发布到项目的 issue tracker——不做访谈,只对你们已经讨论过的内容进行综合。
to-spec-for-pm
把当前对话整理成一份面向产品经理(PM)的业务需求规格文档——用 PM 能看懂的语言,聚焦业务场景、交互流程和页面布局,不涉及技术实现细节。
to-prd
将当前对话上下文转化为 PRD 并发布到项目问题追踪器。当用户希望从当前上下文创建 PRD 时使用。
test5-implementation-coverage-reviewer
用已确认的测试矩阵 CSV 对照当前代码和已有测试,审查实现缺口、测试覆盖、偏差和后续动作。适用于代码生成后、验收前;当用户要求“用矩阵验代码”“审查实现是否满足测试矩阵”“标记实现状态/测试状态/覆盖情况”时使用。