DeepSeek Harness 編碼智能體在處理複雜任務時,往往缺乏顯式的工程流程和可追溯的證據。fullstack-expert 插件爲此提供了一套 Cordis 原生的工作流和安全層,旨在讓智能體的操作過程、計劃與驗證變得透明且可控。
插件定位¶
這是一個面向 DeepSeek Harness 代理的 Cordis 原生、證據驅動的全棧工程規範。它不引入新的代理框架、Shell、文件系統、瀏覽器或數據庫客戶端,而是通過註冊原生能力,爲現有 Harness 流程增加一層工程紀律。
核心功能¶
- Cordis 原生工作流與安全層:作爲 DeepSeek Harness 編碼代理的原生工作流和安全層。
- 倉庫檢查與規劃:支持對倉庫的檢查,以及垂直切片規劃。
- 敏感操作邊界:明確界定敏感操作的範圍。
- 證據記錄:記錄新鮮的驗證證據,並確保驗證證據必須來自 Harness 的原生檢查,而非自證。
- 確定性運行時 Seam:提供
FullstackExpertRuntime狀態 seam,用於管理階段、任務、證據和緊湊事件事實。 - 嵌入式技能:通過原生
ctx.skills註冊嵌入式窄技能。 - 權限與審批:包含權限分類,並在執行前提供審批感知的門禁,敏感操作會委託給 Harness 的原生審批,若不可用則關閉失敗。
- Supabase 檢測:可選的、只讀的 Supabase 項目證據檢測。
- 提供程序中立:操作時不選擇或硬編碼 LLM 適配器。
安裝與啓用¶
使用 DeepSeek Harness CLI 安裝此插件。安裝命令會激活其聲明的補丁層。
dsh plugin --profile web add git+https://github.com/adithya-hmt/fullstack-expert.git#v0.1.1
dsh --profile web --dump-config
dsh --profile web
請將 web 替換爲您配置文件的實際名稱。
典型用法¶
- 請求任務:向代理請求功能、Bug 修復、代碼審查、重構或應用構建。
- 垂直切片規劃:對於實質性工作,代理應調用
fullstack_plan。此操作會進行倉庫檢查、陳述假設/未知數,並使用原生工具實現垂直切片。 - 結構化檢查:使用
fullstack_check進行結構、命令或 Supabase 檢查,並記錄非驗證審查事實。 - 驗證完成:只有當來自 Harness 的原生
verification證據記錄通過且相關失敗不存在時,才能完成工作。
注意事項與範圍¶
- 不引入額外組件:插件不會引入第二個代理框架、Shell 執行器、文件系統後端、瀏覽器驅動、數據庫客戶端或模型提供程序。它重用 Harness 組合中暴露的現有能力。
- 瀏覽器驗證:瀏覽器驗證目前是指導加上證據記錄,直到穩定的瀏覽器工具被組合完成。
- Supabase 操作:Supabase 操作僅限檢測和建議;遷移、鏈接、登錄、推送、重置、拉取、函數部署和外部寫入仍爲顯式敏感操作。
- 配置管理:提供程序配置應保持在此包之外。使用 Harness 提供程序/模型設置表面配置現有的 OpenAI 兼容 CLI 代理(例如
provider: <your proxy adapter>,model: GPT-5.6 Max)。 - 許可證:插件實現遵循 MIT 許可證。
總結¶
fullstack-expert 旨在讓編碼智能體「展示其工作」。它通過原生 Cordis 能力和顯式的工作流,將倉庫檢查、垂直切片規劃、敏感操作邊界和驗證證據標準化,適合需要在 DSH 中實現嚴謹工程流程的開發者。