用chief-of-staff统筹子代理,推进长期目标
機械翻訳 / Machine-translated
原文链接:用chief-of-staff统筹子代理,推进长期目标(cccskills)
技能页面:chief-of-staff
本文结论
安装 chief-of-staff 后,Claude Code 或 Codex 的代理将成为长期目标的主持人。
作业分配给子代理执行,主持人本身则持续与用户保持对话。
本文将介绍如何通过 Wiki 留存记录,以及改善作业环境的思路。
后半部分还会介绍安装步骤和请求示例。
调用 chief-of-staff 后,代理将以目标负责人的身份运作。
它不亲自动手,而是作为主持人将作业交给子代理完成。
请求示例如下:
/chief-of-staff 我想分多次把公司内部管理界面迁移到 Next.js,请担任主持人推进这个目标。
首先会讨论 Wiki 的存放位置。
Wiki 是一个由相互链接的 Markdown 页面组成的文件夹,作为会话结束后依然留存的记忆使用。
如果目标尚无对应的 Wiki,则会在首次写入前与用户确认存放位置。
确定位置后,实际作业将分配给后台子代理执行。
与主持人的对话不会中断,因此在迁移过程中随时可以调整优先级或咨询疑问。
给子代理的指令会保持简洁,通过提示调研笔记、过去的提交记录或 Wiki 页面的位置来传递信息。
该技能的特点在于,在开始作业之前,代理必定会先考虑如何改善自身的工作环境。
在推进迁移作业的同时,还会给出添加防错 Lint 规则或使开发服务器日志可读的建议。
chief-of-staff 是一个技能,它将持续追踪长期目标的一套方法论整体赋予代理。
内容分为以下五个方面。
主持人并行维护两个视角。
一是"如何处理眼前课题"的战术视角。
二是"如何改变环境以让下一个课题顺利推进"的战略视角。
所有作业均由子代理完成,主持人保留自身的上下文窗口(一次能记住的对话量)。
由于使用后台运行的代理,与用户的对话不会停止。
为避免重复说明,已有资料只需提示位置即可共享。
只存在于对话中的知识,在对话被压缩后就会丢失。
因此,主持人会将决策、反复出现的问题以及用户偏好等内容,以一页一个主题的形式写入 Wiki。
index.md 中存放所有页面的列表及每页的一行摘要。
Issue、拉取请求、子代理报告等原始资料不会被转录,而是以引用来源的方式呈现。
维护 Wiki 有效性的操作有以下三种:
| 操作 | 时机 | 内容 |
|---|---|---|
| Ingest | 发现长期有用的信息时 | 更新相关所有页面及 index.md |
| Query | 做决策之前 | 阅读 index.md 及引用页面,将值得留存的答案写成页面 |
| Lint | 定期 | 查找矛盾、孤立页面、断链及过时内容 |
Wiki 的书写原则是记录"历史"而非"当前状态"。
记述中需附上日期,例如"2026-10-13 决定了〇〇"。
涉及代码的记述,需附上该内容有效时的提交记录及仓库名称。
即使情况发生变化,也不修改旧记述,而是添加新日期的记述,并在旧记述上标注已被替代。
主持人着力于构建代理能够轻松、正确地完成作业的环境。
每次收到用户消息时,寻找可改进之处也是其职责之一。
改进对象包括:
同时还须遵守"不创建变通方案"的原则。
不允许临时性的 hack,规范偏差原则上须在功能开发之前修正。
如果运行环境支持,将提议有助于达成目标的定期计划。
Wiki 的 Lint 也是定期执行候选操作之一。
在终端执行以下命令。
安装目标代理(Claude Code 或 Codex 等)可在执行时选择。
npx skills add https://github.com/mattpocock/skills --skill chief-of-staff
如需让代理代为安装,可直接发送以下内容。
可以委托从确认内容到完成配置的全过程。
次の Agent Skill をインストールしてください。
https://github.com/mattpocock/skills/tree/main/skills/in-progress/chief-of-staff
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/chief-of-staff/、Codex なら ~/.agents/skills/chief-of-staff/ に配置してください。
存放位置请根据是否在所有项目中使用,或仅在特定项目中使用来选择。
| 代理 | 所有项目 | 仅特定项目 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 项目的 .claude/skills/ |
| Codex | ~/.agents/skills/ | 项目的 .agents/skills/ |
该技能设定为不由代理自行判断调用。
使用时,Claude Code 请通过指定名称(如 /chief-of-staff)的方式调用。
在请求中附上长期目标和当前情况,对话会更顺畅地推进。
以下是三个典型示例:
/chief-of-staff 我想完善公司服务的测试,减少发布前的手动确认。请整理并推进这个目标的分工。
如果尚无 Wiki,将从商讨存放位置开始。
之后,调研和测试编写将分配给子代理,主持人负责汇报进展和商讨下一步决策。
在推进作业的同时,也请考虑有助于简化后续工作的规范和环境改进。
将在正在进行的作业之外,额外提供改进建议。
包括添加用于检测错误的 Lint 规则、完善 CODING_STANDARDS.md,以及使日志和测试环境数据库可读的方案等。
这个目标有需要持续执行的定期任务吗?
如果运行环境支持,将提议 Wiki Lint 等定期计划。
不支持的环境中不会出现该提议。
使用前,请确认运行环境和权限处理方式。
同一 mattpocock/skills 仓库中,还有适合在长期作业前后搭配使用的技能。
claude-handoff 是将进行中的对话整理成交接摘要,并传递给新后台代理的技能。
在对话变长时,可整理作业方针和参考资料,将后续任务委托出去。
code-review 是以指定提交或分支为基准确认变更的技能。
将对开发规范的符合性与规格实现分开报告,适合用于确认是否遵守了由 chief-of-staff 整理的规范。
ask-matt 是一个顾问角色,会根据情况推荐相关技能及使用顺序。
不知道下一步该用哪个技能时,可以向它咨询。
不会自动运行。
由于设定为不由代理自行判断调用,需要指定名称来调用。
重要的经过会留存在 Wiki 中。
只存在于对话中的知识会因压缩而丢失,因此会将决策与发现附上日期写入 Wiki,以便传递到下一次会话。
该技能的范围是在运行环境支持的情况下提出定期计划建议。
是否实际配置,请在查看建议后由用户自行决定。
chief-of-staff 是一个将长期目标的主持人职责交给代理的技能。
作业分配给子代理执行,用户可以在持续与主持人对话的同时专注于决策。
来龙去脉会附上日期记录在 Wiki 中,每次请求时还会提供规范和作业环境的改进建议。
详情请参阅 cccskills 页面。
本文转载自 cccskills 的文章「用chief-of-staff统筹子代理,推进长期目标」。
技能详情与安装方法请见 cccskills 的 chief-of-staff 页面。