深度剖析fullstack-agent核心实现：一份Markdown提示词文件如何变成完整安装向导

【免费下载链接】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 的记忆、语音、形象、双手一次性装齐的开源安装向导项目。它最反直觉的地方在于整个安装器的核心几乎不是传统代码而是一份Markdown 提示词文件——fullstack-agent.md。这篇文章带你完整剖析它的设计一篇写给 AI 看的说明书是如何变成一套能跑通全流程、还懂得照顾新手的安装向导的。一句话看懂 fullstack-agent 是什么先纠正一个常见误解fullstack-agent不是一个会写全栈代码的 Agent而是一个拥有全套感官的 Agent 的安装器。安装完成后你得到的是一套组合体部件角色对应仓库记忆The mind基于纯文本文件的持久化记忆跨会话记住你和工作ai-memory-vault️语音The voice按住说话键Agent 约 1 秒后用扬声器回答backtalk形象The face浏览器全屏可视化界面随对话同步待机/聆听/思考/说话ai-visualizer️双手The hands可选通过摄像头用裸手移动屏幕上的图片和便签barehands每个部件都是独立开源项目fullstack-agent 负责把它们在对话中装配成一个整体。唯一前置要求装好 Claude Code 并有一个 Claude 订阅$20 的 Pro 套餐就够。核心机密整个安装器是一份 Markdown 提示词打开仓库你会发现它小得离谱全部文件如下文件角色CLAUDE.md安装器启动文件决定进入这个目录的 AI 是安装器不是你的 Agentfullstack-agent.md安装向导本体一份 6 阶段的提示词总指挥start.sh / start.bat启动脚本按正确顺序拉起 face、hands、voiceupdate.sh / update.bat更新脚本安全拉取所有组件新版本绝不动你的文件TROUBLESHOOTING.md跨组件故障手册——注意它是写给 Agent 自己读的README.md项目说明与一键安装命令没有安装包、没有 GUI 工程、没有几百行的安装程序。安装程序就是那 150 多行英文提示词它告诉 AI 该怎么问、按什么顺序装、配置写到哪个文件、失败了去哪查手册。这正是提示词工程Prompt Engineering从技巧走向产品级交付的一个完整样本。两份 Markdown 的分工启动文件 vs 总指挥这个项目里有两个关键角色各由一份 Markdown 承担1. CLAUDE.md身份注入Claude Code 打开某个目录时会自动读取该目录的CLAUDE.md。fullstack-agent 利用了这个机制只要你在仓库目录里启动 ClaudeAI 立刻醒来时就知道——你还没成为用户的 Agent你是建造 Agent 的助手。你在这个文件夹里的工作有且只有一件事带用户走安装流程。它还会做一次状态检查父目录里没有CLAUDE.md说明安装还没做完立即读取 fullstack-agent.md 并严格执行有则说明已安装完成转而提供启动、更新、补装等选项见 CLAUDE.md#L5-L9。这就把重复运行安装命令变成了一件绝对安全的事。2. fullstack-agent.md总指挥The Conductor它的开头只有一句定位This file is the conductor这份文件是总指挥——它负责一次性收集所有答案然后带着这些答案逐个执行每个部件自带的安装向导最后把所有东西接好线以 Agent 的第一句开口问候收尾。六阶段安装向导全景Phase 0 到 Phase 6fullstack-agent.md 把安装拆成 7 个阶段每个阶段的标题本身就是长尾关键词级别的操作性说明Phase 0安家并盘点已有什么fullstack-agent.md#L12 先检查 git 是否存在Windows 走 ZIP 下载可能没有 git然后判断这是全新安装还是收养已有 Agent。如果你之前用别的方式搭过记忆库或可视化界面向导会先盘点再接管已有的身份和记忆保留原样、永不重建手工做的可视化场景还会被晋升到官方画廊里。三条扫描铁律贯穿全程旧项目记忆可以迁移、现有 Obsidian 库不碰、超出授权范围的路径先问再扫。Phase 1菜单fullstack-agent.md#L37 用一句大白话介绍每个部件并把最简单的选项全套都要放在第一个位置当默认值。可选部件只提一次、绝不推销。Phase 2唯一的访谈fullstack-agent.md#L49 这是全文设计最精巧的一步所有问题只在这一次问完Agent 名字、身份三选一、记忆库位置、麦克风模式、语音引擎、默认形象、权限策略……问完之后后续任何步骤都不再开口。每个问题都附带诚实的取舍说明且绝不替用户默默做选择。Phase 3安装部件fullstack-agent.md#L61 按固定顺序克隆四个组件仓库然后读取并执行每个组件自带的向导文件——fullstack-agent 只决定答案和顺序怎么装永远以组件自己的文档为准。这个总指挥 分向导的分工让每个组件可以独立演进。Phase 4接线fullstack-agent.md#L81 把 Phase 2 收集到的答案写进各组件的配置backtalk.json、ai-visualizer.json、barehands.json写完后逐文件回读确认落盘并向用户解释一句语音写小状态便签形象去读它们——这就是全部连接方式。最后往 Agent 的CLAUDE.md里追加修车工条款见下文。Phase 5第一次问候fullstack-agent.md#L100 安装以试车收尾运行 start.sh形象在浏览器打开、语音说出Hello [你的名字]今天我们做什么、按住说话键问一句、看形象随回答律动。如果用户没装语音向导会亲自用文字把问候一字不差地念出来——没有任何人的第一次问候可以是沉默的。Phase 6交接fullstack-agent.md#L112 先关掉试车进程释放端口再在桌面生成以Agent 名字命名的快捷方式Chat / Talk / barehands / Update并且当场逐个双击测试——绝不交出一个没测过的快捷方式。这些设计细节为什么让新手也敢一键安装 读 fullstack-agent.md 时会发现大量防翻车细节每一条背后都是真实事故已打开的终端看不到新装程序安装 git 或 uv 后同一终端里必须用完整路径调用提示词里明确写了这条坑并点名已经咬过一次真实安装。快捷方式必须导出 PATHmacOS 双击.command启动时环境是裸的claude和uv都不在默认 PATH 里所以提示词强制每个脚本首行加export PATH...否则静默失败。Windows 更新脚本故意留空update.bat 是个空文件但注释了整整 20 行解释为什么——cmd 按字节偏移读.bat脚本更新自己会读乱而把自己复制到隐蔽位置再运行这个保护手段恰好和恶意软件行为同形会招来杀毒软件报警得不偿失。于是 Windows 上更新改为直接对 Agent 说update everything and tell me what changed。更新绝不碰你的文件update.sh 的注释写得很清楚——你的CLAUDE.md、记忆库、配置都在仓库跟踪文件之外冲突时你的修改永远赢。而全项目最点睛的一笔是 Phase 4 写进 Agent 大脑的修车工条款fullstack-agent.md#L95-L98当任何东西坏掉、表现怪异或需要修改时修好它是你的工作不是用户的读对应工具的 TROUBLESHOOTING.md 和 README自己诊断、自己修复。永远不要把用户打发去搜网。配套的 TROUBLESHOOTING.md 因此全部用AI 可以直接照做的祈使语气写成。安装文档的第一读者不再是人而是 Agent 自己——文档即运维。从这份提示词里学 4 个提示词工程技巧提示词即产品把行为规则、状态机、异常处理全部写进 Markdown配合版本管理、故障手册和社区协作见 CONTRIBUTING.md提示词就具备了软件工程的完整生命周期。状态感知的启动文件用 CLAUDE.md 做boot 文件同一入口自动分流出未安装 / 已安装两条路径天然支持幂等重跑。一次问完绝不多问所有用户决策集中在一个访谈阶段收集fullstack-agent.md#L49后续步骤静默回填交互体验因此像 GUI 而非问卷。数据主权写进规则永不删除、覆盖、移动用户创建的任何东西出现在启动文件、总指挥、每个阶段三处规则冗余重复是为了在长上下文里也不被遗忘。如何快速体验 fullstack-agent 安装向导体验成本很低三步git clone https://gitcode.com/gh_mirrors/fu/fullstack-agent cd fullstack-agent claude set me up然后 Claude Code 会自己开口我是安装器说set me up我陪你把 Agent 建起来。剩下的名字、部件、配置全部在对话里完成。装完后日常只需记住一件事在 Agent 的家目录包含这些工具文件夹的那个目录打开 Claude Code——在那里打开它才是它自己换到别的目录它就只是个陌生人了。 完整项目说明可看 README.md许可协议为 LICENSEAGPL-3.0-or-later可免费商用。想理解整套系统的手工原理仓库内的故障手册与各组件文档是最佳的深入阅读材料。赞分享【免费下载链接】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点击查看免费下载相关推荐Open Interpreter 中的 GPT-5 系统提示词解析Codex CLI 如何用一份 Markdown 约束编码 Agent 的行为Open Interpreter 中的 GPT 5 系统提示词解析Codex CLI 如何用一份 Markdown 约束编码 Agent 的行为 本文以 co人工智能AI Agent代码智能体开发工具交互助手Open InterpreterCodex CLIGPT-5.2 系统提示词深度解析一份终端编码 Agent 的完整行为规范Open InterpreterCodex CLIGPT 5.2 系统提示词深度解析一份终端编码 Agent 的完整行为规范 codex rs/core/人工智能AI Agent代码智能体开发工具交互助手FlexSearch源码深度剖析一核心Index类如何用Map/Set实现倒排索引FlexSearch源码深度剖析一核心Index类如何用Map/Set实现倒排索引 FlexSearch 是一款运行在浏览器和 Node.js 环境的下一搜索引擎后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考