area

Files (1)

• SKILL.md

SKILL.md (first lines)

Areas 代表持續關注的領域——沒有明確結束日期的長期責任或興趣（如「健康管理」「職涯發展」）。它們和 Projects 的區別在於：Project 完成後會歸檔，Area 則持續存在。Areas 提供跨專案的主題視角，幫助使用者看到不同專案和卡片之間的主題關聯。

每個 Area 存為 `vault/PARA/Areas/<area-name>.md`。

一致性驗證由 PostToolUse hooks 自動處理。狀態變更操作完成後透過 Bash tool 執行 `node .claude/twinmind/bin/tm-post-op.mjs --layer action` 觸發 post-op pipeline。唯讀查詢不需要。

### Post-op 執行方式

透過 Bash tool 執行：

```bash
node .claude/twinmind/bin/tm-post-op.mjs --layer action --event '{"event_type":"<AREA_CREATED|AREA_DEACTIVATED|AREA_REACTIVATED|AREA_UPDATED|AREA_LINKED|AREA_UNLINKED>","event_context":{"area_name":"<name>","area_slug":"<slug>"}}'
```

腳本同步執行，執行完成後再回應使用者。

## Area Schema

Frontmatter 必填欄位：`name`（人類可讀名稱）、`description`（一句話描述）、`status`（active/inactive）、`created`、`updated`、`related_projects`（陣列）、`related_cards`（陣列）。

Body 包含描述和兩個關聯區塊：`## Related Projects`（wikilinks）和 `## Related Cards`（wikilinks）。

## 建立 Area

生成 kebab-case 英文檔名，檢查衝突。建立 .md 檔案，更新 `PARA/Areas/_index.md` 加 wikilink，更新 `vault-index.json` 的 `areas` 新增條目（status: active，空 related 陣列）。執行 post-op（Bash tool，`node .claude/twinmind/bin/tm-post-op.mjs --layer action --event '...'`）。

## 停用 / 重新啟用

Area 不刪除——只切換 status。停用的 Area 不出現在 Dashboard 的 active 區塊中，但檔案保留，隨時可重新啟用。這比刪除安全，因為 Area 的關聯資料（projects、cards）仍有參考價值。

停用：status → inactive。重新啟用：status → active。兩者都更新 index 和 `updated` 日期。執行 post-op（Bash tool，`node .claude/twinmind/bin/tm-post-op.mjs --layer action --event '...'`）。

## 關聯 Project / Card

Areas 的價值在於連結——把分散的 Projects 和 Cards 收攏在同一個主題下。

**關聯 Project**：將 project 名加入 `related_projects`，在 `## Related Projects` 追加 wikilink（`[[PARA/Projects/<name>/goal|<title>]]`），更新 index。

**關聯 Card**：將 card ID 加入 `related_cards`，在 `## Related Cards` 追加 wikilink（`[[Cards/<slug>|<title>]]`），更新 index。

取消關聯為逆操作。重複關聯時回報「已關聯」。每次操作都執行 post-op（Bash tool，`node .claude/twinmind/bin/tm-post-op.mjs --layer action --event '...'`）。

## 更新 Area

修改 description 等 metadata，更新 `updated` 日期和 index。執行 post-op（Bash tool，`node .claude/twinmind/bin/tm-post-op.mjs --layer action --event '...'`）。

## 列出 Areas / 查看詳情

從 `vault-index.json` 讀取，按 active/inactive 分組顯示 name、projects 數、cards 數。查看詳情時讀取 area 檔案顯示完整資訊。唯讀操作，不需 post-op。空態：「目前沒有關注領域」。

From VolderLu/TwinMind, MIT.

More from VolderLu/TwinMind