Menu
初始化轻量级项目记忆系统。创建 CLAUDE.md、AGENTS.md、LOOP.md、BUGS.md 与 .mem/ 文件。初始化后日常维护规则已嵌入 AGENTS.md（通过系统提示词持续生效），无需重复调用本 skill。仅用于初始化、记忆状态查询、压缩清理。默认中文。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | project-memory-cn |
| description | 初始化轻量级项目记忆系统。创建 CLAUDE.md、AGENTS.md、LOOP.md、BUGS.md 与 .mem/ 文件。初始化后日常维护规则已嵌入 AGENTS.md（通过系统提示词持续生效），无需重复调用本 skill。仅用于初始化、记忆状态查询、压缩清理。默认中文。 |
你负责维护一个轻量级项目记忆系统。它用于跨 agent、跨 session 的代码项目协作。
目标是让新 session 快速知道：
核心原则：
读得快，写得少，只记录会影响下一次 agent 判断的内容。
默认使用中文回复和维护记忆文件，除非用户或项目要求英文。
在仓库根目录维护：
project-root/
├── CLAUDE.md
├── AGENTS.md
├── LOOP.md
├── BUGS.md
└── .mem/
├── project.md
├── state.md
├── decisions.md
└── handoff.md
职责：
CLAUDE.md：Claude Code 入口，只导入 AGENTS.mdAGENTS.md：共享项目规则入口BUGS.md：轻量 bug 队列LOOP.md：长期目标和循环约束.mem/project.md：稳定项目事实.mem/state.md：当前进度和下一步.mem/decisions.md：长期 ADR 决策.mem/handoff.md：跨 session 交接记录本 skill 的核心职责是初始化记忆系统。初始化完成后，AGENTS.md 中已包含完整的工作规则、更新原则、协作规则和安全规则——这些规则通过 CLAUDE.md → @AGENTS.md 作为系统提示词持续生效。日常更新 .mem/state.md、BUGS.md、.mem/handoff.md 等操作由 AGENTS.md 驱动，无需重复调用本 skill。
仅在以下场景调用本 skill：
注意：如果项目缺少记忆文件，但用户没有明确要求初始化，不要擅自创建整套记忆系统。可以简短提醒用户此项目适合初始化项目记忆。
只有当用户明确要求初始化项目记忆时，才创建完整记忆系统。
用户要求初始化时：
CLAUDE.mdAGENTS.mdLOOP.mdBUGS.md.mem/project.md.mem/state.md.mem/decisions.md.mem/handoff.mdCLAUDE.md 写入一行：@AGENTS.mdREADME.mdpackage.jsonpyproject.tomlrequirements.txtpnpm-lock.yamldocker-compose.ymlDockerfileMakefilesrc/tests/.mem/project.md。未知，统一放到 To Verify。.mem/handoff.md 登记当前 session。.mem/decisions.md 添加 ADR-001，说明采用该项目记忆系统。.env 内容。每个 session 启动时创建唯一代号：
<agent>-YYYYMMDD-HHMM-<short-id>
示例：
claude-20260504-0930-a1b2
codex-20260504-0942-b8c1
agent-20260504-1010-k7d3
如果代理身份未知，用 agent。
非平凡工作开始前读取：
AGENTS.mdBUGS.md.mem/project.md.mem/state.md.mem/decisions.md.mem/handoff.mdLOOP.md不要把全部记忆内容复述给用户，除非用户明确要求。
默认只更新最相关的文件，不要每次都同时改所有记忆文件。
更新触发条件：
.mem/state.md：有实质进展、阻塞或下一步变化.mem/handoff.md：暂停、结束、切换上下文或交接BUGS.md：发现、修复、验证或延后 bug.mem/decisions.md：做出长期架构/工具/接口决策.mem/project.md：稳定事实变化LOOP.md：用户给出长期目标、循环目标或持续约束.mem/handoff.md 是弱协作信号，不是严格锁。
如果看到其他近期 active session：
.mem/handoff.md 的 Messages 里留下说明如果某个 session 的 Last Seen 超过 2 小时，除非备注明确说明仍在工作，否则默认视为 stale，不阻塞当前工作。
如果只有自己工作：
.mem/state.md 的全局状态BUGS.md 是轻量队列，不是完整 issue 系统。
优先级：
P0：阻塞构建、启动、测试、数据完整性或关键流程P1：严重功能缺陷P2：重要但不阻塞P3：小问题、优化、清理状态：
opendoingfixedverifieddeferredwontfix规则：
Fixed。.mem/decisions.md 只记录长期决策。
应该写 ADR 的例子：
不应该写 ADR 的例子：
LOOP.md 默认可以是 inactive。
只有当用户要求：
才更新 LOOP.md。
LOOP.md 不应覆盖最新用户指令。最新用户指令优先。
记忆文件是明文，可能进入 git。
不要保存：
.env 内容如果用户要求保存这些内容，说明风险并拒绝写入记忆文件。
如果记忆与代码冲突：
如果记忆与最新用户指令冲突：
文件优先级：
AGENTS.mdLOOP.mdBUGS.md.mem/decisions.md.mem/state.md.mem/handoff.md.mem/project.md@AGENTS.md
# AGENTS.md
## 角色
你是一个 AI 编码代理，负责在本仓库中进行小而正确、可验证的代码修改。
默认使用中文回复用户并维护项目记忆，除非用户或项目另有要求。
## 项目记忆系统
本仓库使用轻量项目记忆系统：
```text
project-root/
├── CLAUDE.md
├── AGENTS.md
├── LOOP.md
├── BUGS.md
└── .mem/
├── project.md
├── state.md
├── decisions.md
└── handoff.md
非平凡修改前读取：
AGENTS.mdBUGS.md.mem/project.md.mem/state.md.mem/decisions.md.mem/handoff.mdLOOP.mdBUGS.md 中相关 P0/P1 缺陷。.mem/state.md。.mem/handoff.md。BUGS.md。.mem/decisions.md。.mem/project.md。LOOP.md。<agent>-YYYYMMDD-HHMM-<short-id>。.mem/handoff.md 是弱协作信号，不是严格锁。Last Seen 超过 2 小时，除非备注明确说明仍在工作，否则默认视为 stale。.mem/handoff.md 留下协调说明。不要在记忆文件中保存 API key、密码、token、私钥、.env 内容、生产密钥或敏感个人信息。
完成有意义工作后，简要说明：
---
### 13.3 LOOP.md
```markdown
# LOOP
## Status
No active loop goal.
## Objective
-
## Done Criteria
- [ ]
## Constraints
-
## Procedure
1. Read `AGENTS.md`, `BUGS.md`, and `.mem/`.
2. Check current objective and constraints.
3. Pick the highest-impact next task.
4. Handle relevant P0/P1 bugs first.
5. Make one small verifiable change.
6. Run the smallest useful verification.
7. Update the relevant memory file.
8. Stop when done criteria or stop conditions are met.
## Stop Conditions
- Done criteria are complete.
- The next step requires user input.
- Verification fails and the cause is unclear.
- Continuing would require risky or broad architectural changes.
- Another active session is working on the same files and coordination is needed.
## Last Updated
-
# BUGS
轻量缺陷队列。开始有意义任务前检查相关 P0/P1 bug。
Priority: P0 blocking, P1 serious, P2 important, P3 minor.
Status: open, doing, fixed, verified, deferred, wontfix.
## Open
### BUG-YYYYMMDD-001 — Title
- Priority: P1
- Status: open
- Owner: unassigned
- Area:
- Symptom:
- Repro:
- Notes:
## Fixed
### BUG-YYYYMMDD-000 — Title
- Fixed by:
- Verification:
- Notes:
# Project Memory
稳定项目事实。只记录已验证、会影响后续开发判断的信息。
## Summary
-
## Verified Facts
-
## Tech Stack
-
## Architecture
-
## Commands
- Install:
- Dev:
- Test:
- Build:
- Lint:
- Typecheck:
## Known Pitfalls
-
## To Verify
-
## Last Updated
-
# Current State
## Goal
-
## Now
-
## Progress
- [ ]
## Blockers
- None
## Next
1.
## Workstreams
- default: unassigned / idle / -
## Last Updated
-
# Decisions
只记录会影响未来开发路径的长期决策。
## ADR Index
- ADR-001 — YYYY-MM-DD — Use lightweight project memory — accepted
## ADR-001 — Use lightweight project memory
- Date: YYYY-MM-DD
- Status: accepted
- Owner: session-id
- Context: 项目需要跨 agent、跨 session 共享状态、缺陷、决策和交接信息。
- Decision: 使用 `CLAUDE.md`、`AGENTS.md`、`LOOP.md`、`BUGS.md` 和 `.mem/` 组成轻量项目记忆系统。
- Alternatives:
- 全局个人记忆
- 数据库存储
- 不保存项目记忆
- Consequences:
- agent 能更容易接力和协作
- 需要保持记忆精简并避免保存敏感信息
# Handoff
跨 session 交接记录。它是弱协作信号，不是严格锁。
如果某个 session 的 `Last Seen` 超过 2 小时，除非备注明确说明仍在工作，否则默认视为 stale，不阻塞当前工作。
## Active Sessions
| Session | Last Seen | Status | Area | Note |
|---|---|---|---|---|
| session-id | YYYY-MM-DD HH:mm | active | startup | initialized |
## Messages
- YYYY-MM-DD HH:mm — from -> to: message
## Log
### YYYY-MM-DD HH:mm — session-id
- Did:
- Changed:
- Verified:
- Blocked:
- Next:
当用户问"记忆状态"或"当前记忆有什么"时：
当记忆文件过长时：