pstack-harness

Harness 适配器

当 pstack 工作流指定了委派操作、工作清单、问题、循环、对话记录或可移植资源时，请使用此技能。

pstack 工具名称描述的是意图。请使用当前会话的能力来满足该意图。工具清单和 CLI 帮助是权威依据。切勿虚构工具。如果机制会影响执行或证据，请说明该机制。对于工作清单，请报告项目状态，而不是承载它的载体。

选择操作

执行操作前，请完整阅读每份已选参考资料。只选择下一步所需的操作。若某一步需要多个操作，请合并阅读相应文件。仅当参考资料中链接所描述的操作适用时，才阅读该链接。无需阅读所有参考资料。

操作	必需的参考资料
worklist	工作清单流程
question	结构化问题
spawn	角色解析与交接、委派与隔离、可移植资源路径约定，以及下方当前运行时的适配器
role-handoff	角色解析与交接
persona	当 spawn 指定了某个人设时，阅读人设约定
loop	循环与唤醒
transcript	工作区对话记录以及下方当前运行时的适配器
portable-paths	当命令使用 PSTACK_SKILLS_ROOT、PSTACK_SOURCE_ROOT 或 PROJECT_ROOT 时，阅读可移植资源路径约定

运行时适配器

如果上下文压缩、缩短后的技能内容或技能恢复会影响下一步操作，请阅读技能保留证据。请将文档记录的限制、运行时观察结果和未知行为分别说明。

对于 spawn 或 transcript，只阅读当前运行时针对该操作的列。其他操作无需运行时适配器。

运行时	Spawn 适配器	对话记录位置
claude-code	Claude Code	对话记录位置
codex	Codex	对话记录位置
hermes	Hermes	对话记录位置
grok	Grok Build	对话记录位置
other	其他运行时	对话记录位置

解析可移植资源

阅读上文选定的可移植资源路径约定。只解析下一条命令所需的根路径。在生成的计划中保留精确的命令形式，并在不同所有者、委派者、唤醒和后续轮次之间恢复记录的根路径。

在交接过程中保留角色

角色交接或恢复前，请阅读上文选定的角色解析与交接参考资料。

派生角色

解析或分派角色前，请阅读上文选定的派生参考资料和当前运行时适配器。保留调用方的角色和面板分支数量。

基本操作

使用上方的操作表来处理派生、并行执行、只读执行、结构化问题、工作清单、循环和对话记录。

通用规则

• 自行使用具名的同级技能。“使用 architect 技能”是指加载 pstack 技能 architect 并遵循其要求。该名称对应已安装技能根目录下的一个同级目录，也就是存放此技能自身目录的目录。pstack 中任何其他按名称提及技能的说法，例如“叶子技能”，也以同样方式命名。在 Claude Code 中，使用 Skill 工具并传入纯名称，例如 architect。即使列表中只显示名称、不带描述，也可以正常调用；仅显示名称绝不意味着技能缺失。在 Codex、Grok Build、Hermes 和其他任何运行环境中，请完整阅读 <installed skills root>/<name>/SKILL.md，再根据步骤需要阅读其中引用的文件。绝不要要求用户输入某个 pstack 技能已点名的技能。绝不要编辑技能文件或列表设置来更改其加载方式。
• **仅加载有人点名的技能。**除非用户或已加载的技能点名，否则绝不要通过列出或搜索技能目录来读取或加载 pstack 技能。即使运行环境在描述中列出了某项技能，也可以通过该描述加载。
• 技能文本中的工具名称表示意图，并非必须使用的工具。Task、Glob、Grep、Read、工作清单以及 Cursor 时代的参数（如 readonly）指的是各种能力：使用当前会话提供的任何方式来实现即可（例如搜索工具、shell 命令或只读简报）。能力选择应依据实时描述，而不是凭记忆中的名称。缺少可选工具不会取消该步骤，也无需说明。技能文本中的 subagent_type 表示某个角色或无角色，而 Spawn a role 则将其转化为具体类型。