前言¶
团队里常有人离职、轮岗或分身乏术,但他们的评审习惯、沟通语气、处理某类需求的路径,往往散落在飞书线程、邮件和 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/ 说明。
材料输入¶
支持多类来源,可按场景组合:
| 来源 | 典型能力 |
|---|---|
| 飞书自动采集 / 浏览器 / MCP | 消息、文档、表格(自动采集需凭据或浏览器会话) |
| 钉钉自动采集 | 文档、表格;历史消息部分依赖浏览器自动化 |
| Slack 自动采集 | 频道消息(需 Bot 加入频道) |
| 手动上传 | 飞书 JSON 导出、.eml / .mbox、PDF、截图、Markdown、TXT、粘贴文本 |
| 手填信息 | 角色简介、人格与沟通标签等 |
分析与输出¶
主流程强调「先证据后结论」:工作能力(范围、技术栈、评审重点、输出偏好)与沟通风格(表达、决策、协作、语气)分线分析,预览摘要后再落盘。
默认输出目录为 ./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:钉钉与 Slacktools/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)。