longkeep-context
/longkeep-context
把项目的上下文放进每个 agent 会话都会读的文档里。要写说明性文档(计划、报告、调研、指南、审阅、笔记)或要找以前的文档时使用:它规定文档放在 docs/ 下哪里、怎么找。也用于给项目的文档做体检,搭建或整理项目契约(CLAUDE.md / AGENTS.md)、决策日志(DECISIONS.md)和 agent 的记忆索引(MEMORY.md),以及用户问长项目怎么和 AI agent 一起做不走样(审查、上下文隔离、并行子 agent、思考强度、个人习惯放哪)。用户说「写个计划」「X 的报告放哪了」「Y 当时怎么定的」「给这个项目建 CLAUDE.md」「开个决策日志」「给项目的文档做个体检」时使用。Keep project context in documents; where docs go under docs/ and how to find them; CLAUDE.md, DECISIONS.md, MEMORY.md; project checkup.
- Author
- wingsofsky ↗
- Repository
- longkeep ↗
- Licence
- Apache-2.0
- Last repository change
- 30.10.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 30.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
把项目的上下文放进每个 agent 会话都会读的文档里。要写说明性文档(计划、报告、调研、指南、审阅、笔记)或要找以前的文档时使用:它规定文档放在 docs/ 下哪里、怎么找。也用于给项目的文档做体检,搭建或整理项目契约(CLAUDE.md / AGENTS.md)、决策日志(DECISIONS.md)和 agent 的记忆索引(MEMORY.md),以及用户问长项目怎么和 AI agent 一起做不走样(审查、上下文隔离、并行子 agent、思考强度、个人习惯放哪)。用户说「写个计划」「X 的报告放哪了」「Y 当时怎么定的」「给这个项目建 CLAUDE.md」「开个决策日志」「给项目的文档做个体检」时使用。Keep project context in documents; where docs go under docs/ and how to find them; CLAUDE.md, DECISIONS.md, MEMORY.md; project checkup.
Original author description
把项目的上下文放进每个 agent 会话都会读的文档里。要写说明性文档(计划、报告、调研、指南、审阅、笔记)或要找以前的文档时使用:它规定文档放在 docs/ 下哪里、怎么找。也用于给项目的文档做体检,搭建或整理项目契约(CLAUDE.md / AGENTS.md)、决策日志(DECISIONS.md)和 agent 的记忆索引(MEMORY.md),以及用户问长项目怎么和 AI agent 一起做不走样(审查、上下文隔离、并行子 agent、思考强度、个人习惯放哪)。用户说「写个计划」「X 的报告放哪了」「Y 当时怎么定的」「给这个项目建 CLAUDE.md」「开个决策日志」「给项目的文档做个体检」时使用。Keep project context in documents; where docs go under docs/ and how to find them; CLAUDE.md, DECISIONS.md, MEMORY.md; project checkup.
How it works
- 找文档
- 存文档
- 搭建契约、决策日志和记忆
- 给项目做体检
- 不要做的事
SKILL.md preview
--- name: longkeep-context description: 把项目的上下文放进每个 agent 会话都会读的文档里。要写说明性文档(计划、报告、调研、指南、审阅、笔记)或要找以前的文档时使用:它规定文档放在 docs/ 下哪里、怎么找。也用于给项目的文档做体检,搭建或整理项目契约(CLAUDE.md / AGENTS.md)、决策日志(DECISIONS.md)和 agent 的记忆索引(MEMORY.md),以及用户问长项目怎么和 AI agent 一起做不走样(审查、上下文隔离、并行子 agent、思考强度、个人习惯放哪)。用户说「写个计划」「X 的报告放哪了」「Y 当时怎么定的」「给这个项目建 CLAUDE.md」「开个决策日志」「给项目的文档做个体检」时使用。Keep project context in documents; where docs go under docs/ and how to find them; CLAUDE.md, DECISIONS.md, MEMORY.md; project checkup. --- # 用文档保存项目上下文 新开的 agent 会话只知道它读到的文件。这个 skill 规定那些文件是什么:说明性文档放在 `docs/` 下固定的位置,另有三个文件装着每个会话都要先读的东西。 **用中文回复用户**,包括中途进度和收尾汇报;代码、命令、路径、标识符保持原样。 | 文件 | 装什么 | |---|---| | `CLAUDE.md` / `AGENTS.md` | 项目契约:每个会话都要遵守的规则,每条标出处,150 行以内 | | `DECISIONS.md` | 每个设计选择,附证据和拍板人;只追加,不改旧条目 | | `MEMORY.md` | agent 的长期事实索引:用户的偏好、本机的坑、东西在哪 | 进度写在 `docs/plans/`,不进这三个文件。 ## 找文档 需要以前的计划、报告、决策或笔记时,以及每次写新文档之前: 1. **先看项目指向哪里。** 契约(`CLAUDE.md`、`AGENTS.md`)里常有「去哪找」一节,有的项目还有索引(`INDEX.md`、`docs/README.md`)。先照它们找;它们优先于下面几步。 2. **否则去对应的 `docs/` 分类里找。** 文件名以日期开头,按名字排序就是从旧到新:先读最新的,旧的当历史看。 3. **下「没有」的结论之前先搜**:先在文件名里搜主题词,再在正文里搜(`grep -ril <词> docs/`)。 4. **文档描述的是它写成那天的情况。** 依赖它之前,对一下代码、`git log` 或更新的文档;看到「已被取代」「已过时」的标注,就顺着找到替代它的那份。 5. **找到同一件事的文档,就更新它**,不要另起新文件。 ## 存文档 新建说明性文档(报告、计划、调研或读书笔记、指南、审阅、清单),且同一件事还没有文档时: 1. 放在项目的 `docs/` 下对应的分类文件夹里,没有就建: - `docs/reports/`:工作报告、收尾、复盘 - `docs/plans/`:计划、设计、路线图 - `docs/research/`:调研、对比、论文或书的笔记 - `docs/guides/`:使用说明、操作步骤 - 拿不准:`docs/notes/` 2. 命名为 `YYYY-MM-DD-<主题>.md`,按日期排序,也能按名字找到主题。 3. **绝不**放在项目根目录、代码目录(`src/` 之类)或临时新造的顶层文件夹里。 4. 项目自己的契约对文档另有规定时,以契约为准。 文档怎么写不归这条规则管;它只需要能独立读懂(标题说清是什么、什么时候、关于谁)。 ## 搭建契约、决策日志和记忆 用户要搭建或整理这些文件,或者项目还没有、用户同意建的时候: - **契约**:从 [references/contract-template.md](references/contract-template.md) 起步。按你对项目和用户的了解填一份草稿给用户看;用户点头后再写 `CLAUDE.md`。项目还需要 `AGENTS.md`(Codex 等读这个名字)时,做成指向 `CLAUDE.md` 的链接或一行指引,绝不复制第二份。 - **决策日志**:从 [references/decision-log-template.md](references/decision-log-template.md) 起步。每个架构级选择一条,新的在前,只追加,每条写明谁拍的板。用户采纳的推荐就记成「推荐、用户同意」,绝不记成用户自己的决定。 - **用户自己的习惯**:从 [references/user-template.md](references/user-template.md) 起步。写进用户级文件(`~/.claude/CLAUDE.md`、`~/.codex/AGENTS.md`),绝不写进项目契约。先给用户看草稿,用户点头后再写。 - **记忆**:`MEMORY.md` 是索引,每条一行,细节放单独的文件。反复出现的偏好,提议升进契约。 - **每条规则都标出处**:`[owner]` 是用户的原话,`[agreed]` 是用户同意了的建议,`[incident]` 是返工得来的教训,`[D0xx]` 是决策日志条目。 这些习惯怎么来的,以及配套的协作做法(审查、上下文隔离、并行子 agent、思考强度、个人习惯放哪):[references/working-with-ai-agents.md](references/working-with-ai-agents.md)。用户问到这些时先读它。 ## 给项目做体检 用户要给项目的文档做体检,或者同意了安装后提议的体检时使用。先交报告;用户点头前,不移动、不写入任何文件。 1. **看现状。** 说明性文档现在放在哪(`git ls-files '*.md'`);`CLAUDE.md` / `AGENTS.md`:有多长,里面有没有进度和状态行,有没有代码里已经对不上的说法,`AGENTS.md` 是不是一份走了样的副本;有没有决策日志(`DECISIONS.md`、`adr/`、`docs/adr/`);提交规范是什么(`git log --oneline -30`、`CONTRIBUTING.md`、commitlint 之类)。 2. **交报告**,每条发现附证据(路径或命令输出),问用户下面两步要做哪一步。 3. **整理文档。** 逐个列出文件、它在 `docs/` 下的目标位置和以日期开头的新名字;契约里已有的约定优先。用户同意后用 `git mv` 移动,并修好指向它们的链接。 4. **重写契约。** 先收集素材: - 现有契约,每一行对照仓库核一遍; - 用户反复说过的话:装了 Longkeep 的 sessions 模块的话,导入时加 `--prompts` 会在档案的 `_prompts/` 下写出 `USER_PROMPTS.md` 和 `USER_RULES.md`。一条规则要有两处以上用户说过的原话,按原样引用; - 用户自己的经验:问他们经常纠正什么、以前出过什么问题; - 第 1 步查到的提交规范。 逐条判定:留在契约里(会改变 agent 的做法、从代码里看不出来、写错了代价高);删掉(模型本来就会做、代码里看得出来、已经过时);或者搬走(决策进 `DECISIONS.md`,进度进 `docs/plans/`,还没定下来的偏好进记忆)。按[契约模板](references/contract-template.md)起草,150 行以内,每条规则标出处。你自己推断出来的规则单独列出,逐条问用户要不要。 5. **交付。** 在聊天里贴出完整草稿,附上删了什么、为什么删。用户同意后才替换文件;`AGENTS.md` 如果是指向 `CLAUDE.md` 的链接或一行指引,保持原样。 ## 不要做的事 - 不往契约里写进度、状态行或历史。 - 不先给用户看草稿,就不改他们的 `CLAUDE.md` 或 `AGENTS.md`。 - 不把决策日志的旧条目改成另一个意思;推翻就新开一条。 - 同一件事已有文档时,不另建新文档。
Files in this package (5)
- SKILL.md 7 KB
- references/contract-template.md 5 KB
- references/decision-log-template.md 2 KB
- references/user-template.md 6 KB
- references/working-with-ai-agents.md 9 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · wingsofsky/longkeep | 90 | Apache-2.0 |
| wingsofsky/longkeep | 90 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version 3779be51a0d8 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90project-memory
Use when working in a repository that keeps durable project context, cross-session memory, incident history, decisions, or agent state across Claude, Codex, and later sessions. - 98context-audit
[Adam''s Skills] Audits a repository''s Claude context-injection setup — CLAUDE.md, CONTEXT.md, docs/, .claude/agents/, and the per-project memory directory. Reports bloat, broken links, orphaned docs, security risks, missing rules in subagent prompts, settings that override… - 90longkeep-folder
Run one agent CLI on a folder of repositories, unattended, with a brief the user saved once (folder tasks, built on Longkeep delegation). Use when the user says "run the folder task on <folder>", "work through these repositories overnight", "edit the folder-task brief", or asks… - 100project-init
[Utilities] Use when setting up or re-evaluating portable project context end to end: project-config, reference docs, CLAUDE.md, AGENTS.md. One piece only: project-config, docs-manager --mode=init or ai-context-refresh. - 100project-init
[Utilities] Use when setting up or re-evaluating portable project context end to end: project-config, reference docs, CLAUDE.md, AGENTS.md. One piece only: project-config, docs-manager --mode=init or ai-context-refresh. - 95memory-management
Claude Code auto-memory 与 CLAUDE.md 的管理方法 — 判断值不值得记、记到哪一层(行内注释 / .claude/rules / memory / CLAUDE.md)、怎么写 frontmatter 与 description、何时 update 何时拆分、索引 MEMORY.md 的容量与 hub 化。用户说"记一下""新增/更新记忆""沉淀经验""复盘""改 memory schema""audit memory""记忆系统乱了"时使用;功能开发或长 debug 收尾有值得沉淀的结论时也用。