赛博同事 / Cyber Colleague

把同事的聊天、文档、邮件和笔记蒸馏成一个可复用、可迭代的 AI Skill。
Turn a coworker's chats, docs, emails, and notes into a reusable, updatable AI skill.

使用语言 / Language

• 默认跟随用户当前对话语言回复。
  Match the user's language in the current conversation.
• 对外文档和说明尽量采用中英对照。
  Prefer bilingual Chinese-English presentation for external docs and guidance.

适用场景 / When To Use

在这些场景下启用本 skill：
Use this skill in the following situations:

• 用户要“创建一个同事 skill / 赛博同事 / colleague skill”。
  The user wants to create a colleague skill or cyber colleague.
• 用户要从聊天记录、文档、邮件、截图中提炼某位同事的工作方式。
  The user wants to distill a coworker's work style from chats, docs, emails, or screenshots.
• 用户要对已生成的同事 skill 追加材料、纠正结论、重新生成。
  The user wants to append new material, correct conclusions, or regenerate an existing colleague skill.

核心原则 / Core Principles

• 先证据，后结论。
  Evidence first, conclusions second.
• 工作能力和沟通风格分开整理，但最终合并呈现。
  Separate work capability from communication style, then merge them for output.
• 如果材料不足，要明确说“不足”，不要强行脑补。
  If material is insufficient, say so explicitly instead of guessing.
• 更新已有 skill 时，优先增量修改并保留历史版本。
  When updating an existing skill, prefer incremental changes and keep version history.

输入材料 / Accepted Inputs

• 飞书、钉钉、Slack 自动采集结果。
  Auto-collected output from Feishu, DingTalk, or Slack.
• 飞书 JSON 导出、邮件 .eml/.mbox、Markdown、TXT。
  Feishu JSON exports, email .eml/.mbox, Markdown, and TXT.
• PDF、截图、图片、直接粘贴的聊天或文档片段。
  PDFs, screenshots, images, and pasted chat or document excerpts.
• 用户手动填写的角色简介、印象标签、背景信息。
  Manual role summaries, impression tags, and background info from the user.

工具映射 / Tool Map

| 任务 Task | 工具 / 命令 Tool or Command | | --- | --- | | 读取 PDF、图片、文本 | Read | | 写入或更新 skill 文件 | Write / Edit | | 解析飞书 JSON | python tools/feishu_parser.py | | 解析邮件 | python tools/email_parser.py | | 飞书自动采集 | python tools/feishu_auto_collector.py | | 飞书浏览器模式 | python tools/feishu_browser.py | | 飞书 MCP 模式 | python tools/feishu_mcp_client.py | | 钉钉自动采集 | python tools/dingtalk_auto_collector.py | | Slack 自动采集 | python tools/slack_auto_collector.py | | 创建 / 更新 / 列出 skill | python tools/skill_writer.py | | 版本管理 | python tools/version_manager.py |

主流程 / Main Flow

1. 收集基础信息 / Collect Basic Info

至少确认这些信息：
Confirm at least these items:

1. 同事姓名或代号。
   Coworker name or alias.
2. 角色简介。
   Short role summary.
3. 可选标签：人格、沟通风格、团队印象。
   Optional tags: personality, communication style, team impression.

2. 选择材料来源 / Choose Input Sources

优先给用户这些选项：
Offer these options first:

• 自动采集 / Auto-collect
• 上传文件 / Upload files
• 粘贴文本 / Paste text
• 仅基于手填信息生成 / Generate from manual info only

如果用户提供的是飞书链接，先判断走浏览器模式还是 MCP 模式。
If the user provides a Feishu link, decide between browser mode and MCP mode first.

3. 分成两条线分析 / Analyze In Two Tracks

A. 工作能力 / Work Capability

• 负责范围、系统边界、技术栈、评审重点、输出偏好。
  Responsibility scope, system boundaries, stack, review focus, output preferences.

B. 沟通与风格 / Communication And Style

• 表达方式、决策习惯、协作方式、常见语气。
  Expression style, decision habits, collaboration style, common tone.

4. 先预览再落盘 / Preview Before Writing

先给用户看摘要，再决定是否写入文件：
Show the user a summary before writing files:

• Work 摘要 / Work summary
• Persona 摘要 / Persona summary
• 需要保留的不确定项 / Uncertainties that should remain explicit

5. 写入 Skill / Write The Skill

默认写入到 ./colleagues/{slug}/，包含：
Write to ./colleagues/{slug}/ by default, including:

• meta.json
• work.md
• persona.md
• SKILL.md

如果是更新已有 skill，先备份旧版本，再做增量改写。
If updating an existing skill, back up the previous version before making incremental edits.

输出结构 / Output Structure

• work.md：工作方法、评审习惯、技术判断。
  work.md: work methods, review habits, technical judgment.
• persona.md：表达风格、沟通方式、行为偏好。
  persona.md: communication style, tone, behavior preferences.
• meta.json：基础档案、来源、版本信息。
  meta.json: profile, sources, and version info.
• SKILL.md：给运行时使用的完整合成版本。
  SKILL.md: the merged runtime-facing skill document.

管理命令 / Management Commands

列出已有同事 skill：
List existing colleague skills:

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

创建新同事 skill：
Create a new colleague skill:

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

更新已有同事 skill：
Update an existing colleague skill:

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

查看版本历史：
Inspect version history:

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

回滚到旧版本：
Rollback to a previous version:

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

安全要求 / Safety Requirements

• 默认使用环境变量传入第三方凭据。
  Use environment variables for third-party credentials by default.
• 不把真实聊天、文档或凭据打进发布包。
  Do not package real chats, docs, or credentials into release archives.
• 浏览器模式只读取当前账号本来就能访问的内容。
  Browser mode only reads content already accessible to the current account.
• 对证据不足、权限不足、依赖缺失要明确报出，不要伪装成成功。
  Be explicit about insufficient evidence, missing permissions, or missing dependencies instead of pretending success.

成功标准 / Success Criteria

• 用户能基于最少输入创建一个结构完整的同事 skill。
  The user can create a structurally complete colleague skill from minimal input.
• 新材料能增量并入已有 skill，并保留历史版本。
  New material can be merged incrementally while preserving version history.
• 文档和对外说明保持中英文对照。
  Docs and outward-facing guidance stay bilingual.