workplanlisted
Install: claude install-skill TCcodemaster/claude-workplan
# workplan
## 這個 skill 在做什麼
使用者的工作真相分散在三個地方,這個 skill 負責把它們接起來,但每一層的角色是固定的,不要混用。
| 系統 | 角色 | 讀��� |
|---|---|---|
| Notion 12 個「任務追蹤-*」database | 任務來源 | 全程唯讀,絕不回寫狀態 |
| 提醒事項 | 待辦主要載體,只有日期沒有時間 | 讀寫 |
| iCloud 行事曆「工作」系列 | 只放討論後確認的重點,才有具體時間 | 讀寫 |
四個不變量必須守住。第一,Notion 永遠唯讀,使用者的完成動作只發生在提醒事項。第二,平鋪出來的待辦只設日期,不要改成帶時間。第三,行事曆事件只在使用者明確挑選後才建立,不可以自動把整批待辦倒進行事曆。第四,**重排行程一定要等使用者點頭**,早上的推播只回報現況與待決定的事,不會自己把行程改掉。
## 預設走口述,不要動不動就讀 Notion
使用者講的工作粒度比 Notion 任務粗,而且他自己最清楚今天該做什麼。所以預設流程是**他口述、你用 `add` 建待辦並直接排時段**,一步到位。
Notion 那套(`plan` 從十二個 database 抓任務、依到期日與優先順序排序)只有在他明確說「去看一下 Notion 有什麼沒做完」時才用。不要每次排工作都先跑 `plan`,那要八秒而且排出來的顆粒度往往不是他要的。
你平常只需要認得專案名稱。同一個專案往往有好幾種口語說法,對應表在 `references/project_map.json` 的 `aliases`。認不出來時腳本會列出可用代號並要求你補別名,不要自己猜。
## 排序規則(只有走 `plan` 讀 Notion 時才適用)
任務排序只看任務本身的欄位,不做專案層級的主觀判斷,因為專案的緊急程度會動態變動。順序是到期日近的先,同組看「優先順序」欄位的高中低,再看「難度」欄位,大的先開始以免來不及。
每日容量上限寫在 `wp/config.py`,目前是一天最多三個不同專案、每個專案最多三件、一天總計最多八件。哪三個專案不由 skill 指定,而是照任務隊列自然浮現,一天湊滿三個專案就換下一天。
年度計畫頁(`ROADMAP_PAGE_ID`,選用)不參與計算,它純粹是背景知識,只在報告尾端顯示本月安排供參考。使用者不一定要照它調整,不要拿它去推翻使用者指定的專案範圍。
## 主要流程
腳本就在這個 skill 目錄下,用 `python3 workplan.py` 執行,沒有外部依賴。下面的指令都以 skill 目錄為工作目錄,實際執行時要換成完整路徑。
第一次使用如果報「還沒完成初始化」,那是 `bin/wpkit` 還沒編譯。叫使用者跑 repo 根目錄的 `setup.sh`,不要自己想辦法繞過,那支工具是所有讀寫的唯一入口。
### 排工作:一個指令
```bash
cat <<'JSON' | python3 workplan.py add --list 提醒事項
[
{"project":"官網改版","title":"分析新需求","day":"2026-03-02","minutes":120},
{"project":"內部工具","title":"修正登入 bug","day":"2026-03-03","minutes":180}
]
JSON
```
`add` 會建待辦、掛專案標籤,**然後直接把它們卡進行事曆空檔**,