From a019810fd8cffe337be066c557d8dfefd2eadcc9 Mon Sep 17 00:00:00 2001 From: FuDie0915 Date: Mon, 16 Nov 2026 17:52:28 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E4=BB=93=E5=BA=93?= =?UTF-8?q?=E4=BA=A4=E4=BB=98=E9=AA=8C=E8=AF=81=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .tasks/sb-workflow.md | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/.tasks/sb-workflow.md b/.tasks/sb-workflow.md index 66b589b..3bb071f 100644 --- a/.tasks/sb-workflow.md +++ b/.tasks/sb-workflow.md @@ -2,13 +2,14 @@ ## 当前状态 -- 协议阶段:EXECUTE / 执行。 -- 有效计划:v1,用户在当前会话中完整粘贴计划并明确要求实施,批准范围为本地独立目录的适配与验证。 +- 协议阶段:DEVOPS / 工程交付,仓库信息完善已完成。 +- 有效计划:v1 为已完成的本地适配与验证;本轮仓库完善范围为 README、协作与来源说明、更新记录、Git 与编辑器约定,以及 Gitea 简介和主题标签。 +- 本轮授权:用户先要求为当前项目建立远端仓库,随后指出缺少 README 等标准仓库信息;本轮直接补齐并验证、提交、推送,沿用私有仓库与 `main` 分支。 - 独立项目:`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 写操作。 +- 当前 TODO:适配、安装、建仓及本轮仓库信息完善均已完成。 +- 下一步:按具体需求使用或维护技能;真实模型阶段选择与业务执行仍不属于本次验收。 +- 当前边界:技能源目录和安装副本不作功能修改,`upstream/fd-engineering` 保持原样。远端为私有仓库 `https://stupidbrain.sbs/FuDie0915/SB-Workflow`,本地 `main` 跟踪 `origin/main`;认证配置仅在本项目 Git 元数据中。 ## 目标、范围与验收 @@ -35,6 +36,10 @@ - [x] 2 安装到当前项目并验证发现(完成)。验收:安装文件与交付版本一致,本机 Codex 对当前路径返回已启用的项目级技能。证据:V6、V7;后续授权不包含修改用户级配置或运行业务任务。 - [x] 3 迁移为独立项目并清理 QuQ(完成)。验收:47 个已有文件完整迁移,独立项目中的技能可发现,QuQ 不再加载该技能且无相关文件残留。证据:V8–V10。 - [x] 4 改名为 SB-Workflow 并重新安装到 QuQ(完成)。验收:独立项目、技能标识、显示名称、调用示例和阶段标记一致;QuQ 与独立项目均能发现并启用 `sb-workflow`,不再发现旧的 `fd-engineering` 入口。证据:V11–V13。 +- [x] 5 建立项目私有远端仓库(完成)。验收:已有 47 个文件提交并推送到 `main`,远端提交和文件哈希与本地一致。证据:V14。 +- [x] 6 完善标准仓库信息(完成)。验收:安装与用法清晰,协作、更新、来源和格式约定齐备,静态检查与远端核验通过。证据:V15–V17。 + - [x] 6.1 补齐根目录文档与 Git、编辑器约定(完成)。验证:59 处 Markdown 本地链接有效,源与副本的 13 个文件一致,原始快照保持原样,14 个忽略规则样例及 `git diff --check` 通过。证据:V15。 + - [x] 6.2 更新 Gitea 简介和主题标签并完成交付(完成)。验证:Gitea Markdown 渲染、简介与 5 个主题标签、推送后的远端提交及 54 个文件哈希均核验通过。证据:V16、V17。 ## 验证证据 @@ -53,6 +58,11 @@ - 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,无相关解析错误;检查后关闭了临时进程,未启动模型回合。 +- V14:按后续建仓授权,将已有 47 个文件作为初始提交 `77def46c5fe840cd2660272d87ce95f88566ea00` 推送至私有 Gitea 仓库 `FuDie0915/SB-Workflow`。Git 远端引用、Gitea 分支 API 和文件树核验一致,默认分支为 `main`,本地跟踪 `origin/main`;认证配置仅保存于本项目 Git 元数据。 +- V15:本轮新增 7 个根目录文件:README、CONTRIBUTING、CHANGELOG、NOTICE、`.gitignore`、`.gitattributes` 和 `.editorconfig`。通过一次性 Python 标准库检查:新增文档及技能源中的 59 处本地 Markdown 链接有效,README 目录锚点有效,7 个新文件均为 UTF-8 与 LF;14 个忽略规则样例符合预期,`.env.example`、技能、安装副本和维护记录不被忽略。源与安装副本各 13 个文件的 SHA-256 一致;除本维护记录外,原有 46 个文件的字节内容与初始 Git 快照一致,其中包含原始参考的 20 个文件。README 的 PowerShell 安装示例通过语法解析;本轮未实际安装到其他项目。`git diff --check` 和暂存差异检查均通过。 +- V16:安装目录与发现说明核对了 [OpenAI 官方 Skills 文档](https://learn.chatgpt.com/docs/build-skills)。通过本机 Gitea 的 Markdown API 渲染 README,确认 10 个标题、1 个阶段表格、5 个代码块及页面内锚点结构正常。Gitea 简介已更新,主题标签为 `agent-skills`、`codex`、`documentation`、`engineering`、`workflow`;私有状态与 `main` 默认分支保持不变。本轮未选择开源许可证,来源及当前许可状态写入 NOTICE。 +- V17:文档提交 `3dcc970256887153d06584bd3eeac0b86a7350d0` 已推送。Git 远端引用与 Gitea 分支 API 对应同一提交;Gitea 文件树中的 54 个文件路径和 blob SHA 与本地提交完全一致,远端 README 解码后的字节内容与本地文件相同。本轮只完善文档、格式约定与仓库元数据,不涉及技能行为修改或真实模型运行验证。 + ## 初版规则静态走查 下表保留改名前 `fd-engineering` 版本的场景记录。当前入口已统一更名为 `$sb-workflow`,阶段职责和授权边界不变;本轮重命名及安装验证见 V11–V13。场景走查检查的是指令覆盖与一致性,没有向另一个 Codex 会话发送这些提示,也不证明实际模型会按预期触发或执行。 @@ -79,3 +89,5 @@ 当前独立项目为 `D:\Project\SB-Workflow`,技能显示名称为 `SB-Workflow`,实际调用入口为 `$sb-workflow`。按本轮明确授权,QuQ 与独立项目均已安装并通过本机 Codex 的项目级发现、启用状态及 UI 元数据检查;旧入口已替换。原始参考、适配技能和维护记录仍保留在独立项目。 隐式触发、真实模型阶段选择、真实业务执行和当前桌面聊天的 UI 刷新尚未实测;这些项目不作为已通过项。文档约束依赖实际宿主和模型执行,静态校验及技能发现不等于运行时行为保证。 + +后续仓库交付已完成:私有远端、README、贡献指南、更新记录、来源与许可状态、Git 与编辑器约定,以及 Gitea 简介与主题标签均已补齐,相关静态检查和远端文件核验见 V14–V17。原始适配与安装证据保留为历史记录。