Codex · Claude Code · Cursor
Teamwork 面向人和 agent 长期协作的科研与工程项目：让你用更少的注意力做出正确决定， 让实验结果和结论不白跑、不被误用，并把项目中的知识、判断和决定留在可继续使用的位置。 它包含一个用于方向讨论与复杂计划的 Skill、一份常驻工作约定，以及轻量项目上下文。
Codex 和 Claude Code 已经能够访谈、规划、执行和记忆。Teamwork 把你反复强调的 取舍方式与工程偏好组织成可复用的内容，减少重新解释和纠偏。 当前默认约定面向作者的跨项目工作；其中的研究与协作偏好是个人选择，安装前可阅读 常驻策略，判断是否适合自己的项目。
本仓库接替已废弃的 JinPLu/Teamwork。 旧版把研究、调试、计划、执行、复查拆成八个 Skill 和一组可选 Agent 角色，替宿主 搭出流程脚手架。Astra、Fable 5.1 这一代模型已经把这层脚手架吸收成原生能力， 再维护一套只会与宿主重复并互相冲突。因此本仓库不是旧版的续版，而是一次全面重构： 只保留一个
teamwork-collaborate、一份常驻策略和轻量项目上下文，流程、角色分工与 执行编排交回宿主。装过旧版的，从本仓库 checkout 运行下面的安装命令即可；确认属于 Teamwork 的旧 Skill 与 Agent 角色会被一并移除，你自己的内容不动。
清晰任务，例如“把这个按钮文字改成导出”，直接交给宿主执行。需要一起定方向、
权衡取舍或形成复杂计划时，可点名 teamwork-collaborate：
这两个编码器先比哪个？先看已有读数，给我建议。
- 决策卡：每个主题顶部是一张约一屏的卡：目标、当前问题、各选项及会选中它的证据、 推荐、需要你定什么，以及已定选择的原话和理由。读完这一屏就能做决定；决定后卡片 原地改写，不在旧卡上叠日期摘要。长会话压缩上下文后，agent 也从这张卡接上。
- 先写判据再跑：选择取决于实验结果时，先在卡上写明哪种结果选哪个选项，再跑 最便宜的判别检查；结果出来直接落到对应分支，而不是事后找解释。
- 读数负责数字：决策、汇报和论文表用到的每个结果只写在一份读数里，带对象、版本、 数据、配置和运行来源，计划和汇报链接它。读数更正时，用到它的卡片、计划和汇报随之 更新；没有对应读数的结论标为缺口，不拿别的对象的结果顶替。
- 讨论不翻盘：你提出反对时，agent 先说清被挑战的是哪个前提，只改依赖它的部分； 提新方案前先对照已定边界和项目已有的做法。
- 决策推进：按实际问题比较证据、成本与可区分解释的检查；具体执行、工具与验证使用宿主原生机制。
Teamwork 不规定研究方法，只让结果、结论和决定在协作中保持可用。已有的笔记库和项目 入口继续负责保存知识。这些是方法的预期收益，有限情境的检查不能证明所有长期项目都已 解决漂移问题。
- 常驻策略：安装进宿主全局指令文件，只保留个人研究表达、证据标准与项目连续性偏好。压缩上下文后它仍在；成本由所有任务承担， 因此保持精简。
- 按需 Skill：方向讨论或复杂计划时加载，负责讨论动作：从卡片接续、处理反对、 让选择可判定、证据对上对象、从已选分支形成计划。清晰执行任务继续使用宿主原生能力； 并行、工具调用和执行权限也由宿主负责。
- 项目说明：通过项目指令文件声明本项目的上下文入口，并保留项目自己的约束。 详细记录在需要时读取。
工作约定的权威来源是 policy/teamwork-global.md。 Teamwork 不安装 agents、hooks、调度系统或文档数据库。
git clone https://github.com/JinPLu/teamwork-simplify.git
cd teamwork-simplify
./install.sh codex
# 或 ./install.sh claudeCodex 安装会写入用户 Skill 目录和全局 AGENTS.md 的 Teamwork 托管块；
Claude 安装会写入对应 Skill 目录和全局 CLAUDE.md 托管块。
刷新时从所需 checkout 再运行相同命令。默认复制；本地开发可选 --link。
安装器保护托管区域之外的用户内容，旧版本角色只在内容确认归属于 Teamwork 时清理。
Cursor 使用 ./install.sh cursor 安装 Skill，再运行 ./install.sh cursor-policy
取得策略文本，在 Settings → Rules → User Rules 中更新对应块。安装器不能读取该设置。
./install.sh --project-root /absolute/project/path init-project
./install.sh doctor --project /absolute/project/path初始化只维护 AGENTS.md 的项目说明块和 CLAUDE.md 的共享指令桥接，不创建文档目录或空索引。
首次需要保存持久结果时，遵循项目已有的知识归属和入口；未指定时使用 docs/teamwork/README.md。
已有入口内容保持不动；旧托管桥接中的索引自动导入会被移除。用户自行添加的索引导入
保持不动并给出说明。不预建分类目录，也不迁移旧记录。
doctor 只读检查安装内容、托管块、入口与本地文档链接，不审查文档写作格式。
不带 --project 时会发现本机 Teamwork 项目；--json 输出结构化报告。
未启用的宿主无需补装；Cursor 策略的实际生效情况需要在 Cursor 中查看。
项目记录保存在目录里，并不代表它们已经随 Git 分享。本仓库的对话记录与本机索引 不纳入版本管理；公开说明使用上面的自包含示例，不发布历史对话。