Notion 四象限任務管理

1. 觸發條件

當用戶輸入包含以下意圖時，觸發本技能：

• 新增任務：使用者表達需要記錄、建立或新增待辦事項的意圖，包含任務內容和時間相關資訊
• 查詢任務：使用者詢問指定時間範圍內的待辦事項（如今天、接下來幾天、特定日期範圍等），或希望對任務進行總結、統計分析、四象限分類、瞭解當前任務的整體情況
• 搜尋任務：使用者詢問特定任務的相關資訊，提供關鍵詞或描述
• 更新任務狀態：使用者表示已經完成某項任務、想要將任務標記為已完成/進行中/未開始/已取消等狀態，可通過任務標題或備註進行匹配
• 更新任務截止日期：使用者希望修改任務的截止日期，或將任務延期，可通過任務標題或備註進行匹配

由於agent預設優先從記憶檔案中查詢待辦事項，因此首次觸發使用者需明確輸入使用技能。

2. 使用者配置

2.1 API 金鑰配置

使用者需要提供 API 金鑰，執行以下命令儲存 API 金鑰：

   mkdir -p ~/.config/notion
   echo "your_api_key_here" > ~/.config/notion/api_key

• 禁止從memory記憶檔案或TOOLS.md檔案或上下文獲取API金鑰。

2.2 資料庫配置

使用者需要提供資料庫名稱，執行以下命令儲存資料庫名稱：

   mkdir -p ~/.config/notion
   echo "your_database_name_here" > ~/.config/notion/database_name

• 如果資料庫名稱不存在、Notion 連線失敗、或缺少必需欄位，則提示使用者修正配置。
• 禁止從memory記憶檔案或TOOLS.md檔案或上下文獲取資料庫名稱。
• 禁止在指令碼呼叫失敗時自行呼叫Notion API。

2.3 狀態檔案

• 初始化：如果狀態檔案不存在或不完整，呼叫get_state建立檔案並瞭解資料庫基本情況。
• 儲存位置：指令碼notion_quadrant_manager.py所在目錄下的 notion_quadrant_manager_state.json
• 作用：快取資料庫連線資訊、欄位對映和任務資料，提高操作效率
• 注意事項：確保指令碼所在目錄有寫入許可權
• 訪問方式：通過 get_state 動作獲取狀態檔案中的資料庫相關資訊，禁止閱讀狀態檔案

2.4 依賴安裝

指令碼需要以下 Python 依賴：

• requests：用於傳送 HTTP 請求到 Notion API

安裝依賴的命令：

pip3 install requests

3. 必要欄位

識別資料庫中與下列語義對應的欄位，不要求完全同名，但必須存在對應的 Notion 屬性型別和可用列舉值。

• 待辦事項（標題欄位）
• 截止時間（日期欄位）
• 四象限（select/status/multi_select 欄位）
• 狀態（status/select 欄位）
• 備註（rich_text/title 欄位）
• 分類（multi_select/select 欄位）

4. 呼叫方式

本技能通過 exec 呼叫SKILL.md同目錄scripts資料夾下的 Python 檔案：

python3 ./scripts/notion_quadrant_manager.py <action> '<json_args>'

5. 可呼叫動作

5.1 get_state

獲取database 的相關資訊，用於 AI 理解使用者資料庫的基本情況，並識別必要欄位。

引數：

• 無需傳遞引數

返回：

• tasks_count：狀態檔案中的任務數量
• resolved：資料庫解析資訊
• fields：欄位對映
• last_task：最近一次操作的任務
• bootstrapped：是否執行了 bootstrap 操作

示例：

python3 ./scripts/notion_quadrant_manager.py get_state '{}'

5.2 add

建立任務。理解使用者意圖，歸納總結任務標題、備註、分類，識別對話中的日期、四象限、狀態，生成結構化資料輸出給指令碼執行。

引數：

• title：任務標題（Agent 歸納總結）
• due_date：截止日期（ISO 格式）
• quadrant：四象限分類（Agent推斷）
• status：狀態（預設：未開始）
• category：分類（Agent 歸納總結，可選）
• note：備註（Agent 歸納總結，可選）

返回：

• 建立的任務資訊

示例：

python3 ./scripts/notion_quadrant_manager.py add '{"title":"去北京","due_date":"2026-03-28","quadrant":"重要緊急","status":"未開始","category":"工作","note":"商務出差"}'

5.3 query

查詢指定時間範圍內的任務，支援狀態過濾，可選擇生成總結。

