mcpField
P
ptns

ptns

github.com/guojie-hongAgent 工作流143 次安装6 天前更新
代码仓库

关于 ptns

ptns 是用于编写交接提示词的技能,帮助新的 Agent 会话从零开始继续工作。它整理已验证进展、当前状态、决策和后续步骤,并根据可用的 Agent 工具交付提示词。

主要功能

  1. 01收集目标与已验证进展
  2. 02记录状态、决策和已尝试的无效方法
  3. 03注明准确的文件和命令
  4. 04在交接内容中隐去机密信息
  5. 05发送交接内容或生成可复制提示词

适用场景

  1. 01将未完成任务转交给新会话
  2. 02保留调试过程中的决策和经验
  3. 03准备聚焦的续作提示词
  4. 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 — 发送给活跃会话
  1. 调用 ListAgents,列出可联系的会话。
  2. 向用户简要列出可联系的会话,使用编号:名称、类型,以及已知时的工作目录。省略本会话。
  3. 询问要发送给哪个会话;有 2–4 个选项时使用 AskUserQuestion。始终包含 “不发送——只向我展示提示词” 选项;如果用户选择此项,改按 3b 执行。
  4. 如果列表为空,用一行说明,然后改按 3b 执行。
  5. 用户回答后,使用 ListAgents 打印的确切名称,通过 SendMessage 将交接提示词发送给选定会话。提示词末尾添加一条综合说明:开始下一步之前,接收方先用自己的话概述目标和下一步,并列出所有问题,然后回复收到的交接消息中的 from 地址,之后等待你的回复。
  6. 用一行回复,说明发送给了哪个会话,并表示你正在等待其综合回复。不要重新打印完整提示词。
  7. 收到综合回复后,对照本次对话进行核查。将本次对话已解决的每个问题的答案告知接收方,并纠正每处误解,全部放在一条 SendMessage 中。只向用户提出本次对话尚未解决的问题,并在同一条消息中转达用户的回答。
  8. 完成标准:接收方已收到对每处误解和每个问题的回复。用一行告知用户接收方已准备好开始下一步,并说明用户在此过程中作出的任何决定。

在用户回答前,绝不要发送;绝不要猜测目标会话。

3b. 其他 Agent — 提供可复制的代码块

将完整提示词放在一个围栏代码块中,便于一次性复制。

只回复代码块,不添加其他内容;除非提示词依赖的信息不确定,否则在代码块后另加一行说明不确定之处。

评论

支持 Markdown