danyuchn/claude-work-mode
开发工具为 Claude Code 提供会话工作模式切换的插件,可控制自主执行、任务委派和收尾决策。
项目用途
claude-work-mode 是一个 Claude Code 插件,通过斜杠命令切换模型在一个会话中的行为方式。auto 模式让模型不再为内部、可逆的步骤(本地文件、本地提交、测试)停下来询问;发送消息、安装、密钥、不可恢复的删除、付款、权限变更、生产变更等硬性停止点会汇总成一个待办列表,在最后统一报告。out 模式把检查者或抽查即可验证的批量工作(提取、分类、摘要、审查)交给后台子代理或外部 CLI,主线程负责验证;当主线程一轮读入大量原始输出却没有委派时,会触发一次提醒。wrap 模式用于收束:不开新分支,完成手头工作,只列出新增或改变的决策,每条带标签和建议。off 恢复正常。
模式按会话生效,可以组合(如 /work-mode auto wrap);同时指定 out 和 wrap 时 wrap 优先。直接输入 /work-mode 会打开多选选择器。根据 README 的说明,模式文本只在下一个工具结果或提示时传给模型一次,压缩或恢复后才会再次传入,因此不会每轮都增加负担。
安装与首次使用
前提:Claude Code 2.1.314 或更高版本,并支持 function-hook 插件。在 Claude Code 中执行:
/plugin install work-mode --marketplace danyuchn/claude-work-mode
回答 y 添加 marketplace,然后选择作用范围。可选的 gates 是另一个插件:
/plugin install work-mode-gates --marketplace danyuchn/claude-work-mode
gates 需要 bash、jq、git 和 python3。一段 60 秒演示视频 展示了三种模式下的行为变化。安装后输入 /work-mode 选择模式,或直接传参,例如 /work-mode auto wrap。
可选 gates
模式会写入 ~/.claude/state/tempo/<session_id>,供 shell 钩子读取。gates 插件自带三个钩子:scratch-doc-guard.sh 在 auto 下阻止新建 SUMMARY*/REPORT*/NOTES*/FINDINGS*/ANALYSIS*.md;git-safe-commit-gate.sh 处理带路径的 git commit 以及文件已有未暂存改动时的 git add;decision-label-guard.py 阻止回复中的决策部分出现无标签条目,或未说明双方得失的权衡条目。在 auto 下,本应询问的 gate 改为拒绝,并给出理由告诉模型该怎么做。hooks/lib/tempo-auto.sh 提供 tempo_auto_on "$INPUT" 和 tempo_deny "<reason>",可用于编写自己的 gate;密钥、强制推送、部署等真正的硬性停止点应在所有模式下都保持询问。
配置
无需任何配置。语言依次根据 WORK_MODE_LOCALE、Claude Code 的 language 设置(提到中文时选择繁体中文)、LC_ALL/LANG 决定,否则为英文。要个性化,可创建 ~/.config/work-mode/config.json,或用 WORK_MODE_CONFIG 指向一个文件;仓库提供了 完整的配置示例。字段涵盖称呼与代词、auto 的额外规则、out 的委派指令与命令正则、提醒阈值与模板、wrap 的决策标题与标签,以及可选的配额表,用于在多个外部模型池之间路由。
使用约束
这是 Claude Code 插件,需要 Claude Code 2.1.314 及以上版本,不能用于其他编程代理。gates 插件额外依赖 bash、jq、git 和 python3,基础模式不需要这些。模式状态写入 ~/.claude/state/tempo/,可选配置从 ~/.config/work-mode/ 或 WORK_MODE_CONFIG 指定的路径读取。项目采用 MIT 许可证。开发检查通过 ./check.sh 运行,需要 tsc 和 Claude Code 的 API 类型。
HotRepo 点评
该项目进入 HotRepo 新项目记录的时间是 2026-11-08,在约九小时的统计窗口内获得 103 个 Star。对于一个聚焦的小型插件来说,这样的开局不错。由于目前只有这一条快照记录,还看不出多日趋势。项目的关注度与 Claude Code 的插件和钩子生态直接相关:把模式文本持久化到文件、让 shell 钩子可以读取,以及在 auto 下把确认提示转换为拒绝并附上理由,这些设计让 gates 具有实际作用,而不只是装饰。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。