codex-memory-bootstrap

Category: Tools & Productivity | Uploader: AKin-lvyifang | Downloads: 0 | Version: v1.0（Latest）

当用户说“初始化这个项目记忆”，或项目进入长任务、复杂协作、跨会话续接阶段时使用。

Changelog: Source: GitHub https://github.com/AKin-lvyifang/codex-memory-lite

Directory Structure

Current level: skills.zh-CN/codex-memory-bootstrap/

📁 templates/
- 📄 component-reuse.md 366 B
- 📄 current.md 351 B
- 📄 design-rules.md 1.3 KB
- 📄 frontend-design-standards.md 9.5 KB
- 📄 frontend-page-workflow.md 3.5 KB
- 📄 project-agents-block.md 2.1 KB
- 📄 spec-index.md 1.0 KB
- 📄 tasks-index.md 337 B
- 📄 workflow-rules.md 401 B
📄 SKILL.md 2.7 KB

SKILL.md

---
name: codex-memory-bootstrap
description: 当用户说“初始化这个项目记忆”，或项目进入长任务、复杂协作、跨会话续接阶段时使用。
---

# Codex Memory Bootstrap

在需要长期协作的项目中，初始化结构化上下文目录，避免继续依赖单文件 handoff。

## 写入前校验

在创建 `.codex-memory/` 之前，先确定绝对路径变量：`PROJECT_ROOT`。

- `PROJECT_ROOT` 必须是当前会话对应的项目根目录
- 不得把 `~`、`/`、`~/.config/opencode`、`~/.codex`、skills 目录、配置目录当成项目根目录
- 如果当前目录看起来不像项目目录，或项目根目录仍不明确，先停止创建，再确认目录
- 后续所有目录和文件都必须创建在 `{PROJECT_ROOT}/.codex-memory/` 下
- 不要直接把裸相对路径 `.codex-memory/` 当成最终创建目标

## 适用场景

满足任一条件时使用：
- 用户明确说“初始化这个项目记忆”
- 当前任务会跨多个会话继续推进
- 当前任务涉及多个文件、多个页面或多个主题
- 当前项目已有 handoff/规则/历史堆积
- 当前会话已出现上下文膨胀风险

## 自然触发短语

- 初始化这个项目记忆

## 目标

创建最小可用的 `.codex-memory/` 结构，并在项目根目录建立项目级 `AGENTS.md` 管理块。

## 执行步骤

1. 检查项目根目录是否已存在 `.codex-memory/`
2. 若不存在，则创建以下结构：

```text
.codex-memory/
├── current.md
├── spec/
│   ├── index.md
│   ├── design-rules.md
│   ├── component-reuse.md
│   └── workflow-rules.md
├── tasks/
│   ├── index.md
│   ├── active/
│   └── archive/
└── archive/
```

3. 使用标准模板写入上述文件
4. 若项目根目录不存在 `AGENTS.md`，则创建项目级 `AGENTS.md`
5. 若项目根目录已存在 `AGENTS.md`，则只追加或更新"项目级上下文管理"管理块，不要破坏用户其他内容
6. 若项目中存在旧 handoff 文件，如 `codex-handoff.md`，则记录"待迁移"提示，但不要自动删除旧文件
7. 汇报初始化结果：
   - 本次使用的 `PROJECT_ROOT`
   - 已创建目录
   - 已创建文件
   - 是否发现旧 handoff
   - 是否建议下一步执行迁移

## 初始化完成后应提醒用户

- 该项目已启用 `.codex-memory/`
- 后续新会话优先读取 `current.md`
- 若存在旧 handoff，建议执行迁移而不是继续双轨维护

## 约束

- 不要自动删除旧 handoff 文件
- 不要在初始化阶段擅自迁移旧内容
- 不要把历史过程直接塞进 `current.md`
- 在 `PROJECT_ROOT` 未确认前，不要创建任何 `.codex-memory/` 目录或文件

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

codex-memory-bootstrap

Directory Structure

SKILL.md

Report

Notice