Duetkifu：記錄研究每一步的 AI Agent協作棋譜
English version → Duetkifu: A Kifu for Research, Recording Every Move You and Your AI Agent Make
跟 AI agent 一起做研究，一天可以試十幾件事。但是到了寫論文的時候，留下來的只有「成功的那一條」，失敗的嘗試、後來更正的數字，全都散在聊天紀錄裡。
Duetkifu（我叫它「研究棋譜」）就是為了這件事做的開源工具（MIT）：保存你和 AI agent 一起做研究的每一步（move），包含走不通的死路，並且記下每個數字是從哪裡來的。支援 Claude Code、Codex、Gemini CLI、Cursor，或任何能編輯 JSON 檔的 AI agent。
GitHub：https://github.com/Ashur5457/duetkifu | 教學：docs/tutorial.md | 給 LLM 的摘要：llms.txt
為什麼要記死路？
論文只呈現走通的那條路。其他的過程，像是失敗的嘗試、後來被更正的數字、太晚才注意到的線索，最後都留在聊天紀錄、投影片和記憶裡，然後就不見了。AI agent 試得越快，這些看不見的部分就累積得越快，靠手寫根本追不上。
Duetkifu 做了什麼
- 每次嘗試是一個「move」。記錄它接在哪一步之後、為什麼做、結果如何；如果是死路，還要寫為什麼走不通。
- 死路也是研究結果。失敗的 move 一定要有理由和原因類型：想法本身錯了、資料不可信（這條路其實沒被真正檢驗過）、分析方法有問題，或是成本太高。下一個人（或下一個 agent）才分得出「真的走不通」和「根本沒測過」。
- 每個數字都有出處。由記錄在案的腳本從原始檔重新計算，或取自有 SHA-256 指紋的指定檔案，或標示「無資料」並說明原因。對不上的地方會列出來，不會被悄悄改掉。
- agent 負責寫，你負責決定。agent 開啟、關閉 move 並起草文字；頁面會標示「agent 寫的、你還沒看過的」內容。move 的結論、確認的原因、審閱標記永遠由你決定。
- 全部在一個 HTML 頁面裡。研究紀錄（
kifu.json）畫成可在瀏覽器中閱讀、編輯的樹狀圖；同時內含 Duetsheet，也就是可以留言、可以在圖上徒手圈選、和 agent 一起修改的互動式報告。
名字的由來：kifu（棋譜）是將棋、圍棋一手一手的對局紀錄，棋手會在賽後復盤，看局勢是在哪裡轉折、哪一手是失誤。duet 是二重奏，研究者和 AI agent 看同一份譜。
示範 GIF
1. 把研究紀錄當成樹狀圖閱讀
GIF 內容：示範專案的研究紀錄畫成樹狀圖。點選一個 move 會展開它的理由、結果和資料鏈。move 的形狀表示結局（成立、死路、更正、獨立查核、未解決、規劃中）。
2. 邊讀邊問 AI agent
GIF 內容：在圖上圈出一塊區域，選擇問題（例如「資料從哪裡來？」「怎麼算的？」「可信嗎？」），按一下送出，agent 的回答會出現在浮動面板。
3. 自由排版頁面
GIF 內容：問題、樹狀圖、move、主線等區塊可拖曳、摺成一列、調整大小或全螢幕。
4. 編輯 move，復原與重做
GIF 內容：修改一個死路的原因，再用 Undo 取消、Redo 還原。每次修改都記錄是誰、何時做的。
快速開始
需要 Python 3.8 以上，只用標準函式庫，不用另外安裝東西。
搭配 Claude Code（終端機、VS Code 或 JetBrains），安裝一次就好：
/plugin marketplace add Ashur5457/duetkifu /plugin install duetkifu@duetkifu
之後請 Claude 針對你的資料夾啟動 Duetkifu（/duetkifu skill）。
不想裝外掛的話，直接執行：
python duetkifu.py "你的資料夾路徑"
瀏覽器會自動開啟並連到該資料夾。原始資料只會被讀取，紀錄和報告存在資料夾內的 duetkifu/ 子資料夾。介面支援英文、繁體中文、簡體中文、日文、韓文、西班牙文。
常見問題
Duetkifu 是什麼？給與 AI agent 一起做研究的人用的開源研究紀錄與報告審閱工具，保存每一步（含死路）以及每個數字的出處。
支援哪些 AI agent？Claude Code、Codex、Gemini CLI、Cursor，或任何能編輯 JSON 的 agent（見 AGENTS.md）。
要錢嗎？免費，MIT 授權。目前是 v0.8 原型，歡迎試用後回報問題。
和實驗筆記或聊天紀錄有什麼不同？每個 move 有結構（接續哪步、理由、結果、失敗原因），數字會和重新計算、檔案指紋比對，整條路徑畫成可編輯的樹。
試用有問題或想要的功能，歡迎到 GitHub 開 issue，或直接留言給我。
關鍵字：研究紀錄、研究日誌、AI agent 實驗筆記、死路、負面結果、可重現性、資料來源追蹤、人機協作研究、Claude Code 外掛、Codex、Gemini CLI、棋譜、Duetkifu、Duetsheet。
留言
張貼留言