你有了一个零散的想法——它太大,无法在单个Agent会话中处理,且笼罩在迷雾之中:从当前状态到形成计划的路径尚不清晰。本Skill可为此规划路径:创建一张工单地图,然后逐一处理其中的工单,直至通往目标的路径清晰可见。这张地图与领域无关——无论是工程工作、课程内容,只要符合这种模式都适用。
工单地图
每张工单地图是一个简洁的Markdown文件,每次路径探索对应一张,与项目一同纳入Git追踪。它是标准化的工件——整个地图会作为上下文加载到每个会话中,因此必须保持简洁。
工单处理过程中创建的资产应从地图中链接引用,而非在地图内重复。
结构
工单条目以短横线命名的slug作为唯一标识,slug同时作为迷你标题(例如
、
、
)——需简洁到能控制token用量,且在地图内唯一。
markdown
## relational-db: Relational Or Non-Relational Database?
Blocked by: <slug>, <slug>
Status: open | in-progress | resolved
Type: Research | Prototype | Grilling | Task
### Question
<question-here>
### Answer
<answer-here>
slug是标准ID,用于所有
关联和文本引用;冒号后的标题为可选内容。当工单的
列表中所有工单均标记为
时,该工单即解除阻塞。会话需先将工单
设为
并保存地图,以此“认领”工单,避免并行会话重复处理。
每个工单的规模应控制在单个100K token的Agent会话范围内。
工单类型
工单分为四种类型:
- Research(调研):查阅文档、第三方API或知识库等本地资源,生成Markdown摘要作为资产。当需要当前工作目录以外的知识时使用此类型。
- Prototype(原型):通过创建低成本、粗糙的具体工件(如大纲、草稿、代码 stub,或通过/prototype Skill生成UI/逻辑代码)提升讨论的清晰度,生成的原型作为资产。当核心问题是“外观应如何设计”或“行为应如何实现”时使用此类型。
- Grilling(深度问询):与Agent进行对话,使用/grilling和/domain-modeling Skill,每次提出一个问题。这是默认类型。
- Task(任务):讨论推进前必须完成的实际手动工作——无需决策、原型制作或调研。例如将数据从一处迁移到另一处、注册第三方服务、配置权限等。Agent会尽可能自动化处理;若无法自动化,则向用户提供精确的手动操作清单。任务完成后标记为resolved;答案部分需记录已完成的工作及后续工单依赖的关键信息(如凭证位置、新URL、行数统计等)。
战争迷雾
地图在当前探索边界之外故意保持不完整——不要规划尚未可见的内容。边界是已知领域边缘的未阻塞工单;解决这些工单即可推进边界。逐一消除战争迷雾,直至通往目标的路径清晰且无剩余工单。
调用方式
分为两种分支场景。无论哪种情况,
每个会话都必须以交接流程结束——每个会话最多解决一个工单。
创建工单地图
用户通过零散想法调用本Skill。
- 运行/grilling和/domain-modeling会话,梳理待决策事项。
- 创建新地图——大部分内容为迷雾状态,明确当前边界,同时即时解决无需过多思考的条目。
- 执行交接流程。创建地图是单个会话的工作,请勿同时处理工单。
处理工单地图
用户通过现有地图的路径调用本Skill。工单slug为可选参数——若未指定,由系统而非用户选择下一个待处理的工单。
- 加载整个地图作为上下文。
- 选择工单:若用户指定了slug则使用该工单;否则按文档顺序选择第一个未阻塞的工单。认领工单:将设为并保存后再开展工作。
- 解决工单,按需调用相关Skill——包括块中指定的Skill。若存疑,可使用/grilling和/domain-modeling。
- 在工单主体中记录答案,并将设为。
- 添加新发现的工单并设置正确的关联。若已做出的决策导致地图其他部分失效,则更新或删除相关工单。
- 执行交接流程。
用户可并行处理未阻塞工单,因此需考虑其他Agent在各自会话中编辑地图的情况。
交接流程
每个会话结束时需清空上下文并开启一个或多个新会话。以用户可复制粘贴的下一步操作块收尾,分为两种情况:
仍有未处理工单:列出当前未阻塞的工单,然后提供两种可复制粘贴的选项:一个用于单会话的基础命令(由系统选择下一个工单),以及每个未阻塞工单对应的固定命令(用于并行处理)。每个新窗口粘贴一行——可开启其中一个、部分或全部会话。
下一步操作 — 3个未阻塞工单:
、
、
。
清空上下文,然后开启新会话。
单会话 — 处理下一个未阻塞工单:
Invoke /wayfinder with the map at <path>.
并行处理 — 每个窗口粘贴一行,最多可开启全部3个会话:
Invoke /wayfinder with the map at <path>, ticket auth-strategy.
Invoke /wayfinder with the map at <path>, ticket cache-layer.
Invoke /wayfinder with the map at <path>, ticket rate-limits.
无未处理工单:迷雾已被充分驱散,通往目标的路径清晰可见——地图已完成。(初始深度问询也可能未发现任何迷雾,这种情况下无需创建地图。)建议直接实施,或使用/to-prd安排多会话的落地工作。
备注
可选块,用于声明
领域、每个会话应
的Skill,以及本次探索的通用偏好设置。