关于 ptns
ptns 是用于编写交接提示词的技能,帮助新的 Agent 会话从零开始继续工作。它整理已验证进展、当前状态、决策和后续步骤,并根据可用的 Agent 工具交付提示词。
主要功能
- 01收集目标与已验证进展
- 02记录状态、决策和已尝试的无效方法
- 03注明准确的文件和命令
- 04在交接内容中隐去机密信息
- 05发送交接内容或生成可复制提示词
适用场景
- 01将未完成任务转交给新会话
- 02保留调试过程中的决策和经验
- 03准备聚焦的续作提示词
- 04向可联系的 Claude Code 会话发送交接
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ guojie-hong/ skills --skill ptns安装后在 Claude Code 中输入/ptns确认已加载。
附带文件agents/openai.yaml
详细介绍
新会话提示词
编写一条交接提示词:另一个会话从一无所知开始,只能看到这些文字。请为这位首次阅读者撰写。
如果用户传入了参数,它就指定了下一会话的重点;请围绕它组织提示词。
1. 收集状态
从本次对话中收集信息,并检查环境中可以确认的内容:
- 用一句话说明目标。
- 已完成的事项,以及每项如何验证。未验证的内容标记为未验证。
- 当前状态:分支、未提交的更改、正在运行或尚未完成的事项。
- 下一步:具体到可以立即开始。
- 已作出的决定及各自的理由,避免下一会话重新讨论。
- 已尝试但行不通的方法,以及过程中发现的注意事项。
- 下一步涉及的确切文件、符号和命令。
省略下一会话通过一次查找即可获取的内容(例如 git log、文件内容、--help)。保留它无法查到的内容:理由、行不通的方法、未成文的惯例。
2. 编写提示词
使用用户当前使用的语言撰写。
- 直接对下一会话发出指令,使用祈使句(“继续……”“接下来,……”)。
- 路径、符号和命令须保持准确。
- 隐去机密:将每个 API 密钥、密码、令牌和个人信息替换为
<API_KEY>之类的占位符。 - 尽量简短:每一行都应包含下一会话原本需要重新查明或询问的信息。
- 以工作目录开头,明确下一会话应在该目录中工作。
- 以“下一步”及其完成标准结尾。
完成标准:首次阅读者无需提出任何问题,就能开始下一步。
3. 交付
首先判断当前运行的是哪个 Agent:
- Claude Code — 存在
ListAgents和SendMessage工具。按 3a 执行。 - 其他任何 Agent(Codex、agy,或任何不具备这些工具的 Agent)— 按 3b 执行。
不要询问用户使用的是哪个 Agent;检查你实际拥有的工具。
3a. Claude Code — 发送给活跃会话
- 调用
ListAgents,列出可联系的会话。 - 向用户简要列出可联系的会话,使用编号:名称、类型,以及已知时的工作目录。省略本会话。
- 询问要发送给哪个会话;有 2–4 个选项时使用
AskUserQuestion。始终包含 “不发送——只向我展示提示词” 选项;如果用户选择此项,改按 3b 执行。 - 如果列表为空,用一行说明,然后改按 3b 执行。
- 用户回答后,使用
ListAgents打印的确切名称,通过SendMessage将交接提示词发送给选定会话。提示词末尾添加一条综合说明:开始下一步之前,接收方先用自己的话概述目标和下一步,并列出所有问题,然后回复收到的交接消息中的from地址,之后等待你的回复。 - 用一行回复,说明发送给了哪个会话,并表示你正在等待其综合回复。不要重新打印完整提示词。
- 收到综合回复后,对照本次对话进行核查。将本次对话已解决的每个问题的答案告知接收方,并纠正每处误解,全部放在一条
SendMessage中。只向用户提出本次对话尚未解决的问题,并在同一条消息中转达用户的回答。 - 完成标准:接收方已收到对每处误解和每个问题的回复。用一行告知用户接收方已准备好开始下一步,并说明用户在此过程中作出的任何决定。
在用户回答前,绝不要发送;绝不要猜测目标会话。
3b. 其他 Agent — 提供可复制的代码块
将完整提示词放在一个围栏代码块中,便于一次性复制。
只回复代码块,不添加其他内容;除非提示词依赖的信息不确定,否则在代码块后另加一行说明不确定之处。
评论
支持 Markdown