dongshuyan/compass-skills

What it solves

COMPASS Skills は、長時間にわたる AI エージェントワークフローでの状態・コンテキスト喪失を解決します。ユーザーの好み、プロジェクトの進捗、タスクの依存関係をローカルで管理することで、会話全体を再生する必要をなくし、エージェントがセッションを跨いでもユーザーの目標と合致し続けます。

How it works

このプロジェクトは、AI コーディングエージェント（Claude Code や Codex など）にインストールできる SKILL.md パッケージのセットを提供します。これらのスキルは Markdown 指示とローカル Python スクリプトを用いて特定のワークフローを実装します：

• State Management：コミュニケーションの好みを保持するローカルユーザープロファイルと、リポジトリ内のタスクグラフ（DAG）で目標とサブタスクを追跡します。
• Alignment：曖昧またはハイリスクなタスクは、実行前に焦点を絞った質問で絞り込む「明確化ゲート」を通ります。
• Continuity：現在の会話状態を新しい AI セッション用の貼り付け可能なプロンプトに圧縮します。
• Meta-Programming：成功した実行履歴を新しい再利用可能スキルに変換したり、実証に基づいて既存スキルをアップグレードするツールを含みます。

Who it’s for

複雑で長期的なプロジェクトを管理し、コンテキストを維持しながら進捗を追跡し、エージェントが元の目的から逸脱しないようにしたい開発者向けです。

Highlights

• Local-First Privacy：すべてのタスクとプロファイルデータはローカルに保存され、外部サーバーへアップロードされません。
• Task Forest：会話の境界を超えても残る可視化可能なタスクグラフ。
• Session Handoff：AI 会話間のシームレスな切り替えを実現する専用プロンプトジェネレータ。
• Skill Engineering：観測されたエージェントの実行履歴から直接スキルを構築・洗練するツール。