泛微項目文檔協作:Ecology 文檔只讀檢索與已確認文件上傳

前言

做泛微(Weaver)項目交付時,團隊經常要反覆做兩件事:按項目條件找 Ecology 裏的文檔,以及把已經和客戶確認過的文件傳回去。直接寫腳本對接,每次都要重新處理認證、接口地址和字段約定,成本不低;而通用的文件讀寫工具對 Ecology 的項目文檔結構並不瞭解,容易動到不該動的文檔。

下面介紹一個把這兩件事收斂到一處的 Skill:泛微項目文檔協作。

這是什麼

泛微項目文檔協作是一個面向泛微項目交付場景的 Agent Skill,座標 @user_040dcc29/weaver-project-documents,由社區開發者 user_040dcc29 發佈,當前版本 1.0.6,來源標記爲 community,分類爲 office-efficiency。

它提供兩件事:Ecology 文檔的只讀檢索,以及已確認項目文件的上傳。認證由用戶本人完成,Skill 本身不接管憑據;跨包依賴由項目交付協調總控統一恢復。也就是說,它把認證和依賴協調交給人與上層總控,自己只管檢索和上傳這兩段明確的動作。

核心功能

1、Ecology 文檔只讀檢索。按項目條件查詢 Ecology 中的文檔,結果只讀,不做修改或刪除。
2、已確認項目文件上傳。對已經確認過的項目文件執行上傳,上傳範圍限定在已確認的文件上。

從簡介看,這兩個能力圍繞「項目文檔」這一個對象展開:一邊是查,一邊是傳,讀寫方向相反。

安裝與啓用

官方地址:https://api.skillhub.cn/user_040dcc29/weaver-project-documents
SkillHub 頁面:https://www.skillhub.cn/skills/user_040dcc29/weaver-project-documents

安裝時在 SkillHub 上使用該座標即可定位到這個包:

@user_040dcc29/weaver-project-documents

@user_040dcc29/weaver-project-documents 是該 Skill 在 SkillHub 上的座標,發佈者爲 user_040dcc29。安裝後在對應的 Agent 運行時中引用該 Skill 即可啓用。

需要說明的是,已抓取資料裏沒有給出具體的安裝命令,也沒有分運行時的差異說明(Cursor、Codex CLI、Claude Code 分別怎麼裝)。本文不給出未經覈實的命令,實際操作以官方頁面爲準。

配置方面,標籤裏有一條 requires_api_key=false,表示該 Skill 不需要預先準備 API Key。這與簡介中「認證由用戶本人完成」一致——認證動作由使用者自己走,不通過配置項注入。

典型用法

已抓取資料只給出了能力層面的描述,沒有提供可直接復現的命令行示例或接口字段示例。因此本節只描述使用時的調用方向,具體參數和返回結構以官方頁面與 Skill 內的 SKILL.md 爲準。

1、檢索文檔:把項目條件交給該 Skill,讓它在 Ecology 文檔範圍內做只讀查詢,拿到項目相關的文檔列表。
2、上傳文件:把已確認的項目文件交給該 Skill 執行上傳。

認證環節由你本人完成,使用前先確認已具備對應的 Ecology 訪問憑據。

適用場景與注意

適合做泛微項目交付的團隊:需要按項目查詢 Ecology 文檔,並且需要把確認過的文件回傳到項目文檔中的場景。

需要注意的幾點:

1、檢索是隻讀的,不要期待這個 Skill 會修改或刪除文檔。
2、上傳範圍限定在「已確認項目文件」,文件是否確認過是使用前提,不是 Skill 自己判斷的。
3、認證由用戶本人完成,Skill 不代管憑據。
4、跨包依賴由項目交付協調總控統一恢復。如果依賴恢復環節出問題,檢查上層總控,而不是這個 Skill 本身。
5、流行度數據在不同資料裏不一致(一組爲評分 100000、下載 1066、安裝 0,另一組爲評分 99109、下載 1001),本文不對具體數值做判斷,只能說目前社區反饋還比較少。

結尾

泛微項目文檔協作把 Ecology 項目文檔的只讀檢索和已確認文件上傳收斂到同一個 Skill 裏,認證和跨包依賴分別交給使用者本人和項目交付協調總控。它的價值在於把項目交付裏反覆出現的查文檔、傳文檔兩段動作固定下來,而不是提供一個泛化的文件讀寫工具。

官方地址:https://api.skillhub.cn/user_040dcc29/weaver-project-documents
SkillHub 頁面:https://www.skillhub.cn/skills/user_040dcc29/weaver-project-documents

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