Impa 審查
在獨立的鎖定會話中啟動技術文件審查,並回傳報告。適用於任何文件,無需作者參與。僅回報發現結果:即使被要求「審查並修正」,它也絕不會編輯文件或程式碼。
請勿讀取 method.md、checklist.md 或 reference/ 中的任何內容。審查工具會自行載入它們,將它們排除在此會話之外正是其關鍵所在。
如果您在此會話中撰寫或修改了這些文件,請遵循 round.md 中的步驟。
步驟
-
將簡報寫入
"${TMPDIR:-/tmp}"/impa/<專案>/direct-<n>/brief-1.md,其中<n>是上一個資料夾編號加一。此檔案僅記錄事實,絕不包含您的觀點,因此請勿事先閱讀文件:使用 impa 審查方法審查技術文件。請勿編輯任何檔案。 專案:<絕對路徑> 文件:<使用者指定的絕對路徑,或「自行尋找」> 其他來源:<使用者指定的依賴或同級儲存庫的絕對路徑,或「無」> 文件計畫:<專案中 .impa/plan.md 的絕對路徑,或「無」> 本次任務要求(使用使用者的話):"<提示>" 範圍:<使用者指定的範圍,或「整個文件集」> 上次任務遺留的未解決問題:無 已移交給人員:無 回傳該方法的報告。如果發現任何超出範圍的問題,請提及,但不要刻意尋找。 -
在背景啟動審查。為「其他來源」下的每個路徑添加
--add-dir:impa review --brief <簡報> --add-dir <專案>大型文件集可能需要
--timeout <分鐘>,預設為 20 分鐘。 -
如果指令以退出碼 1 結束,表示審查未完成,此時任何
review-1.md都是不完整的。若沒有review-1.json,或error以Error: spawn開頭,則表示無法啟動:請閱讀指令輸出的內容,然後使用備用方案。否則,請使用更大的--timeout再執行一次。如果再次失敗,請告知使用者沒有審查完成,並提供來自review-1.json的error資訊。 -
否則,僅讀取簡報旁邊的
review-1.md。按原樣回傳其內容,並附上指令輸出行中的成本,然後停止。除非使用者要求,否則請勿對發現結果採取行動:修正是一個獨立步驟,應在此步驟之後進行。如果review-1.json中的verdict為空,則表示沒有結論行,因此請聲明報告不可信賴。
如果 impa 不在 PATH 中或無法啟動,請使用 round.md 第 3 節中的備用方案。如果該備用方案也無法啟動,請告知使用者未執行任何審查。絕不要在此會話中進行審查。