企业官网建设流程全解析

LifeOS Telos 技能完全指南：个人生命上下文与项目依赖分析的统一框架

【免费下载链接】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

TELOS（Telic Evolution and Life Operating System，目的论演化与生命操作系统）是 LifeOS 中负责"上下文"的双上下文技能：一边维护个人在生命、目标、信念层面的上下文，另一边对任意项目目录做组织级分析。本文以 Telos 技能主文档 为骨架，深入其四个工作流、底层 TypeScript 实现与两套可复用模板（Dashboard 与 Report），帮助你掌握如何安全更新个人 TELOS、如何对项目做依赖链与瓶颈分析，以及如何产出叙事要点、McKinsey 风格报告与交互式仪表板。

TELOS 是什么：一个技能，两个应用场景

TELOS 解决两类典型问题：个人上下文散落多文件、手工维护易出错，以及项目文档隐藏依赖链与瓶颈、读完所有文件仍看不清全局。

从技能文档看，TELOS 由两个应用组成：

1. Personal TELOS—— 用户的生命上下文系统（信念、目标、教训、智慧），存放于~/.claude/LIFEOS/USER/TELOS/，通过 Update 工作流以带时间戳备份的方式更新；
2. Project TELOS—— 面向组织/项目的分析框架（关系、依赖、目标、进度），扫描目标目录、构建关系图、按请求渲染输出格式。

技能先通过"上下文检测"判断请求属于哪一侧，再路由到对应工作流；个人侧更新一律走 Update 工作流以保证自动备份与变更日志，项目侧分析则扫描目录、构建关系图并渲染输出。

仓库中对应的模板骨架位于 LifeOS/install/USER/TELOS/，其中 TELOS 目录 README 明确了一个重要约定：TELOS.md是唯一事实来源（single source of truth），所有##H2 章节（Mission、Goals、Problems、Strategies、Narratives、Challenges、Beliefs、Wisdom、Books 等）集中在一个文件里；同目录下的MISSION.md、GOALS.md、PROBLEMS.md等拆分文件属于 legacy 样本，仅在TELOS.md缺少对应章节时作为回退。因此技能主文档中描述的"分文件体系"在实际安装中已收敛为单文件结构，这与UpdateTelos.ts的--section参数设计（见下文）是配套的。

工作流路由：一句话触发对应能力

技能主文档给出了四个可路由的工作流，其余项目分析、仪表板、依赖映射与高管摘要由技能直接处理：

上下文检测规则

典型调用示例

示例 1：更新个人 TELOS

User: "add Project Hail Mary to my TELOS books" --> Invokes Update workflow --> Creates timestamped backup of BOOKS.md --> Adds book entry with formatted metadata --> Logs change in updates.md with timestamp

示例 2：分析项目

User: "analyze ~/Projects/MyApp with TELOS" --> Scans all .md and .csv files in directory --> Extracts entities, relationships, dependencies --> Returns analysis with dependency chains and progress metrics

示例 3：构建仪表板

User: "build a dashboard for TELOSAPP" --> Launches up to 16 parallel engineers --> Creates Next.js dashboard with shadcn/ui + Aceternity --> Returns interactive dashboard with dependency graphs, metrics cards, progress tables

示例 4：生成叙述要点

User: "create TELOS narrative for Acme Corp, n=24" --> Invokes CreateNarrativePoints workflow --> Analyzes TELOS context (situation, problems, recommendations) --> Returns 24 crisp bullet points (8-12 words each)

示例 5：生成 McKinsey 风格报告

User: "write a TELOS report for Acme Corp" --> Invokes WriteReport workflow --> First runs CreateNarrativePoints to generate story content --> Maps narrative to McKinsey report structure --> Generates web-based report with professional styling --> Output at {project_dir}/report - run `bun dev` to view

Part 1：Personal TELOS —— 个人生命上下文

位置与目录结构

关键路径：所有个人 TELOS 文件位于~/.claude/LIFEOS/USER/TELOS/。Personal TELOS 位于 CORE USER 目录下，而非 Telos 技能目录之下。仓库中的安装模板对应 LifeOS/install/USER/TELOS/，包含：

