AgentSkillsCN

reflecting

在完成各项变更后，及时审查并更新项目所有文档。适用于完成新功能、重构代码，或当文档可能已过时时使用。

SKILL.md
--- frontmatter
name: reflecting
description: "Review and update all project documentation after making changes. Use after completing features, restructuring code, or when documentation may be stale."
disable-model-invocation: true
user-invocable: true
argument-hint: "[summary of recent changes, or leave blank to auto-detect]"

Reflecting — Update Project Documentation

After completing significant features or structural changes, review and update all project documentation.

Steps

  1. •

    Read current state of all docs and source files:

    • •README.md, CLAUDE.md, AGENTS.md
    • •wrangler.jsonc, src/worker.js (scan routes), public/index.html (scan version + features)
    • •All files in .claude/skills/
  2. •

    Check README.md:

    • •Features list matches what's implemented
    • •Project structure matches actual file tree
    • •Environment variables table is complete
    • •API endpoints table is complete
    • •Setup instructions are accurate
    • •No references to deleted files or old architecture
  3. •

    Check CLAUDE.md:

    • •Quick Commands section is current
    • •Architecture section matches actual structure
    • •API Routes table matches src/worker.js
    • •Environment variables table is complete
    • •Common Gotchas section covers new patterns
    • •External APIs section is current
  4. •

    Check AGENTS.md:

    • •Code conventions match current patterns
    • •Feature-adding instructions are accurate
    • •Any new patterns or conventions documented
  5. •

    Check skills in .claude/skills/:

    • •Frontend skill: UI patterns, color scheme, element caching still accurate
    • •Backend skill: routing pattern, helper imports, caching still accurate
    • •This skill: checklist still complete
  6. •

    Check version: Ensure <meta name="app-version"> was bumped if index.html changed

  7. •

    Cross-check consistency: Ensure these are in sync across all docs:

    • •API routes table (README.md, CLAUDE.md, backend skill)
    • •Environment variables table (README.md, CLAUDE.md)
    • •Project structure / file tree (README.md, CLAUDE.md)
    • •iOS 12 constraints (CLAUDE.md, frontend skill)
    • •Version bumping instructions (CLAUDE.md, frontend skill)
  8. •

    Apply updates to any files that are out of date

  9. •

    Ask the user if they want to commit and push the documentation updates