docs: 完善项目说明和协作规则

This commit is contained in:
湛兮
2026-05-26 11:30:03 +08:00
parent 88d4578600
commit 2fcfece32b
12 changed files with 270 additions and 30 deletions
@@ -0,0 +1,20 @@
---
name: readme-structure-sync
description: Use this skill when changing files, folders, package scripts, routes, API modules, or project conventions in role-admin; it ensures README.md stays synchronized with the current repository structure.
---
# README Structure Sync
Use this skill whenever a task changes repository structure, important entry files, package scripts, routes, API modules, environment variables, or collaboration conventions.
## Workflow
1. Inspect the touched files and decide whether they affect `README.md`.
2. If directories or key files were added, removed, renamed, or moved, update the `README.md` directory map.
3. If `package.json` scripts changed, update the `README.md` important scripts table.
4. If business modules, API contracts, routes, or environment variables changed, update the matching README section.
5. Keep README descriptions short and operational: what the file or directory does, not a generic framework explanation.
## Touch-Up Rule
Do not scan the whole repository only for this skill. When a task already touches applicable files, fix obvious README drift in the same pass. If full cleanup is larger than the request, update the current workflow and top-level declarations, then call out the remaining gap.