AgentSkillsCN

maintain-project-rules

在“.cursor/rules/”目录下审计并维护项目规则。适用于审计项目规则、检查前缀规范、同步doc/rules.md文件，或当用户询问关于“.cursor/rules”或前缀规范时使用。

SKILL.md
--- frontmatter
name: maintain-project-rules
description: Audit and maintain project rules in .cursor/rules/. Use when auditing project rules, checking prefix convention, syncing doc/rules.md, or when the user asks about .cursor/rules or prefix convention.

maintain-project-rules

Activation gate

Use if:

  • •User asks to audit or maintain project rules, check prefix convention, or sync doc/rules.md.
  • •Context involves .cursor/rules/, rule files (.mdc), or conventions from cursor-rules-principles / retro.

Source of truth

  • •cursor-rules-principles.md (in repo or ~/.cursor) – prefix table 000–500, general principles. See reference.md for full prefix table.
  • •commands/retro.md (PROJECT RULES section) – prefixes 000/050/100/200/900, flat .mdc, no subfolders in rules.

Procedure

  1. •

    Resolve paths

    • •PROJECT_ROOT: git rev-parse --show-toplevel
    • •PROJECT_CURSOR_DIR: ${PROJECT_ROOT}/.cursor
    • •PROJECT_RULES_DIR: ${PROJECT_CURSOR_DIR}/rules
    • •If PROJECT_RULES_DIR does not exist, report "No .cursor/rules in this repo" and stop.
  2. •

    Audit

    • •List all *.mdc in PROJECT_RULES_DIR (flat; no subfolders per convention).
    • •For each file: name, prefix vs principles/retro, frontmatter (description, alwaysApply, globs), line count (~<50 preferred), overlap with other rules (duplicate or near-duplicate content).
    • •Flag: missing prefix, wrong prefix slot, missing/invalid frontmatter, oversized file, duplicate content.
  3. •

    Proposals

    • •RENAME: file without numeric prefix → suggest prefix from reference.md / retro.
    • •MERGE: two or more rules with overlapping scope → suggest target file and sections.
    • •DELETE: only with clear justification (obsolete, fully merged); do not execute without user confirmation.
    • •Do not delete, move, or rename until user confirms.
  4. •

    Sync doc/rules.md

    • •If repo has doc/rules.md or docs/rules.md: update the "Context-Specific Rules" (or equivalent) list to match current .mdc files and their globs/scope. Keep doc and rules directory in sync.

Output

  • •Report: table of files (path, prefix OK?, frontmatter OK?, lines, notes); list of proposals (RENAME/MERGE/DELETE with reason and target).
  • •Closing line: "Do zastosowania: potwierdź zmiany lub wywołaj agenta rules-keeper."
  • •No destructive changes without explicit user confirmation.

Reference

For full prefix table and conventions, see reference.md.