mcpField
T
Telos

Telos

github.com/danielmiessler生産性19.6k142 回インストール今日更新
リポジトリ

Telos について

Telosは、個人のライフコンテキスト管理とプロジェクト文書の分析を行うスキルです。個人情報の更新時にタイムスタンプ付きバックアップを作成し、MarkdownやCSVから依存関係と進捗を抽出します。

主な機能

  1. 01個人の目標、信念、学びの管理
  2. 02更新のバックアップと変更記録
  3. 03Markdownと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

機能

2 種類のコンテキストを読み取り、更新します。個人 TELOS:プリンシパルの人生に関するコンテキスト(目標、信念、知恵、書籍、映画、課題、物語、戦略、ミッション、モデル、予測、トラウマ、フレーム、教訓、誤った信念)を ~/.claude/LIFEOS/USER/TELOS/ に保存します。更新ワークフローを通じて更新し、タイムスタンプ付きのバックアップを作成します。プロジェクト TELOS:.md/.csv ファイルのディレクトリを分析して、依存関係の連鎖(PROBLEMS→GOALS→STRATEGIES→PROJECTS)、ボトルネック、整合性、進捗を抽出し、McKinsey 形式のレポート、n=24 のナラティブポイント、または並列作業するエンジニアが構築する Next.js ダッシュボードを作成します。

解決する問題

人生のコンテキストもプロジェクトの状況も多数のファイルに分散しており、手作業で扱うとミスが起こりやすくなります。個人の目標、信念、教訓は古くなり、手動で編集すると履歴を失ったり、構造を壊したりする危険があります。プロジェクトのドキュメントには、作業が順調に進んでいるかを左右する依存関係の連鎖、ボトルネック、整合性の欠如が隠れています。すべてのファイルを読んでも、PROBLEMS が GOALS に、GOALS が PROJECTS にどうつながるのか見えないことがあります。このスキルは、どちらのコンテキストにも安全にアクセスできる単一の方法を提供します。個人向けにはバックアップ付きの構造化された更新を、プロジェクト向けには関係性の自動分析と出力の生成を行います。

仕組み

TELOS(Telic Evolution and Life Operating System)は、コンテキスト収集システムであり、次の 2 つの用途があります。

  1. 個人 TELOS - {PRINCIPAL.NAME} の人生に関するコンテキストシステム(信念、目標、教訓、知恵)を ~/.claude/LIFEOS/USER/TELOS/ に保存します。
  2. プロジェクト TELOS - 組織やプロジェクト向けの分析フレームワーク(関係性、依存関係、目標、進捗)です。

このスキルは、リクエストがどちらのコンテキストを指しているかを判定し(後述の「コンテキストの判定」を参照)、適切なワークフローに振り分けます。個人情報の更新は必ず更新ワークフローを通じて行い、バックアップと変更履歴の記録を自動的に作成します。プロジェクト分析では対象ディレクトリをスキャンして関係グラフを構築し、指定された形式で出力を生成します。

ワークフローの振り分け

ワークフローを実行する際は、この通知を直接出力してください。

Running the **WorkflowName** workflow in the **Telos** skill to ACTION...
ワークフロートリガーファイル
Update「TELOS に追加」「目標を更新」「書籍を TELOS に追加」Workflows/Update.md
InterviewExtraction「コンテンツを抽出」「インタビューを抽出」「インタビューを分析」Workflows/InterviewExtraction.md
CreateNarrativePoints「ナラティブを作成」「ナラティブポイント」「TELOS レポート」「n=24」Workflows/CreateNarrativePoints.md
WriteReport「レポートを書く」「McKinsey レポート」「TELOS レポートを作成」「専門家向けレポート」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 のコンテキストを判定する方法:

ユーザーのリクエストコンテキスト場所
「自分の TELOS」「自分の目標」「自分の信念」「TELOS に追加」個人 TELOS~/.claude/LIFEOS/USER/TELOS/
「Alma」「TELOSAPP」「[プロジェクト] を分析」「〜用のダッシュボード」プロジェクト TELOSユーザーが指定したディレクトリ
「~/path/to/project を分析」プロジェクト TELOS指定されたパス

Part 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 を更新する

重要: 手動で編集しないでください。更新ワークフローを使用してください。

ワークフロー: 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


Part 2: プロジェクト TELOS(組織分析)

機能

任意のプロジェクトディレクトリに対して、TELOS は次のことを行います。

  1. 関係性の発見 - ファイルやエンティティ間のつながりを特定します
  2. 依存関係のマッピング - 何が何に依存しているかを特定します
  3. 目標の抽出 - 明示された目標と暗黙の目標を発見します
  4. 進捗の分析 - 進捗状況と指標を追跡します
  5. ナラティブの生成 - エグゼクティブサマリーを作成します
  6. ビジュアルダッシュボード - データを使った見やすい UI を構築します

対象ディレクトリの検出

柔軟なファイル検出 — 必須の構成はありません:

# 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

分析

プロジェクトディレクトリ(プロジェクト名、明示的なパス、または一般的な場所)をスキルに指定します。適切な分析では、問題→目標→戦略→プロジェクトの依存関係の連鎖、進捗を妨げるボトルネック、プロジェクトが明示された目標に沿っているかどうか、進捗・完了の指標、リスク領域(期限超過またはブロック中の作業)を明らかにします。分析は、ファイルに実際に記載された内容に基づいて行い、キャッシュされた前提には決して依存しません。

ソースファイルを見つけます。

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

求められた形式で提示します。形式は、Markdown レポート(Mermaid 図)、インタラクティブなウェブダッシュボード、JSON エクスポート、またはエグゼクティブサマリーです。

ダッシュボードの構築

成果物は、以下のスタックとデザイントークンに基づく分析を表示する、インタラクティブな Next.js ダッシュボードです。ゼロから作るのではなく、提供済みの DashboardTemplate/ のひな形から始めてください(ファイルブラウザー、Markdown/CSV のレンダリング、依存関係ビューを備えた、動作する Next.js アプリです。コピーして実行する手順については README を参照してください)。その後、分析に合わせてページを調整してください。作業を明確に分割できる場合は、データ解析ライブラリ、共有コンポーネント、ページごとのビュー、テーマ、統合など、複数のエージェントに並行して作業を割り振ってください。独立した作業は同時に進めます。(公開 Issue #1555 の対応によるものです。@tzioup — 以前はひな形への参照がありませんでした。)

技術スタック:

  • Next.js 14 + TypeScript
  • UI コンポーネントには shadcn/ui
  • レイアウトには Aceternity UI
  • Tailwind CSS
  • Tokyo Night Day テーマ(プロフェッショナルなライトテーマ)

機能:

  • 依存関係グラフ(Mermaid または D3.js)
  • 進捗テーブル(並べ替え、フィルタリング可能)
  • メトリクスカード(KPI、統計情報)
  • タイムラインの可視化
  • 関係ネットワーク

デザイントークン:

--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 のカードレイアウト
  • タイムラインチャート - 時間経過に伴う進捗
  • ステータスダッシュボード - KPI の概要
  • 関係ネットワーク - 力学ベースのグラフ
  • 棒グラフ - 比較用の 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" を記録してください。

コメント