关于 Telos
Telos 是用于个人生活背景维护和项目分析的技能,面向整理目标、信念与项目文档的用户。它通过带时间戳的备份保护个人更新,并从 Markdown 和 CSV 文件提取项目依赖与进展。
主要功能
- 01维护个人目标、信念与经验
- 02更新时创建备份并记录变更
- 03分析 Markdown 和 CSV 项目文件
- 04提取目标、依赖与进度
- 05生成报告、叙述要点或仪表板
适用场景
- 01安全更新个人目标或信念记录
- 02梳理项目中的目标与依赖关系
- 03检查项目进度、瓶颈和风险
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ danielmiessler/ lifeos --skill telos安装后在 Claude Code 中输入/telos确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
DashboardTemplate/.gitignoreREADME.mdbun.locknext.config.mjsnext-env.d.tspackage.jsonpostcss.config.mjsDashboardTemplate/app/page.tsxlayout.tsxglobals.cssDashboardTemplate/app/add-file/page.tsxDashboardTemplate/app/api/chat/route.tsDashboardTemplate/app/api/file/get/route.tsDashboardTemplate/app/api/file/save/route.tsDashboardTemplate/app/api/files/count/route.tsDashboardTemplate/app/api/upload/route.tsDashboardTemplate/app/ask/page.tsxDashboardTemplate/app/file/[slug]/page.tsxDashboardTemplate/app/progress/page.tsxDashboardTemplate/app/teams/page.tsxDashboardTemplate/app/vulnerabilities/page.tsxDashboardTemplate/components/sidebar.tsxDashboardTemplate/components/ui/button.tsxbadge.tsxcard.tsxprogress.tsxtable.tsxDashboardTemplate/lib/data.tstelos-data.tsutils.ts详细介绍
🚨 必须:语音通知(任何操作前均须执行)
调用此技能后,必须先发送此通知,再执行任何其他操作。
-
发送语音通知:
curl -s -X POST http://localhost:31337/notify \ -H "Content-Type: application/json" \ -d '{"message": "Running the WORKFLOWNAME workflow in the Telos skill to ACTION"}' \ > /dev/null 2>&1 & -
输出文本通知:
Running the **WorkflowName** workflow in the **Telos** skill to ACTION...
这不是可选项。调用此技能后,请立即执行此 curl 命令。
Telos
功能介绍
读取和更新两类上下文。个人 TELOS:主事人的生活上下文——目标、信念、智慧、书籍、电影、挑战、叙事、策略、使命、模型、预测、创伤、框架、经验教训、错误信念——位于 ~/.claude/LIFEOS/USER/TELOS/,通过 Update 工作流更新,并创建带时间戳的备份。项目 TELOS:分析包含 .md/.csv 文件的目录,提取依赖链(PROBLEMS→GOALS→STRATEGIES→PROJECTS)、瓶颈、对齐情况和进展,然后生成 McKinsey 风格的报告、n=24 个叙事要点,或由多名工程师并行构建的 Next.js 仪表板。
问题
生活上下文和项目状态都散落在许多文件中,手动处理容易出错。个人目标、信念和经验教训会逐渐过时,手动编辑还可能导致历史丢失或结构损坏。项目文档中隐藏着决定工作是否步入正轨的依赖链、瓶颈和错位问题——即使读完每个文件,也可能看不出 PROBLEMS 如何关联 GOALS,又如何关联 PROJECTS。此技能为这两类场景提供了统一且安全的入口:个人内容通过带备份的结构化更新进行维护,项目内容则通过自动化关系分析生成可视化输出。
工作原理
TELOS(Telic Evolution and Life Operating System)是一个上下文收集系统,包含两种应用:
- 个人 TELOS - {PRINCIPAL.NAME} 的生活上下文系统(信念、目标、经验教训、智慧),位于
~/.claude/LIFEOS/USER/TELOS/ - 项目 TELOS - 面向组织/项目的分析框架(关系、依赖、目标、进展)
此技能会检测请求所指的上下文(参见下文“上下文检测”),然后将请求路由至相应工作流。个人内容更新始终通过 Update 工作流进行,以便自动创建备份和变更日志条目。项目分析会扫描目标目录、构建关系图,并生成你所需的输出格式。
工作流路由
执行工作流时,直接输出此通知:
Running the **WorkflowName** workflow in the **Telos** skill to ACTION...
| 工作流 | 触发语句 | 文件 |
|---|---|---|
| Update | “add to TELOS”、“update my goals”、“add book to TELOS” | Workflows/Update.md |
| InterviewExtraction | “extract content”、“extract interviews”、“analyze interviews” | Workflows/InterviewExtraction.md |
| CreateNarrativePoints | “create narrative”、“narrative points”、“TELOS report”、“n=24” | Workflows/CreateNarrativePoints.md |
| WriteReport | “write report”、“McKinsey report”、“create TELOS report”、“professional report” | Workflows/WriteReport.md |
**注意:**对于常规项目分析、仪表板、依赖映射和执行摘要,此技能会直接处理,无需单独的工作流文件。
示例
示例 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:使用 TELOS 分析项目
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)
--> Output is slide-ready for presentations or customer briefings
示例 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
--> White background, subtle Tokyo Night Storm accents
--> Includes: cover page, executive summary, findings, recommendations, roadmap
上下文检测
{DA_IDENTITY.NAME} 如何判断 TELOS 上下文:
| 用户请求 | 上下文 | 位置 |
|---|---|---|
| “my TELOS”、“my goals”、“my beliefs”、“add to TELOS” | 个人 TELOS | ~/.claude/LIFEOS/USER/TELOS/ |
| “Alma”、“TELOSAPP”、“analyze [project]”、“dashboard for” | 项目 TELOS | 用户指定的目录 |
| “analyze ~/path/to/project” | 项目 TELOS | 指定路径 |
第 1 部分:个人 TELOS({PRINCIPAL.NAME} 的生活)
位置
关键路径: 所有个人 TELOS 文件都位于:
~/.claude/LIFEOS/USER/TELOS/
个人 TELOS 位于 CORE USER 目录中,而不是直接放在 Telos 技能目录下。
个人 TELOS 框架
所有文件均位于 ~/.claude/LIFEOS/USER/TELOS/:
核心理念
- TELOS.md - 主框架文档
- MISSION.md - 人生使命陈述
- BELIEFS.md - 核心信念和世界观
- WISDOM.md - 积累的智慧
人生数据
- BOOKS.md - 最喜欢的书籍
- MOVIES.md - 最喜欢的电影
- LEARNED.md - 随时间积累的经验教训
- WRONG.md - {PRINCIPAL.NAME} 曾经判断错误的事情(成长追踪)
心智模型
- FRAMES.md - 心智框架和视角
- MODELS.md - 用于决策的心智模型
- NARRATIVES.md - 个人叙事和自我故事
- STRATEGIES.md - 人生中正在采用的策略
目标与挑战
- GOALS.md - 人生目标(短期和长期)
- PROJECTS.md - 活跃项目
- PROBLEMS.md - 待解决的问题
- CHALLENGES.md - 当前面临的挑战
- PREDICTIONS.md - 对未来的预测
- TRAUMAS.md - 过去的创伤(用于理解背景和疗愈)
变更追踪
- updates.md - 所有 TELOS 更新的完整变更日志
使用个人 TELOS
读取文件
# View specific file
read ~/.claude/LIFEOS/USER/TELOS/GOALS.md
read ~/.claude/LIFEOS/USER/TELOS/BELIEFS.md
# View recent updates
read ~/.claude/LIFEOS/USER/TELOS/updates.md
更新个人 TELOS
重要: 切勿手动编辑。请使用 Update 工作流。
工作流: Workflows/Update.md
该工作流提供:
- 自动创建带时间戳的备份
- 在 updates.md 中记录变更
- 保留版本历史
- 确保格式和结构正确
可更新的文件: 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
第 2 部分:项目 TELOS(组织分析)
能力
对于任何项目目录,TELOS 都可以:
- 发现关联关系 - 查找文件/实体之间的联系
- 映射依赖关系 - 确定各项内容之间的依赖关系
- 提取目标 - 找出明示和隐含的目标
- 分析进度 - 追踪进展和指标
- 生成叙述 - 创建高管摘要
- 构建可视化仪表板 - 使用数据构建精美界面
目标目录检测
灵活发现文件——不要求固定结构:
# User specifies directory
"Analyze ~/Projects/<your-org-tree>"
--> {DA_IDENTITY.NAME} scans for .md and .csv files anywhere in tree
# {DA_IDENTITY.NAME} automatically finds all .md and .csv files regardless of structure
分析
将该技能指向一个项目目录(名称中包含 project 的目录、指定路径或常见位置)。良好的分析应揭示依赖链 PROBLEMS→GOALS→STRATEGIES→PROJECTS、阻碍进展的瓶颈、项目是否与既定目标一致、进度/完成度指标,以及风险领域(逾期或受阻的工作)——分析依据应来自文件的实际内容,绝不依赖缓存的假设。
发现源文件:
find $TARGET_DIR -type f \( -name "*.md" -o -name "*.csv" \)
按要求的格式交付:Markdown 报告(Mermaid 图表)、交互式 Web 仪表板、JSON 导出或高管摘要。
构建仪表板
交付内容是一个交互式 Next.js 仪表板,用于根据以下技术栈和设计令牌呈现分析结果。请从已提供的脚手架 DashboardTemplate/ 开始(这是一个可运行的 Next.js 应用:文件浏览器、Markdown/CSV 渲染、依赖关系视图——复制并运行的步骤请参阅其 README),而不是从头开始,然后根据分析结果调整页面。根据工作可清晰拆分的方式,将构建任务分配给多个并行 Agent——数据解析库、共享组件、各页面视图、主题、集成——同时执行彼此独立的部分。(通过公开议题 #1555 接入,@tzioup——该模板此前已提供,但未被引用。)
技术栈:
- Next.js 14 + TypeScript
- shadcn/ui 用户界面组件
- Aceternity UI 布局
- Tailwind CSS
- Tokyo Night Day 主题(专业浅色)
功能:
- 依赖关系图(Mermaid 或 D3.js)
- 进度表格(可排序、可筛选)
- 指标卡片(关键绩效指标、统计数据)
- 时间线可视化
- 关系网络
设计令牌:
--background: #ffffff
--foreground: #1a1b26
--primary: #2e7de9
--accent: #9854f1
--destructive: #f52a65
--success: #33b579
--warning: #f0a020
常见 TELOS 文件
标准项目 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 卡片布局
- 时间线图表 - 随时间变化的进度
- 状态仪表板 - 关键绩效指标概览
- 关系网络 - 力导向图
- 柱状图 - 用于比较的 Recharts 图表
- 折线图 - 趋势分析
安全与隐私
个人 TELOS:
- 切勿提交到公共仓库
- 切勿公开分享
- 更改前务必备份
- 仅使用 Update 工作流
项目 TELOS:
- 可能包含敏感数据
- 对外分享前请先征求同意
- 示例中应对敏感信息进行脱敏
- 遵循 LifeOS 安全协议
注意事项
- Telos 数据属于个人隐私。 切勿将其包含在公共仓库、技能或输出中。
- 目标和依赖关系会变化——提供建议前务必读取当前状态。 不要依赖缓存的知识。
- 项目仪表板会从多个来源获取数据。 展示前请确认数据是否为最新。
执行日志
完成任何工作流后,追加一条 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"。