Skillget

Teamwork

agent
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Evidence-first skills for Codex, Cursor, and Claude Code: research, debugging, planning, execution, review, and goal loops.

README.md

Teamwork

English · 更新日志 · 参与贡献 · MIT License

让 Codex、Cursor 和 Claude Code 在复杂科研/工程任务中先找证据、再行动，并用可检查的结果收尾。

Teamwork 是一个 Codex-first 的 Codex + Cursor + Claude Code skill package。它不替代 shell、MCP、浏览器、权限或测试工具，而是在这些原生能力之上补上任务路由、证据约束、可控分工、跨回合记忆和验收闭环。

Teamwork 工作流

它解决什么

常见问题 Teamwork 的处理方式
调研停在一个来源 从 seed source 扩展到 primary source、相邻证据和必要的反例
研究、实现、复盘混成一条长聊天 按风险路由到 research、debug、plan、execute、review 或 goal
多个 subagents 各说各话 只拆独立任务，主 agent 负责范围、集成和最终验证
缺路径、端口、模型或配置时随手兜底 必需值只能来自用户、项目、源码、配置、测试或已接受计划
“已完成”没有证据 用来源、日志、测试、diff、artifact 或 fresh review 支撑结论

小问题仍走平台原生 fast path；Teamwork 只在额外流程能提高正确性、连续性或可验收性时介入。

快速开始

准备条件：已安装并能正常使用 Codex、Cursor 或 Claude Code 中的至少一个；本仓库的安装入口使用 Bash。

以 Codex 为例：

git clone https://github.com/JinPLu/Teamwork.git
cd Teamwork
./install.sh codex
./scripts/check-update.sh --no-fetch

安装后直接用自然语言描述目标，不需要记 workflow 名称：

先调研这个领域、关键论文和现有代码，再给我一个可执行方案。
定位这个 CI 失败的根因，先用日志和复现证据确认，再修复。
按已接受的计划执行并验证；失败要记录原因，直到通过或遇到真实 blocker。
严格 review 这次产出，重点检查假成功、防御性 fallback 和 AI 冗余。

选择安装方式

平台 命令 安装结果
Codex ./install.sh codex ~/.codex/skills/、~/.codex/agents/，以及 ~/.codex/AGENTS.md 中的 Teamwork 标记块
Cursor ./install.sh cursor ~/.cursor/skills/、~/.cursor/agents/；按终端提示复制 User Rules
Claude Code ./install.sh claude ~/.claude/skills/、~/.claude/agents/，以及 ~/.claude/CLAUDE.md 中的 Teamwork 标记块
三个平台 ./install.sh all 安装以上全部用户级入口

默认使用 --copy 和 performance-first profile。高级 profile、单独安装 agents/policy 等选项以帮助输出为准：

./install.sh --help
./install.sh --profile cost-first codex

项目级安装与完整初始化：

./install.sh --project-root /path/to/project project
./install.sh --project-root /path/to/project init-project

project 安装项目级 skills/agents；init-project 还会配置项目规则、docs/teamwork/ 记忆入口和可用的 CodeGraph。维护本仓库时可使用 ./install.sh --link codex，让已安装内容跟随 checkout 更新。

安装器只管理 Teamwork 专属目录、agent 文件和带边界标记的全局 policy 块；平台自己的权限、MCP、浏览器和测试配置仍由平台及用户控制。平台细节见 Codex、Cursor 和 Claude Code 文档。

什么时候使用

适合：

  • 论文/领域调研、API 或库选型、竞品与历史决策查证；
  • 需要证据链的方案比较、实验设计和工程实现；
  • 可复现故障、flaky 测试、CI、崩溃或 UI 症状诊断；
  • 值得分成独立轨道的 subagent 调研、实现或复查；
  • 跨回合推进，或持续迭代直到测试通过、目标达成或确认 blocker。

不必使用：一句话事实、明显的小编辑、局部语法问题，或分工成本高于收益的强耦合任务。敏感、破坏性、付费或公开操作仍遵守平台权限和用户确认。

工作方式

using-teamwork 是轻量路由入口，按当前任务需要加载专用 skill：

Skill 负责什么
teamwork-research 查证来源、外部约束、方案空间和 repro surface
teamwork-debug 用复现、日志、假设和 instrumentation 确认根因
teamwork-plan 明确范围、边界、步骤、验收和停止条件
teamwork-execute 在已接受范围内实现并验证
teamwork-review 检查 diff、证据、质量和完成声明
teamwork-goal 对明确目标持续迭代，直到完成或真正受阻

teamwork-init 负责项目接入与规则瘦身，teamwork-update 负责安装刷新和 release hygiene。只有跨回合复用确有价值时，才写入固定位置：

docs/teamwork/research/YYYY-MM-DD-<slug>.md
docs/teamwork/plans/YYYY-MM-DD-<slug>.md
docs/teamwork/reports/YYYY-MM-DD-<slug>.md

更新与验证

更新 checkout 后，重新执行原安装目标，再检查安装面是否一致：

git pull --ff-only
./install.sh codex
./scripts/check-update.sh --no-fetch

如需同时检查某个项目的本地安装：

./scripts/check-update.sh --project /path/to/project

包版本以 VERSION 为准，并与 plugin manifests 保持一致。仓库开发和发版前运行：

./scripts/validate.sh
python3 scripts/eval-teamwork.py --split dev
python3 scripts/run-teamwork-live-eval.py --help

文档导航

  • CODEX.md：Codex 安装、项目设置、subagents、Goal Mode 与模型 profile。
  • CURSOR.md：Cursor 安装、User Rules、Task subagents 与 goal 记录。
  • CLAUDE.md：Claude Code 安装、Task subagents 与 goal 记录。
  • CHANGELOG.md：面向用户的版本变化。
  • CONTRIBUTING.md：问题反馈、修改范围和验证要求。
  • skills/*/SKILL.md：各 workflow skill 的行为定义。

问题与建议请提交到 GitHub Issues。

Reviews (0)

No results found