decision-pulselisted
Install: claude install-skill chengwesley/decision-pulse
# Decision Pulse
目的:避免使用 AI 工作時認知負荷過重而不自知。設計契約與驗收標準在
[`references/spec.md`](references/spec.md)(目標 G1–G12);**任何改動都要先對回那份 spec**,
對不回去的就不做。這個工具偏離使用者目標兩次,spec 就是為了防止第三次。
## 執行
腳本在這個 skill 資料夾的 `scripts/` 裡(不論裝在哪個 AI 工具的 skills 目錄,都用本檔所在位置的相對路徑):
```bash
python <本 skill 資料夾>/scripts/scan_today.py --date YYYY-MM-DD --save
```
- 不給 `--date` 就是今天。**每一次都只看一天**,沒有跨日比較。
- `--save` 把結果存進本 skill 的 `history/`:`decision-pulse-<日期>.html`(頁面)、`<日期>.json`(完整數據)。**一個日期一份**,`history/` 是個人資料,不進版控。console 只印路徑和一句話總結(省 token)。
- **每個日期一個獨立頁面,不互相覆蓋。** 工具能發佈 HTML(例如 Claude 的 Artifact)就發佈該日期的檔案;發佈後執行 `scan_today.py --record-url <日期> <連結>` 記進 `history/published.json`。同一個日期再次更新時,用 `published.json` 裡的連結更新同一頁。不能發佈的工具,告訴使用者 HTML 檔的位置,請他用瀏覽器打開。**不要手寫或改寫頁面**,版面由腳本固定。
- 回覆時附上那一句總結,讓使用者不打開頁面也知道大概。
### 問到過去某天:先用已存的結果
1. 先看 `history/<日期>.json` 在不在。
2. **在的話直接用它分析、回覆**,並附上 `published.json` 裡的連結;不要重新掃描對話紀錄。
3. 不在的話才執行 `--date <日期> --save`,再發佈、記錄連結。
4. 使用者明確說「重跑/重新分析」時才覆蓋舊結果。已存頁面的語言跟現在的 `lang` 不同時(看 `<日期>.json` 的 `config.lang`,沒有這個欄位就是 zh-TW),也要用 `--date <日期> --save` 重新產生,數字不會變,只換文字。
5. **今天**的資料還在變動,每次都重新掃描。
- 使用者想「一直看得到」時,告訴他可以開 `pulse-clock/pulse-clock.pyw`:桌面圓形小時鐘,外圈四段弧=四大指標等級,每 30 分鐘呼叫本 skill 的 `scan_today.py --json` 更新,不跳通知。小時鐘只顯示,不自己算數字。
## 第一次使用:語言與職能
1. **語言**:`config.local.json` 沒有 `lang` 時,**照使用者提問用的語言決定,不用另外問**:用中文問寫 `"lang": "zh-TW"`,用英文問寫 `"lang": "en"`,其他語言先用 `en`。之後使用者說要換語言,就改這個欄位。
2. **職能**:沒有 `role` 的話,**用同一種語言問使用者一次職能**(工具有選項式提問就用它,沒有就直接用文字問)(工程/營運・HR/業務/設計/主管/其他;英文為 Engineering / Oper