@jstxn/agentdir-pi
为本地优先的AI编程助手提供记忆与证据捕获能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@jstxn/agentdir-pi。 它的用途是：为本地优先的AI编程助手提供记忆与证据捕获能力。 完整的 Skill 内容见：https://321skill.com/skills/jstxn-agentdir-pi/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请重构这个模块，并记录下你的思考过程。” 它会自动调用AgentDir-Pi，将重构的每一步理由、尝试的代码方案以及最终选择都记录下来。完成后，你可以查看本地生成的JSON文件，清晰地看到AI的完整推理路径和代码演变证据。
介绍
AgentDir-Pi 是一个专为本地优先的AI编程助手设计的npm包，旨在解决AI在复杂编码任务中上下文记忆易丢失、决策过程不透明的问题。它通过一个轻量级的本地存储机制，持续记录AI助手在开发过程中的思考、代码片段、错误尝试和最终解决方案，形成结构化的“证据链”。
使用时，开发者只需将其集成到自己的AI编程助手（如基于Claude、Cursor的Agent）项目中。当AI助手执行任务时，该包会自动或在开发者指定的时机，将对话、代码变更、系统命令等关键信息捕获并存储到本地文件中，便于后续追溯和复盘。
它非常适合需要AI深度参与复杂、长期或实验性编码项目的开发者，尤其是那些希望理解AI决策逻辑、复用成功经验或进行团队知识沉淀的工程师和项目负责人。
建议在项目初期就进行集成，并定期查看生成的记忆文件，以优化AI的提示词和任务拆解逻辑。请注意，它主要记录文本信息，不处理二进制文件，且存储内容可能包含敏感信息，需注意本地文件安全。
核心特点
与同类工具相比，它明确采用“本地优先”架构，所有数据存储在开发者本地，无需担心云端隐私和延迟问题；同时，它专注于“证据捕获”，不仅记录结果，更强调记录AI的决策过程和中间状态，为调试和优化提供完整上下文。
注意事项
不适合需要云端同步、实时协作或处理大量非文本（如图片、视频）证据的场景。
常见问题
AgentDir-Pi 和普通的日志工具有什么区别？
它专为AI Agent设计，结构化记录思考链和代码演进，而非简单的运行日志。
数据存在哪里？安全吗？
数据默认存储在项目本地目录中，安全由开发者自己控制，不上传云端。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/jstxn-agentdir-pi/raw/index.md 读取 @jstxn/agentdir-pi 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/jstxn-agentdir-pi/raw/index.md（查看排版版本）