代理单证册
- 作者仓库星标 25,450
- 作者仓库 repomix
- 领域
- 效率工具
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @yamadashy · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Agent Carnet
A tiny CLI that gives you a shared markdown notebook on disk under `.carnet/<category>/<slug>.md`. Notes have a 30-day default lifespan that resets every time they are read or applied; useful ones survive, stale ones drift to `.trash/` automatically.
## Quick reference
```bash
# Save (always pass --summary and --agent claude-code)
echo "body content" | agent-carnet save deps/iconv-issue \
--summary "iconv-esm v0.7 types broken — pin to v0.6" \
--agent claude-code \
--tags compat,esm
# Recall
agent-carnet find iconv # search summaries (does NOT bump lifespan)
agent-carnet list # category-grouped overview, sorted by last_used
agent-carnet list --sort use_count # most-applied notes first
agent-carnet show deps/iconv-issue # read full content (bumps last_used; weak use signal)
# Mark as actually applied (strong use signal — bumps last_used + use_count)
agent-carnet used deps/iconv-issue
# Maintain
agent-carnet move <from> <to>
agent-carnet rm <path> --yes
```
When unsure of a subcommand's full flag set, run `agent-carnet <command> -h` (e.g.
`agent-carnet save -h`, `agent-carnet used -h`). Each subcommand prints its own
focused help — required arguments, options, and examples — without invoking
filesystem operations.
## When to save
Save proactively when you discover something worth preserving across sessions:
- Research findings that took effort to derive
- Non-obvious patterns / gotchas in the codebase
- Solutions to tricky problems
- Architectural decisions and the reasoning behind them
- In-progress work that may be resumed later
## When to recall
Before starting related work or when context might exist:
- `agent-carnet find <topic>` — quick scan of summaries
- `agent-carnet list <category>` — browse a folder
- `agent-carnet show <path>` — actually read (resets `last_used`; only use when the content matters)
## When to call `used`
Call `agent-carnet used <path>` after a carnet **actually shaped your work**:
- You applied the recorded fix and it solved the bug.
- You consulted the carnet before retrying a hypothesis and skipped a dead-end.
- You used the canonical name from a `vocab` carnet in new code instead of inventing your own.
`used` increments `use_count` — a durable importance signal that survives across sessions and lets future readers (and `agent-carnet list --sort use_count`) surface load-bearing notes.
Reading a carnet does NOT count. `show` already keeps it alive (weak signal); `used` records that the note was worth keeping for a real reason (strong signal).
## Hard rules
- `--summary` is required. Make it decisive — reading the summary in isolation tells the next reader (or the next agent) whether to read further.
- `--agent claude-code` is required.
- `find` does NOT bump anything. `show` bumps `last_used`. `used` bumps `last_used` AND increments `use_count`.
- `updated` tracks content modification only (`save`, `save --update`). It is independent of `last_used` and is not the lifespan driver.
- The 30-day expiry is automatic — do not manually clean up. `keep: true` pins permanent notes.
- Auto-prune runs on every CLI invocation; deleted carnets land in `.carnet/.trash/` for 7 days before hard delete.
## Path conventions
- `<category>/<slug>` — kebab-case, no leading slash, no `..`.
- Categories are folders; create new ones freely as needed.
- Subcategories are allowed: `deps/esm/iconv-issue` works.
## When to read references/
This SKILL.md is enough for everyday note-keeping. Open the references/ files **only** when one of these specific cases applies — they are not always-on context, so do not load them speculatively.
| Read this file | When |
|---|---|
| `references/cookbook.md` | You are about to use (or are being asked about) a tag-based pattern such as `tags: [vocab]` for project terminology or `tags: [hypothesis]` for debugging dead-ends. The file shows the full pattern, including how to structure the body and `meta:` for that pattern. |
| `references/frontmatter.md` | You need to write or read the `meta:` extension namespace, set a non-trivial `lifespan` / `keep`, or understand why an unfamiliar frontmatter field is or is not preserved on save. |
If neither case applies, **do not read references/**. The base of this file already covers daily save/find/show/touch/move/rm flows.
章节与文件索引
按说明文件中的顺序排列。
快速参考
何时保存
何时回忆
何时调用二手
硬性规定
文件/命令 -> .carnet/<category>/<slug>.md · .trash/ · agent-carnet <command> -h · agent-carnet save -h · agent-carnet used -h · agent-carnet find <topic> · agent-carnet list <category> · agent-carnet show <path>
内容校验值 -> 1d21e6751dab
当前原文的自动摘译,尚未人工审校。
快速参考
当不确定子命令的完整标志设置时,请运行
agent-carnet <command> -h(例如agent-carnet save -h、agent-carnet used -h)。每个子命令都会打印自己的重点帮助 - 所需的参数、选项和示例 - 而不调用文件系统操作。何时保存
当您发现一些值得跨会话保留的内容时,请主动保存: 努力得出的研究结果 代码库中不明显的模式/陷阱 棘手问题的解决方案 架构决策及其背后的推理
何时回忆
在开始相关工作之前或上下文可能存在时:
agent-carnet find <topic>— 快速扫描摘要agent-carnet list <category>— 浏览文件夹agent-carnet show <path>— 实际阅读(重置last_used;仅在内容重要时使用)何时调用二手
在证书真正塑造了您的工作后,请致电
agent-carnet used <path>:您应用了记录的修复并解决了错误。在重试假设之前,您查阅了单证册,从而跳过了一条死胡同。您在新代码中使用了vocab单证册中的规范名称,而不是发明自己的名称。used增量use_count——一个持久的重要性信号,在整个会话中持续存在,并让未来的读者(和agent-carnet list --sort use_count)表面承载笔记。硬性规定
需要
--summary。使其具有决定性——单独阅读摘要会告诉下一个读者(或下一个代理)是否进一步阅读。需要--agent claude-code。find不会碰撞任何东西。show颠簸last_used。used颠簸last_used和增量use_count。updated仅跟踪内容修改(save、save --update)。它独立于last_used,并且不是寿命驱动因素。