Pine
9cbf4b4a8b
- 主 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。
3.3 KiB
3.3 KiB
name, description
| name | description |
|---|---|
| memory | 项目记忆库。任何开发/改动前必须先调用本技能载入记忆（总约束、各端口记忆、长期/短期/当前计划）；改动落地后必须校验、提交并更新对应记忆文件。用户提到「记忆」「进度」「开发到哪了」「上下文」或开始改动任一项目时触发。 |
记忆库（Memory）
强制流程：读记忆 → 校验基线 → 改动 → 校验 → 提交 → 更新记忆。 每次开发/改动项目前，必须先调用 /memory 载入记忆；每次改动落地，必须完成提交并更新对应记忆文件。
记忆文件一览（接口契约）
| 文件 | 作用 | 何时更新 |
|---|---|---|
.claude/memory/MASTER.md |
总约束（全局规则、不可违背项） | 规则变化 |
.claude/memory/plans/LONG-TERM.md |
长期计划（愿景 / 架构阶段 0-5） | 阶段变更 |
.claude/memory/plans/SHORT-TERM.md |
短期计划（当前迭代目标） | 迭代开始/结束 |
.claude/memory/plans/CURRENT.md |
当前计划（进行中任务、待办、上次进展） | 每次改动后 |
.claude/memory/ports/<port>.md |
各端口/子项目记忆 | 每次改动后 |
.claude/skills/memory/projects/<port>.md |
各项目约束（子skill：仓库/流程/关键路径） | 项目约定变更 |
标准工作流（6 步）
- 载入：读
MASTER.md⇒ 读CURRENT.md⇒ 读目标端口ports/<port>.md⇒ 读对应projects/<port>.md约束 ⇒ 按需读LONG-TERM / SHORT-TERM。 - 基线：在
CURRENT.md「本次改动」记录将改的文件与path:line现状。 - 改动：只改锁定范围；完成后跑编译 / 类型检查 / 相关测试。
- 提交：在该子项目仓库内中文+功能分批提交（见 MASTER 约定），不得混入根仓库或其它仓库。
- 记录：更新
ports/<port>.md（进度 / 已实现 / 已知问题 / 新锚点）与CURRENT.md（完成、下一步）；影响计划则更新SHORT-TERM / LONG-TERM。 - 收尾：如需，回写
MASTER.md规则或对应projects/<port>.md约束。
端口 → 记忆/约束文件对照
| 端口 | 记忆 | 约束 |
|---|---|---|
| 工作区/根 | ports/root.md |
projects/root.md |
| server-core | ports/server-core.md |
projects/server-core.md |
| agent-desktop | ports/agent-desktop.md |
projects/agent-desktop.md |
| park-desktop (dpm) | ports/park-desktop.md |
projects/park-desktop.md |
| compute-engine | ports/compute-engine.md |
projects/compute-engine.md |
| training | ports/training.md |
projects/training.md |
| web-official | ports/web-official.md |
projects/web-official.md |
| admin-portal | ports/admin-portal.md |
projects/admin-portal.md |
行号锚点规范
- 记忆引用一律写成
path:line（如app/routers/auth.py:145），据此可直接定位，不用概念性描述。 - 变更后行号失效：更新记忆时重新核对并沿用最新行号。
- 涉及「完成度 / 已实现 / 已知问题」必须落到具体文件与行，而非仅写“已支持 X”。
各项目约束（子skill）
见 projects/*.md。每条均含「改动必须提交 + 更新记忆」的强制条款，与仓库级 AGENTS.md / CLAUDE.md 冲突时以项目 README / AGENTS.md 与本 skill 的 MASTER 总约束为准。