组织.skill / organization-skill

organization-skill 是 colleague-skill 的组织级扩展原型。
organization-skill is an organizational extension prototype built on top of colleague-skill.

原始的 colleague-skill 解决的是“如何把一个员工蒸馏成可调用的 AI Skill”；这个项目继续往上扩展到岗位、部门、公司和企业级路由。
The original colleague-skill focuses on turning an employee into a callable AI Skill; this project extends that idea upward to roles, departments, companies, and enterprise routing.

项目目标 / Goal

把组织里的隐性知识、流程、边界、规则和协作方式，沉淀成一组可组合、可路由、可版本化的 Skill。
The goal is to distill organizational knowledge, workflows, boundaries, rules, and collaboration patterns into a set of composable, routable, and versioned Skills.

这不是一个“大一统大脑”，而是一套分层模型：
This is not a single all-knowing brain. It is a layered model:

• company skill：解释统一 operating model
  company skill: explains the shared operating model
• department skill：解释团队边界和流程
  department skill: explains team boundaries and workflows
• role skill：解释岗位职责与执行方式
  role skill: explains role responsibilities and execution patterns
• enterprise router：负责导航、定位与分流
  enterprise router: handles navigation, classification, and routing

当前能力 / Current Capabilities

当前仓库已经包含以下能力：
The repository already contains the following capabilities:

1. 同事 Skill 基础 / Colleague Skill Foundation

• 上游 create-colleague
  Upstream create-colleague
• 多源材料输入：飞书、钉钉、邮件、导出文件、手动文本
  Multi-source inputs: Feishu, DingTalk, email, exports, and manual text

说明：当前仓库将 .claude/skills/create-colleague/ 作为上游子模块引用。
Note: .claude/skills/create-colleague/ is currently referenced as an upstream submodule.

2. 组织 Skill 创建器 / Organization Skill Builder

路径：.claude/skills/create-organization/
Path: .claude/skills/create-organization/

当前支持：
Currently supports:

• role
• department
• company

统一产出：
Unified outputs:

• overview.md
• playbook.md
• interfaces.md
• SKILL.md
• meta.json
• versions/
• knowledge/

3. 企业 Router 创建器 / Enterprise Router Builder

路径：.claude/skills/create-enterprise-router/
Path: .claude/skills/create-enterprise-router/

当前支持 company / department / role 的分层路由和企业级入口说明。
Supports layered routing across company / department / role and provides an enterprise entry layer.

4. 材料接入层 / Material Ingestion Layer

路径：.claude/skills/create-organization/tools/org_material_manager.py
Path: .claude/skills/create-organization/tools/org_material_manager.py

当前支持：
Currently supports:

• 统一归档材料到 knowledge/
  Unified material archiving into knowledge/
• 复用 create-colleague 的 parser / collector
  Reuse of create-colleague parsers and collectors
• 登记材料索引与来源
  Material indexing and source tracking

5. 冷启动资料池 / Seed Material Pool

路径：seed_materials/
Path: seed_materials/

用途：公开资料、访谈提纲、原始笔记、结构化摘要。
Purpose: public sources, interview guides, raw notes, and structured summaries.

6. 演示样本链 / Demo Sample Chains

当前内置两条公开样本链：
The repository currently includes two public sample chains:

• 完整链 / Complete chain:
  • gitlab_company_public
  • gitlab_infrastructure_platforms_public
  • gitlab_backend_engineer_public
  • gitlab_enterprise_router_public
• 骨架链 / Partial skeleton:
  • 37signals_company_public
  • 37signals_programmer_public
  • 37signals_enterprise_router_public

说明：37signals 样本链当前故意缺少完整 department 层，用来展示 router 在材料不足时如何保持边界感。
Note: the 37signals sample intentionally lacks a full department layer so the router can demonstrate boundary-aware behavior when material is incomplete.

7. 演示包 / Demo Pack

