SuperAPI AI 工具集

direct

编程与开发

查看项目

更新于 10-15 21:04

技能介绍

Direct 是 nanomia-ai/devflow 中的一项技能,用途是在实现之前,为当前变更请求确定最小且安全的执行契约:保留用户要求的结果,把局部实现选择交给执行者;不因改动大就建立过程记录,也不因 diff 小就隐藏需要持久化的意图。

主要能力与流程:先执行入口 gate,读取 references/project-gate.md 并应用 direct 行;若 gate 路由到别处则不修改任何内容。若存在 index,先读取 index,按 index 路由只读理解请求所需的最少 Product、Domain、Architecture、Design、decision 文档,并读取当前 Git revision 与 status。创建新 artifact 前,先在 index 限定的 Work state glob 中查找是否已有同一活跃契约。

若选中的活跃 Work state 指定 next_route: direct,则先读 references/work-state.md 处理该交接;若交接需要上层判断或保留探索,则把问题发给 next_action 指定的 product、architecture、design、adopt 或 sketch,这些路由不改 Work artifact。若当前成员的 Sketch state 的 next_route 为 direct,写入前先读 references/sketch-handoff.md 完成落地契约。

写入前先路由问题:产品/Domain 语义不足发往 product,技术边界不足发往 architecture,交互原则不足发往 design;需要证据或探索则返回 sketch;只有确实存在有约束力的选择时才询问用户,且仅在真正要问之前读 references/question-dialogue.md。

随后判断持久性:若对话中断后仅凭 diff 无法恢复意图与下一步、会改变需持久化的项目知识或约束性决定、或验证/风险/协调在对话后仍开放或需独立验证者,则归为 tracked;全部为否则归为 ephemeral,不建 Work 目录,返回当前对话内的范围化行动、必要 canonical 读取、写入边界、相称验证与收尾条件。进行中的 ephemeral 变更若越过该 gate,须先停下重新归类为 tracked。

仅对 tracked 契约应用写入细节:在构造、创建、修改契约或激活集成契约前,读 references/work-state.md 与 references/direct-tracked-contract.md;其他 actor 持有管理权期间不得修改 spec。上层判断回到 Direct 时,将变更后的 canon 与既有 spec 和 verification 对照,必要时按 amendment 边界处理,或把 state 交给 work、verify。

最后报告:分类(ephemeral、tracked 或单一负责的 decision route)、Artifacts(新建或更新的 Work 路径或 none)、下一步行动(每个独立 artifact 一个范围化行动,含集成阻塞关系)、依据(所用 canonical 文档与 Git state,以及未证假设)。完成条件是:按三个问题选择持久性、每个 tracked artifact 自洽可恢复、只上报有约束力的选择、且未执行实现或验证。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息;该技能依赖 devflow 的 references 文档与 index、Git 状态等前置条件。