實驗報告自動駕駛 是做什麼的?
從作業到交付全程驅動報告:檢查檔案、選擇環境、執行實驗、擷取有用的結果、填充使用者提供的範本,並檢查最終的 DOCX 檔案。一旦所需的檔案和個人欄位準備就緒,無需使用者執行例行步驟即可繼續操作。
絕不偽造軟體輸出、螢幕截圖、使用者詳細資料、引用或環境值。僅在環境不可用、缺乏授權或缺少必要欄位而可能導致報告不實時才進行中斷。
設定
將包含此 SKITCH.md 檔案的目錄解析為 SKILL_DIR。使用絕對路徑執行捆綁的腳本;當前目錄可能是使用者的報告資料夾,而非技能資料夾。
如果沒有報告工作區:
python3 "$SKILL_DIR/scripts/init_report.py" work/report-name \
--kind lab \
--discipline packet-analysis \
--title "ARP 協定抓包與欄位分析"
對於專業實踐,使用 --kind practice。提供的 DOCX 仍作為報告範本;請勿用通用的 Markdown 草稿取代它。
圖片檢查器需要 Pillow:
python3 -m pip install -r "$SKILL_DIR/requirements.txt"
閱讀資料
在撰寫之前對每個輸入進行分類:
- 範本: 控制章節、欄位、頁面佈局和視覺風格。
- 良好參考: 顯示有用的步驟長度、措辭或螢幕截圖放置位置。
- 反例: 顯示應避免的問題。
- 任務資料: 提供所需的資料、程式碼、拓撲結構和預期結果。
- 私人資料: 遵循使用者的處理指示,僅提供授權的事實。請參閱 user-data-and-privacy.md。
學習模式,而非另一個人的身份或結果。請勿複製姓名、螢幕截圖、地址、私人記錄或第一人稱主張。
閱讀 disciplines.md,然後載入與之相符的學科檔案。僅在任務實際跨學科時才載入第二個檔案。
決定交付內容
記錄:
- 所需的章節和評分提示;
- 使用者已提供的欄位;
- 軟體、作業系統、資料、拓撲結構和預期輸出;
- 每個提交的主張所需的可見結果;
- 長度、日期、檔案名稱和檔案格式規則。
僅從使用者提供或確認的值中填寫姓名、學號、班級、教師、組織、角色、日期和其他欄位。在所有出現的地方使用相同的值。對範本要求的遺漏欄位詢問一次。除非使用者明確提供,否則將簽名、分數和審批欄位留空。請勿重複使用來自不相關報告的檔案名稱模式。
在編輯 Word 之前,請閱讀 docx-qa.md 並測量提供的範本:紙張尺寸、邊距、表格、字型、字號、行距、縮排、圖片寬度、標題、頁首、頁尾和頁碼。這些測量值控制輸出。
選擇環境
閱讀 environment-playbook.md,然後檢查當前機器:
python3 "$SKILL_DIR/scripts/probe_environment.py" --json
請勿假設作者的電腦或虛擬化產品。遵循任務指定的作業系統和軟體。對於常見的中國大學課程,將 Windows 視為 Office、PowerShell、SQL Server、eNSP、廠商模擬器和僅限 Windows 的教學軟體的主要路線。對於 Linux 網路和安全工具,使用 Linux 或 Kali。僅在指定的軟體和所需的螢幕截圖保持等效時,才原生使用 macOS;否則,使用任何可用的 Windows 或 Linux 虛擬機器、容器、WSL 或授權的遠端實驗室。
將權限修復和失敗的嘗試保留在工作筆記中,除非它們改變提交的結果。安全工作必須保持在本地實驗室、課程系統、故意設定的脆弱目標或其他授權的系統內。
執行與擷取
閱讀 evidence-and-screenshots.md 和所選的學科檔案。
- 構建滿足任務的最小設定。
- 執行報告中將出現的每個命令和程式碼路徑。
- 執行有意義的 GUI 操作後,檢查最新的應用程式狀態。
- 記錄確切的輸入、檔案名稱、版本、地址、幀數和觀察到的值。
- 擷取顯示結果的畫面;無需擷取每次點擊。
- 保持原始螢幕截圖、封包檔案、資料和原始碼不變。
生成的圖表可以解釋概念,但不能代替真實的軟體結果。一份報告中使用的螢幕截圖必須在檔案名稱、地址、連接埠、值和環境上保持一致。
在撰寫草稿之前檢查圖片資料夾:
python3 "$SKILL_DIR/scripts/evidence_manifest.py" path/to/evidence \
--output evidence-manifest.json
修復損壞的檔案、意外重複、無法讀取的截圖、暴露的私人資料以及缺失的結果畫面。
根據觀察到的結果進行撰寫
對於每個實作步驟,說明操作、觀察到的值或行為、附近的螢幕截圖,以及僅在必要時提供的簡短解釋。保持理論和摘要與範例和任務成比例。
對於專業實踐,將其作為指派的工作來撰寫:收到了什麼、檢查或操作了什麼、如何做出判斷以及記錄了什麼結果。請勿添加關於螢幕截圖數量、報告結構、保留的工件或報告選擇不介紹的內容的簡報說明。請勿僅僅為了填補來源行而添加公司首頁。
對於程式碼,僅實作請求的行為。請勿添加未使用的抽象、推測性的選項、不可能情況的檢查或重申簡單程式碼的註解。
建構並檢查 DOCX
在可用時使用主機代理的文件工具;否則使用相容的 DOCX 工具和真實的渲染器。就地填充提供的範本。僅在報告內容取代範本文字時才移除範例文字。
渲染最新的 DOCX 並以 100% 比例檢查每一頁:
- 螢幕截圖和標題清晰且對齊;
- 文字、表格和圖片不會裁剪或重疊;
- 中文和拉丁字元正確渲染;
- 標題、編號、間距、縮排、邊距、頁首、頁尾和頁碼與範本相符;
- 姓名、日期、命令、地址、幀數、圖形和結論一致;
- 沒有多餘的空白頁或幾乎空白的頁面殘留;
- 檔案名稱遵循此任務的規則;
- 沒有憑證、私人工作區資料或不相關的個人資訊殘留。
在每次版面變更後重複渲染。除非使用者要求工作資料,否則僅交付請求的檔案。