用途:在“还不知道该建什么”时,先梳理未决的架构、策略、范围、证据、访问与设计问题,产出决策与证据,而非实现交付物。若设计已明确,应改用 plan-prompts 或 task-decomposer。
主要能力:一张地图是一个父级跟踪项,含 Destination、Notes、Decisions so far、Not yet specified、Out of scope 五个部分,仅保存指向工单的指针与范围边界。每张工单只含一个问题,且恰好一个类型标签(decision-map:discussion、research、prototype、unblock)和一个交互标签(decision-map:hitl 或 decision-map:afk)。支持阻塞关系、可见负责人、会话认领与关闭状态。
使用方式:先确认后端,.docs/agents/issue-tracker.md 存在时以其为准,否则本地存于 .docs/decision-maps/<effort>/;仅当用户明确选择 GitHub 时才用 gh,需 gh 2.96.0 以上并先 gh auth status。frontier.py 需 Python 3.12 且仅用标准库。常用命令:uv run python skills/decision-map/scripts/frontier.py --map 42;加 --degraded 走降级路径;--local .docs/decision-maps/billing 用于本地。
两种模式:Mode A 绘制地图,广度扫描问题、建标签与地图、创建工单、连阻塞边、计算前沿后停止;Mode B 处理地图,每次调用只解决一张工单,先验证会话认领,按类型解决,记录 RESOLVED、OUT_OF_SCOPE 或 INVALIDATED 之一,再重算前沿。
限制:不实现任何功能,不把模糊希望变成任务;HITL 工单必须由人判断;空前沿不等于完成,需按状态阶梯判定 ACTIVE、WAITING、BLOCKED、FOGGY 或 COMPLETE。标签缺失、工单标签缺失或重复、认领验证失败时应显式报错,不得静默重建地图。具体收费、平台支持范围等资料暂未提供。