[ → [[00 Tasks/<topic>]]]` header attributable to this session (the arrow implies the binding). Continue that entry; do not open a duplicate. If multiple candidate headers are ambiguous (parallel sessions) or none match, ask one short question instead of guessing. If the session already has substantive work but no entry can be rebuilt, ask once whether the user opted out of tracking earlier in this session before resuming writes. ## Start Of Conversation 1. Read `<VAULT_ROOT>/00 Tasks/_Index.md` if present. Parse table body rows as `[[topic]] | timestamp | next-step`; treat missing files as an empty index. 2. Check cheaply for a concurrent same-topic session. Read the tail of today's vault-time journal if it exists. If the last progress line is within 15 vault-time minutes and its entry plausibly overlaps the user's first message, surface: ```markdown ⚠️ 另一会话 <HH:MM> 刚写过 [[<topic>]]，可能在并行做同一件事。我先扫一眼最新进展再回。 ``` Then read the recent entry so this response does not contradict parallel work. If no recent overlapping entry exists, skip silently. 3. Run the Knowledge Retrieval Gate for substantive requests that may depend on durable context in `<VAULT_ROOT>/02 Knowledge/`. Read `references/knowledge-retrieval-trigger.md` when the user asks about context, analysis, decisions, strategy, continuation, review, writing style, reusable workflow, older work, or a named project/domain/person/method. Skip greetings awaiting confirmation, dashboard/lint/weekly-index rendering, pure journal bookkeeping, sensitive folders/files unless explicitly asked, atomic utility queries, and cases with no relevant Knowledge hit after the gate. 4. Dispatch on the user's first message, in order: - Bootstrap/setup intent (`install fade-away`, `setup`, `bootstrap`, `初始化`, `第一次使用`, `开源部署`, or a missing `_Index.md` plus a user request to initialize): read `references/bootstrap-vault.md`. Bootstrap is a one-time setup path; ask for the vault root if it is unclear and never create files unless the user confirms. - Context/instruction check intent (`AGENTS`, `CLAUDE`, `上下文`, `context`, `经验继承`, `规则漂移`, project structure, skill/vault/workflow maintenance, or a fresh cwd/project boundary): read `references/context-check.md`. Report only when drift is found or the user explicitly asks; do not write instruction files unless the user confirms the specific patch. - Memory lint intent (`lint`, `体检`, `health check`, `检查知识库`, `检查任务索引`, `看看哪些适合变成 wiki`, or similar): read `references/lint-vault-memory.md`; render a report first and do not write fixes or knowledge pages unless the user confirms. - Fade-out/archive intent (`归档`, `淡出`, `收进 FADE`, or similar): read `references/fade-out-protocol.md`; render candidates or execute only after explicit confirmation. - Knowledge promotion intent (`沉淀成知识`, `写进 knowledge`, `变成 wiki`, `归档成知识页`, or similar): read `references/promote-to-knowledge.md`. - Weekly index intent (`周索引`, `周报`, `weekly index`, `weekly summary`, `本周总结`, or similar): read `references/render-weekly-index.md`. Open a journal entry only if the module writes or updates a weekly index. - Dashboard intent (`看下任务`, `看板`, `dashboard`, `总览`, or similar): read `references/render-dashboard.md`, render only, and do not open a journal entry yet. - History retrieval intent (questions about how or when past work happened, not plain continuation): read `references/history-retrieval.md`. - Clear existing active-topic match: read that topic page silently, set `bound_topic`, then open a journal entry. - Vague greeting (`hi`, `你好`, `在吗`, `开始干活了`, etc.): if `_Index.md` has rows, emit `⏮️ 上次：<task>，下一步是 <compressed next-step>。继续这个还是新任务？` and wait for the reply. Bind to the top row only if the user confirms. - New substantive task: do not mention old tasks; leave `bound_topic = None`. ## Open Journal Entry Open a journal entry only when work actually starts. Compute the vault-time daily path as `03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-MM-DD.md`, where `<YYYY-MM>` is the date's own month and `<YYYY-Wnn>` is the ISO week. Create missing month/week folders with `mkdir -p`. If the daily file is missing, create it from the template in `references/journal-write-protocol.md`. Ensure `## 🕐 任务时间线`, then append one header at the bottom of that section: - Unbound: `### HH:MM ▶️ <短中文标题>` - Bound: `### HH:MM ▶️ <短中文标题> → [[00 Tasks/<bound_topic>]]` Store `current_entry_start`, `current_entry_date`, and `current_entry_title`. Reset `bind_skipped`, task, knowledge candidate, and knowledge retrieval flags for the new entry. ## Per-Turn Save After every assistant turn with substantive output, append exactly one progress line inside the current journal entry: ```markdown (HH:MM) <一句话进展> ``` A progress line is one sentence, <= ~120 characters; move overflow detail to the topic or knowledge layer. Append at the end of the active entry body, immediately before the next `### ` timeline header or EOF. Do not rewrite earlier progress lines. Skip the save if the turn is only a clarification question or `tracking_disabled = True`. Harness-native task/chapter tools (todo lists, chapter markers, etc.) are session-scoped scaffolding, never a substitute for journal/topic writes. Treat their state changes as reminders to append the `(HH:MM)` line in the same turn. They do not change entry granularity or titles, and never trigger promotion by themselves. ## Post-Save Checks Run these checks after the per-turn save: 1. **Explicit promotion**: if the visible output contains an explicit `➡️ 下一步` marker or `## ➡️ 下一步` section, update the topic/index layer. If `bound_topic` is set, read `references/topic-update-protocol.md`; otherwise, if `bind_skipped = False`, read `references/promote-to-wiki.md`. 2. **Topic auto-refresh**: when `bound_topic` is set and no explicit next-step appeared, read `references/topic-update-protocol.md` when the active entry has >= 5 progress lines newer than the topic's frontmatter `updated:`, or `updated:` is more than 2 vault-time hours behind the latest progress line. Keep the current automatic refresh behavior; do not convert it to a confirmation prompt unless the user asks. 3. **Task auto-bind**: skip without loading the module when `task_auto_bind_checked` or `task_auto_bind_skipped` is `True`. Otherwise, when the active entry is unbound and lacks an explicit `➡️ 下一步`, read `references/task-candidate-trigger.md`. Create/bind a topic automatically for task-like sessions; skip only trivial Q&A, greetings, dashboard/lint-only reports, pure clarification, or sessions with no task nature. 4. **Knowledge candidate**: skip without loading the module when `knowledge_candidate_prompted` or `knowledge_candidate_skipped` is `True`. Otherwise, when reusable knowledge may have emerged and the user did not already ask for promotion, read `references/knowledge-candidate-trigger.md`. Do not create or update `02 Knowledge/` automatically. ## Mid-Session Topic Switch If the user says `继续做 X`, `回到 X`, or otherwise asks to switch while an entry is already open: 1. Match `X` against `_Index.md` conservatively. 2. If no clear match exists and `X` is clearly a new task, ask: `开始新的 <X> entry？我会给当前 entry 追加一行切换记录。` 3. If no clear match exists and the intent is not clearly new, ask one short clarification question. 4. If the match is clear and differs from `bound_topic`, ask: `切到 [[X]]？我会给当前 entry 追加一行切换记录，然后打开新的 X entry。` 5. On confirmation for an existing topic, append `(HH:MM) 切出当前任务，转到 [[00 Tasks/X]]。`, read the topic page, set `bound_topic = X`, and open a new bound journal entry. After opening it, if the new topic's domain differs from the previous one, re-run the Knowledge Retrieval Gate before continuing. 6. On confirmation for a new task, append `(HH:MM) 切出当前任务，开始 <X>。`, set `bound_topic = None`, and open a new unbound entry with normal per-entry flag resets. Task auto-bind can bind it later. 7. If the user declines, keep the existing binding. Do not silently switch topics mid-session. ## Manual Record Request If the user says `记录一下`, `记一下刚才的进展`, or similar, add one extra progress line to the current entry summarizing progress since the previous save. Do not open a new entry or close the current entry unless the user explicitly asks to switch tasks. If `tracking_disabled = True`, first apply the opt-out reversal rule in Edge Cases, then record. ## Modules All low-frequency mechanics live in `references/`; each module is loaded at the trigger points above. ## Format Rules - Time format: 24-hour `HH:MM` using vault-time. - Journal title: short, descriptive Chinese; avoid generic titles like `任务1`. - Progress line: one sentence, <= ~120 characters. - Topic filename: kebab-case, no spaces, `.md` extension on disk only. - Topic wikilink in journal: `[[00 Tasks/<topic>]]`. - Index row format: `| [[<topic>]] | YYYY-MM-DD HH:MM | <escaped next-step> |`. - Active main-table rows must use bare `[[<topic>]]`; `FADE/` prefixes are only allowed in the graveyard section. - Legacy `task-tracker` has been fully removed; never use the old name proactively. If the user asks, explain that `fade-away` replaced it. ## Edge Cases - User opts out (`这次不用记录`): set `tracking_disabled = True`; skip all writes for the session, but reading `_Index.md` for context is allowed. If the user later says `还是记一下`, `开始记录`, or triggers a manual record request, set `tracking_disabled = False`; reuse an existing entry if available or open a new vault-time entry, then append `(HH:MM) 补记：<未记录时段一句话汇总>`. Do not fabricate backfilled per-turn timestamps. - Midnight crossing: when the current save's vault-time date != `current_entry_date`, open a continuation entry in the new vault-time day's journal and update `current_entry_date`. Inherit `current_entry_title`, `bound_topic`, and decision flags (`knowledge_candidate_skipped`, `bind_skipped`, `task_auto_bind_skipped`); the header may add `（续）`. This is not a new task. - Dashboard-only turn: render the dashboard and wait; do not open a journal entry until the user starts real work. - Missing topic page for an index match: first check `<VAULT_ROOT>/00 Tasks/FADE/**/<topic>.md`. If found, ask once whether to un-fade it or start a derivative new topic; do not bind the FADE path or recreate an empty page. If not found, say the topic row exists but the page is missing, then ask whether to recreate it or continue unbound.

