# SB-Workflow Codex 工作流适配与安装 ## 当前状态 - 协议阶段:EXECUTE / 执行。 - 有效计划:v1,用户在当前会话中完整粘贴计划并明确要求实施,批准范围为本地独立目录的适配与验证。 - 独立项目:`D:\Project\SB-Workflow`;交付技能目录:项目内 `sb-workflow`。 - 后续授权:用户先要求安装到原工作目录 `D:\Project\QuQ`,随后要求迁移成独立项目并清理原目录;本轮又明确要求将 workflow 改名为 `SB-Workflow` 并安装到当前 QuQ 项目。 - 当前 TODO:适配、校验、迁移、改名,以及两个项目的技能安装与发现检查均已完成。 - 下一步:在 QuQ 或独立项目的下一条消息中通过 `$sb-workflow` 指定阶段试用;真实模型阶段选择与业务执行尚未验证。 - 当前边界:原始参考文件保存在 `upstream/fd-engineering` 且未改动,适配技能保存在 `sb-workflow`。独立项目和 QuQ 的项目级安装均为 `.agents/skills/sb-workflow`。QuQ 仅新增此次明确授权的安装目录,维护记录留在独立项目;未修改用户级配置,未执行发布或 Git 写操作。 ## 目标、范围与验收 制作通过 `$sb-workflow` 加自然语言选择阶段的 Codex Skill,显示名称为 `SB-Workflow`;其前身名为 `fd-engineering`。保留八阶段、中文输出、六项工程约束、分层 TODO、任务记录与恢复机制。交付 `SKILL.md`、11 份参考文档及 `agents/openai.yaml`,使用可移植相对引用。 显式阶段优先;未指定时按意图和任务状态判断。任务授权与宿主权限分别核对,批准可复用,工作流阶段不能改变实际宿主模式。审查和提交说明不自动修改源码或 Git 状态。 ## 研究依据与决策 - 源文件:原始 `fd-engineering` 下 20 个文件,当前保存于独立项目的 `upstream/fd-engineering`;适配前记录全部文件的 SHA-256,最终比较以确认原样保留。 - 原始内容来自 Local-Cursor 的 `internal/skills/builtin/fd-engineering`,提取时对应提交 `8affd678b685993b6b347371e7f05dcc53361305`。 - 用户选择:单入口工作流,先交付独立目录。 - 官方 Skill 说明:,规划阶段已读取;本次复用已核实的 `SKILL.md`、相对参考文件与 UI 元数据结构。 - 不再分发原来的 8 个 Cursor 命令文件;其阶段语义纳入主入口与相应参考文档。 - 不增加运行时脚本、MCP 或项目依赖;技能按需使用宿主实际可用工具。 ## 有效计划与分层 TODO - [x] 1 工作流适配(完成)。验收:13 个独立技能文件齐备,原始目录不变,静态检查通过,未安装与未实测范围已说明。 - [x] 1.1 主入口、八阶段路由与 UI 元数据(完成)。证据:V1、V2、V4;统一调用语法与阶段文档映射正确,自动匹配使用默认启用策略。 - [x] 1.2 11 份参考文档与宿主权限、授权恢复规则(完成)。证据:V2、V3、S1–S12;保留阶段边界、分层 TODO 与任务恢复机制。 - [x] 1.3 结构、元数据、引用、内容保留和原始文件检查(完成)。证据:V1–V5;原始 20 个文件全部未变。 - [x] 1.4 八阶段及授权、只读宿主、恢复场景静态走查与交付(完成)。证据:S1–S12;独立文件与调用示例齐备,技能安装与真实触发不计入本次完成范围。 - [x] 2 安装到当前项目并验证发现(完成)。验收:安装文件与交付版本一致,本机 Codex 对当前路径返回已启用的项目级技能。证据:V6、V7;后续授权不包含修改用户级配置或运行业务任务。 - [x] 3 迁移为独立项目并清理 QuQ(完成)。验收:47 个已有文件完整迁移,独立项目中的技能可发现,QuQ 不再加载该技能且无相关文件残留。证据:V8–V10。 - [x] 4 改名为 SB-Workflow 并重新安装到 QuQ(完成)。验收:独立项目、技能标识、显示名称、调用示例和阶段标记一致;QuQ 与独立项目均能发现并启用 `sb-workflow`,不再发现旧的 `fd-engineering` 入口。证据:V11–V13。 ## 验证证据 - 初始环境检查:系统 Python 3.13.18 与内置工作区 Python 均缺少 `yaml` 模块。最终通过现有 `uv` 的隔离临时运行环境加载 PyYAML 6.0.3 完成校验,没有向项目、系统 Python 或交付技能添加运行时依赖。 - V1:外层执行 `uv run --no-project --python D:\DevTools\Python313\python.exe --with PyYAML python -X utf8 -`,从标准输入运行审计代码。审计代码通过该解释器的子进程实际调用 skill-creator 的 `scripts/quick_validate.py` 检查交付目录,退出码为 0,输出 `Skill is valid!`。 - V2:同一审计检查通过。交付目录恰好包含 13 个文件(`SKILL.md`、11 份参考文档、`agents/openai.yaml`);44 处本地 Markdown 引用全部指向包内存在的文件;无旧命令 `/FD-*`、Cursor 路径、旧命令模板相对路径或开发机绝对路径残留。 - V3:逐份比较 11 份参考文档与规范化调用语法后的源文件。6 份仅调用语法变化;5 份(workflow、research、plan、execute、task-record)增加或修正单入口、宿主权限、计划展示、工具与持久化兼容说明。UIUX、TODO、Grill、审查、交付与提交说明的既有业务规则保留。主入口的六项工程约束与原文逐字一致;8 个固定中文阶段标记全部保留。 - V4:YAML 解析与约束检查通过。3 个 UI 字符串均使用引号,简短描述符合 25–64 字符范围,默认提示包含 `$fd-engineering`。未配置关闭隐式调用的策略,自动匹配保持默认启用;未声明外部工具依赖。八阶段路由与各自参考文档映射检查通过。 - V5:按适配前记录的 SHA-256 逐项比较源目录,20 个文件的相对路径、数量和哈希全部一致。 - V6:后续安装到当前项目 `.agents/skills/fd-engineering`。安装前不存在同名目标目录;复制后 13 个文件的相对路径、数量和 SHA-256 与独立交付版本全部一致。 - V7:使用本机 Codex 可执行文件生成的协议 Schema 核对参数后,启动临时、独立的本地 app-server,以当前目录请求 `skills/list`,参数为 `cwds: ["D:\\Project\\QuQ"]`、`forceReload: true`。实际返回 `name: fd-engineering`、`scope: repo`、`enabled: true`、`path: D:\Project\QuQ\.agents\skills\fd-engineering\SKILL.md`、`interface.displayName: FD 工程工作流`,该技能无解析错误。检查未启动模型回合或新建聊天,检查结束后关闭了本次启动的 app-server 进程。 - V8:迁移前对交付技能 13 个文件、原始参考 20 个文件、项目级安装 13 个文件及任务记录 1 个文件建立清单,共 47 个文件。预先核对源路径属于 QuQ、目标路径属于 `D:\Project\codex-workflow`,确认目标不存在、源目录无符号链接或目录联接。批量搬迁命令被自动审批拦截且未执行,随后改为逐个明确路径移动。移动后、更新本迁移记录前,全量 47 个文件的 SHA-256 与迁移前清单一致。 - V9:从独立项目启动临时本地 Codex app-server,对 QuQ 和独立项目同时请求 `skills/list`,使用 `forceReload: true`。实际结果:QuQ 的 `fd-engineering` 数量为 0;独立项目数量为 1,路径为 `D:\Project\codex-workflow\.agents\skills\fd-engineering\SKILL.md`,`scope: repo`、`enabled: true`,无该技能解析错误。检查结束后关闭了本次启动的进程,未启动模型回合。 - V10:移走文件后仅删除 QuQ 中已确认为空的 `.agents/skills`、`.agents` 和 `.tasks` 目录。最终 QuQ 仅剩迁移前已存在且受保护的 `Chiaki` 与 `SnowLuma-v2.4.2-win-x64-lite` 两个目录;`codex-workflow`、`fd-engineering`、`.agents` 和 `.tasks` 均无残留。 - V11:本轮开始时确认 QuQ 未安装 workflow。随后将独立项目重命名为 `D:\Project\SB-Workflow`,适配技能和独立项目安装目录改名为 `sb-workflow`,本记录改名为 `.tasks/sb-workflow.md`。运行文档中的调用名统一为 `$sb-workflow`,显示名称为 `SB-Workflow`,八个阶段标记改用 `[SB:...]`;原始参考目录的 20 个文件 SHA-256 全部未变。 - V12:再次实际运行 skill-creator 的 `quick_validate.py`,输出 `Skill is valid!`。源技能、独立项目安装、QuQ 安装各 13 个文件,三份 SHA-256 清单一致;44 处本地引用有效,八阶段路由和八个阶段标记齐全,六项工程约束原文保持一致。运行文档中无旧技能名或 FD 品牌残留,隐式调用保持默认启用。 - V13:通过本机 Codex app-server 对 `D:\Project\QuQ` 与 `D:\Project\SB-Workflow` 同时请求 `skills/list`,使用 `forceReload: true`。两处均返回唯一的 `name: sb-workflow`、`scope: repo`、`enabled: true`、`interface.displayName: SB-Workflow`,默认提示包含 `$sb-workflow`,路径指向各自的 `.agents/skills/sb-workflow/SKILL.md`。两处旧名称数量均为 0,无相关解析错误;检查后关闭了临时进程,未启动模型回合。 ## 初版规则静态走查 下表保留改名前 `fd-engineering` 版本的场景记录。当前入口已统一更名为 `$sb-workflow`,阶段职责和授权边界不变;本轮重命名及安装验证见 V11–V13。场景走查检查的是指令覆盖与一致性,没有向另一个 Codex 会话发送这些提示,也不证明实际模型会按预期触发或执行。 | 编号 | 场景 | 文档规定的阶段与行为 | 走查结论 | |---|---|---|---| | S1 | `$fd-engineering 研究这个项目` | RESEARCH:调查入口、复用能力、事实和未知项,不进行业务实现 | 已覆盖 | | S2 | `$fd-engineering 质询这个方案中的关键决策` | GRILL:先调查事实,每轮解决一个关键决策;回答不等于批准实现 | 已覆盖 | | S3 | `$fd-engineering 规划这个需求` | PLAN:输出可审阅计划、分层 TODO 与验收;不自动实现 | 已覆盖 | | S4 | `$fd-engineering 为这个页面设计原型` | UIUX:核实需求与参考范围、确认简报和候选数量后制作隔离原型;生产实现仍需授权 | 已覆盖 | | S5 | `$fd-engineering 执行当前计划`,计划明确且有批准、宿主可写 | EXECUTE:核对计划版本与真实文件,连续实施、验证和自检 | 已覆盖 | | S6 | `$fd-engineering 审查当前修改` | REVIEW:基于真实差异和证据报告问题,不自动修复源码、暂存或提交 | 已覆盖 | | S7 | `$fd-engineering 为这个项目制定打包交付方案` | DEVOPS:先研究与规划;已授权时推进对应本地工作,外部操作需明确意图 | 已覆盖 | | S8 | `$fd-engineering 生成提交说明` | COMMIT:从真实差异起草中文说明,不自动暂存、提交、推送或初始化仓库 | 已覆盖 | | S9 | 要求执行,但没有可用已批准计划,且不符合小改动快速路径 | 转入 PLAN 完成前置规划,不把执行请求当作任意实现授权 | 已覆盖 | | S10 | 用户已提供完整计划并明确要求实施 | 复用该计划与批准,不重复索取同一授权;照常核对宿主权限 | 已覆盖 | | S11 | 宿主处于只读 Plan mode,即使已有实施批准 | 仅做宿主允许的调查与规划;禁止的文件写入保持待执行,批准保留在对话中 | 已覆盖 | | S12 | 恢复已有复杂任务,部分检查已过期或存在其他用户修改 | 按明确选定的记录核对计划、批准、TODO、实际文件与证据;过期检查重新验证,保护无关改动 | 已覆盖 | ## 剩余风险与交付结论 本次独立目录适配已完成,结构、引用、内容保留与原始目录完整性检查通过,12 个规则场景已静态走查。调用示例位于交付技能的主入口路由表。 当前独立项目为 `D:\Project\SB-Workflow`,技能显示名称为 `SB-Workflow`,实际调用入口为 `$sb-workflow`。按本轮明确授权,QuQ 与独立项目均已安装并通过本机 Codex 的项目级发现、启用状态及 UI 元数据检查;旧入口已替换。原始参考、适配技能和维护记录仍保留在独立项目。 隐式触发、真实模型阶段选择、真实业务执行和当前桌面聊天的 UI 刷新尚未实测;这些项目不作为已通过项。文档约束依赖实际宿主和模型执行,静态校验及技能发现不等于运行时行为保证。