坏了也不用翻手册:fullstack-agent「agent当维修工」自修复机制的设计哲学

📅 发布时间:2026/10/16 1:19:55
坏了也不用翻手册:fullstack-agent「agent当维修工」自修复机制的设计哲学
【免费下载链接】fullstack-agentGive your AI a full stack: memory, voice, face, and hands. This is the I want an AI agent shortcut. It sets up the entire jaredrhod stack for you with an installation wizard. Select which pieces you want or do it all!项目地址https://gitcode.com/gh_mirrors/fu/fullstack-agent点击查看免费下载fullstack-agent 是一个 AI agent 一站式安装向导它为 AI 装上一整套全栈记忆memory、声音voice、面孔face和双手hands。这篇文章解读它最独特的设计哲学——让 agent 自己当维修工的自修复机制东西坏了不用翻手册只要向你的 agent 描述问题它就会自己查阅排障文档、定位原因并完成修复。一、把维修工写进 agent 的灵魂fullstack-agent 的自修复不是某个脚本而是安装结束时写进 agent 身份文件的一条职责。安装向导在接线阶段Phase 4会向 home 目录的CLAUDE.mdagent 的身份与行为准则文件追加一段关键规则原文是You are the mechanicThis agent runs on open tools that live in this folder (the memory vault, backtalk, ai-visualizer, barehands). When anything breaks, acts strange, or needs changing, fixing it is YOUR job, not the persons: read the relevant tools TROUBLESHOOTING.md and README, diagnose, and repair it yourself. Never send the person off to search the internet. If they ask how something works, explain it in plain English.你是维修工。这套系统由本文件夹里的一系列开源工具运行。任何组件坏了、行为异常或需要调整时修复是你的职责不是用户的去读对应工具的 TROUBLESHOOTING.md 和 README自行诊断并修好它。绝不把用户打发去搜网。如果用户问某个东西如何工作就用大白话解释。这一段就写在安装向导的总谱里fullstack-agent.md。整个自修复体系的起点是把排障从用户的工作重新定义为agent 的工作。二、自修复怎么运转三层排障体系第 1 层每个组件自带写给 agent 看的说明书fullstack-agent 组装的四个组件——ai-memory-vault记忆、backtalk声音、ai-visualizer面孔、barehands双手——每一个仓库都自带一份TROUBLESHOOTING.md而且这些文档的写作对象不是人类是 agentREADME.md 明确写着 Every repo here ships a troubleshooting guide written for your agent to read。也就是说文档的结构、措辞都为了让 AI 能直接读懂并照做而设计这正是自修复能成立的底层基建。第 2 层跨组件问题由总装车间兜底单件工具的故障归各自的文档管而部件之间的接线问题归 fullstack-agent 仓库顶部的 TROUBLESHOOTING.md。它只收录住在部件之间的问题例如面孔静止不动、声音却在说话 → 检查ai-visualizer.json的bus_dir是否指向 backtalk 目录然后重启移动了 agent 文件夹 → 所有接线都是路径agent 读一遍 fullstack-agent.md 重跑接线阶段即可只动配置路径agent 忘了自己是谁 → 因为 Claude Code 只在 home 文件夹里打开时才会读CLAUDE.md第 3 层agent 亲自上手而不是教你修CLAUDE.md 里有一条硬性规则Do the work yourself (run the commands, edit the configs) instead of telling the person to do it——agent 要自己执行命令、修改配置只有真正需要用户动手的步骤授权摄像头/麦克风、输入密码才交给用户。配合You are the mechanic中的 Never send the person off to search the internet三层合起来就是一条完整的自修复链路发现问题 → 找到对应文档 → 自己诊断 → 自己执行修复。三、安全底线自修复绝不删除你的文件敢于让 agent 动手的前提是信任。fullstack-agent 用一套收养规则adoption rules划出边界安装向导从头到尾重复同一条承诺永不删除、覆盖或移动用户自己创建的东西。替换 新组件接管旧文件原封留在磁盘上并大声说明确认身份文件CLAUDE.md、记忆库vault、笔记都存放在各组件仓库的 tracked 文件之外因此任何更新都碰不到它们更新时如果你改过配置文件backtalk.json、ai-visualizer.json等git 冲突时你的修改获胜update.sh 顶部注释写明 your edit wins修复可以激进但对用户数据必须保守——这是这套机制最容易被忽略、也最关键的设计。四、日常怎么用一句话搞定出故障了打开 Chat 会话用大白话描述问题即可。README 原文鼓励Seriously. Open the chat and describe the problem. … you never have to debug this stack yourself.真的不用自己调试这套栈更新全部组件macOS 上运行 update.sh或双击桌面的 Update 快捷方式Windows 上直接在聊天里说 update everything and tell me what changedagent 会做同样的事并汇报变化中断恢复安装途中关掉了窗口claude --continue续上会话即可装到一半的状态不会丢五、这套设计哲学对普通用户意味着什么零调试门槛排障文档按AI 可读标准编写agent 是唯一读者用户只需要会说人话职责前移安装、接线、修复、更新全部是 agent 的 KPI用户只负责提问和验收数据主权清晰组件代码可随意更新替换用户资产身份、记忆、笔记、配置永远在仓库之外只读、只引用、不搬迁一句话总结 fullstack-agent 的维修哲学手册不是写给人翻的是写给 agent 读的而用户唯一要做的就是说出哪里坏了。️赞分享【免费下载链接】fullstack-agentGive your AI a full stack: memory, voice, face, and hands. This is the I want an AI agent shortcut. It sets up the entire jaredrhod stack for you with an installation wizard. Select which pieces you want or do it all!项目地址https://gitcode.com/gh_mirrors/fu/fullstack-agent点击查看免费下载相关推荐二维码损坏不用愁专业修复工具全攻略二维码损坏不用愁专业修复工具全攻略 当二维码因污损、撕裂或打印错误导致无法识别时掌握科学的二维码修复方法能帮助我们高效恢复重要信息。本文将系统介绍损坏二维码开发工具图像处理创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考