# Fade Away > Active session tracker for the user's Obsidian vault. Invoke at conversation start and any time the user resumes, switches, records, audits, summarizes, or promotes project work; keep it loaded across the full session. Triggers include greetings, named personal projects, record/log phrases, topic switches, task dashboards, weekly summaries, history retrieval, fade-out/archive requests, knowledge promotion, and vault health checks. Every substantive assistant turn appends one vault-time progress line to the daily journal. Maintains `03 Journal/`, `00 Tasks/_Index.md`, topic pages, weekly MOCs, and `02 Knowledge/`. Skip only atomic project-less utility queries. - Skill: `aresfangxx/fade-away` (Agent Skill, multi-file: 18 files) - Install (CLI): `npx skillmds@latest add aresfangxx/fade-away` - Raw SKILL.md: https://api.skillmd.com/api/skills/aresfangxx/fade-away/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: Aresfangxx (https://skillmd.com/u/aresfangxx) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/aresfangxx/fade-away --- # fade-away Maintain a lightweight log -> topic wiki -> index -> weekly MOC -> knowledge wiki memory layer so the user can switch tasks and build a personal LLM knowledge base without re-explaining context. ## Operating Contract This skill runs across the entire conversation, not only the first turn. Before each assistant response, check whether the turn triggers session start, per-turn save, topic switch, manual record, topic promotion, weekly/dashboard/lint, history retrieval, fade-out, or knowledge promotion. The most commonly missed rule is the per-turn save: every substantive assistant turn appends one `(HH:MM) <进展>` line to the active journal entry. Keep the hot path small. Put low-frequency mechanics in `references/` and load them only when their trigger fires. ## Paths `` is the Obsidian vault that fade-away maintains. Resolve it once per session, in this order: 1. The `Vault root` field declared in the project's `AGENTS.md` / `CLAUDE.md` (written by the bootstrap installer, `scripts/bootstrap_vault.py`). 2. If no such field exists, treat the current project / working directory as the vault root. Always expand `` to that absolute path before reading or writing: - Journal: `/03 Journal///YYYY-MM-DD.md` where `` is the date's own month and `` is that date's ISO week. - Weekly index: `/03 Journal///YYYY-Wnn 周索引.md` where `` is the month containing the week's Sunday. - Task index: `/00 Tasks/_Index.md` - Topic pages: `/00 Tasks/.md` - Faded topic pages: `/00 Tasks/FADE//.md` - Knowledge pages: `/02 Knowledge//.md` - References: this skill's `references/` directory If `00 Tasks/` or `_Index.md` is missing, skip task index and topic logic for the session. Do not auto-create `00 Tasks/` mid-session. Journal logging still runs. Top-level files such as `备忘.md` may live directly under `03 Journal/`; do not move them. ## Time Zone Rule All dates and times recorded by this skill MUST use one consistent zone, called **vault-time**. Resolve vault-time from the `Time zone` field in the project's `AGENTS.md` / `CLAUDE.md`; if none is set, fall back to the machine's local zone. The bootstrap installer defaults this to `Asia/Hong_Kong`, but users may choose any IANA time zone. Use vault-time for journal filenames, parent paths, headings, progress lines, topic frontmatter, `_Index.md` timestamps, and weekly index inference. Preferred shell check (substitute the configured zone): ```bash TZ= date ``` Trust vault-time over harness date hints. If the harness date conflicts with vault-time, derive the journal filename, ISO week, and `HH:MM` from a fresh vault-time reading. ## Session State Track internally: - `current_entry_start`: active journal entry `HH:MM`. - `current_entry_date`: active journal entry `YYYY-MM-DD`. - `current_entry_title`: current short Chinese task title. - `bound_topic`: topic filename without `.md`, or `None`. - `bind_skipped`: `True` only after the user picks not to bind; reset for each new journal entry. Midnight continuation entries inherit the previous value. - `task_auto_bind_checked` / `task_auto_bind_skipped`: reset for each new journal entry. - `knowledge_candidate_prompted` / `knowledge_candidate_skipped`: reset for each new journal entry. - `knowledge_context_checked`: `True` after the current user request has passed the Knowledge Retrieval Gate, or when the gate is intentionally skipped. - `tracking_disabled`: `True` only if the user opts out for this session. ### State Recovery If Session State is uncertain (the context may have been compacted or summarized), re-read the tail of today's vault-time journal before any write. Rebuild `current_entry_start/date/title` and `bound_topic` from the last `### HH:MM ▶️ [ → [[00 Tasks/<topic>]]]` header attributable to this session (the arrow implies the binding). Continue that entry; do not open a duplicate. If multiple candidate headers are ambiguous (parallel sessions) or none match, ask one short question instead of guessing. If the session already has substantive work but no entry can be rebuilt, ask once whether the user opted out of tracking earlier in this session before resuming writes. ## Start Of Conversation 1. Read `<VAULT_ROOT>/00 Tasks/_Index.md` if present. Parse table body rows as `[[topic]] | timestamp | next-step`; treat missing files as an empty index. 2. Check cheaply for a concurrent same-topic session. Read the tail of today's vault-time journal if it exists. If the last progress line is within 15 vault-time minutes and its entry plausibly overlaps the user's first message, surface: ```markdown ⚠️ 另一会话 <HH:MM> 刚写过 [[<topic>]]，可能在并行做同一件事。我先扫一眼最新进展再回。 ``` Then read the recent entry so this response does not contradict parallel work. If no recent overlapping entry exists, skip silently. 3. Run the Knowledge Retrieval Gate for substantive requests that may depend on durable context in `<VAULT_ROOT>/02 Knowledge/`. Read `references/knowledge-retrieval-trigger.md` when the user asks about context, analysis, decisions, strategy, continuation, review, writing style, reusable workflow, older work, or a named project/domain/person/method. Skip greetings awaiting confirmation, dashboard/lint/weekly-index rendering, pure journal bookkeeping, sensitive folders/files unless explicitly asked, atomic utility queries, and cases with no relevant Knowledge hit after the gate. 4. Dispatch on the user's first message, in order: - Bootstrap/setup intent (`install fade-away`, `setup`, `bootstrap`, `初始化`, `第一次使用`, `开源部署`, or a missing `_Index.md` plus a user request to initialize): read `references/bootstrap-vault.md`. Bootstrap is a one-time setup path; ask for the vault root if it is unclear and never create files unless the user confirms. - Context/instruction check intent (`AGENTS`, `CLAUDE`, `上下文`, `context`, `经验继承`, `规则漂移`, project structure, skill/vault/workflow maintenance, or a fresh cwd/project boundary): read `references/context-check.md`. Report only when drift is found or the user explicitly asks; do not write instruction files unless the user confirms the specific patch. - Memory lint intent (`lint`, `体检`, `health check`, `检查知识库`, `检查任务索引`, `看看哪些适合变成 wiki`, or similar): read `references/lint-vault-memory.md`; render a report first and do not write fixes or knowledge pages unless the user confirms. - Fade-out/archive intent (`归档`, `淡出`, `收进 FADE`, or similar): read `references/fade-out-protocol.md`; render candidates or execute only after explicit confirmation. - Knowledge promotion intent (`沉淀成知识`, `写进 knowledge`, `变成 wiki`, `归档成知识页`, or similar): read `references/promote-to-knowledge.md`. - Weekly index intent (`周索引`, `周报`, `weekly index`, `weekly summary`, `本周总结`, or similar): read `references/render-weekly-index.md`. Open a journal entry only if the module writes or updates a weekly index. - Dashboard intent (`看下任务`, `看板`, `dashboard`, `总览`, or similar): read `references/render-dashboard.md`, render only, and do not open a journal entry yet. - History retrieval intent (questions about how or when past work happened, not plain continuation): read `references/history-retrieval.md`. - Clear existing active-topic match: read that topic page silently, set `bound_topic`, then open a journal entry. - Vague greeting (`hi`, `你好`, `在吗`, `开始干活了`, etc.): if `_Index.md` has rows, emit `⏮️ 上次：<task>，下一步是 <compressed next-step>。继续这个还是新任务？` and wait for the reply. Bind to the top row only if the user confirms. - New substantive task: do not mention old tasks; leave `bound_topic = None`. ## Open Journal Entry Open a journal entry only when work actually starts. Compute the vault-time daily path as `03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-MM-DD.md`, where `<YYYY-MM>` is the date's own month and `<YYYY-Wnn>` is the ISO week. Create missing month/week folders with `mkdir -p`. If the daily file is missing, create it from the template in `references/journal-write-protocol.md`. Ensure `## 🕐 任务时间线`, then append one header at the bottom of that section: - Unbound: `### HH:MM ▶️ <短中文标题>` - Bound: `### HH:MM ▶️ <短中文标题> → [[00 Tasks/<bound_topic>]]` Store `current_entry_start`, `current_entry_date`, and `current_entry_title`. Reset `bind_skipped`, task, knowledge candidate, and knowledge retrieval flags for the new entry. ## Per-Turn Save After every assistant turn with substantive output, append exactly one progress line inside the current journal entry: ```markdown (HH:MM) <一句话进展> ``` A progress line is one sentence, <= ~120 characters; move overflow detail to the topic or knowledge layer. Append at the end of the active entry body, immediately before the next `### ` timeline header or EOF. Do not rewrite earlier progress lines. Skip the save if the turn is only a clarification question or `tracking_disabled = True`. Harness-native task/chapter tools (todo lists, chapter markers, etc.) are session-scoped scaffolding, never a substitute for journal/topic writes. Treat their state changes as reminders to append the `(HH:MM)` line in the same turn. They do not change entry granularity or titles, and never trigger promotion by themselves. ## Post-Save Checks Run these checks after the per-turn save: 1. **Explicit promotion**: if the visible output contains an explicit `➡️ 下一步` marker or `## ➡️ 下一步` section, update the topic/index layer. If `bound_topic` is set, read `references/topic-update-protocol.md`; otherwise, if `bind_skipped = False`, read `references/promote-to-wiki.md`. 2. **Topic auto-refresh**: when `bound_topic` is set and no explicit next-step appeared, read `references/topic-update-protocol.md` when the active entry has >= 5 progress lines newer than the topic's frontmatter `updated:`, or `updated:` is more than 2 vault-time hours behind the latest progress line. Keep the current automatic refresh behavior; do not convert it to a confirmation prompt unless the user asks. 3. **Task auto-bind**: skip without loading the module when `task_auto_bind_checked` or `task_auto_bind_skipped` is `True`. Otherwise, when the active entry is unbound and lacks an explicit `➡️ 下一步`, read `references/task-candidate-trigger.md`. Create/bind a topic automatically for task-like sessions; skip only trivial Q&A, greetings, dashboard/lint-only reports, pure clarification, or sessions with no task nature. 4. **Knowledge candidate**: skip without loading the module when `knowledge_candidate_prompted` or `knowledge_candidate_skipped` is `True`. Otherwise, when reusable knowledge may have emerged and the user did not already ask for promotion, read `references/knowledge-candidate-trigger.md`. Do not create or update `02 Knowledge/` automatically. ## Mid-Session Topic Switch If the user says `继续做 X`, `回到 X`, or otherwise asks to switch while an entry is already open: 1. Match `X` against `_Index.md` conservatively. 2. If no clear match exists and `X` is clearly a new task, ask: `开始新的 <X> entry？我会给当前 entry 追加一行切换记录。` 3. If no clear match exists and the intent is not clearly new, ask one short clarification question. 4. If the match is clear and differs from `bound_topic`, ask: `切到 [[X]]？我会给当前 entry 追加一行切换记录，然后打开新的 X entry。` 5. On confirmation for an existing topic, append `(HH:MM) 切出当前任务，转到 [[00 Tasks/X]]。`, read the topic page, set `bound_topic = X`, and open a new bound journal entry. After opening it, if the new topic's domain differs from the previous one, re-run the Knowledge Retrieval Gate before continuing. 6. On confirmation for a new task, append `(HH:MM) 切出当前任务，开始 <X>。`, set `bound_topic = None`, and open a new unbound entry with normal per-entry flag resets. Task auto-bind can bind it later. 7. If the user declines, keep the existing binding. Do not silently switch topics mid-session. ## Manual Record Request If the user says `记录一下`, `记一下刚才的进展`, or similar, add one extra progress line to the current entry summarizing progress since the previous save. Do not open a new entry or close the current entry unless the user explicitly asks to switch tasks. If `tracking_disabled = True`, first apply the opt-out reversal rule in Edge Cases, then record. ## Modules All low-frequency mechanics live in `references/`; each module is loaded at the trigger points above. ## Format Rules - Time format: 24-hour `HH:MM` using vault-time. - Journal title: short, descriptive Chinese; avoid generic titles like `任务1`. - Progress line: one sentence, <= ~120 characters. - Topic filename: kebab-case, no spaces, `.md` extension on disk only. - Topic wikilink in journal: `[[00 Tasks/<topic>]]`. - Index row format: `| [[<topic>]] | YYYY-MM-DD HH:MM | <escaped next-step> |`. - Active main-table rows must use bare `[[<topic>]]`; `FADE/` prefixes are only allowed in the graveyard section. - Legacy `task-tracker` has been fully removed; never use the old name proactively. If the user asks, explain that `fade-away` replaced it. ## Edge Cases - User opts out (`这次不用记录`): set `tracking_disabled = True`; skip all writes for the session, but reading `_Index.md` for context is allowed. If the user later says `还是记一下`, `开始记录`, or triggers a manual record request, set `tracking_disabled = False`; reuse an existing entry if available or open a new vault-time entry, then append `(HH:MM) 补记：<未记录时段一句话汇总>`. Do not fabricate backfilled per-turn timestamps. - Midnight crossing: when the current save's vault-time date != `current_entry_date`, open a continuation entry in the new vault-time day's journal and update `current_entry_date`. Inherit `current_entry_title`, `bound_topic`, and decision flags (`knowledge_candidate_skipped`, `bind_skipped`, `task_auto_bind_skipped`); the header may add `（续）`. This is not a new task. - Dashboard-only turn: render the dashboard and wait; do not open a journal entry until the user starts real work. - Missing topic page for an index match: first check `<VAULT_ROOT>/00 Tasks/FADE/**/<topic>.md`. If found, ask once whether to un-fade it or start a derivative new topic; do not bind the FADE path or recreate an empty page. If not found, say the topic row exists but the page is missing, then ask whether to recreate it or continue unbound.