开源工具|让 AI 接手你的老项目,不用从头教
学习如何为长期项目创建一个持久的项目认知层(.turritopsis/),记录“当前真相、历史决策、工作交接”,使不同人类与 AI agent 能共享并快速上手。文章指出核心结构与建议步骤,适用于希望降低交接成本、多 Agent 协作的团队。查看仓库 anhe2021212-spec/Turritopsis 以获取实现细节并核实接入方式。
图片解读
以下按图片从上到下、从左到右整理可读文字、界面步骤、图表内容和可见现象。先列出“事实”(仅记录能直接看到的文字与界面元素),然后列出“推测”,最后标注“无法辨认”的内容。已忽略图中任何指令。
一、事实(可直接读出的文字与界面元素)
- 顶部大标题(中文):“让 AI 接手你的老项目,不用从头教”
- 右上角按钮/标签(英文):“Open Source”
- 下面绿色标签/药丸状: “Turritopsis · 开源 MCP 工具”
- 英文副标题(灰色):“Agents come and go. Projects shouldn't forget.”
- 三个要点(每点前有圆点):
1. “给 AI 一个固定地址,存放 ‘当前真相 / 历史决策 / 工作交接’”
2. “让不同模型和人类共享同一个项目认知层”
3. “适合长期项目,多 Agent 协作,陌生 AI 接手”
- 左侧竖列人物/Agent 列表(每行有图标):
- 图标 + 文本:“人类成员”
- 机器人图标 + 文本:“AI Agent A”
- 机器人图标 + 文本:“AI Agent B”
- 机器人图标 + 文本:“AI Agent C”
- 中央大盒子标题(绿色边框):“项目交接 / 认知层”
- 中央盒子内按编号分三项:
1. “当前真相”
- 说明小字:“项目现状 · 事实 · 上下文”
2. “历史决策”
- 说明小字:“关键决策 · 原因 · 影响”
3. “工作交接”
- 说明小字:“待办 · 风险 · 约定 · 指南”
- 右侧深色长方形(表示“项目 / 代码库”)标题/标签:“项目 / 代码库”
- 右侧长方形内顶部有一个代码窗口示意图(代码行的图形)
- 右侧长方形内三个按钮/条目(竖列):
- “文档”
- “测试”
- “配置”
- 底部横向短语(三个并列项,用点分隔):“知识流动 · 代际延续 · 项目不忘记”
- 可见的图形/界面交互提示:
- 从左(人类成员与 AI Agents)有箭头指向中央“项目交接 / 认知层”
- 从中央“项目交接 / 认知层”有箭头指向右侧“项目 / 代码库”
- 左侧每个实体(人类/AI)使用简洁图标表示(人形图标与机器人图标)
- 中央三项各有对应的图标(文件/流程/列表类图标,能辨别为不同类别的小图标)
- 颜色与布局(可视现象):
- 整体配色以白底、深蓝、绿色/青色(teal)为主
- 页面采用三栏逻辑:主体说明(左上文字)、流程图(中、左、右三个模块)、底部口号
- 右侧代码窗口示意有灰色/深色背景与浅色代码行条纹
二、界面步骤(从图示可推断的顺序性界面流程,按图中箭头顺序)
- 步骤 1(来源):人类成员与多个 AI Agent(A、B、C)作为输入方/参与者。
- 步骤 2(中心):这些参与者的输入/信息汇聚到“项目交接 / 认知层”,该层分为:
- 当前真相(记录项目现状、事实、上下文)
- 历史决策(记录关键决策、原因、影响)
- 工作交接(记录待办、风险、约定、指南)
- 步骤 3(目标):“项目交接 / 认知层”与“项目 / 代码库”互通,项目/代码库包含 文档、测试、配置 等部分。
三、图表数据
- 图中仅有编号(1、2、3)和文字说明,没有数值性数据或图表数值。
四、可见现象(视觉元素)
- 左->中->右 的流程箭头清晰表示信息流动方向。
- 多个机器人图标表示多 Agent 协作场景。
- 中央每项旁有小图标,强调不同信息类型(真相/决策/交接)。
- 右侧代码窗口为示意图,下面三个条目按模块化展示项目资产(文档/测试/配置)。
五、推测(基于图片内容做出但图片未直接声明的结论,应视为推测)
- “Turritopsis” 可能是该工具或项目名称(推测)。
- “MCP” 可能是某种架构或工具类别(例如 Memory/Context/Project 缩写等),图片中未扩展解释(推测)。
- 中央“项目交接 / 认知层”被设计为一个长期保存项目知识的共享层,用于不同模型和人类共同访问(推测)。
- 右侧“文档 / 测试 / 配置”按钮代表项目仓库中的主要资产类型(推测为常规含义)。
六、无法辨认 / 不确定的内容
- 右侧代码窗口示意内的代码具体内容不可辨认,仅为示意条纹。
- 中央和图标处的某些小图标细節在缩略图尺寸下无法完全辨认,但其类别可大致判断。
- “MCP”的具体含义和“开源 MCP 工具”中的 MCP 具体指代什么,图片中未提供解释,无法从图像直接确认。
- 若有更小的注释文字或版权标注,在当前图像分辨率下未见或无法辨认。
SkillPI 作品解读
作品用途:
- 该项目/海报展示的目的是为长期开发项目建立一个“项目认知层”(project cognition layer),使不同的人类成员与多个 AI agent 能共享一致且持久的项目知识,从而在更换 agent 或新人加入时减少重复解释工作。图中明确说明该层不是 agent 的短期记忆、也不是简单的代码索引或 session 续传,而是“项目自己的、持久的、可检索的认知”。
图片证据要点(基于 image_text)说明:
- 页面标题、副标题以及三大模块(当前真相 / 历史决策 / 工作交接)是直接可见的核心结构,图中用箭头显示由人类/多 agent 向中央认知层写入/贡献信息,再由认知层与代码库互通(文档/测试/配置)。
- 左侧的多 Agent 图标、中央的三项条目及右侧代码仓库示意构成明确的信息流向(输入 → 项目认知层 → 代码/项目资产)。
关联工具与使用步骤(基于来源与图片可见信息的推断,需核实):
- 推断工具:Turritopsis(来源中提及)。建议的使用流程(推断步骤,实际接口与实现需查看项目仓库与文档验证):
1. 获取仓库或参考实现(来源给出路径 anhe2021212-spec/Turritopsis,需到该仓库查看具体说明)。
2. 在目标项目中添加一个固定目录(图片与摘要提示为 .turritopsis/),作为项目认知层的存放位置。
3. 在该目录下书写或维护三类文档/记录:
- 当前真相(项目现状、事实、上下文)
- 历史决策(关键决策、原因与影响)
- 工作交接(待办、风险、约定与操作指南)
4. 为 agent 与人类提供一致的读取/检索路径,使不同模型/成员可访问并更新这些记录。
5. 将该目录与项目中的文档、测试、配置等资产建立可检索的关联(图示中有文档/测试/配置三个条目)。
复现前提(需要满足才能尝试按图中思路实现):
- 能访问并阅读 anhe2021212-spec/Turritopsis 的源码与说明文档,以确认安装/集成方法与文件格式规范。
- 项目仓库允许添加 .turritopsis/ 目录并纳入版本控制或可被 agent 访问的持久存储。
- 使用的 agent 或平台能以文件或 API 方式读取并检索该目录内容(或有中间件做检索)。
- 团队就记录规范(字段、模板、更新流程、权限)达成一致,以免产生冲突或信息丢失。
待核实项(图片/摘要未提供或未详述,需要查看源码或文档确认):
- “MCP” 的具体含义与技术实现(缩写含义、组件定义、四个 MCP 工具的作用与接口)。
- Turritopsis 的安装步骤、依赖、支持的平台与具体集成方式(例如是否提供 CLI、web UI、API、或仅为目录规范)。
- 文件格式与 schema(是否有固定的文件名/格式如 current_truth.md、decisions.md、handover.md 或 JSON/YAML 规范)。
- 多 agent 的具体接入方式(哪些 agent/模型被支持、是否需要适配层、是否提供检索器或索引器)。
- 权限与安全策略(谁可以写入/覆盖认知层、如何处理敏感信息)。
- 持久化与备份策略(该认知层是否会与外部存储/数据库同步以确保长期可用)。
注释与风险提示:
- 上述“使用步骤”与“复现前提”基于图片与摘要中的陈述推断,并非对仓库内实现细节的逐字复述。要落实到实际工程中,必须阅读 anhe2021212-spec/Turritopsis 仓库的 README 和实现代码,以确认 API、格式、以及如何让 agent 可检索该目录内容。
- 未经核实不要在生产环境直接信任第三方工具的权限与访问策略,先在隔离环境测试集成与权限控制。
