適用於 Openclaw 的 Proof

Proof 是一款優先 Web 的協作式 Markdown 編輯器,旨在實現 AI 智能體與人類用戶之間無縫的文檔互動。

dshipper
v1.0.0
Mar 12, 2026
0
925
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install proofeditor

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 proofeditor。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Proof?

Proof 作為一個專門的協作環境,供智能體和人類共同編寫 Markdown 文檔。透過利用 Openclaw Skills 連接到 Proof API,智能體可以加入共享工作階段,透過作者標籤追蹤來源,並即時管理文檔狀態。這項技能確保 AI 的貢獻是透明的,並整合到專業的工作流中,從而超越靜態文本生成,進入活躍的多用戶文檔參與模式。

與本地文件編輯不同,Proof 專注於使用 proofeditor.ai 的集中式 API 進行基於 Web 的協作。它允許智能體顯示在線狀態,透過修訂追蹤提供建議,並透過塊級操作管理複雜的文檔結構。這使其成為團隊使用 Openclaw Skills 構建共享知識庫、報告和迭代專案文檔的重要工具。

Proof 應用場景

  • 建立並分享協作專案計劃、規格說明或 Bug 報告。
  • 評審人類撰寫的草案並提供行內建議或評論。
  • 管理需要來源和編輯歷史的長篇文檔。
  • 協調多個 AI 實體貢獻於單一事實來源的多智能體工作流。
  • 在人類編輯時智能體保持在線狀態的即時腦力激盪會議。

Proof 運作原理

  1. 智能體識別 Proof URL 或被觸發建立新的協作文檔。
  2. 技能提取唯一的文檔 Slug 和存取權杖以建立授權連線。
  3. 智能體使用特定的 Agent ID 和狀態(例如:正在閱讀、正在思考)發出在線信號,以通知人類協作者。
  4. 智能體獲取當前文檔狀態或快照,以了解最新內容和修訂版本。
  5. 使用各種策略應用編輯,從簡單的追加到具有冪等鍵(Idempotency-Key)的複雜塊級操作,以確保可靠性。
  6. 智能體輪詢待處理事件,以響應人類的反饋、評論或已接受的建議。

Proof 設定指南

要將 Proof 與 Openclaw Skills 配合使用,請確保您擁有來自 proofeditor.ai 的 API 權杖。您可以使用以下 bash 指令建立一個新文檔:

curl -sS -X POST https://www.proofeditor.ai/share/markdown \
  -H "Content-Type: application/json" \
  -d '{"title":"My Document","markdown":"# Hello\n\nFirst draft."}'

對於現有文檔,請使用 Bearer 權杖進行授權:

curl -sS "https://www.proofeditor.ai/api/agent/<slug>/state" \
  -H "Authorization: Bearer <token>" \
  -H "X-Agent-Id: <your-agent-id>"

Proof 資料結構與分類體系

Proof 透過文檔 Slug 和快照組織數據。關鍵元數據元素包括:

欄位 描述
slug 文檔 URL 的唯一識別碼
accessToken API 互動所需的憑據
by 每次寫入所需的歸屬字串(例如:ai:agent-name)
X-Agent-Id 用於管理在線身份和狀態
baseRevision 用於防止陳舊覆寫(409 錯誤)的版本號

支援的塊操作包括 replace_block, insert_before, insert_after, delete_block, 以及 find_replace_in_block。

Proof 進階特性

  • 冪等編輯:在 V2 編輯中使用 Idempotency-Key 以確保安全重試而不重複內容。
  • 修訂追蹤:支援 suggestion.add 和 rewrite.apply 用於人工參與的評審循環。
  • 即時在線:智能體可以將狀態更新為正在閱讀、正在思考、正在行動或正在等待。
  • 修訂鎖定:透過檢查 baseRevision 與當前伺服器狀態來防止數據流失。
  • 事件確認:允許智能體處理並確認(ack)特定的文檔事件以保持同步。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*