mcpField
W
wayfinder

wayfinder

github.com/carlitoseAgent 工作流049 次安装2 周前更新
代码仓库

关于 wayfinder

wayfinder 是用于绘制调查、决策和后续工作前沿的 Agent 技能。它维护持久化地图，并将未决事项转为规范工单；除非用户要求，否则不执行后续工作。

主要功能

  1. 01绘制目标与依赖关系
  2. 02追踪后续阻塞项
  3. 03将未决事项转为工单
  4. 04维护产物图元数据
  5. 05默认停止在执行之前

适用场景

  1. 01实施前梳理调查路径
  2. 02追踪阻塞后续工作的决策
  3. 03创建聚焦的研究或任务工单
  4. 04根据已完成发现更新项目地图

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/carlitose/agent-skills --skill wayfinder

安装后在 Claude Code 中输入/wayfinder确认已加载。

附带文件agents/openai.yaml

详细介绍

Wayfinder

负责调查地图、持久化前沿和不确定性路由。默认负责规划； 不会执行目标，也不会定义其他工单格式。

所有发出或使用的工单元数据均采用规范的 Ticket Envelope v1。将序列化工作委托给 to-tickets 或共享 CLI。

默认设置

  • 地图存放在 docs/specs/<slug>.md 或 docs/specs/<slug>-wayfinder.md。
  • 每张地图都有一个 ## Artifact Graph 章节、稳定的 Artifact ID、Role: wayfinder， 并且只能是 Standalone: true 或一个带有相互对应的所有者边的 Parent。
  • 工单存放在 docs/tickets/<spec-slug>/。
  • 向后兼容为可选项。仍须标记破坏性迁移、破坏外部契约的变更和不可逆变更。
  • 仅当目标本身不明确时，才提出一个简洁的问题；否则说明假设。

目标检查关卡

  • 目标明确：说明假设并立即规划。
  • 不要为了走过场而调用 grilling。
  • 如果未解决的回答会实质性改变目标、范围或初始前沿，则调用规范的 grilling。
  • 分轮提问并等待确认。
  • 确认前不要创建任何持久化产物。

延后决策

  • 目标已知但仍有未解决的决策：不要在当前访谈中处理。
  • 使用 to-tickets 发出规范的 Ticket Envelope，并设置 execution_mode: HITL；其正文必须要求通过 grilling 对该决策进行确认。
  • 在决策得到确认前，将该工单保留在前沿中。
  • 不要为访谈状态添加 Ticket Envelope 字段。

流程

  1. 仅重建足以确定目标、决策、未知事项、排除项和下一个阻塞边所需的上下文。
  2. 创建或更新地图：
# <Title>

## Artifact Graph
- Artifact ID: `artifact:<stable-id>`
- Role: `wayfinder`
- Standalone: true

## Type
Wayfinding spec

## Status
Active

## Destination
Reachable target outcome.

## Decisions So Far
- Decision, evidence, and durable record.

## Not Yet Specified
- Unknown that blocks reliable execution.

## Out of Scope
- Explicit exclusion.

## Frontier / Blocking Edges
- Edge, why it blocks, unblock condition, and owning ticket.

## Ticket Plan
- ID, type, mode, blockers, title, expected output.

## Next Review
- What the next agent or human inspects.
  1. 通过 to-spec 记录持久化的架构／产品／诊断决策，然后在地图中链接这些决策。
  2. 通过 to-tickets 创建范围明确的 research、prototype、grilling 或 task 工单。每个工单都必须说明问题／结果、证据、前沿、工作计划和排除项。
  3. 使用现有工单的模式、阻塞项或 ID 之前，先通过共享的 ticket-parse 命令解析工单。不要根据 Blocked By 等标题推断这些字段。
  4. 除非用户明确要求执行，否则在地图处停止。将一个就绪工单交给 execute-ticket，或将一个文件夹交给 ticket-autopilot。当人工在一张地图上运行多个 Pi 会话时，请遵循多会话工作规则。

维护

  • 将已持久化的目标和范围作为已确认的上下文重复使用。
  • 除非用户明确更改目标，或新证据会实质性改变目标、范围或初始前沿，否则不要重新启动 grilling。
  • 发生此类变更时，先返回目标检查关卡，再进行任何持久化更新。
  • 将已完成工单的证据和决策纳入地图。
  • 删除已解决的未知事项，不要留下过时的问题。
  • 将前沿保持在接下来几个重要边的范围内。
  • 与其猜测，不如优先创建另一张调查工单。
  • 报告地图路径、工单文件夹、就绪／受阻前沿以及建议的下一步。

评论

支持 Markdown