mcpField
T
Telos

Telos

github.com/danielmiessler生产力19.6k142 次安装今天更新
代码仓库

关于 Telos

Telos 是用于个人生活背景维护和项目分析的技能,面向整理目标、信念与项目文档的用户。它通过带时间戳的备份保护个人更新,并从 Markdown 和 CSV 文件提取项目依赖与进展。

主要功能

  1. 01维护个人目标、信念与经验
  2. 02更新时创建备份并记录变更
  3. 03分析 Markdown 和 CSV 项目文件
  4. 04提取目标、依赖与进度
  5. 05生成报告、叙述要点或仪表板

适用场景

  1. 01安全更新个人目标或信念记录
  2. 02梳理项目中的目标与依赖关系
  3. 03检查项目进度、瓶颈和风险

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/danielmiessler/lifeos --skill telos

安装后在 Claude Code 中输入/telos确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

DashboardTemplate/
.gitignore
README.md
bun.lock
next.config.mjs
next-env.d.ts
package.json
postcss.config.mjs
DashboardTemplate/app/
page.tsx
layout.tsx
globals.css
DashboardTemplate/app/add-file/
page.tsx
DashboardTemplate/app/api/chat/
route.ts
DashboardTemplate/app/api/file/get/
route.ts
DashboardTemplate/app/api/file/save/
route.ts
DashboardTemplate/app/api/files/count/
route.ts
DashboardTemplate/app/api/upload/
route.ts
DashboardTemplate/app/ask/
page.tsx
DashboardTemplate/app/file/[slug]/
page.tsx
DashboardTemplate/app/progress/
page.tsx
DashboardTemplate/app/teams/
page.tsx
DashboardTemplate/app/vulnerabilities/
page.tsx
DashboardTemplate/components/
sidebar.tsx
DashboardTemplate/components/ui/
button.tsx
badge.tsx
card.tsx
progress.tsx
table.tsx
DashboardTemplate/lib/
data.ts
telos-data.ts
utils.ts

详细介绍

🚨 必须:语音通知(任何操作前均须执行)

调用此技能后,必须先发送此通知,再执行任何其他操作。

  1. 发送语音通知:

    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 &
    
  2. 输出文本通知:

    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)是一个上下文收集系统,包含两种应用:

  1. 个人 TELOS - {PRINCIPAL.NAME} 的生活上下文系统(信念、目标、经验教训、智慧),位于 ~/.claude/LIFEOS/USER/TELOS/
  2. 项目 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 都可以:

  1. 发现关联关系 - 查找文件/实体之间的联系
  2. 映射依赖关系 - 确定各项内容之间的依赖关系
  3. 提取目标 - 找出明示和隐含的目标
  4. 分析进度 - 追踪进展和指标
  5. 生成叙述 - 创建高管摘要
  6. 构建可视化仪表板 - 使用数据构建精美界面

目标目录检测

灵活发现文件——不要求固定结构:

# 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"。

评论

支持 Markdown