为 AI Coding Agent 提供「记忆」功能,能显著减少错误、降低 API 调用成本、促进 Agent “学习”,简化 Vibe Engineering
@PawelHuryn 强调,这种方法超越了人类手动管理的 Claude Skills,而是通过可编辑的 Markdown 文件实现自动化知识积累。
关键建议:具体操作步骤
· 文档化现有方案:让 Agent 将代码逻辑记录为 .md 文件,作为知识库基础。
· 对比检查:新任务前,让 Agent 审视当前实现与文档的差异(如帖子截图所示:Agent 扫描“fuckups. md”文件,发现边缘函数可能泄露技术错误细节,并自动修复为用户友好提示)。
· 任务引用:启动新任务时,明确指示 Agent 参考相关 .md 文件,避免重复错误。
· PRD 转化:用 Agent 将 PRD 拆解为 .md 任务列表,便于迭代。
项目示例:accredia. io 的文档体系
作者公开了自己在线证书平台 https://t.co/PlWNCyRza7 的 /documentation/ 目录下 12 个 .md 文件模板(可直接复制调整),这些文件由 AI Agent 全程创建、更新和管理。它们覆盖项目全生命周期,形成自洽的知识闭环:
· analytics. md:分析系统,追踪证书与用户互动,支持隐私事件日志和实时仪表盘。
· architecture. md:后端优先架构指南,使用 Clerk 认证、Supabase Edge Functions 和 JWT 授权。
· cron. md:自动化同步任务,处理组织、用户资料和邮件对账。
· database. md:数据库表 schema 参考,包括组织、课程、证书等核心实体。
· design. md:设计系统规范,定义排版、颜色、组件和无障碍标准。
· emails. md:队列式邮件通知,使用 Postmark 处理证书发送、重试和模板。
· fuckups. md:错误教训库,记录认证失误、UX 问题及最佳实践(如截图中 Agent 据此修复错误处理)。
· permissions. md:角色权限矩阵(管理员、成员、学生、匿名),定义端点访问规则。
· security. md:安全措施,包括 XSS 防护、输入验证和防作弊机制。
· socialsharing. md:社交预览架构,支持图像生成和缓存。
· todo. md:待办改进列表。
· variables. md:环境变量指南,覆盖前后端秘密管理。
专注 - Context Engineering, AI(Coding)Agents.
分享 - AI papers, apps and OSS.
ex Microsoft MVP
合作 - 私信/邮箱:shaomeng@outlook.com
📢 公众号/小红书: AI 启蒙小伙伴
🔗 信息卡提示词 🔽