日常使用
项目记忆 HENG.md
把项目规矩写进 HENG.md(或沿用现成的 AGENTS.md、CLAUDE.md),heng-agent 每次启动自动读入;用
- 预计用时
- 约 4 分钟
- 适用版本
- v0.5.0 及以上
写下项目规矩
在项目根目录放一个 HENG.md,写上技术栈、命名约定、提交规范这类规矩,每次启动自动读入。所有项目通用的写在 ~/.heng-agent/HENG.md。
# 项目规矩
- 包管理用 pnpm,不要用 npm / yarn
- 接口返回统一用 src/api/response.py 的 ok() / fail()
- 提交信息用中文,格式 type(scope): 说明不想自己写,输入 /init:它分析项目,生成项目说明 AGENTS.md(跨工具的开放标准,别的工具也读得到);项目里已有说明文件就更新现有的。
已有的说明直接能用
从别的工具转过来,不用迁移。这些文件都会读:
| 范围 | 文件 |
|---|---|
| 项目 | 根目录的 HENG.md、AGENTS.md、CLAUDE.md、CLAUDE.local.md;子目录里的同名文件 |
| 用户 | ~/.heng-agent/HENG.md、~/.claude/CLAUDE.md |
内容一样的(比如 CLAUDE.md 链到 AGENTS.md)只算一份;CLAUDE.md 里的 @路径 引用会展开。读到写给 Claude Code 的说明时,还会附一段工具名对照(Bash → bash、Edit → edit_file……)。
几份说明内容冲突时,后面的为准:用户级在前、项目级在后;同一级里 CLAUDE.md < AGENTS.md < CLAUDE.local.md < HENG.md;子目录的说明比根目录的更具体。
随手记一条:# 开头
聊着聊着想起一条规矩,输入以 # 开头的一句话,它不发给模型,而是让你选记进项目还是用户的 HENG.md,立即生效:
# 这个项目用 pnpm查看与修改:/memory
/memory:按生效顺序列出每份说明各占多少 token、#快速记忆会写进哪个文件;合计超过 1 万 token 时提醒精简(比如 CLAUDE.md 里只写一行@AGENTS.md);/memory edit project//memory edit user:用编辑器打开项目或用户的 HENG.md。
大项目:子目录各放一份
大项目的子目录可以有自己的 HENG.md(比如 frontend/HENG.md)。模型第一次读写那个目录的文件时自动附上,每份只附一次,不读那个目录就不占上下文。
做完是这样
/memory 里列出了你的 HENG.md(以及读到的 AGENTS.md、CLAUDE.md)和各自的 token 数;新开一个会话问「这个项目用什么包管理器」,它直接按你写的规矩回答。