team-skills-platform

面向团队协作与平台治理的开源 Team Skills Platform，用于把单代理执行模式升级成“Tech Lead 编排 + 专业角色协作”的虚拟研发团队工作模型，并叠加 ECC 风格的 harness layer、specialist 命令与运行时增强能力。当前平台同时支持 team mode 与 solo mode，前者强调多人交接，后者强调单人闭环但保留同样的关键门禁。

English: Team Skills Platform (TSP) is an open-source framework for role-based AI delivery workflows. It packages role prompts, shared skills, commands, rules, hooks, examples, and install tooling for Claude Code, Codex, and OpenCode. Custom extensions can be layered on top via the overlay mechanism; the public repository ships only public capabilities.

Quick Start / 最小安装

适合第一次体验公开能力的最短路径：

node scripts/build-platform-artifacts.js
node scripts/install-apply.js --profile team --target claude
node scripts/install-apply.js --profile full --target codex
node scripts/install-apply.js --profile full --target opencode

Who It's For / 适合谁

• 想把 AI 编码从“单代理乱跑”升级成“角色分工 + 明确 handoff + 明确 gate”的团队
• 需要一套可安装、可验证、可迁移的 prompts、skills、commands、rules 与 hooks 底座
• 想在公开能力之上，叠加自定义 overlay 扩展的团队

Community / 社区协作

• 贡献方式：见 CONTRIBUTING.md
• 行为准则：见 CODE_OF_CONDUCT.md
• 安全报告：见 SECURITY.md
• 支持边界：见 SUPPORT.md

平台目标

• 用角色边界替代单线流程技能，统一产品、架构、研发、测试、运维的协作方式。
• 在仓库内维护平台无关的 canonical 定义，并自动生成 Codex / Claude 需要的角色技能、agent prompt、命令面和插件清单。
• 提供可安装、可校验、可迁移的团队能力底座，而不是一次性的项目脚手架。
• 内置 React/Next 优先的前端工程规范与 UI/UX 治理能力，用统一规则承接页面、交互和体验质量。
• 内置 ECC 风格的 specialist agents、快捷 commands、rules packs、runtime hooks、contexts 与 examples，提升整体可用性。
• npm 安装包内置 crates/oris-claude-bridge 与多平台预构建二进制，安装时按用户操作系统自动选择 bridge，无需本机 Rust 工具链。
• 持续净化原则：每次大版本升级，目标是尽可能移除当前版本引入的所有补丁程序与临时绕行方案——补丁是现实妥协，不是长期设计；每一轮演进都应让平台比上一版更干净。

框架说明

平台架构

TSP 采用 角色 + 技能 + Agent + 规则 + Hooks + Workflow 引擎 六层架构：

层	目录	职责
角色定义	roles/	8 个专业角色的 canonical YAML 定义（tech-lead 编排）
技能层	skills/	195+ 平铺技能，覆盖调试、编排、学习、前端、后端、安全等
Agent 层	agents/specialists/	27 个 specialist agents（规划、review、build-fix、语言专项）
规则层	rules/	common 规则 + 13 语言规则包（TS/Python/Go/Java/Kotlin/Rust/Swift/C++/C#/PHP/Perl + 中文）
Hooks 层	hooks/ + scripts/hooks/	37 个运行时 hook（prompt guard、context monitor、memory persistence 等）
命令面	commands/	80+ 命令（团队主链 8 个 + specialist + 工具链）
Workflow 引擎	workflows/ + scripts/workflow-*.js	YAML DAG 工作流，支持依赖解析、状态持久化、失败恢复

安装工具链公开主线支持 3 个 code agent：Claude Code、Codex、OpenCode。其他历史 target 保留为隐藏兼容路径，不再作为公开 onboarding 主线。

OpenCode 集成

TSP 为 OpenCode 提供了完整的适配支持，包括：

• AGENTS.md 自动生成：包含完整的规则索引、角色索引、命令索引和技能索引
• Agent 系统适配：所有角色和 specialist agents 都添加了 YAML front matter 配置
• Hooks 系统适配：将 TSP hooks 转换为 OpenCode 插件格式
• 配置文件生成：自动生成 opencode.json 配置文件
• Skills 系统兼容：所有 SKILL.md 文件都兼容 OpenCode 的 skill 工具

OpenCode 安装

# 安装完整 OpenCode 配置
node scripts/install-apply.js --profile full --target opencode

# 或使用 npm 脚本
npm run install:opencode

OpenCode 配置

安装完成后，OpenCode 配置文件位于 ~/.config/opencode/opencode.json，包含：

{
  "$schema": "https://opencode.ai/config.json",
  "instructions": ["./AGENTS.md"],
  "plugin": ["team-skills-platform"],
  "permission": {
    "edit": "allow",
    "bash": "allow"
  }
}

OpenCode 使用

1. 启动 OpenCode：在项目目录运行 opencode
2. 查看可用角色：AGENTS.md 中包含所有角色的索引
3. 切换角色：使用 @tech-lead、@frontend-engineer 等方式切换角色
4. 执行命令：使用 /team-intake、/team-plan 等团队命令
5. 加载技能：使用 skill 工具加载 SKILL.md 文件

OpenCode 目录结构

~/.config/opencode/
├── AGENTS.md                    # 主配置文件（自动生成）
├── opencode.json                # OpenCode 配置文件
├── agents/                      # Agent 定义文件
│   ├── tech-lead.md
│   ├── product-manager.md
│   └── ...
├── command/                     # 命令文件
│   ├── team-intake.md
│   ├── team-plan.md
│   └── ...
└── plugins/                     # 插件目录
    ├── team-skills-platform/    # TSP 插件
    │   ├── skills/              # 技能文件
    │   ├── rules/               # 规则文件
    │   └── ...
    └── tsp-hooks.js             # Hooks 插件

发布为 npm 包 @colin4k1024/tsp，内置 Rust bridge 预构建二进制，安装零依赖。

集成的开源框架与方法论

TSP 整合了多个社区开源框架的精华能力，而非从零构建：