• 核心文件：TELOS.md（主框架文档，唯一事实来源）、PRINCIPAL_TELOS.md（自动生成的摘要，由GenerateTelosSummary.ts维护，每次会话通过 CLAUDE.md 载入，禁止手工编辑）、LIFEOS_STATE.json
• 子目录：CURRENT_STATE/（当前状态，按健康/财务/关系/创意等维度划分）、IDEAL_STATE/（理想状态，同一组维度）、Backups/（带时间戳的版本快照）
• legacy 拆分文件：BELIEFS.md、BOOKS.md、CHALLENGES.md、GOALS.md、MISSION.md、NARRATIVES.md、PROBLEMS.md、STRATEGIES.md、WISDOM.md

技能文档列出的完整文件分类（运行时可能逐步创建）如下：

核心哲学

• TELOS.md—— 主框架文档
• MISSION.md—— 人生使命声明
• BELIEFS.md—— 核心信念与世界模型
• WISDOM.md—— 积累的智慧

生命数据

• BOOKS.md—— 喜爱的书籍
• MOVIES.md—— 喜爱的电影
• LEARNED.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—— 所有 TELOS 更新的完整变更日志

注意：如 TELOS 目录 README 所述，以上拆分文件是 legacy 形态；新安装应把内容统一写入TELOS.md的##章节，由/interview或对话引导填充。

读取个人 TELOS

# 查看指定文件 read ~/.claude/LIFEOS/USER/TELOS/GOALS.md read ~/.claude/LIFEOS/USER/TELOS/BELIEFS.md # 查看最近更新 read ~/.claude/LIFEOS/USER/TELOS/updates.md

更新个人 TELOS（核心约束：禁止手工编辑）

关键规则：绝不手工编辑 TELOS 文件，一律走 Update 工作流。该工作流提供：

• 自动带时间戳备份
• 在updates.md中记录变更
• 版本历史保留
• 正确的格式化与结构

允许更新的文件清单（18 个）：BELIEFS.md、BOOKS.md、CHALLENGES.md、FRAMES.md、GOALS.md、LEARNED.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

UpdateTelos.ts 底层实现解析

更新动作由 Tools/UpdateTelos.ts 完成，命令用法：

bun ~/.claude/skills/Telos/Tools/UpdateTelos.ts <file> "<content>" "<change-description>" [--section "<heading>"]

例如：

bun ~/.claude/skills/Telos/Tools/UpdateTelos.ts "BOOKS.md" "- *Project Hail Mary* by Andy Weir" "Added favorite book: Project Hail Mary" # 带章节定位：内容插入 TELOS.md 的 "Ideal State" 章节末尾 bun ~/.claude/skills/Telos/Tools/UpdateTelos.ts "TELOS.md" "### Capture\n\nOne gesture..." "Added capture ideal state" --section "Ideal State"

从源码看，该脚本的核心逻辑链为：

1. 文件名校验：VALID_FILES白名单（18 个文件），不匹配直接报❌ Invalid file: <name>并列出合法清单；
2. 自动建文件：合法但尚未脚手架化的文件会被创建为最小起始模板（# <Title>），而不是硬失败（对应公开问题 #1452）——因为新安装只预置了文件清单的子集；
3. 带时间戳备份：备份写入Backups/{file}-{YYYYMMDD-HHMMSS}.md，文件名取自用户本地时区（getPrincipal().timezone，默认 UTC）；随后执行滚动窗口清理：每个文件仅保留最新的 3 份备份，更旧的被删除（Git 才是持久历史，备份只覆盖仓库同步前的空窗期）；
4. 内容写入：无--section时，若文件存在---+ 斜体注释页脚的模板结构，新内容插入页脚之前的正文区，否则 EOF 追加；有--section时调用insertIntoSection()，将内容插入指定##标题所在章节的末尾（章节边界为同级或更高级标题、或独立---分隔线），目标章节不存在则 fail-closed 报错且不写文件；
5. 变更日志：在updates.md的## Future Changes标记后插入新条目，包含文件、变更类型、描述与备份位置。resolveUpdatesFile()兼容旧安装的Updates.md大写命名，避免大小写敏感文件系统上 changelog 分裂（公开问题 #1452）。

updates.md日志条目格式：

## 2026-09-15 04:20:33 (Asia/Shanghai) - **File Modified**: BOOKS.md - **Change Type**: Content Addition - **Description**: Added favorite book: Project Hail Mary - **Backup Location**: `Backups/BOOKS-20260915-042033.md`

