القائمة
初始化轻量级项目记忆系统。创建 CLAUDE.md、AGENTS.md、LOOP.md、BUGS.md 与 .mem/ 文件。初始化后日常维护规则已嵌入 AGENTS.md（通过系统提示词持续生效），无需重复调用本 skill。仅用于初始化、记忆状态查询、压缩清理。默认中文。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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:
当用户问"记忆状态"或"当前记忆有什么"时：
当记忆文件过长时：