skillgram 錯誤回報

skillgram-report

啟動合約

在下列任一情況為真時使用此技能：

• skillgram 印出 ok:false、結束碼為 1/2、崩潰，或說出與磁碟不一致的內容 (registered 但主機設定中無對應條目、指向無效位置的連結、回報零技能但資訊清單有技能)。
• 代理需要某項能力，而 skillgram missing "<query>" 回答 found:false。
• 安裝或註冊在文件規定的重新啟動後未生效。

不適用於：「如何執行 X」（請閱讀 INSTALL.md），或沒有觀察到缺口的單純功能構想。

嚴格規則

1. 錯誤絕不作為技能提出。永遠不要執行 propose 來掩蓋錯誤行為。
2. 缺口絕不作為錯誤提出。中心中沒有某項能力就是一個請求。
3. 不得捏造證據：每個退出碼、路徑和 JSON 行都必須來自你剛才執行的命令。
4. 貼上前先遮蔽：代碼、密碼、私有主機、客戶名稱。保留結構，變更數值。
5. 永遠不要手動編輯主機設定檔（config.toml、config.yaml、.claude.json、.cursor/mcp.json）來「修復」skillgram。這會隱藏錯誤。
6. 在聲稱成功之前先讀回設定：<harness> mcp get skillgram（或 mcp list）和 skillgram status。退出碼不是證明。

決策閘門

觀察	管道
ok:false、非零退出、錯誤連結、輸出中的謊言、崩潰	錯誤 → bug_report.yml
你實際需要的功能回報 found:false	技能請求 → skill_request.yml
缺失的是 skillgram 命令、旗標或行為，而非技能	錯誤（在標題中寫「功能」）
在另一台機器或主機上正常運作	記為證據；不是修復
不確定	收集兩項證據，讓使用者選擇管道

執行步驟

1. 重現一次，保留確切的命令列。使用 CLI（skillgram <command> --json，若未安裝則使用 python <repo>/skillgram.py <command> --json）並記錄退出碼（Windows PowerShell 用 $LASTEXITCODE，POSIX 用 $?）。
2. 擷取環境資訊：
   • skillgram status --json
   • skillgram doctor --json（唯讀；去除你不想公開的路徑）
   • 作業系統、Python 版本、skillgram 版本、主機、以及你使用的啟動器 （當 PATH 上的啟動器不正確時，使用 SKILLGRAM_MCP_CLI_<HARNESS>）。
3. 對於任何註冊聲明，請在聲明成功的命令之後擷取 <harness> mcp get skillgram（或 mcp list）。
4. 對於缺口，請擷取 skillgram missing "<query>" --json 和 skillgram demand --limit 20（它會對無人能回答的查詢進行排序，讓議題與需求紀錄一致）。
5. 根據範本撰寫議題內容，並在發布前展示給使用者。使用 gh issue create --repo Xhuk/skillgram --template bug_report.yml（或直接填寫表單時使用 --body-file <file>）發布，或將文字交給使用者。

輸出合約

回覆時確切包含：

• 管道：bug 或 skill-request
• 證據：命令、退出碼、一行 JSON
• 環境：OS / Python / skillgram / 主機 / 啟動器
• 預期結果：一句話，無推測
• 處理方式：已發布（附上議題網址）或留為文字供使用者使用