feat: 补齐后端 agent skill 规范

- .agents: 新增中文提交与注释同步 skill 及项目索引

- AGENTS.md: 增加本地 skill 入口并保留 README 同步规则

- README.md: 同步 Agent skill 目录说明
This commit is contained in:
湛兮
2026-06-11 17:48:08 +08:00
parent efa71ede6d
commit e9931a0923
5 changed files with 163 additions and 1 deletions
+23
View File
@@ -0,0 +1,23 @@
# access-manage Agent Skills
本目录存放 `access-manage` 的项目级 Agent skill。规则参考 SeaCloud 项目的 agent skill 组织方式,并按当前 Fastify、TypeScript、mysql2 和学习型后端项目场景保留最小必要规范。
## 使用入口
1. 进入仓库后先读 `AGENTS.md``RTK.md`
2. 创建或修改代码文件时,使用 `header-comment-sync` 保持中文文件头、导出声明和复杂逻辑注释同步。
3. 提交或推送代码时,使用 `chinese-commit-message` 生成英文 type 前缀加中文摘要的 commit message。
4. 目录、关键文件或脚本发生变化时,继续使用 `readme-structure-sync` 同步 README。
5. 所有 skill 的触达文件补齐规则只处理本次任务相关文件,不要求为了单次任务全仓扫描。
## 当前项目事实
- 应用类型:门店员工权限管理后端。
- 技术栈:Fastify、TypeScript、mysql2、zod、@fastify/jwt
- 关键边界:保持 controller、service、repository 分层,不引入 ORM。
## Skill 索引
- `header-comment-sync`:中文文件头、导出声明、复杂逻辑和风险边界注释。
- `chinese-commit-message`:中文提交信息格式。
- `readme-structure-sync`README 与目录结构同步规则。