fade-away は何をしますか？
軽量なログ → トピックWiki → インデックス → 週次MOC → 知識Wikiメモリ層を維持し、ユーザーがタスクを切り替えたり、コンテキストを再説明せずに個人的なLLM知識ベースを構築できるようにします。
動作契約
このスキルは最初のターンだけでなく、会話全体を通じて動作します。各アシスタント応答の前に、そのターンがセッション開始、ターンごとの保存、トピック切り替え、手動記録、トピック昇格、週次/ダッシュボード/リント、または知識昇格のトリガーとなるかを確認します。最も見落とされがちなルールはターンごとの保存です。実質的なアシスタントターンごとに、アクティブなジャーナルエントリに(HH:MM) <進捗>の行を1行追加します。
ホットパスは小さく保ちます。頻度の低いメカニズムはreferences/に配置し、トリガーが発火したときだけ読み込みます。
パス
<VAULT_ROOT>はfade-awayが管理するObsidian保管庫です。セッションごとに1回、次の順序で解決します。
- プロジェクトの
AGENTS.md/CLAUDE.mdに宣言されたVault rootフィールド（ブートストラップインストーラscripts/bootstrap_vault.pyによって書き込まれます）。 - そのようなフィールドが存在しない場合、現在のプロジェクト/作業ディレクトリを保管庫ルートとして扱います。
読み書きの前に、常に<VAULT_ROOT>をその絶対パスに展開します。
- ジャーナル:
<VAULT_ROOT>/03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-MM-DD.mdここで<YYYY-MM>は日付自身の月、<YYYY-Wnn>はその日付のISO週です。 - 週次インデックス:
<VAULT_ROOT>/03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-Wnn 週次インデックス.mdここで<YYYY-MM>はその週の日曜日を含む月です。 - タスクインデックス:
<VAULT_ROOT>/00 Tasks/_Index.md - トピックページ:
<VAULT_ROOT>/00 Tasks/<topic-filename>.md - 知識ページ:
<VAULT_ROOT>/02 Knowledge/<domain>/<page>.md - 参照: このスキルの
references/ディレクトリ
00 Tasks/または_Index.mdがない場合、そのセッションではタスクインデックスとトピックのロジックをスキップします。セッション中に00 Tasks/を自動生成しないでください。ジャーナルログは引き続き実行されます。
备忘.mdなどのトップレベルファイルは03 Journal/の直下に置かれることがあります。移動しないでください。
タイムゾーンルール
このスキルで記録されるすべての日時は、保管庫時間と呼ばれる一貫したゾーンを使用する必要があります。保管庫時間は、プロジェクトのAGENTS.md / CLAUDE.mdのTime zoneフィールドから解決します。設定されていない場合は、マシンのローカルゾーンにフォールバックします。ブートストラップインストーラはデフォルトでこれをAsia/Hong_Kongに設定するため、未設定の保管庫はAsia/Hong_Kong / GMT+8 / UTC+8として動作します。
ジャーナルのファイル名、親パス、見出し、進捗行、トピックのフロントマター、_Index.mdのタイムスタンプ、週次インデックスの推測に保管庫時間を使用します。
推奨されるシェルチェック（設定されたゾーンに置き換えてください）:
TZ=Asia/Hong_Kong date
保管庫時間をハーネスの日付ヒントよりも信頼します。ハーネスの日付が保管庫時間と矛盾する場合は、新しい保管庫時間の読み取りからジャーナルのファイル名、ISO週、HH:MMを導出します。追加/同時実行の詳細については、references/journal-write-protocol.mdを参照してください。
セッション状態
内部で追跡します:
current_entry_start: アクティブなジャーナルエントリのHH:MM。current_entry_date: アクティブなジャーナルエントリのYYYY-MM-DD。current_entry_title: 現在の短い中国語のタスクタイトル。bound_topic: 拡張子.mdなしのトピックファイル名、またはNone。bind_skipped: ユーザーがバインドしないことを選択した後にのみTrue。task_auto_bind_checked/task_auto_bind_skipped: 新しいジャーナルエントリごとにリセットされます。knowledge_candidate_prompted/knowledge_candidate_skipped: 新しいジャーナルエントリごとにリセットされます。knowledge_context_checked: 現在のユーザーリクエストが知識検索ゲートを通過した後、またはゲートが意図的にスキップされた場合にTrue。tracking_disabled: ユーザーがこのセッションでオプトアウトした場合にのみTrue。
会話の開始
-
存在する場合、
<VAULT_ROOT>/00 Tasks/_Index.mdを読み取ります。テーブル本体の行を[[topic]] | timestamp | next-stepとして解析します。存在しないファイルは空のインデックスとして扱います。 -
同じトピックの同時セッションがないか簡単に確認します。今日の保管庫時間のジャーナルが存在する場合、その末尾を読み取ります。最後の進捗行が保管庫時間で15分以内であり、そのエントリがユーザーの最初のメッセージと重複する可能性が高い場合、次のように表示します:
⚠️ 別のセッションが <HH:MM> に [[<topic>]] に書き込んだばかりです。同じことを並行して行っている可能性があります。最新の進捗を確認してから返答します。その後、最近のエントリを読み取って、この応答が並行作業と矛盾しないようにします。最近の重複エントリがない場合は、静かにスキップします。
-
_Index.md、今日のジャーナル、または一致したトピックページのみに依存する前に、実質的なリクエストに対して知識検索ゲートを実行します。リクエストが<VAULT_ROOT>/02 Knowledge/に永続的なコンテキストがある可能性のあるプロジェクト/ドメイン/人物/メソッドに関する場合、またはユーザーがコンテキスト、分析、決定、戦略、継続、レビュー、文体、再利用可能なワークフロー、または過去の作業を尋ねた場合、references/knowledge-retrieval-trigger.mdを参照してください。インベントリファーストルーティングを使用します。ライブのKnowledgeツリーをリストし、そこから現在のフォルダ/プロジェクトを導出し、広範な本文検索の前にファイル名、H1/タイトル、エイリアス、タグ、status: canonical、ナビゲーションページ、および信頼できる情報源ページをマッチングします。確認待ちの挨拶、ダッシュボード/リントのみのレポート、純粋なジャーナル簿記、アトミックなユーティリティクエリ、およびこのメタデータファーストのパスの後に該当するKnowledgeヒットがない場合のみスキップします。 -
ユーザーの最初のメッセージに応じて、順にディスパッチします:
- ブートストラップ/セットアップ意図（
install fade-away、setup、bootstrap、初期化、第一次使用、開源部署、または欠落した_Index.mdとユーザーからの初期化リクエスト）:references/bootstrap-vault.mdを参照してください。ブートストラップは一度限りのセットアップパスです。保管庫ルートが不明な場合は尋ね、ユーザーが確認しない限りファイルを作成しないでください。 - コンテキスト/手順確認意図（
AGENTS、CLAUDE、上下文、context、経験継承、規則漂移、プロジェクト構造、スキル/保管庫/ワークフローメンテナンス、または新しいcwd/プロジェクト境界）:references/context-check.mdを参照してください。ドリフトが見つかった場合、またはユーザーが明示的に尋ねた場合にのみ報告し、ユーザーが特定のパッチを確認しない限り、手順ファイルを書き込まないでください。 - メモリリント意図（
lint、体检、health check、檢查知識庫、檢查任務索引、看看哪些適合變成 wiki、または類似）:references/lint-vault-memory.mdを参照してください。最初にレポートを表示し、ユーザーが確認しない限り修正や知識ページを作成しないでください。 - 知識昇格意図（
沈澱成知識、寫進 knowledge、變成 wiki、歸檔成知識頁、または類似）:references/promote-to-knowledge.mdを参照してください。 - 週次インデックス意図（
週索引、週報、weekly index、weekly summary、本週總結、または類似）:references/render-weekly-index.mdを参照してください。モジュールが週次インデックスを書き込んだり更新したりする場合にのみ、ジャーナルエントリを開きます。 - ダッシュボード意図（
看下任務、看板、dashboard、總覽、または類似）:references/render-dashboard.mdを参照し、レンダリングのみ行い、まだジャーナルエントリは開かないでください。 - 既存のトピックへの明確な一致: そのトピックページを静かに読み取り、
bound_topicを設定し、その後ジャーナルエントリを開きます。 - あいまいな挨拶（
hi、你好、在嗎、開始幹活了、など）:_Index.mdに行がある場合、⏮️ 前回: <task>、次のステップは <next-step>です。これを続けますか、それとも新しいタスクですか？と出力し、返信を待ちます。ユーザーが確認した場合のみ、最初の行にバインドします。 - 新しい実質的なタスク: 以前のタスクには言及せず、
bound_topic = Noneのままにします。
- ブートストラップ/セットアップ意図（
ジャーナルエントリを開く
実際に作業が開始されたときにのみ、ジャーナルエントリを開きます。保管庫時間の日次パスを03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-MM-DD.mdとして計算します。ここで<YYYY-MM>は日付自身の月、<YYYY-Wnn>はISO週です。欠落している月/週フォルダはmkdir -pで作成します。
日次ファイルがない場合、references/journal-write-protocol.mdのテンプレートから作成します。## 🕐 タスクタイムラインを確認し、そのセクションの下部に見出しを1つ追加します:
- 未バインド:
### HH:MM ▶️ <短い中国語タイトル> - バインド済み:
### HH:MM ▶️ <短い中国語タイトル> → [[00 Tasks/<bound_topic>]]
current_entry_start、current_entry_date、current_entry_titleを保存します。新しいエントリのために、タスク、知識候補、知識検索のフラグをリセットします。
ターンごとの保存
実質的な出力を持つ各アシスタントターンの後、現在のジャーナルエントリ内に正確に1行の進捗行を追加します:
(HH:MM) <一言進捗>
アクティブなエントリ本文の最後、次の### タイムライン見出しまたはEOFの直前に追加します。以前の進捗行を書き換えないでください。ターンが単なる確認質問である場合、またはtracking_disabled = Trueの場合は保存をスキップします。
書き込む前に、正確な追加位置、同時書き込みのリベース、保管庫時間の境界処理、落とし穴行の構文、またはジャーナルテンプレートが必要な場合は、references/journal-write-protocol.mdを参照してください。
保存後のチェック
ターンごとの保存後にこれらのチェックを実行します:
- 明示的な昇格: 可視出力に明示的な
➡️ 下一步マーカーまたは## ➡️ 下一步セクションが含まれている場合、トピック/インデックス層を更新します。bound_topicが設定されている場合はreferences/topic-update-protocol.mdを参照してください。そうでなく、bind_skipped = Falseの場合はreferences/promote-to-wiki.mdを参照してください。 - トピック自動更新:
bound_topicが設定されており、明示的な次のステップが表示されなかった場合、アクティブなエントリが既存の陳腐化しきい値を満たす可能性がある場合はreferences/topic-update-protocol.mdを参照してください。現在の自動更新動作を維持し、ユーザーが要求しない限り確認プロンプトに変換しないでください。 - タスク自動バインド: アクティブなエントリが未バインドで、明示的な
➡️ 下一步がない場合、references/task-candidate-trigger.mdを参照してください。タスクのようなセッションではトピックを自動的に作成/バインドします。些細なQ&A、挨拶、ダッシュボード/リントのみのレポート、純粋な確認、またはタスクの性質がないセッションはスキップします。 - 知識候補: 再利用可能な知識が出現した可能性があり、ユーザーがまだ昇格を要求していない場合、
references/knowledge-candidate-trigger.mdを参照してください。02 Knowledge/を自動的に作成または更新しないでください。
セッション中のトピック切り替え
ユーザーが繼續做 X、回到 X、またはエントリが既に開いている状態で切り替えを要求した場合:
Xを_Index.mdと控えめにマッチングします。- 明確な一致がない場合、1つの短い確認質問をします。
- 一致が明確で
bound_topicと異なる場合、[[X]]に切り替えますか？現在のエントリに切り替え記録を1行追加し、新しいXエントリを開きます。と尋ねます。 - 確認後、
(HH:MM) 現在のタスクから切り替え、[[00 Tasks/X]]に移動します。を追加し、トピックページを読み取り、bound_topic = Xを設定し、新しいバインドされたジャーナルエントリを開きます。 - ユーザーが拒否した場合、既存のバインディングを維持します。
セッション中に静かにトピックを切り替えないでください。
手動記録要求
ユーザーが記錄一下、記一下剛才的進展、または類似のことを言った場合、前回の保存以降の進捗を要約した追加の進捗行を現在のエントリに1行追加します。ユーザーが明示的にタスクの切り替えを要求しない限り、新しいエントリを開いたり、現在のエントリを閉じたりしないでください。
モジュール
低頻度のワークフローはオンデマンドでのみ読み込みます:
references/journal-write-protocol.md: ジャーナル作成、追加位置、保管庫時間の境界処理、同時書き込みのリベース、落とし穴行の構文、およびジャーナルテンプレート。references/bootstrap-vault.md: 新しいユーザーのObsidian保管庫向けの一度限りのセットアップワークフロー。確認後にのみ、最小限のfade-awayディレクトリ/テンプレート/インデックスと手順エントリポイントを作成します。references/context-check.md: コールドスタートまたは境界変更時の、AGENTS.md、CLAUDE.md、プロジェクト構造メモ、Knowledge継承などの古くなった指示/コンテキストサーフェスのチェック。確認されるまで書き込まずにドリフトを報告します。references/task-candidate-trigger.md: 実質的な未バインドタスクエントリを00 Tasksに自動バインドします。些細なまたは非タスクセッションはスキップします。references/topic-update-protocol.md: バインドされたトピックページを更新し、_Index.mdをリフレッシュし、現在のトピック自動更新動作を実行します。references/promote-to-wiki.md: 明示的な➡️ 下一步またはタスク自動バインドトリガーの後に、未バインドのジャーナルエントリをトピックページにバインドし、_Index.mdを更新します。references/render-dashboard.md:_Index.mdから読み取り専用のタスクダッシュボードをレンダリングします。references/render-weekly-index.md: オンデマンドの週次MOCを03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-Wnn 週次インデックス.mdに生成または更新します。references/lint-vault-memory.md: タスク、ジャーナル、週次インデックス、およびKnowledge層の読み取り専用のヘルスレポートをレンダリングします。references/knowledge-retrieval-trigger.md: 実質的な作業の前に、ライブの02 Knowledge/ツリーをインベントリし、メタデータから候補をランク付けし、少数の関連ページを読み取って、古い永続的なコンテキスト、メソッド、プロジェクトの事実が回答に影響を与えられるようにします。references/knowledge-candidate-trigger.md: 確認されるまで書き込まずに、02 Knowledge/への再利用可能なジャーナル素材を提案します。references/promote-to-knowledge.md: 確認後に02 Knowledge/の下にキュレーションされたページを作成または更新します。
フォーマットルール
- 時刻形式: 設定された保管庫タイムゾーンを使用した24時間制の
HH:MM。 - ジャーナルタイトル: 短く説明的な中国語。
任務1のような一般的なタイトルは避けます。 - トピックファイル名: kebab-case、スペースなし、拡張子
.mdはディスク上のみ。 - ジャーナル内のトピックウィキリンク:
[[00 Tasks/<topic>]]。 - インデックス行の形式:
| [[<topic>]] | YYYY-MM-DD HH:MM | <エスケープされた次のステップ> |。 - レガシーな
task-trackerディレクトリは削除されました。ユーザーが古いトラッカーについて尋ねた場合は、fade-awayがそれを置き換えたことを説明します。
エッジケース
- ユーザーのオプトアウト（
這次不用記錄）:tracking_disabled = Trueを設定します。セッション中のすべての書き込みをスキップしますが、コンテキストのための_Index.mdの読み取りは許可されます。 - 日付変更線をまたぐ場合: 保管庫時間の午前0時を使用します。保管庫時間の午前0時を過ぎた後は、新しい保管庫時間の日のジャーナルに継続エントリを開き、そこでのターンごとの保存を続行します。
- ダッシュボードのみのターン: ダッシュボードをレンダリングして待機します。ユーザーが実際の作業を開始するまで、ジャーナルエントリを開かないでください。
- インデックスに一致するトピックページがない場合: トピック行は存在するがページがないことを伝え、再作成するか、バインドせずに続行するかを尋ねます。