AgentSkillsCN

update-agents-md

跨仓库维护 AGENTS.md 文件：查找并审阅所有 AGENTS.md 文件，落实各项规范与优化措施（修正过时或错误的指导内容，精简冗长表述，将大段内容拆分为独立文档并添加相关链接），同时结合当前对话中获取的新知识与背景信息，为更新内容提供简洁明了的要点汇总。适用于需要更新 AGENTS 文件、执行或全面梳理 AGENTS 更新流程，以及在整条仓库或子文件夹范围内开展 AGENTS.md 维护工作时使用。

SKILL.md
--- frontmatter
name: update-agents-md
description: Maintain AGENTS.md files across a repo: find and review every AGENTS.md, apply hygiene rules (fix outdated or incorrect guidance, reduce verbosity, split large sections into docs and link them), add newly learned context from the current conversation, and provide a concise enumerated update summary. Use when asked to update AGENTS files, run/sweep the agents update skill, or when AGENTS.md maintenance is required across a repository or subfolder.

Update AGENTS.md

Overview

Keep AGENTS.md files accurate, concise, and within size limits by sweeping the repo, updating stale guidance, and reporting changes in a short numbered list.

Workflow

1) Locate the scope

  • •Use CODEX_WORKTREE as the root if set; otherwise use the current working directory.
  • •Find all AGENTS.md files with rg --files -g 'AGENTS.md'.
  • •Read each AGENTS.md in full before editing.

2) Delegate subfolder updates

  • •If a subfolder has its own AGENTS.md and the changes are specific to that subfolder, deploy a subagent to update it.
  • •If delegation is unavailable, update it directly and note the limitation.

3) Apply hygiene rules

  • •Fix anything outdated or incorrect, even if unrelated to the immediate request.
  • •Tighten verbose sections without losing meaning.
  • •If a section grows to hundreds of lines, move it into docs/ (or an existing docs file) and link it from a single references list near the top of AGENTS.md.
  • •Do not allow any AGENTS.md to exceed 1000 lines; split content into docs and link it if needed.
  • •Keep edits ASCII unless the file already uses non-ASCII characters.

4) Add new learnings

  • •If the current conversation reveals reusable guidance, add it to the most relevant AGENTS.md.

5) Report

  • •Provide a concise enumerated list of updates made.
  • •If no changes were needed, state that explicitly.