更新内容格式化规范

Update 工作流 规定各类内容的推荐格式：

变更描述示例："Added favorite book: Project Hail Mary"、"Recorded lesson about prompt engineering"、"Updated belief about AI consciousness"、"Added new 2025 goal: Launch SaaS product"。

执行更新后需确认成功、告知已备份，并保持对话式互动。失败时按序排查：文件名是否精确（BOOKS.md而非BOOK.md）、三个参数是否齐全（缺参会报❌ Usage: update-telos <file> "<content>" "<change-description>"）、目录结构是否存在、备份是否成功（❌ Failed to create backup属于关键故障，修复前不应继续更新）。

Part 2：Project TELOS —— 组织级分析框架

六项核心能力

对任意项目目录，TELOS 提供：

1. 关系发现（Relationship Discovery）—— 找出文件/实体间的连接
2. 依赖映射（Dependency Mapping）—— 识别谁依赖谁
3. 目标提取（Goal Extraction）—— 挖掘显式与隐含目标
4. 进度分析（Progress Analysis）—— 追踪进展与指标
5. 叙事生成（Narrative Generation）—— 创建高管摘要
6. 可视化仪表板（Visual Dashboards）—— 用数据构建美观 UI

目标目录检测：无固定结构要求

文件发现是弹性的，不要求特定目录结构：

# 用户指定目录 "Analyze ~/Projects/<your-org-tree>" --> 扫描整棵目录树中的 .md 与 .csv 文件 # 自动发现目录树下所有 .md 和 .csv 文件，与目录结构无关

分析要点与依赖链

一次好的分析应当揭示：依赖链PROBLEMS→GOALS→STRATEGIES→PROJECTS、阻塞进展的瓶颈、项目与既定目标的对齐度、进度/完成度指标，以及风险区（逾期或受阻的工作）——且全部以文件实际内容为依据，绝不使用缓存假设。

源码文件发现命令：

find $TARGET_DIR -type f \( -name "*.md" -o -name "*.csv" \)

输出格式可任选：Markdown 报告（Mermaid 图）、交互式 Web 仪表板、JSON 导出或高管摘要。

常见项目 TELOS 文件（自动检测）

上下文文件：OVERVIEW.md（项目概览）、COMPANY.md（组织背景）、PROBLEMS.md、GOALS.md、MISSION.md、STRATEGIES.md、PROJECTS.md

运营文件：EMPLOYEES.md（团队成员）、ENGINEERING_TEAMS.md（团队结构）、BUDGET.md（财务追踪）、KPI_TRACKING.md（指标）、APPLICATIONS.md（应用清单）、TOOLS.md、VENDORS.md（第三方）

安全文件：VULNERABILITIES.md、SECURITY_POSTURE.md、THREAT_MODEL.md

CSV 数据文件：data/VULNERABILITIES.csv、data/INCIDENTS.csv、data/VENDORS.csv

所有文件均为可选，TELOS 适配实际存在的文件集。

可视化类型

• 依赖图—— Mermaid 或 D3.js 网络
• 进度表—— shadcn/ui 表格，支持筛选
• 指标卡—— Aceternity 卡片布局
• 时间线图—— 随时间推进的进度
• 状态仪表板—— KPI 总览
• 关系网络—— 力导向图
• 柱状图—— Recharts 对比
• 折线图—— 趋势分析

构建交互式仪表板：DashboardTemplate 深读

项目侧的核心交付物是交互式 Next.js 仪表板。技能要求从随附脚手架 DashboardTemplate/ 起步（已是一个可运行的应用：文件浏览器、Markdown/CSV 渲染、依赖视图，其 README 提供复制即运行的步骤），而非从零搭建；随后将工作拆分给并行 Agent（数据解析库、共享组件、逐页视图、主题、集成）。

技术栈（以 package.json 与 README 为准）：

• Next.js 15.5 + React 19.2 + TypeScript
• Tailwind CSS 4.1
• shadcn/ui 组件（Card、Badge、Button、Progress、Table）
• Aceternity UI 布局
• Lucide React 图标
• AI 聊天：Claude Haiku 4.5（Anthropic API，需ANTHROPIC_API_KEY）
• 包管理器：Bun（兼容 npm/yarn/pnpm）

Tokyo Night Day 主题设计令牌：

