LifeOS Telos Update 工作流解析:引导式对话更新个人生命上下文并自动备份

LifeOS Telos Update 工作流解析:引导式对话更新个人生命上下文并自动备份 LifeOS Telos Update 工作流解析引导式对话更新个人生命上下文并自动备份【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS导读本文深入解析 LifeOS 中 Telos 技能的Update 工作流对应文档 Update.md当用户想向个人 TELOSTelic Evolution and Life Operating System目标驱动的生命上下文框架中追加一本读过的书、一条人生教训或一个新目标时AI 助手如何以对话方式引导更新并通过底层update-telos脚本自动完成时间戳备份与变更日志。读完本文你将掌握 TELOS 文件的完整分类体系、update-telos 命令的三参数调用约定、--section精确插入机制、备份轮换策略与变更追踪的源码级实现以及一套可直接复用的错误处理与安全准则。TELOS 是什么个人生命上下文框架TELOS 是 LifeOS 的核心个人上下文系统集中存放于运行时目录~/.claude/LIFEOS/USER/TELOS/仓库内对应脚手架目录 LifeOS/install/USER/TELOS。它记录的不是零散笔记而是用户的信念、目标、教训、智慧与个人哲学——所有会长期影响决策的人生操作系统数据。文件分类体系完整 taxonomy根据 Update 工作流文档TELOS 目录下的文件可划分为五大类。注意全新安装的脚手架scaffold只内置其中一部分文件其余文件会随着生命数据的积累逐步创建工作流会自动跳过尚不存在的文件分类文件用途核心哲学TELOS.md主框架文档MISSION.md人生使命陈述BELIEFS.md核心信念与世界模型WISDOM.md累积的智慧生命数据BOOKS.md喜爱的书籍MOVIES.md喜爱的电影LESSONS.md学到的教训WRONG.md曾经错过的认知成长追踪心智模型FRAMES.md心智框架与视角MODELS.md心智模型NARRATIVES.md个人叙事STRATEGIES.md正在采用的策略目标与挑战GOALS.md人生目标PROJECTS.md进行中的项目PROBLEMS.md待解决的问题CHALLENGES.md当前挑战PREDICTIONS.md对未来的预测TRAUMAS.md过往创伤供上下文与疗愈变更追踪updates.md综合变更日志backups/所有变更的时间戳备份值得说明的是仓库当前脚手架实际内置的文件是这些分类的一个子集见 LifeOS/install/USER/TELOSTELOS.md、MISSION.md、BELIEFS.md、GOALS.md、PROBLEMS.md、CHALLENGES.md、STRATEGIES.md、NARRATIVES.md、WISDOM.md、BOOKS.md等这印证了脚手架启动子集、数据驱动增量创建的设计。单一事实来源TELOS.md从 TELOS 目录 README 可以看到该项目对 TELOS 文件体系有一个关键演进TELOS.md是唯一的规范文件single source of truth所有内容以##二级标题分节组织Mission、Goals、Problems、Strategies、Narratives、Challenges、Beliefs、Wisdom、Books……其余如MISSION.md、GOALS.md等拆分文件是为向后兼容保留的 legacy 样例工具仅在TELOS.md缺少对应分节时才回退读取。因此 Update 工作流中列出的 18 个合法文件名实际是对完整 taxonomy 的兼容层——源码的合法文件白名单正是按这份清单实现的详见下文。何时触发 Update 工作流Update 工作流通过自然语言意图触发。当用户说出类似以下语句时AI 助手应转入该流程I just finished a great book, add it to TELOS刚读完一本好书加进 TELOSAdd this lesson I learned to TELOS把这条教训加进 TELOSUpdate my beliefs with...用……更新我的信念I want to add a goal我想加一个目标Record this in my wisdom把这条记入我的智慧Update TELOS with...用……更新 TELOS任何表明想更新生命上下文的表述从 SKILL.md 的工作流路由表可以确认add to TELOS、update my goals、add book to TELOS等短语都会路由到 Workflows/Update.md。该技能同时承担Personal TELOS个人生命上下文与Project TELOS对 .md/.csv 目录做依赖分析并产出报告/看板双职责而更新个人 TELOS这一路径始终走 Update 工作流以保证备份和变更日志自动发生。三条铁律工作流文档明确要求执行前必须恪守绝不手工编辑 TELOS 文件——永远使用本命令始终创建备份——每次变更都要记录并备份保持对话式——不要只是执行要与用户就更新内容展开交流校验输入——确保更新内容对目标文件是合理的。update-telos 命令参数与调用约定Update 工作流的核心是一条名为update-telos的命令运行时位于~/.claude/skills/Telos/Tools/UpdateTelos.ts仓库内对应 UpdateTelos.ts。它是唯一的合法写入通道——源码注释明确写道 this tool is the sole sanctioned write path。主命令引导式更新FILE$1; CONTENT$2; DESCRIPTION$3; bun ~/.claude/skills/Telos/Tools/UpdateTelos.ts $FILE $CONTENT $DESCRIPTION三个位置参数分别是参数含义示例$1File目标文件名必须与合法清单完全一致BOOKS.md$2Content要追加的实际文本内容- *Project Hail Mary* by Andy Weir$3Description变更描述写入变更日志Added favorite book: Project Hail Mary可选参数--section除三个位置参数外脚本还支持--section heading可选参数在位置参数之后传入。它在源码头部注释中有精确定义不带--section时内容追加到文件末尾若文件带斜体页脚则插入页脚之上带--section时内容落到指定分节的末尾——TELOS.md是分节式结构若直接追加到 EOF会把一条 Ideal State 条目错误地归档到 Changelog 分节下。当分节不存在时脚本fail-closed安全失败不写入任何内容。# 追加到文件末尾 update-telos BOOKS.md - Project Hail Mary by Andy Weir Added new favorite book # 插入到指定分节末尾如 TELOS.md 的 Ideal State 分节 update-telos TELOS.md ### Capture\n\nOne gesture... Added capture ideal state --section Ideal State辅助命令工作流还定义了三条辅助命令用于查看合法文件清单、最近变更与单文件内容# 列出全部合法 TELOS 文件 echo Valid TELOS files: ... # BELIEFS.md / BOOKS.md / CHALLENGES.md / FRAMES.md / GOALS.md # LESSONS.md / MISSION.md / MODELS.md / MOVIES.md / NARRATIVES.md # PREDICTIONS.md / PROBLEMS.md / PROJECTS.md / STRATEGIES.md # TELOS.md / TRAUMAS.md / WISDOM.md / WRONG.md # 查看最近 50 行 TELOS 更新记录 head -50 ~/.claude/LIFEOS/USER/TELOS/updates.md # 查看指定 TELOS 文件内容 FILE$1; cat ~/.claude/LIFEOS/USER/TELOS/$FILE源码级实现UpdateTelos.ts 的完整执行链路合法文件白名单与校验脚本第 62-67 行维护了一个硬编码白名单VALID_FILES与工作流文档的清单一一对应18 个文件且注意是LESSONS.md而非 SKILL.md 中写到的LEARNED.md以脚本为准const VALID_FILES [ BELIEFS.md, BOOKS.md, CHALLENGES.md, FRAMES.md, GOALS.md, LESSONS.md, MISSION.md, MODELS.md, MOVIES.md, NARRATIVES.md, PREDICTIONS.md, PROBLEMS.md, PROJECTS.md, STRATEGIES.md, TELOS.md, TRAUMAS.md, WISDOM.md, WRONG.md ];参数不足args.length 3或文件名不在白名单中时脚本都会打印❌错误并process.exit(1)安全退出。文件不存在时的容错自动创建 starter源码注释说明了一个设计决策脚手架只内置合法文件的一个子集因此当目标文件尚未创建时脚本不再硬性失败而是自动创建一个最小 starter 文件# Title\n并提示✅ Created starter file: filename随后正常执行备份与追加流程public issue #1452 的产物。备份机制时间戳快照 滚动窗口每次写入前脚本执行以下备份逻辑第 185-206 行生成时间戳getLocalTimestamp()基于主理人Principal配置的时区生成YYYYMMDD-HHMMSS格式时间戳——注意源码当前实现读取的是 identity.ts 中getPrincipal()返回的timezone字段默认回退 UTC而工作流文档描述的是统一使用 Pacific Time以源码为准时间戳时区跟随LIFEOS_CONFIG.toml的[principal].timezone配置。复制备份将目标文件复制为Backups/文件名去 .md-时间戳.md。滚动清理每个文件只保留最新的 3 份备份slice(0, -3)删除更旧的。源码注释解释了原因Git 才是持久历史本地备份只覆盖到下次仓库同步前的空窗期——在引入该清理逻辑前2026-07-12仓库积累过 79 份过期备份。内容追加页脚感知与分节插入写入逻辑第 208-240 行处理两种形态无--section时检测文件是否以--- 斜体注释页脚结尾TELOS 模板的标准形态。若存在页脚新内容插入到页脚之前的正文末尾避免新条目落到页脚注释之后否则普通 EOF 追加。有--section时调用导出的insertIntoSection()函数第 109-141 行已export供测试。该函数去除#前缀后对分节标题做大小写不敏感前缀匹配如Ideal State可匹配## Ideal State (The IDEAL in ...)分节结束于同级或更高级标题或独立的---分隔线越过尾部空行、以单空行分隔插入内容分节不存在时返回null调用方打印❌ Section not found in file: section并退出——已生成的备份保留在 Backups/ 目录但目标文件分毫未动fail-closed。变更日志updates.md 的写入策略logChange()第 246-297 行负责记录变更日志时间戳使用YYYY-MM-DD HH:MM:SS (时区)格式同样跟随主理人时区变更日志文件名做了大小写兼容处理resolveUpdatesFile()优先使用已存在的updates.md否则Updates.md都不存在则惰性创建小写updates.md同样是为了避免大小写敏感文件系统把日志分裂成两个文件public issue #1452插入位置优先在## Future Changes标记之后保证最新在前找不到该标记则回退为文件末尾追加每条日志包含四个字段File Modified、Change Type固定为Content Addition、Description、Backup Location指向Backups/时间戳.md。执行完成后脚本输出汇总 TELOS update complete! File: BOOKS.md Backup: Backups/BOOKS-20260812-143000.md Change: Added favorite book: Project Hail Mary五步处理流程从请求到确认工作流文档定义了一套标准的处理顺序AI 助手应严格遵循Step 1 解析请求Parse the Request——确定三点要添加什么一本书、一条教训、一个信念……应该进哪个文件BOOKS.md、LESSONS.md、BELIEFS.md……背景是什么为什么这对用户重要Step 2 准备更新内容Prepare the Update——按文件类型格式化文本文件类型推荐格式Books- *Book Title* by Author NameLessons## Lesson Title\n\n[Description]Beliefs## Belief Statement\n\n[Explanation]Goals## Goal Title\n\n[Details]Wisdom Quote or wisdom statement\n\n[Context or attribution]同时准备一条清晰的变更描述例如Added favorite book: Project Hail MaryRecorded lesson about prompt engineeringUpdated belief about AI consciousnessAdded new 2025 goal: Launch SaaS productStep 3 执行更新Execute the Update——依次传入文件名、内容、描述三个参数bun ~/.claude/skills/Telos/Tools/UpdateTelos.ts BOOKS.md - *Project Hail Mary* by Andy Weir Added favorite book: Project Hail MaryStep 4 确认并互动Confirm and Engage——更新成功后告知用户添加了什么注明已完成备份询问是否还有其他内容要添加或更新视情况对这次更新的意义做一点反思。Step 5 优雅处理错误Handle Errors Gracefully——命令失败时依次排查文件名是否合法必须与清单完全一致、内容是否被正确引用、TELOS 目录结构是否存在并给出可操作的修复指引。对话式实战示例工作流文档提供了四个端到端示例完整还原了用户意图 → 格式化 → 执行 → 确认对话的闭环示例 1添加一本书用户说 I just finished Project Hail Mary, add it to TELOS助手回复确认将 Andy Weir 的《Project Hail Mary》加入 BOOKS.md执行命令后输出✅ Added to BOOKS.md and backed up!并顺势追问那本书对压力下的问题解决有非常有趣的见解。你还想捕捉它带来的其他东西吗——比如一条教训或洞见示例 2记录一条教训用户说 Add a lesson about always backing up important context before making changes助手将内容格式化到 LESSONS.md确认备份成功后关联到系统设计与个人知识管理并建议要不要把这条也作为策略加进 STRATEGIES.md示例 3更新信念用户说 I want to update my beliefs - I think AI will become conscious within the next decade助手按## AI Consciousness Timeline标题 说明文本的格式写入 BELIEFS.md并在确认后温和质疑这个时间线比大多数预测都乐观。是什么让你如此有信心示例 4批量更新用户说 Add three books: Dune, Foundation, and Neuromancer助手执行三次独立的 update-telos 命令每本书一次全部确认备份完成后追问这几本是你最近读的还是想确保记录在案的长年最爱错误处理与校验规则常见错误及修复错误场景错误输出修复方式文件名非法❌ Invalid file: BOOK.md文件名必须完全一致是BOOKS.md复数而非BOOK.md参数缺失❌ Usage: update-telos file content change-description补齐三个参数文件不存在❌ File does not exist: [path]检查 TELOS 目录结构注当前版本脚本会自动创建 starter 文件见上文备份失败❌ Failed to create backup: [error]检查目录权限与备份文件夹分节不存在❌ Section not found in file: section确认--section的分节标题拼写此时目标文件未被写入执行前的五条校验规则✅ 文件名在合法清单中✅ 内容非空✅ 变更描述准确反映本次变更✅ 内容格式与文件类型匹配✅ 用户已确认更新针对重大变更Vector 同步企业相关更新的选择性推送工作流文档记录了一条 2026-08-12 的常驻指令standing directive个人 TELOS 与主理人在 Vector 平台上的公司 tenant 存在内容重叠tenant 名称只出现在私有的LIFEOS/USER/CONFIG/OPERATIONAL_RULES.md的 Vector 规则中绝不写入本文档。当更新涉及企业相关内容——商业目标、工作策略或项目、公司状态——应在执行本地更新的同一动作中通过_VECTOR网关将该切片推送到 tenant 的状态文档。关键约束必须如实理解_VECTOR是私有技能不在公开发布包中——未安装它的环境自动跳过此同步写入受 steward 门控steward-gated同步是选择性的绝不整库搬运个人材料健康、创伤、财务、人际关系、私人叙事永远不跨域若写入路径无法接收文档必须显式标记绝不能静默跳过。安全与隐私TELOS 包含主理人最私密的信息工作流文档给出了明确的安全红线每次变更前必须完成备份绝不把 TELOS 提交到公开仓库绝不公开分享 TELOS 内容始终保持版本历史。这一原则与 TELOS 目录 README 的隐私声明互为印证该目录只以引导脚手架sample scaffold形式随安装包发布任何用户写入的内容都留在本机发布构建器会剥离LIFEOS/USER/**并为每个新安装者重新铺设空白样例。备份系统四要素时间戳备份到Backups/、变更记录到updates.md、完整版本历史、统一的时区时间戳全部由脚本自动完成无需人工干预。相关文件索引工作流定义LifeOS/install/skills/Telos/Workflows/Update.md核心实现唯一合法写入通道LifeOS/install/skills/Telos/Tools/UpdateTelos.ts技能总览与工作流路由LifeOS/install/skills/Telos/SKILL.mdTELOS 目录脚手架与使用说明LifeOS/install/USER/TELOS/README.md主理人时区解析备份时间戳依赖LifeOS/install/hooks/lib/identity.ts同技能其他工作流InterviewExtraction.md、CreateNarrativePoints.md、WriteReport.md【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考