feat(memory): 新增项目记忆库技能(.claude/skills/memory + .claude/memory)
- 主 skill SKILL.md:简明,指向 总约束/长期/短期/当前计划 与各端口记忆;定义强制工作流(读记忆→校验基线→改动→校验→提交→更新记忆)与 path:line 行号锚点规范。 - 总约束 MASTER.md:全局规则、仓库纪律、git 约定、进程铁律、记忆纪律。 - 计划三层:LONG-TERM(阶段0-5)/SHORT-TERM(当前迭代)/CURRENT(进行中)。 - 各端口记忆 ports/*.md:root/server-core/agent-desktop/park-desktop/compute-engine/training/web-official/admin-portal 的进度/已实现/已知问题/锚点。 - 各项目约束 projects/*.md(子skill):仓库/强制流程/关键路径/行号规范。 - CLAUDE.md 增补第 11 条:每次开发/改动必须调用 /memory 并提交+更新记忆。 - .gitignore 排除 .claude/settings.local.json。
This commit is contained in:
@@ -0,0 +1,57 @@
|
||||
# 总约束(MASTER)
|
||||
|
||||
> 全局、跨项目、不可违背。冲突优先级:**项目内 AGENTS.md/README.md 的具体规则 > 本总约束 > 本项目 CLAUDE.md 概述**。
|
||||
> 每次开发改动前先读本文件(经 /memory)。
|
||||
|
||||
## 1. 目录分桶(不可混放)
|
||||
|
||||
- `code/` 一切可运行代码 / 代码仓库
|
||||
- `design/` 项目设计与架构文档
|
||||
- `materials/` 课程内容、政策研究、园区数据等非代码资料
|
||||
- `reference/` 参考源(独立仓库,根忽略)
|
||||
|
||||
## 2. 仓库纪律
|
||||
|
||||
- 主仓库(`opc`)只管 `design/ materials/` 与根文档、全局规范;**不跟踪各 `code/*` 子项目代码,保留文件夹**。
|
||||
- `code/*` 各为独立仓库(组织 Pine);`reference/*` 独立仓库。
|
||||
- 任一子项目改动,在**各自仓库**内分批提交,不得混入根仓库或其它仓库。
|
||||
|
||||
## 3. git 提交约定
|
||||
|
||||
- 用**中文**、按**功能分批**提交,避免多文件一次提交。
|
||||
- 提交信息不允许包含 `Co-Authored-By: Claude <noreply@anthropic.com>`。
|
||||
- 先询问用户验证,通过后再提交。
|
||||
- 上线/部署相关提交由用户手动执行(`backend-deploy-by-user`)。
|
||||
|
||||
## 4. 进程管理铁律
|
||||
|
||||
- **AI 绝对禁止启动/重启/停止任何前后端服务进程**(server-core :8090、park-desktop :10085、s2s :8765、vite、Tauri 等)。
|
||||
- 需要时先通知用户,由用户亲自操作。AI 只做改代码、编译检查、接口测试(仅在服务已运行且不重启前提下)。
|
||||
|
||||
## 5. 凭据卫生
|
||||
|
||||
- `*.env*`、`*.local` 含密钥/凭据,默认 gitignore,勿提交。
|
||||
- `.claude/settings.local.json` 为本地配置,勿提交。
|
||||
|
||||
## 6. 记忆纪律(本 skill 强制)
|
||||
|
||||
- 每次开发/改动**前**调用 `/memory` 载入记忆。
|
||||
- 每次改动**后**:校验 → 提交 → 更新 `ports/<port>.md` 与 `CURRENT.md`。
|
||||
- 记忆必须用 `path:line` 锚点,可直接定位。
|
||||
- 计划变化同步 `LONG-TERM / SHORT-TERM`;规则变化同步本文件或对应 `projects/<port>.md`。
|
||||
|
||||
## 7. 后端架构标准(server-core)
|
||||
|
||||
- FastAPI **四层架构**(接口→业务→领域→基础设施),禁止反向依赖。
|
||||
- server-core 与算力调度经**内部 IP/loopback** 交互;对外算力统一走服务端 `/api/v1`。
|
||||
|
||||
## 8. UI 基调
|
||||
|
||||
- 前端设计不偏离 `code/agent-desktop/console/` 主基调;admin-portal 用 shadcn/ui(遵循 `design/installation.md`)。
|
||||
- 培训网站/小程序遵循自身「暗色粒子品牌语言」,但整体以 console 为基准。
|
||||
|
||||
## 9. 待办 / 已知落差(重要,随时更新)
|
||||
|
||||
- server-core 现状为「身份/门户演示」内核:无 `dispatcher.py`、无 `app/training` 子应用(设计与实现不符,待阶段2重构入口)。
|
||||
- 8 个 RBAC 既有失败测试(权限种子问题)**非本次引入**,待排查。
|
||||
- 若干 `/admin/*`(课程/活动/报名/测评/园区)与算力管理端点属阶段2-4,尚未实现。
|
||||
Reference in New Issue
Block a user