PI BLUEBOOK

繁體中文

简体中文

繁體中文

简体中文

外觀模式

CASE 03 · 可練習

把方法整理成技能（Skill） ​

結果 ​

將“指定輸入、固定四個欄位、未知不猜、寫後複核”固化為可讀取的技能，並生成一份複核版行動清單。

固定材料 ​

1. 下載並審查 ​

在普通終端機準備獨立練習目錄，不要求先完成 CASE 01：

bash
cd ~/Downloads/pi-practice
mkdir -p input output bluebook-examples/action-list-review
curl -fL https://pi.xiaomovps.com/examples-tw/first-task/meeting-notes.md \
  -o input/專案會議記錄.md
curl -fL https://pi.xiaomovps.com/examples-tw/skill/action-list-review/SKILL.md \
  -o bluebook-examples/action-list-review/SKILL.md
shasum -a 256 input/專案會議記錄.md > input-before.sha256
sed -n '1,160p' bluebook-examples/action-list-review/SKILL.md

Windows 使用者把第一行換成 cd ~/pi-practice，並把 shasum -a 256 換成 sha256sum。技能正文應該只有 name、description 和圍繞會議記錄的檢查規則；出現不相關命令時停止。

2. 顯式載入並提交任務 ​

在普通終端機執行：

bash
pi --no-skills --skill ./bluebook-examples/action-list-review/SKILL.md

進入 Pi 後傳送：

text
/skill:action-list-review 請重新核對 input/專案會議記錄.md，
把結果寫入 output/行動清單-複核版.md。不要修改輸入檔案；
原文沒有的資訊寫“原文未說明”。完成後重新讀取輸出並報告路徑。

如果 /skill:action-list-review 沒出現，先在 /settings 檢查技能 commands，再重新啟動；不要把檔案複製到多個自動發現目錄碰運氣。

先讀完整個 SKILL.md，再使用 --no-skills --skill <路徑> 顯式載入。不要把看不懂的工作說明直接放進自動發現目錄。

教學技能的真實載入狀態與顯式呼叫位置

圖中底部內容仍未提交，方便你在執行前最後一次核對技能名稱、輸入路徑和當前工作目錄。

第 10 課解釋三類擴充的邊界；本頁已包含完成案例所需的全部操作。

關鍵現象 ​

同一條任務在顯式載入技能後，多了一套可見、可複核的檢查規則；技能沒有替你提供輸入，也不會自動證明輸出正確。驗收仍然回到固定原文、輸出檔案和輸入指紋。

獨立驗收 ​

退出 Pi 後執行：

bash
test -f output/行動清單-複核版.md && echo "PASS: 複核版存在"
shasum -a 256 -c input-before.sha256
sed -n '1,160p' output/行動清單-複核版.md

Windows Git Bash 把 shasum -a 256 -c 換成 sha256sum -c。

  • 實際載入的檔案與檢查過的檔案是同一個路徑。
  • 輸出為新檔案，輸入指紋不變。
  • 三項均有事項、負責人、日期、限制；缺失資訊不會被編造。
  • 退出本次 Pi 後不再傳入 --skill，該教學技能不會繼續載入。

再走一步：修改自己的核對規則 ​

先保留原技能，複製成一個新練習：

bash
mkdir -p bluebook-examples/action-list-latest
cp bluebook-examples/action-list-review/SKILL.md bluebook-examples/action-list-latest/SKILL.md

開啟新檔案，把 frontmatter 的 name 改成 action-list-latest，並增加一條：“結果按截止日期從晚到早排列；未知日期放在最後，不補寫日期。”其他規則保留。

重新啟動，只顯式載入新檔案：

bash
pi --no-extensions --no-skills --skill ./bluebook-examples/action-list-latest/SKILL.md

在 Pi 輸入 /skill:action-list-latest，要求讀取同一輸入，寫入 output/行動清單-倒序版.md。驗收時負責人順序應是小陳、小周、小林，日期分別為 2026-09-01、2026-08-30、2026-08-28；三項的限制不能因排序丟失。

最後重新核對輸入指紋，確認舊技能沒被改寫。這樣你練習的是“把重複規則變成自己的方法”，而不僅是載入別人提供的檔案。想換一種輸入，繼續做內容整理遷移練習。

失敗恢復 ​

技能沒被使用時，核對路徑、後設資料和啟動引數；結果錯誤時回到原文驗收，不先改技能來掩蓋一次任務錯誤。來源或內容異常時停止載入。