引數：

• start_date：開始日期（可選，格式：YYYY-MM-DD）
• end_date：結束日期（可選，格式：YYYY-MM-DD）
• days：天數（可選，當不提供 start_date 和 end_date 時使用，不傳時預設：7）
• status：任務狀態列表（可選，預設：["未開始", "進行中"]）
• category：任務分類（可選）
• quadrant：任務四象限（可選，如：重要緊急、緊急不重要、重要不緊急、不重要不緊急）
• summary：是否生成總結（當用戶要求總結時傳true，預設：false）

返回：

• 指定時間範圍內的任務列表（包含超時任務提醒）
• 如果 summary 為 true，還返回四象限統計、重要緊急任務列表、建議提前完成任務列表、超時任務列表和建議

示例：

# 查詢指定日期範圍的任務
python3 ./scripts/notion_quadrant_manager.py query '{"start_date":"2026-04-01","end_date":"2026-04-07","status":["未開始", "進行中"]}'

# 查詢最近 7 天的任務並生成總結
python3 ./scripts/notion_quadrant_manager.py query '{"days":7,"summary":true}'

# 查詢指定分類和四象限的任務
python3 ./scripts/notion_quadrant_manager.py query '{"days":7,"category":"工作","quadrant":"重要緊急"}'

5.4 search

搜尋指定任務。

引數：

• query：查詢關鍵詞

返回：

• 所有匹配到的任務（按相似度排序）

示例：

python3 ./scripts/notion_quadrant_manager.py search '{"query":"北京出差"}'

5.5 update_status

更新任務狀態和/或截止日期。優先使用任務標題或備註進行精確匹配，更新失敗或不確定具體任務引數就使用search方法和使用者確認。

引數：

• title：任務標題（用於查詢任務，必選）

  來源於7w4.net。

• note：任務備註（用於查詢任務，可選）
• status：任務狀態（可選，如：未開始、進行中、完成等）
• due_date：任務截止日期（可選，格式：YYYY-MM-DD）

返回：

• 更新後的任務資訊

示例：

# 通過任務標題更新狀態為進行中
python3 ./scripts/notion_quadrant_manager.py update_status '{"title":"去北京","status":"進行中"}'

# 通過任務備註更新截止日期
python3 ./scripts/notion_quadrant_manager.py update_status '{"note":"商務出差","due_date":"2026-04-15"}'

# 同時更新任務狀態和截止日期
python3 ./scripts/notion_quadrant_manager.py update_status '{"title":"去北京","status":"進行中","due_date":"2026-04-15"}'

6. 四象限處理

6.1 寫入資料時四象限推測規則

• 是否重要：任務內容凡涉及領導、父母等重要關係人，涉及學習、健康、資金處理、晉升，涉及事先承諾的均為重要
• 是否緊急：任務完成日期距今天小於等於2天的均為緊急
• 如判定成功，請在寫入資料完成後告知使用者寫入的四象限分類
• 如無法判定重要性或緊急性，直接詢問使用者四象限分類

6.2 總結分析流程

1. 檢查資料庫中是否有四象限欄位，如有則直接使用該值判定
2. 基於使用者不同象限的任務數量，基於減少緊急任務數量、專注重要任務的原則，給出當前任務情況統計和建議

7. 超時任務處理

• 識別截止時間早於當前時間的任務
• 在查詢和總結時單獨列出這些任務
• 使用醒目的方式提醒使用者這些任務已超時
• 超時任務優先顯示在任務列表頂部

8. 輸出要求

Python 指令碼返回 JSON，至少包含：

• ok：操作是否成功
• action：執行的動作
• message：操作結果訊息
• data：操作結果資料

Agent 讀取 JSON 後，根據回覆訊息的平臺（微信、飛書等），選擇合適的排版（列表、表格、分割線、圖示等）對齊並羅列任務，組織自然語言回覆給使用者，保證內容清晰，重點突出。

微信QQ示例：

⏰ 任務歸類 x2
1.title-1
  （進行中/3.28/重要緊急）📚
2.title-2
  （進行中/3.28/重要緊急）💼

這個 Skill 質量不錯，能幫你用四象限法則管理 Notion 中的待辦事項。優點是功能齊全、查詢速度快、會自動提醒超時任務、智慧識別字段名稱。缺點是需要手動配置 API 金鑰和資料庫，對新手來說有點麻煩。總體來說是個好用的時間管理工具，配置好後使用體驗流暢。