Memory Index【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kitUser[user] Prefers dark mode, uses Windows 11, PowerShell → user-preferences.md[user] Senior DevOps engineer, 8 years experience → user-preferences.mdProject[project] Always use bun instead of npm → project-conventions.md[project] Tailwind v4 preferred, no v3 → tech-decisions.mdFeedback[feedback] User likes concise responses, no filler → feedback-history.mdReference[reference] Squid proxy runs on port 3128 → infrastructure-notes.md而仓库中的真实 MEMORY.md 与之一致 markdown # Memory Index ## Project - [project] Always create a new dedicated branch for major code changes → project-conventions.md - [project] AG Kit only supports Gemini CLI and Google Antigravity (not other AI coding tools) → project-conventions.md - [project] Component metadata uses SemVer while toolkit releases use CalVer → tech-decisions.md设计要点索引只做指针 摘要不承载细节。会话启动时只需加载这份 ≤200 行的轻量文件SKILL 估测约 1,000 tokens却能避免每次 3,000–10,000 tokens 的重新探索成本——用瘦索引 按需读全文换取跨会话的长期收益。7.3 主题文件格式frontmatter 结构化内容每个主题文件由两段组成——带元数据的 frontmatter 与结构化正文--- type: user | feedback | project | reference created: 2026-04-01 updated: 2026-04-01 --- # User Preferences ## Development Environment - OS: Windows 11 - Shell: PowerShell - Editor: Cursor / Windsurf - Package Manager: bun (NOT npm) ## Communication Style - Prefers concise responses - Likes tables for comparisons - Dislikes verbose explanationsfrontmatter 的三个字段并非口头约定而是由 memory.schema.json 做了机器可校验的约束type限定为四枚举值之一created/updated使用 date 格式且三者均为必填、不允许额外字段additionalProperties: false。这意味着任何违反格式的记忆文件都能被校验工具发现保证整个记忆体系在结构上始终可被程序化消费。7.4 记忆分类法TaxonomySKILL 用一张表精确划定了什么信息该归哪类TypeWhat to StoreExampleuserRole, preferences, tools, communication styleSenior DevOps, prefers dark modefeedbackWhat user liked/disliked about agent outputUser said too verbose, prefers tablesprojectCoding standards, tech choices, conventionsUse bun not npm, Tailwind v4referenceNon-sensitive infrastructure notes, public URLs, configsProd API hostname and port分类不是形式主义——它决定了信息写入哪个主题文件、被检索时的命中路径也约束了什么不该存。7.5 黑名单什么绝对不能保存SKILL 明确列出六类禁止入库的内容及其理由Dont SaveWhy密钥、凭据、token、密码、私钥、API key记忆是持久化的可能在会话间共享可从代码推导的信息读package.json就够了不必背诵依赖临时调试上下文污染记忆且日后无用精确代码片段代码会变记忆会过期可能移动的文件路径用 glob 模式或描述代替完整对话记录记忆只用于蒸馏后的洞察这条黑名单是 CRITICAL RULES 第 4 条Distill, dont copy的展开也是记忆系统防污染的防火墙——记住为什么而不是当时打印了什么。八、记忆的完整生命周期Save / Recall / Search / Prune/remember只覆盖了写入这一半另一半由 memory-system 技能的另外三个操作补齐构成闭环Save保存— 触发词用户说 remember / save / dont forget。流程即/remember工作流那五步。Recall召回— 触发场景会话启动或用户问 what do you remember about X读取.agents/memory/MEMORY.md索引扫描与当前任务相关的条目命中则读取对应主题文件静默应用——除非用户主动询问否则不背诵记忆内容错误的示范是我记得你喜欢深色模式、用 bun…正确的做法是直接按偏好执行。Search搜索— 触发词do I have any notes about X对.agents/memory/*.md执行 Grep 检索返回带文件引用的匹配条目用户需要细节时再读全文。Prune清理— 触发条件索引超过 200 行预警Memory index is getting large (X lines). Review recommended.建议合并相关条目建议将旧条目归档到memory/archive/绝不自动删除必须先征求用户同意。九、会话启动协议记忆如何无缝衔接记忆系统的价值在于新会话无需重新自我介绍。SKILL 规定了每个会话开始时的标准动作1. Check: Does .agents/memory/MEMORY.md exist? → YES: Read index. Apply relevant context silently. → NO: Continue without memory. Create on first remember trigger. 2. Apply memory WITHOUT reciting it. ❌ WRONG: I remember you prefer dark mode and use bun... ✅ RIGHT: (silently apply preferences, use bun in commands) 3. Exception: If user asks what do you remember? → recite relevant memories.【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考