Precedent Loop Skill 技能

技能简介

Precedent Loop 是一款专为 Codex 与 Claude Code 设计的本地化、人工把关的「先例记忆」技能。它把代理与开发者合作过程中确认下来的根因、决策与踩坑经验，沉淀为可被检索的「先例（precedent）」，让下一次开新会话时无需从头复述。整套流程强调「由人审核、Agent 提案」，避免自动记忆不可控的问题。开源协议为 Apache-2.0，仅支持 Apple Silicon 芯片的 macOS。

核心能力

1. 候选管理：决策落定或根因确认后，由 Agent 生成结构化候选；使用者可在桌面 Hub 中改写、让 AI 重写、接受或拒绝，只有点击「确认」的版本才会落库。
2. 限次召回：单次会话最多拉取 8 条、5000 字以内的相关先例，按需读取，避免上下文膨胀。
3. 双端共享：Codex 与 Claude Code 共用一份知识库，通过 MCP 与 hooks 同时连接，两者之间也可互相查询。
4. 本地导入：支持将已有的 Markdown 笔记（.md/.markdown/.mdx）通过本机的 Codex 或 Claude Code CLI 转成候选导入；App 不保存任何模型 Key。
5. 使用统计：每条先例的「被检索次数」「真正影响判断的次数」都有记录，长期无人使用的可以清掉，保持知识库清爽。

安装配置

1. 需要 macOS（Apple Silicon）系统，Codex CLI 与/或 Claude Code CLI 已安装并登录。
2. 下载 PrecedentLoop--arm64-local-install.dmg，把 App 拖入 Applications 目录；首次打开需在「系统设置 - 隐私与安全」中点「仍要打开」放行未签名应用。
3. 安装向导会引导用户同时配置 Codex 与 Claude Code 两个客户端的 hooks。

使用步骤

1. 在 Codex 或 Claude Code 会话中确认决策或根因，让 Agent 整理成结构化候选。
2. 打开 PrecedentLoop 桌面应用查看候选，改写或让 AI 重写，点击「确认入库」。
3. 后续会话中，Agent 会按需检索知识库并只取相关条目的标题、摘要或全文。
4. 当先例过时或错误时，Agent 主动提交「修订候选」，同样需要人工确认才会覆盖原版本。

适用场景

1. 长期项目的根因追踪：把分散在不同会话里的 Bug 根因集中复用，避免每周重新排查。
2. 跨项目约定共享：例如后端项目的接口约定可在前端项目里被检索。
3. 团队内部知识沉淀：让团队成员的项目经验可被 AI 助理按需检索，提升新人融入速度。
4. 多人协作代码审查：把团队讨论后定下的设计取舍变成先例保留，防止每次讨论重复。
5. AI 写代码习惯养成：把「必须遵守的规则」留在 AGENTS.md，把「特定场景下的洞察」放在 Precedent Loop，职责分明。

适用人群

使用 Codex 或 Claude Code 长期参与同一项目或多项目的工程师；希望拥有「长期 AI 记忆」但又不愿把全部控制权交给 AI 自动记忆的严谨开发者；维护团队级知识库的 Tech Lead；想把 Markdown 笔记转成 AI 可读经验的资深个人用户。

工作原理

检索基于 SQLite 的 FTS5 trigram 全文检索加字面匹配，没用向量检索；好处是简单、可解释、不依赖外部服务，代价是同义说法可能搜不到，因此要求每条先例入库时附带 3 到 16 个检索词。App 不调用任何模型端点、不保存任何 Key，所有数据落在本地 SQLite 文件中，可整库备份。开发者 hemuzzz 自 2026 年 7 月 8 日用至 10 月 4 日，库内 79 条经验，被检索 307 次，模型标记用上 113 次。

官方链接

• 仓库与下载：https://github.com/hemuzzz/PrecedentLoop
• 协议：MIT License；
• 演示视频：仓库 README 开头嵌入 83 秒演示