这是个人使用的 skills,只是做记录使用
planning-with-files
地址: https://github.com/OthmanAdi/planning-with-files
planning-with-files 是 Othman Adi 的 MIT 技能.目的是让智能体把进行中的任务写到项目磁盘上,避免计划只活在对话窗口里.
| 文件 | 记什么 | 何时更新 |
|---|---|---|
task_plan.md | 目标、阶段、状态、下一步 | 每个阶段之后 |
findings.md | 调研和发现 | 有新发现就写 |
progress.md | 会话日志、测试结果、错误 | 执行过程中 |
安装
Claude Code
在项目目录里打开 Claude Code,把下面两行当作会话里的斜杠命令执行
/plugin marketplaceaddOthmanAdi/planning-with-files /plugininstallplanning-with-files@planning-with-files更新
/plugin update planning-with-files@planning-with-files想让复杂任务每次都走这套流程,在项目的CLAUDE.md加一行:
When a task needs3+ steps or5+ tool calls, invoke the planning-with-files skill first and keep task_plan.md current.Codex
Codex 从~/.agents/skills/或仓库的.agents/skills/发现技能,从~/.codex/hooks.json或仓库的.codex/hooks.json发现 hook。技能和 hook 要一起装
gitclone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-filesmkdir-p~/.agents/skills ~/.codex/hookscp-r/tmp/planning-with-files/.agents/skills/planning-with-files ~/.agents/skills/cp-r/tmp/planning-with-files/.codex/hooks/* ~/.codex/hooks/cp/tmp/planning-with-files/.codex/hooks.json ~/.codex/hooks.jsonrm-rf/tmp/planning-with-files💡如果
~/.codex/hooks.json里已经有别的 hook,不要直接覆盖,把这 7 项合并进去:SessionStart、UserPromptSubmit、PreToolUse、PermissionRequest、PostToolUse、PreCompact、Stop。
重启 Codex,用/hooks查看并信任新 hook。确认文件在:
codex--versionls-la~/.agents/skills/planning-with-files/SKILL.mdls-la~/.codex/hooks.json ~/.codex/hooks/一次性审查或 CI 不要被现有计划牵着走时:
PLANNING_DISABLED=1codexexec-oreview.md'review this branch'使用方法
Claude Code
/plan 给 UART DMA 接收补超时、溢出标志清除和失败后的缓冲区回收codex
用 planning-with-files 规划并实现:给 UART DMA 接收补超时、溢出标志清除和失败后的缓冲区回收。先写计划文件,再按阶段做。做的过程中:查到的芯片行为写入findings.md;每完成一个阶段,把task_plan.md的状态改成 complete,并在progress.md记下改了哪些文件、测试是否通过。连续两次搜索或读文档后就要把要点写入findings.md
中途执行/clear或上下文被压缩后,下一条消息会从磁盘上的计划接着做,例如:
继续当前计划,从第一个未完成阶段做起。全部阶段的**Status:**都是complete后,用完成检查确认。Claude 插件里是/status。两边都可以在技能目录运行:
sh~/.claude/skills/planning-with-files/scripts/check-complete.shCodex 个人安装的脚本在~/.agents/skills/planning-with-files/scripts/。
长时间任务可以在 Claude 里改用完成门:
/pwf--gatedUART DMA 超时与错误恢复 /plan-goal这样在仍有进行中阶段、并且进度还在前进时,Claude 和 Codex 可以拦住过早停止。普通模式只提醒,不会拦住。计划正文改过之后,用/plan-attest重新锁定;hook 会拒绝注入和已记录摘要不一致的计划正文
handoff
地址: https://github.com/mattpocock/skills/tree/main/skills/productivity
handoff 是把当前对话生成一份临时的 Markdown, 交割另一个智能体接着做.
什么时候用
只有工作必须离开当前会话时才用,一共四种:
| 场景 | 为什么要一份文件 |
|---|---|
| 从 Claude 换到 Codex,或反过来 | 新工具看不到旧对话 |
| 换目录或换仓库 | 常见的是去做一个一次性原型 |
| 交给同事 | 对方需要一份能读的说明 |
| 做到一半分出一条支线 | 你继续原会话,另一个智能体去做支线 |
同一工具、同一目录里从讨论转到实现,用/compact。后面的内容可以丢掉时,用/clear。同一台机器、同一工具、同一目录里复制上下文,用会话分叉更省事。handoff的优势是文件能带到分叉去不了的地方。
安装
Claude Code
claude plugininstallmattpocock-skills@claude-plugins-officialCodex
codex plugin marketplaceaddmattpocock/skills codex pluginaddmattpocock-skills@mattpocock装完后新开一次会话。/handoff本身不依赖/setup-matt-pocock-skills;那个命令是给 issue 跟踪和词汇表用的。
使用
输入/handoff,并写明下一会话要干什么。技能会按这个目标压缩对话,写到系统临时目录
/handoff 下一会话只补 UART DMA 超时的回归测试💡Linux 上是
$TMPDIR,否则是/tmp;Windows 上是%TEMP%。文件不进当前仓库,因为交接是过路文件,不是要长期维护的文档。
例子
你在 Claude Code 里查清了 UART DMA 超时:完成中断没来,是因为错误标志没清。驱动还没改,测试也还没写。你想让 Codex 只补回归测试。
在 Claude 里输入:
/handoff 下一会话在 Codex 里只补 UART DMA 超时的回归测试,不要改驱动它会写出类似这样的文件,并告诉你路径,例如/tmp/handoff-uart-dma.md:
# 交接:UART DMA 超时回归测试下一会话只补测试,不改驱动。## 当前结论接收超时是因为错误标志在完成后没有清除,完成中断因此不再到来。 这个结论来自本会话对 ISR 的阅读,还没有在硬件上复现。## 已有材料- 驱动:firmware/uart_dma.c - 现有测试:tests/test_uart_dma.c - 讨论过的计划:docs/adr/0004-dma-error-flags.md## 下一步在现有测试框架里加一条回归:制造未清除的错误标志,断言超时路径会失败。## 建议技能- write-tests先读一遍。没验证过的话不要写成已确认事实,否则下一个智能体会把它当成前提。若 Codex 不会马上开,先复制出去:
cp/tmp/handoff-uart-dma.md ~/notes/handoff-uart-dma.md在 Codex 的新会话里指向这个文件,不要把全文贴进 shell 命令。正文里的反引号和$(...)可能被 shell 截断,而且不会报错。
先读 ~/notes/handoff-uart-dma.md,然后只补 UART DMA 超时的回归测试,不要改驱动。原 Claude 会话保持不动。Codex 做完后,把测试路径发回 Claude 即可。
相关视频
Matt Pocock 视频 “/handoff is my new favourite skill”(YouTube: dtAJ2dOd3ko)
teach
地址:https://github.com/mattpocock/skills/tree/main/skills/productivity
teach 是一个把 AI 变成能持续根进学习进度的老师.它围绕你的实际目标设计课程,把资料、练习和学习记录保存到当前目录,方便你隔几天、换一个会话后继续学习。
安装
Claude Code
npx skills@latestaddmattpocock/skills--skillteach--agentclaude-code--globalCodex
npx skills@latestaddmattpocock/skills--skillteach--agentcodex--global如果上述两者都使用,可以用以下命令进行替代
npx skills@latestaddmattpocock/skills--skillteach--agentclaude-code codex--global-skill teach:只选择teach。-agent:指定安装给哪个工具。-global:当前用户的各个项目都可使用。去掉它,则安装到当前项目。
使用例子
以”学习 Linux C 的生产者—消费者模型”为例,
建立独立的学习目录
mkdir-p~/Documents/learning/linux-c-queuecd~/Documents/learning/linux-c-queue启动 Claude Code,并使用 skill
/teach 我想学习 Linux C 的生产者—消费者模型。 我的基础: - 会 C 语言、指针、结构体和基本链表。 - 会创建 pthread 线程,知道 mutex 的基本用法。 - 不理解条件变量如何与互斥锁配合,也不清楚等待条件为什么常用 while。 实际目标: 独立实现一个固定容量的线程安全消息队列,支持多个生产者和消费者;队列空时等待、满时等待,并能够安全关闭和退出。 学习要求:1. 使用简体中文,首次出现的专业术语解释清楚。2. 每次约20分钟,只学习一个核心问题。3. 先通过几个问题确认我的基础,再确定第一课。4. 使用可信资料,课程给出原始文档链接。5. 每课先讲必要知识,再让我完成一个小练习;我回答前不要展示完整答案。6. 根据我的回答记录真正掌握的内容,以及仍然存在的误解。7. 所有学习材料保存在当前目录。 验收标准: 最后让我自己写出队列,并解释共享状态如何受保护、等待条件为什么需要重新检查、关闭时怎样唤醒等待线程。
💡当前 skill 没有完整的初始水平测评流程,因此第一次使用时写清已有知识和不懂的地方,会更容易得到合适的课程 [作者说明]
Skill 排行
- https://www.skills.sh/