MKD（mkd — Make Decision）是供 AI 在对话中途调用的本地决策卡 CLI。它在浏览器中渲染一页一项的卡片流，包含四类卡片：decision（以产品经理口吻写的问题陈述、可折叠背景说明、带书面理由的选项、可选自定义项与备注）、question（Markdown 内容加单选/多选/开关控件与自由文本）、report（供用户逐条回应的报告段落）、table（可逐行作答的表格）。决策项有硬性规则：每个选项必须写明收益与代价，验证器会拒绝缺少理由的选项（退出码 2）；最多一个推荐选项，且其理由须明确说明为何被推荐。
无需安装步骤，没有编译二进制，也不向 PATH 添加任何内容；用 Bun 从技能目录直接运行 TypeScript：bun "<skill-dir>/cli/index.ts" <specPath>。常用旗标包括 --wait、--copy、--no-open、--port <n>、--timeout <min>，以及 Claude Code 专有的 --artifact --title-prefix <session-name>。若缺少 Bun，提示用户安装：curl -fsSL https://bun.sh/install | bash，不要用 Node 替代。所有输出落在 ~/.mkd/，不写入当前工作目录。
默认流程为非阻塞复制粘贴：CLI 打开页面后即退出，用户在方便时作答，把 Result JSON 粘贴回对话；该 JSON 即执行契约，AI 严格照其执行。status 为 skipped 表示“稍后再定”，不是拒绝；chosen 为 CUSTOM 表示按 customText 执行。Orca 环境中默认走 Orca 流程，需后台运行并由“Send to Claude”提交，不可前台运行。--wait 为阻塞式同回合作答，具有按运行的 x-mkd-token 提交门，仅在需要同回合继续时使用。退出码含义：0 已提交、1 超时无提交（用户离开）、2 规格有误、130 用户取消、143 被终止。图片粘贴仅在 wait 模式或 Orca 流程可用；复制模式禁用粘贴。每套卡片使用 4747-4946 中的稳定端口，同一规格重开可恢复已保存答案；不同浏览器或来源的答案不会合并。artifact 模式仅适用于具备 Artifact 工具的 Claude Code 且已登录 claude.ai，需自行发布页面并设置 watch。
具体字段、默认值与校验规则见 references/schema.md，可复制的规格示例见 references/examples.md。适用场景是超过 3 个决策点、需要背景与书面取舍的决策、需逐点回应的长报告、表格逐行判定、答案需锚定到原文短语的情况；1-2 个选项选择、单个是否、≤3 个简单决策应改用 AskUserQuestion，非交互或无人值守场景应输出纯文本。以上信息来自公开资料，其余细节暂未提供。