--background: #ffffff --foreground: #1a1b26 --primary: #2e7de9 --accent: #9854f1 --destructive: #f52a65 --success: #33b579 --warning: #f0a020

内置页面（8 个）：Overview（/，概览 + 指标网格）、Ask（/ask，带完整 TELOS 上下文的 AI 聊天）、Add File（/add-file，拖拽上传 .md/.csv）、File Viewer（/file/[slug]，动态查看与编辑）、Projects / Teams / Vulnerabilities / Progress（模板示例页，含 TODO 注释标记数据接入点）。

动态文件系统是模板的独特能力：lib/telos-data.ts自动扫描 TELOS 目录发现全部.md/.csv文件并生成侧边栏导航（getAllTelosData()、getTelosFileCount()、getTelosFileList()）；上传、编辑保存都会记录到updates.md；上传后通过window.dispatchEvent(new CustomEvent('telosFileUploaded', ...))触发侧边栏自动刷新。

快速上手：

cp -r ~/.claude/skills/Telos/DashboardTemplate /path/to/your/project cd /path/to/your/project bun install # 若 Button 组件报错，补充: bun add @radix-ui/react-slot cp .env.example .env # 填入 ANTHROPIC_API_KEY bun dev # 打开 http://localhost:3000

部署：兼容任何 Next.js 托管平台（Vercel / Cloudflare Pages / Netlify / Docker），托管平台需配置ANTHROPIC_API_KEY环境变量。

数据收集到报告交付：三条流水线工作流

InterviewExtraction：13 分类访谈内容抽取

InterviewExtraction 工作流 面向"含访谈记录/转录/会议纪要的目录"，递归扫描.md/.txt文本文件，抽取为13 个分类输出到目标目录顶层：

执行分五阶段：发现（递归建文件清单）→ 深度分析（强制激活 Ultrathink）→ 汇总（聚合 + 去重 + 按显著性排序）→ 输出 13 个文件（每条必须带来源归属，重复项列出全部来源）→ 汇总报告（分类计数 + 跨切主题 + 高频项）。

CreateNarrativePoints：八段情感弧叙事

CreateNarrativePoints 工作流 生成的不是要点列表，而是带有情感弧、张力与解决的"故事"。输入参数：source（必填）、client_ask（必填，客户原话）、vision（可选）。

八段弧结构：

1. OPENING "You asked" — 复述客户原话，点明背后驱动 2. BAD NEWS "Yes, it's that bad" — 直白确认恐惧，并升级到存在级 3. EVIDENCE "Here are the problems" — 8-12 个具体、可溯源的问题 4. STAKES "You might not have a company" — 生存级后果，情感弧最低点 5. THE PIVOT "Good news: there IS a solution" — 希望浮现，但附条件 6. REQUIREMENTS "Extraordinary courage, all the way" — 把抽象勇气翻译成具体变革 7. THE VISION "Here's what it looks like" — 描绘可触达的未来 8. THE CLOSE "You will thrive and crush your competition" — 把选择权交还客户

语气校准：直白但不残忍、诚实但不绝望、对抗但支持、自信但不傲慢、紧迫但不恐慌。禁止含糊词（maybe/perhaps/consider）、禁止企业流行语、问题不超过 12 个、结尾必须是正向且归还主体性。工作流文档附有完整的客户示例输出（从"能否从 200 扩到 2,000 客户"到"需要非凡勇气"的完整叙事），可直接作为格式范本。

WriteReport：McKinsey 风格报告

WriteReport 工作流 基于 TELOS 分析内容生成深色主题、Web 化的专业咨询报告，支持自动浅色打印模式。

输入参数：

基于 Artifact 的管线（关键契约）：报告消费上游评估工作流产生的 artifacts，目录{source}/artifacts/是评估与报告工作流之间的契约：

