SuperAPI AI 工具集

shaping-framing

写作与研究

查看项目

更新于 10-16 08:48

技能介绍

用途:在进入 capsule/card 规划前,把对话类素材提炼成清晰的框架(Frame),为 pragma 规划提供依据。该技能源自 rjs/shaping-skills 的 framing-doc,并针对本仓库做了适配,命名空间为 pragma:shaping-*,以避免路由歧义,同时明确了 pragma 重入要求,权限边界与 docs/shape-pragma-integration.md 对齐。

适用时机:输入为转录文本、通话笔记或分散的干系人消息;团队认同问题存在但尚不能简洁陈述;在 capsule/card 工作前需要有证据支撑的“为何是现在”。不适用:已有稳定 capsule 和明确的下一切片;任务已可实施、只需 /pragma:card。

主要流程:收集来源输入,在时间顺序重要时确认排序;提取直接证据并与综合判断分开;产出包含 Problem、Outcome 和边界的框架;识别理解上的变化与仍不确定之处;定义 pragma 重入步骤。

必需输出:Frame(有证据支撑的问题与结果);Handoff To Pragma,含 Capsule impacts(需新增或修订的术语/不变量)、Candidate cards(1-3 个候选切片行为)、Open uncertainty(需 /pragma:spike 的项)、Next command(/pragma:capsule 或 /pragma:card)。

约束:不规定实现细节;不取代 capsule 对词汇和不变量的权威;不直接路由到 /pragma:slice。生命周期:状态为 discovery,下一步默认 /pragma:capsule,capsule 稳定时用 /pragma:card,循环为 /pragma:consult。