mend-agent-rules（修改 Agent 规则）

Mend Agent Rules

This skill automates the synchronization of CLAUDE.md and AGENTS.md using AI / LLM to ensure they always reflect the current state of the repository's agents and skills.

Purpose

To provide AI agents with up-to-date instructions and context about available specialized capabilities without manual maintenance.

Instructions

1. Discovery: Scan the following directories and categorize them:

- Project Skills: All SKILL.md files in .claude/skills/ (recursive). - Agents: Agent definitions or metadata in .claude/agents/. - CRITICAL: Do NOT scan skills/ or agents/ directories at the root level. ONLY scan under .claude/.

1. Extraction: For each skill/agent found, extract:

- name: From YAML frontmatter or directory name. - description: From YAML frontmatter or first paragraph. - path: Relative path from the workspace root.

1. Target Identification: Identify documentation files and their respective markers:

- CLAUDE.md and AGENTS.md: - <!-- AVAILABLE_SKILLS_START --> and <!-- AVAILABLE_SKILLS_END --> - <!-- AVAILABLE_AGENTS_START --> and <!-- AVAILABLE_AGENTS_END --> - <!-- FRAMEWORK_DOCS_START --> and <!-- FRAMEWORK_DOCS_END -->

1. Formatting:

- Skills List: Generate a table of all discovered project skills. - Agents List: Generate a table of discovered agents.

1. Synchronization: Replace the content between the specific markers in BOTH target files.

- Update BOTH CLAUDE.md and AGENTS.md with the project skills table, agents table, and framework documentation. - CRITICAL: The framework documentation (explaining what Agent Skills are, directory structure, and guidelines) MUST be present in both files between the FRAMEWORK_DOCS markers. If it is missing from one but present in the other, synchronize it.

1. Verification: Confirm that both files are identical except for their top-level headers (# CLAUDE.md vs # AGENTS.md) and that all markers are preserved.

Markers

CLAUDE.md

<!-- AVAILABLE_SKILLS_START -->
<!-- AVAILABLE_SKILLS_END -->

<!-- AVAILABLE_AGENTS_START -->
<!-- AVAILABLE_AGENTS_END -->

<!-- FRAMEWORK_DOCS_START -->
<!-- FRAMEWORK_DOCS_END -->

AGENTS.md

<!-- AVAILABLE_SKILLS_START -->
<!-- AVAILABLE_SKILLS_END -->

<!-- AVAILABLE_AGENTS_START -->
<!-- AVAILABLE_AGENTS_END -->

<!-- FRAMEWORK_DOCS_START -->
<!-- FRAMEWORK_DOCS_END -->

Example Table Format