clayzhang-tw/claude-academic-workflow-zh/appendix
Claude Code and agent skill by clayzhang-tw/claude-academic-workflow-zh
- community
Checking that the SKILL.md file is still in the repository.
Install
npx vskill@latest install clayzhang-tw/claude-academic-workflow-zh/appendixSKILL.md
附錄 J 打開一份長大的技能檔
J-0 為什麼要看一份完整的
第 3 章教你建技能檔,用的例子是一個五段的小檔案。附錄 F 講了十二個設計模式,但那是在描述形狀。
兩者中間有一段空白:你知道要從摩擦開始,也知道有哪些模式,卻沒看過一份真的長大之後的東西長什麼樣。這一頁補那一段。
下面是我實際在用的引用查核技能。它從一段「幫我看這個引用能不能用」的提示詞開始,用了幾個月變成現在這樣。
這份已經縮過。 本機路徑改成了通用寫法,變更紀錄只留一則。結構與判準表是完整的,長度大約是原檔的一半。
⚠️ 看的時候請帶著 J-4 那個提醒:你的第一版不該長這樣,而且不可能長這樣。
J-1 先看骨架
九個大節。這是它現在的目錄:
第一,「模式 A/模式 B」不是兩個技能,是同一件事的兩種深度。 這解決一個很實際的問題:你不會為了確認一筆書目格式就啟動三個角色的對抗審查,但你也不希望投稿前的全稿掃描被草草帶過。
第二,〈邊緣情況處理〉這一節在最開始不存在。 它是每次撞到牆之後多加一列長出來的。
J-2 逐段看
觸發:它自己決定什麼時候該出現
這一段在防什麼:最後一列。前面四列是我開口叫它,最後一列是它自己該想起來。
那一條是我又一次差點出錯之後才補的。我沒說「引用」,只說「幫我把這段補完整」,於是它順手加了一筆我沒查過的來源。第 3 章講「技能是長出來的」,這一行就是長出來的地方。
模式路由:開場第一件事
這一段在防什麼:預設值選錯。
⚠️ 注意「自動升級」與「降級」是不對稱的。升級的條件寫了六條,其中兩條寫明強制或自動升級,降級只要我說一句話。這個不對稱是刻意的:要它更嚴格應該很容易發生,要它放鬆應該需要我明確開口。
倒數第二條是我踩過的:文獻來自搜尋推薦、而且沒有全文的時候,最容易發生「看起來很合適所以就用了」。
七大判準:這一頁最該抄走的東西
表裡的 4b、5b 附在 4、5 底下,主列是七條。
這一段在防什麼:憑印象放行。
⚠️ 沒有「每筆都要逐項回答,不可跳過」那一句,這張表會退化成一個心裡的印象。你掃過去覺得「大致沒問題」,然後放行。有那一句,你得對第 3 列寫下「二手引用」這四個字,而寫下來的那一刻你就知道它撐不住方法論宣稱。
判準 4b 值得多說一句。它原本只寫「被引幾次」,後來改成「被引的極性」:一篇被引 200 次、其中多數是被拿來反駁的,那它不是領域共識,是靶子。單看總被引數完全看不出這件事。
三個角色:為什麼要拆開
這一段在防什麼:找的人跟審的人是同一個。
三個角色分開,是因為 Finder 剛把那段話挑出來,它記得的是「我為什麼覺得這段合適」。讓它回頭審自己,它看到的是自己的理由,不是紙上的證據。 這條規則在本書第 7 章、第 14 章各出現一次,這裡是它的第三個實例。
Gatekeeper 只在五筆以上才跑,因為三筆引用談不上「分布」。
存在查核:判準之前還有一關
這一段在防什麼:把「文字對得上」當成「這個引用可以用」。
存在查核只回答一個問題:那句話在不在。它不回答那句話能不能撐你的主張。
邊緣情況:這一節是撞出來的
節錄六列。原檔有二十多列。
這一段在防什麼:每一列都是一次「當時想不到、事後才知道要防」。
⚠️ 第四列尤其值得看:「取不到」跟「沒有」是兩件事,而工具回你的東西長得一模一樣。 那一列不是設計出來的,是我把一篇拿得到的論文寫成「查無全文」之後補上的。
J-3 把這份檔對回十二個模式
附錄 F 講的十二個設計模式,在這一份檔案裡可以逐個指出來:
| 附錄 F 的模式 | 在這份檔的哪裡 | |
|---|---|---|
| ① 模式路由 | 「模式選擇(開場第一件事)」+自動升級規則 | |
| ② 角色分工與對抗 | Finder/Challenger/Gatekeeper 三個角色 | |
| ③ 階段編號 | 第 0 關 存在查核 → 七大判準 → 全域診斷 | |
| ④ 人的關卡 | 「使用者堅持用被 REJECT 的」那一列,決定權明確交回(這是使用者主動堅持時才交回,不是流程中途的強制停點,只算部分對應) | |
| ⑤ 逐項判準清單 | 七大判準表,「不可跳過」 | |
| ⑥ 前置存在查核 | 第 0 關 存在查核 | |
| ⑦ 覆蓋範圍聲明 | Gatekeeper 的「全文驗證覆蓋率」;「取不到 ≠ 沒有」 | |
| ⑧ 迴圈要有出口 | 存在查核失敗「最多退回一次,再失敗即 REJECT」(這是重試次數的上限,不是附錄 F 說的評估—修訂輪數上限,只算部分對應) | |
| ⑨ 反面規則 | 「不可寫成沒有全文」「不可直接互比」 | |
| ⑩ 技能之間寫清楚分工 | 〈與其他技能的分工〉整節 | |
| ⑪ 規格化交接 | 結構化紀錄(引文+位置+驗證層級)|最終輸出的總覽表 | |
| ⑫ 工具自己記演進 | 變更紀錄,見 J-4 |
十二個模式在一份檔案裡都找得到對應(④⑧只算部分對應),而這不是我事先照著清單設計的。是反過來。附錄 F 那十二個模式,本來就是從這一類檔案裡掃出來的共通形狀。
J-4 你的第一版不該長這樣
上面那份檔案有九個大節。⚠️ 如果你看完決定坐下來寫一份九個大節的技能檔,多半會卡在你還沒遇到的地方。
那些節不是設計出來的,是撞出來的。舉一個真的例子,這是它的變更紀錄裡的一則:
那一節不是我想到「應該要有收尾步驟」,是我數了一次 16 比 6。
所以你的第一版該長什麼樣:第 3 章 3.1 那個五段的版本。使用者背景、步驟、輸出格式、品質標準、不要做什麼。就這樣。
然後照這個順序長:
- 被同一件事絆到第二次 → 在「不要做什麼」多寫一行
- 發現自己每次都要先講一遍研究背景 → 把它寫進「使用者背景」
- 開始覺得同一個技能有時要快有時要細 → 這時候才需要模式路由
- 某次它給的東西你事後才發現不對 → 這時候才需要判準清單
- 你開始不確定自己有沒有漏掉什麼 → 這時候才需要覆蓋範圍聲明
⚠️ 每一步的觸發條件都是一次真實的失誤,不是一個階段目標。 沒被絆到就不要加。多加的每一條都是你以後要維護、而且不知道能不能刪的東西。
附錄 F 的模式增減判準是同一句話:你上一次因為缺它而卡住是什麼時候? 答不出來,就是還不需要。
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingappendix/J-a-grown-skill.md
Popularity
- Repository stars
- 74
- Repository forks
- 8
- 7-day trend score
- 22
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/clayzhang-tw/claude-academic-workflow-zh/appendix)