mcpField
D
decision-map

decision-map

github.com/light-chengAgent 工作流521 次安装3 天前更新
代码仓库

关于 decision-map

decision-map 是面向大型、模糊或跨多个会话工作的用户调用型规划技能。它用 Markdown 地图和工单记录决策与待解问题，每次会话处理一项，并在规划完成后转交项目规格编写。

主要功能

  1. 01创建持久化决策地图
  2. 02将问题拆分为决策工单
  3. 03记录工单间的阻塞关系
  4. 04制图阶段并行开展研究工单
  5. 05每次会话处理一项非研究工单

适用场景

  1. 01规划规模大且目标不明的项目
  2. 02跨会话整理决策
  3. 03梳理待解问题间的依赖
  4. 04为项目规格编写整理已完成的规划

安装

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

$npx skills add https://github.com/light-cheng/skills --skill decision-map

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

ATTRIBUTION.md
agents/
openai.yaml
references/
EXAMPLES.md
MAP-CONTRACT.md
WORKFLOW.md
tests/
test_decision_map_contract.py

详细介绍

决策图

decision-map 是一个由用户明确调用的规划阶段，适用于目标模糊、大型或跨多个会话的工作。只有在收到明确的 $decision-map 请求后才运行。它会在本地 Markdown 跟踪文件上绘制一张持久化决策图，并在每个会话中解决一个工单。

当 docs/agents/light-project.md 存在时，只读取其中的议题跟踪器和工作区域字段，并使用所引用的跟踪器约定。如果没有引导配置，则保留以下本地 .scratch 约定，并在交接中说明使用了该默认设置。

核心模型

.scratch/<effort>/map.md              ← canonical map
.scratch/<effort>/issues/NN-<slug>.md ← child decision tickets
  • 地图： Destination、Notes、Decisions so far、Not yet specified、Out of scope。
  • 工单： 一个粒度为单项决策的问题，包含 Type、Status 和 Blocked by。

具体结构和跟踪器操作见 MAP-CONTRACT.md。

执行

  • 绘制： 说明目标，按广度优先的方式梳理前沿／模糊点，创建地图和可明确界定的工单，设置阻塞关系，并行启动 light-research 工单，然后停止。
  • 处理： 加载地图，认领选定的前沿工单，通过该工单对应的能力解决问题，追加 ## Answer 并更新地图，然后停止；绘制阶段并行处理 light-research 工单的情况除外。

完整模式步骤见 WORKFLOW.md；示例见 EXAMPLES.md。

组合使用

使用相应能力解决工单：light-research、light-prototype、socratic（由人作出决策），或 light-to-questionnaire（交由他人处理）。每个会话最多解决一个非研究类工单。

交接

当未完成工单数为零、模糊点已全部消除，且剩余范围已归入 Out of scope 时，建议明确请求 $project-spec，然后停止。

decision-map → project-spec

评论

支持 Markdown