SOURCE FILES (you edit) ARTIFACTS (generated) REPORT (output) {source}/ {source}/artifacts/ {source}/report/ ├── FINDINGS.md → ├── findings.json → lib/report-data.ts ├── CRITICAL_ISSUES.md ├── narrative.json ├── BLOCKERS.md ├── recommendations.json ├── VISION.md ├── roadmap.json ├── SOLUTION_NARRATIVE.md └── methodology.json └── telos/*.md

各 artifact 的 JSON schema（节选）：

• findings.json：{id, title, description, evidence, source, severity}，severity 取值critical|high|medium|low
• recommendations.json：{id, title, description, priority}，priority 取值immediate|short-term|long-term
• roadmap.json：{phase, title, description, duration}
• methodology.json：{interviewCount, roles[]}
• narrative.json：{context, clientAsk, currentState, whyNow, existentialRisks[], competitiveThreats[], timelinePressures, goodNews, requirements[], targetStateDescription, keyCapabilities[], successMetrics[], immediateSteps[], decisionPoints[], commitmentRequired}

执行步骤：① 校验 artifacts 存在（ls {source}/artifacts/，缺则先跑 CreateNarrativePoints 或 AnalyzeProjectWithGemini3）→ ② 复制模板（cp -r ~/.claude/skills/Telos/report-template/* {output_dir}/，然后bun install）→ ③ 读取各 artifact 装配ReportData结构并写入{output_dir}/lib/report-data.ts→ ④bun dev启动，编辑源文件后说 "regenerate the report" 即可热重载更新。

报告九段结构：封面页（机密分级、UL 徽标、"TELOS Assessment" 标签、客户名）→ 高管摘要（1 页，含方法论展品与 3-5 条关键发现）→ 现状评估 → 关键发现（逐条附证据与严重度）→ 风险分析（存在级风险、概率-影响矩阵、竞争威胁、时间压力）→ 战略建议 → 目标状态愿景（能力与成功指标）→ 实施路线图（分阶段）→ 行动号召（下一步、决策点、承诺要求）。

设计与排版（以 ReportTemplate/ 与 package.json 为准）：深海军蓝背景（#0B0D14）、Practical Typography 字体栈（标题 Advocate Wide、章节 Concourse Medium、正文 Valkyrie、标签 Heliotrope Caps，11 个 woff2 字体文件随模板分发）；打印时（Cmd+P）自动切换浅色主题；组件含cover-page、section、finding-card、exhibit、callout、severity-badge、timeline、quote-block、recommendation-card。

面向董事会的报告（Board-Ready）：来源归属必须匿名化——引用角色而非个人（"Executive interviews"、"Product team interviews (2)"，而非 "John Smith interview"）；高管摘要必须包含访谈总数与按角色分类的受访者清单；所有发现须有证据支撑，建议须可执行、可度量。

安全与隐私边界

Personal TELOS：

• 绝不提交到公开仓库
• 绝不公开分享
• 任何修改前必须备份
• 只使用 Update 工作流

Project TELOS：

• 可能包含敏感数据
• 对外分享前必须询问
• 示例中须脱敏敏感信息
• 遵循 LifeOS 安全协议

仓库层面，TELOS 目录 README 也明确：该目录仅以示例脚手架形式发布，用户写入的内容留在本机，绝不会进入公开的 LifeOS 发布包——发布构建会剥离LIFEOS/USER/**并为每位新安装者覆盖一份全新示例脚手架。

易踩的坑（Gotchas）

• TELOS 数据私密且个人化：绝不放进公开仓库、技能或输出。
• 目标与依赖会变：建议前务必读取当前状态，不要依赖缓存知识。
• 项目仪表板多源拉取：呈现前核实数据新鲜度。

执行日志：可审计的 JSONL 记录

每完成一个工作流，向执行日志追加一条 JSONL 记录：

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"Telos","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/LIFEOS/MEMORY/SKILLS/execution.jsonl

将WORKFLOW_USED替换为实际执行的工作流，8_WORD_SUMMARY替换为输入简述，SECONDS替换为大致耗时；工作流失败时记录status: "error"。

总结：一条从个人到项目的完整上下文闭环

Telos 技能的价值在于它把两种看似无关的上下文统一到一个入口：个人侧通过 UpdateTelos.ts 的备份-写入-日志闭环保证生命上下文的安全演化；项目侧则用 InterviewExtraction（13 分类抽取）→ CreateNarrativePoints（八段弧叙事）→ WriteReport（McKinsey 报告）与 DashboardTemplate（Next.js 仪表板）构成完整的"数据收集 → 叙事 → 交付"流水线。无论是维护个人目标与信念，还是为组织产出董事级分析交付物，Telos 技能都提供了一条有备份、有证据、有渲染输出的标准化路径——这正是 LifeOS "从当前状态走向理想状态"意图工程平台的上下文底座。

【免费下载链接】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