前言¶

團隊裏常有人離職、輪崗或分身乏術，但他們的評審習慣、溝通語氣、處理某類需求的路徑，往往散落在飛書線程、郵件和 Wiki 裏。每次都要口頭轉述或翻聊天記錄，成本高，也容易失真。

下面介紹的是 SkillHub 社區 Skill「賽博數字人同事製作 Skill」（座標 @user_dedbd569/cyber-colleague）。它面向 Agent 運行時，用統一流程把聊天、文檔、郵件和筆記等材料，整理成可迭代、可加載的「同事 Skill」，而不是一次性提示詞。

這是什麼¶

一句話定位： 把某位同事的工作方法、流程與溝通風格，從多源材料中提煉出來，生成結構化的本地 Skill 包，並支持增量更新與版本管理。

• 出品與維護： SkillHub 社區發佈者 user_dedbd569，分類 ai-agent，來源 community。
• 官方入口： SkillHub 技能頁，API 標識地址爲 https://api.skillhub.cn/user_dedbd569/cyber-colleague。
• 頁面版本： SkillHub 展示爲 v1.0.1；技能包內 SKILL.md 元數據標註爲 1.2.1，以你實際安裝到的包爲準。
• 依賴 API Key： 標籤 requires_api_key=false；飛書、釘釘、Slack 等自動採集如需第三方憑據，通過環境變量注入，見下文。

核心功能¶

以下能力均來自技能包內的 SKILL.md、README.md 與 tools/ 說明。

材料輸入¶

支持多類來源，可按場景組合：

分析與輸出¶

主流程強調「先證據後結論」：工作能力（範圍、技術棧、評審重點、輸出偏好）與溝通風格（表達、決策、協作、語氣）分線分析，預覽摘要後再落盤。

默認輸出目錄爲 ./colleagues/{slug}/，包含：

• work.md：工作方法與評審習慣
• persona.md：溝通與行爲偏好
• meta.json：檔案、來源與版本信息
• SKILL.md：供運行時加載的合成技能文檔

更新已有同事 Skill 時會先備份，再增量改寫；配套 version_manager.py 支持列出歷史與回滾。

配套工具腳本¶

技能目錄內提供解析與採集入口，例如：

• tools/feishu_parser.py、tools/email_parser.py：解析導出文件
• tools/feishu_auto_collector.py、tools/feishu_browser.py、tools/feishu_mcp_client.py：飛書相關採集
• tools/dingtalk_auto_collector.py、tools/slack_auto_collector.py：釘釘與 Slack
• tools/skill_writer.py、tools/version_manager.py：創建、更新、列出版本

安裝與啓用¶

通過 SkillHub 安裝（推薦）¶

官方頁面要求 Agent 參照 SkillHub 安裝說明 安裝座標 @user_dedbd569/cyber-colleague。

1、檢查是否已有 CLI：

command -v skillhub && skillhub --version

2、未安裝時安裝 CLI（完整包或僅 CLI，按文檔選擇）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

3、安裝技能到當前 Agent 的 skills 目錄（須使用 --dir，否則默認 ./skills/ 可能不被識別）：

skillhub install @user_dedbd569/cyber-colleague --dir <你的 skills 目錄>

常用路徑示例（以 SkillHub 文檔爲準）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下 .agents/skills/

安裝後按所用客戶端要求重載或重啓 Agent，使技能目錄生效。

本地依賴與可選組件¶

若只用手動上傳的 PDF、郵件、Markdown 或粘貼文本，技能包說明指出完成 Python 語法檢查即可起步：

cd <技能安裝目錄>
python -m py_compile tools/*.py

需要自動採集時，再安裝可選依賴：

python -m pip install -r requirements.txt

部分來源可單獨安裝，例如 requests、slack-sdk、playwright，瀏覽器模式還需 playwright install chromium。細節見技能包內 INSTALL.md。

自動採集相關環境變量（節選）¶

憑據建議走環境變量，不寫進配置文件。飛書自動採集示例：

COLLEAGUE_FEISHU_APP_ID
COLLEAGUE_FEISHU_APP_SECRET
COLLEAGUE_FEISHU_USER_ACCESS_TOKEN
COLLEAGUE_FEISHU_REFRESH_TOKEN
COLLEAGUE_FEISHU_P2P_CHAT_ID

釘釘：COLLEAGUE_DINGTALK_APP_KEY、COLLEAGUE_DINGTALK_APP_SECRET。Slack：COLLEAGUE_SLACK_BOT_TOKEN。完整列表與說明見 INSTALL.md。

技能包 README.md 另提供從 GitHub 倉庫 titanwings/colleague-skill 克隆到本地 skills 目錄的方式；與 SkillHub 安裝二選一即可。

典型用法¶

在支持本地 Skill 的 Agent 中加載本技能後，按 SKILL.md 引導操作即可。

1. 觸發場景¶

適合在用戶提出「創建同事 skill / 賽博同事」、要從聊天記錄或文檔提煉某人工作方式、或對已有同事 Skill 追加材料與糾正時使用。

2. 交互主流程¶

1、確認同事姓名或代號、角色簡介，可選人格與溝通標籤。
2、選擇材料來源：自動採集、上傳文件、粘貼文本，或僅基於手填信息生成。
3、若提供飛書鏈接，先區分瀏覽器模式與 MCP 模式。
4、分「工作能力」與「溝通風格」兩線分析，向用戶展示 Work / Persona 摘要及不確定項。
5、確認後寫入 ./colleagues/{slug}/；更新時先備份再增量修改。

3. 命令行管理示例¶

列出已有同事 Skill：

python tools/skill_writer.py --action list --base-dir ./colleagues

創建新同事 Skill：

python tools/skill_writer.py --action create --slug <slug> --name <name> --base-dir ./colleagues

查看版本歷史與回滾：

python tools/version_manager.py --action list --slug <slug> --base-dir ./colleagues
python tools/version_manager.py --action rollback --slug <slug> --version <version> --base-dir ./colleagues

安裝驗收可先查看各工具幫助，例如 python tools/skill_writer.py --help（其餘入口見 INSTALL.md）。

適用場景與注意¶

適合誰： 需要把特定同事的可複用「工作記憶」固化成 Skill、並在人員變動後仍能由 Agent 調用的團隊；材料以飛書、郵件、文檔爲主、且願意走預覽確認流程的用法。

限制與注意：

• 材料不足時技能要求明確標註「不足」，不應腦補；權限不足或依賴缺失也應如實報錯。
• 瀏覽器模式只讀取當前賬號已可訪問的頁面，不提升權限。
• 打包發佈到 SkillHub 時，使用 python tools/package_skillhub.py，且不應把真實聊天、本地 colleagues/ 示例或憑據打進壓縮包（見 SKILLHUB_UPLOAD.md）。
• 社區 Skill 的評分與下載量會變動；抓取時 SkillHub 顯示評分 100000、下載 6443、安裝 317，以頁面實時數據爲準。

結尾¶

「賽博數字人同事製作 Skill」把分散在多端的協作痕跡，收斂成可版本化的同事 Skill 包，並區分工作能力與人格溝通兩條分析線，適合作爲團隊知識沉澱的 Agent 工作流起點。

官方地址：https://www.skillhub.cn/skills/user_dedbd569/cyber-colleague（API：https://api.skillhub.cn/user_dedbd569/cyber-colleague）。