路径：demo_pack/gitlab_public_sample/ 与 demo_pack/37signals_public_sample/
Path: demo_pack/gitlab_public_sample/ and demo_pack/37signals_public_sample/

用途：快速理解这套链路、直接复制问题做演示、用评分卡做评估。
Purpose: quickly understand the chain, run copy-paste demos, and evaluate results with a scorecard.

分层模型 / Layered Model

当前方法论采用五层对象模型：
The current methodology uses a five-layer object model:

1. employee skill：一个人的 tacit knowledge、工作方法、表达风格
   employee skill: one person's tacit knowledge, working style, and communication style
2. role skill：一个岗位应该如何工作、如何交付、如何协作
   role skill: how a role should work, deliver, and collaborate
3. department skill：一个部门负责什么、如何运作、如何对接
   department skill: what a department owns, how it operates, and how others interact with it
4. company skill：公司的共识、制度、治理、术语和经营方式
   company skill: company-wide principles, governance, terminology, and operating model
5. enterprise router：统一入口，把请求路由到正确层级
   enterprise router: unified entry point that routes requests to the correct layer

更多细节见：
For more detail, see:

• docs/organization_skill_prd.md
• docs/organization_skill_matrix.md
• docs/organization_data_ingestion.md
• docs/enterprise_router_prd.md

如何使用 / How To Use

A. 看整体设计 / Read the Design

推荐顺序：
Recommended order:

1. docs/organization_skill_prd.md
2. docs/organization_skill_matrix.md
3. docs/organization_data_ingestion.md
4. docs/enterprise_router_prd.md

B. 看公开样本链 / Explore the Public Sample Chain

进入：demo_pack/gitlab_public_sample/
Open: demo_pack/gitlab_public_sample/

推荐顺序：
Recommended order:

1. skills_index.md
2. walkthrough.md
3. demo_questions.md
4. demo_scorecard.md

C. 创建自己的组织 Skill / Create Your Own Organization Skill

在 Claude Code 中使用：
Use in Claude Code:

/create-organization
/create-enterprise-router

D. 管理材料 / Manage Materials

通过 .claude/skills/create-organization/tools/org_material_manager.py
Use .claude/skills/create-organization/tools/org_material_manager.py

把文件、飞书导出、邮件等接入到组织对象的 knowledge/ 目录。
to ingest files, Feishu exports, emails, and related material into an organization's knowledge/ directory.

目录概览 / Repository Layout

.
├── .claude/
│   └── skills/
│       ├── create-colleague/
│       ├── create-organization/
│       └── create-enterprise-router/
├── demo_pack/
├── docs/
├── examples/
├── internal/
├── seed_materials/
├── README.md
├── README_EN.md
├── FAQ.md
├── CONTRIBUTING.md
└── ROADMAP.md

说明：internal/ 用于存放本地过程记录和非公开的一次性工作文件。
Note: internal/ is used for local process notes and non-public-facing working files.

从哪里开始 / Where To Start

如果你是第一次看这个项目，建议这样：
If this is your first time here, start in this order:

1. README.md
2. README_EN.md
3. FAQ.md
4. examples/gitlab_public_sample.md
5. demo_pack/gitlab_public_sample/README.md

当前状态 / Current Status

这是一个：
This project is currently:

• 可运行的组织蒸馏原型
  a runnable organizational distillation prototype
• 同事.skill 的组织级扩展
  an organizational extension of colleague-skill
• 可开源打磨的项目雏形
  an open-source-ready project shell

它还不是一个完全产品化、完全自动化的平台。
It is not yet a fully productized or fully automated platform.

发布文件 / Release Files

根目录当前已补齐最基础的开源发布文件：
The repository root now includes the minimum open-source release files:

• LICENSE
• FAQ.md
• CONTRIBUTING.md
• ROADMAP.md
• examples/
• README_EN.md

下一步 / Next Steps

见：
See:

• ROADMAP.md
• CONTRIBUTING.md