【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载导读Skill Surface Consolidation技能面整合是 gsd-core v1.40.0 引入的一项核心特性为了削减“热启动时枚举技能列表”的开销将 31 个细粒度微技能折叠为 4 个全新的分组父技能并让 6 个现有父技能以--flag形式吸收原本独立的子操作从而实现零功能损失的命令面瘦身。读完本文你将完整掌握整理后的命令调用方式含每个分组技能的 routing 表格与参数说明、被吸收子操作的迁移路径、/gsd-next的角色保留规则以及如何在源码与工作流层面验证“删除即删除、不留影子存根”的约束。一、为什么需要整合技能面在未整合之前gsd-core 的命令技能数量膨胀到 31 个微技能例如gsd-add-todo、gsd-note、gsd-add-backlog、gsd-plant-seed、gsd-check-todos、gsd-add-phase、gsd-insert-phase、gsd-remove-phase、gsd-edit-phase、gsd-new-workspace、gsd-settings-advanced、gsd-sketch-wrap-up等。它们各自只承担一个很小的子操作却在每次会话启动时都要被逐一枚举、装载到技能列表产生明显的eager skill-listing overhead热启动技能枚举开销。整合的核心思路是“行为保留、入口收敛”功能上零损失每一个被删除微技能的行为都通过一个分组父技能上的 flag 完整存活下来数量上大幅收敛整理后commands/gsd/*.md只交付 60 个子技能外加 6 个命名空间元技能见 #123路由上单点化用户不再需要记忆十几个近义命令只需要记住 4 个分组父技能 少量 flag。从当前仓库结构看commands/gsd 目录中已不存在add-todo.md、plant-seed.md、edit-phase.md、settings-advanced.md等独立命令文件取而代之的是capture.md、phase.md、config.md、workspace.md四个分组命令文档记载的“60 6”为设计目标数量读者应以实际安装版本为准。二、REQ-CONSOLIDATE-01四个新分组父技能2.1/gsd-capture— 捕获入口统一/gsd-capture将“todo / note / backlog / seed / 列表查看”五类捕获操作统一为一个命令。默认无 flag走结构化 todo 流程其余通过 flag 路由Flag目的被吸收的工作流无作为结构化 todo 记入.planning/todos/add-todo--note零摩擦想法捕获追加/列表/提升note--backlog加入 ROADMAP.md 的 backlog 停车场999.x 编号add-backlog--seed捕获带触发条件的前瞻想法写入.planning/seeds/SEED-YYMMDD-xxx-slug.mdplant-seed--list交互式 todo 浏览器 动作路由check-todos--list-seeds只读种子列表/审计可选状态过滤list-seeds对应的命令文件 commands/gsd/capture.md 明确规定了解析规则解析arguments块的首个 token若是--note/--backlog/--seed/--list-seeds/--list则剥掉 flag、把剩余参数转交给对应工作流否则全部交给 add-todo 工作流并“保留目标工作流的所有门禁目录结构、重复检测、提交等”。# 示例用法 /gsd-capture 调研缓存淘汰策略的备选方案 # → add-todo /gsd-capture --note 想到一个不错的命令名 # → note /gsd-capture --backlog 给 ROADMAP 加一条远期想法 # → add-backlog /gsd-capture --seed 当 X 条件满足时启动 Y 实验 # → plant-seed /gsd-capture --list # → check-todos2.2/gsd-phase— 阶段 CRUD 统一/gsd-phase把 ROADMAP.md 的阶段增、插、删、改四个操作收敛为一个命令主要面向里程碑内的阶段管理Flag动作被吸收的工作流无在当前里程碑末尾追加整数阶段add-phase--insert在指定阶段后插入小数阶段如 72.1insert-phase--remove删除未来阶段并重编号后续阶段remove-phase--edit原地编辑既有阶段的任意字段edit-phasecommands/gsd/phase.md 给出了 flag 参数的传参格式--insert后跟after-phase-number description--remove后跟阶段号--edit后跟phase-number [--force]无 flag 时整段参数作为阶段描述交给 add-phase。roadmap 与状态在流程内通过init phase-op与定向读取解析。/gsd-phase 增加一个性能回归验证阶段 # → add-phase /gsd-phase --insert 72.1 插入紧急修复工作 # → insert-phase /gsd-phase --remove 73 # → remove-phase /gsd-phase --edit 72 修改该阶段描述 # → edit-phase2.3/gsd-config— 配置入口统一/gsd-config把三类配置入口常规开关、高级旋钮、第三方集成、模型档案切换合并Flag动作被吸收的工作流无交互式 5 问常规配置model、research、plan_check、verifier、branchingsettings--advanced高级旋钮规划调优、超时、分支模板、跨 AI 执行settings-advanced--integrations第三方 API KeyBrave/Firecrawl/Exa、评审 CLI 路由、agent 技能注入settings-integrations--profile name无交互切换模型档案quality / balanced / budget / inheritset-profile内联 SDK值得注意的细节commands/gsd/config.md 中--profile不再走工作流文件而是内联调用 SDK先通过command -v gsd-tools校验gsd-tools是否在 PATH 上缺失时给出安装提示npm i -g opengsd/gsd-core并停止随后执行gsd-tools query config-set-model-profile profile-name --raw并原样展示输出。这就是“子操作以 flag 形式存活”的典型实现--profile是一个内联的 SDK 查询而不是一个独立技能文件。2.4/gsd-workspace— 工作区管理统一/gsd-workspace将工作区的创建、列举、删除收敛为一个命令commands/gsd/workspace.mdFlag动作被吸收的工作流--new创建隔离工作区仓库副本 独立.planning/透传--name、--repos、--path、--strategy、--branch、--autonew-workspace--list扫描~/gsd-workspaces/展示汇总表list-workspaces--remove确认并删除工作区目录、清理 worktreeremove-workspace与其它三个分组技能不同/gsd-workspace没有“默认模式”——无 flag 时直接展示用法提示明确要求必须给出--new、--list、--remove三者之一避免歧义路由。三、REQ-CONSOLIDATE-02六个现有父技能以 flag 吸收子操作除四个新分组父技能外还有六个既有父技能通过 flag 吸收了原本独立的子操作父技能吸收的 flag对应原微技能/gsd-update--syncsync-skills跨运行时根同步已管理的 GSD 技能支持--from/--to/--dry-run/--apply/gsd-update--reapplyreapply-patches更新后用“原始基线、用户修改备份、新装版本”三方比对合并自定义修改/gsd-sketch--wrap-upsketch-wrap-up将草图设计发现打包为持久项目技能/gsd-spike--wrap-upspike-wrap-up将 spike 发现打包为持久项目技能/gsd-map-codebase--fast轻量扫描只派发一个 mapper agent 而非四个可选--focus tech/arch/quality/concerns/gsd-map-codebase--queryintel 查询模式query term、status、diff、refresh需intel.enabled: true/gsd-code-review--fixcode-review-fix评审完成后自动应用修复支持--all、--auto子 flag/gsd-progress--do ...do自由文本意图智能分发匹配后确认再转交/gsd-progress--nextnext自动推进到下一逻辑步骤支持--force、--auto、--converge几个值得展开的实现要点/gsd-update --reapply的三方比对机制commands/gsd/update.md 记载其基于“pristine baseline原始基线、user-modified backup用户修改备份、newly installed version新装版本”做三方合并把用户对 GSD 的自定义改动在升级后重新铺回对应工作流文件为 gsd-core/workflows/reapply-patches.md。/gsd-update --next/--rc不是进度推进注意区分/gsd-update的--next别名--rc是指向nextRC dist-tag如1.4.0-rc.1的发布通道选择与/gsd-progress --next的“推进工作流”语义完全不同。它们共存于不同父技能下互不冲突。/gsd-progress --next --converge当下一步是规划Route 3时可通过收敛循环plan-review convergence路由要求workflow.plan_review_convergencetrue用gsd config-set workflow.plan_review_convergence true开启并支持透传评审者 flag--codex、--claude、--opencode、--ollama、--lm-studio、--llama-cpp、--all与--max-cycles N。/gsd-map-codebase --fast的按需装载设计commands/gsd/map-codebase.md 特别注明--fast对应的scan.md工作流“故意不放进execution_context”这样常见的完整地图路径不会为其支付装载成本——这本身就是本次“削减 eager 开销”理念在单个命令内部的延续。/gsd-code-review --fix吸收gsd-code-review-fix在命名空间技能 commands/gsd/ns-review.md 中直接记载了迁移事实“gsd-code-review-fixwas absorbed bygsd-code-review --fixin #2790”。四、REQ-CONSOLIDATE-03/gsd-next的角色保留本次整合明确了一条重要边界/gsd-next不是被退休的工作流推进命令它被保留为state-aware smart-entry launcher状态感知的智能入口启动器。工作流推进workflow advancement统一收敛到/gsd-progress --next/gsd-next只做“入口/路由器”的角色读取项目与工作流状态通过gsd-tools smart-entry --json展示情境相关的下一步动作菜单并派发恰好一个既有 GSD 命令后停止它自己从不执行实际工作见 commands/gsd/next.md 与 gsd-core/workflows/smart-entry.md。这避免了两个命令在“下一步干什么”上的职责重叠/gsd-next回答“现在最该做什么”探测 菜单/gsd-progress --next回答“直接推进到下一逻辑步骤”状态机推进。五、REQ-CONSOLIDATE-04删除即删除不留影子存根整合的硬性约束是所有被删除微技能的裸斜杠形式bare slash forms例如gsd-add-todo gsd-add-backlog gsd-plant-seed gsd-check-todos gsd-add-phase gsd-insert-phase gsd-remove-phase gsd-edit-phase gsd-new-workspace gsd-list-workspaces gsd-remove-workspace gsd-settings-advanced gsd-settings-integrations gsd-set-profile gsd-sketch-wrap-up gsd-spike-wrap-up gsd-reapply-patches gsd-code-review-fix …必须解析为 “Unknown command”不允许存在任何 shadow stubs影子存根。从仓库结构看commands/gsd 目录的命令清单中已完全找不到上述文件名只有code-review.md而没有code-review-fix.md只有update.md而没有reapply-patches.md即“入口层面物理删除”。注意gsd-core/workflows 中仍保留code-review-fix.md、reapply-patches.md、add-phase.md、edit-phase.md等工作流文件——它们是分组命令在流程内部按需装载的执行体而不是对外暴露的斜杠命令入口。这正是“命令面收敛、执行面保留”的架构分层斜杠命令只作为唯一入口具体执行逻辑仍按工作流文件拆分。六、REQ-CONSOLIDATE-05autonomous 工作流的调用迁移整合要求autonomous.md自主执行剩余所有阶段改调/gsd-code-review --fix而不是已删除的gsd-code-review-fix。在 gsd-core/workflows/autonomous.md 中可以找到对应的实现证据工作流先从EXECUTE_POST_HOOKS_JSON解析kind step且ref.skill code-review的活动步骤钩子若没有活动的 code-review 步骤钩子则显示 “Code review skipped (code-review capability inactive)” 并继续覆盖workflow.code_reviewfalse且明确要求经由 Capability Registry 判断而非直接查询开关若存在则用注册表提供的技能主干进行分派Skill(skillgsd-code-review, args${PHASE_NUM} --fix --auto)注意这里使用注册表提供的 stem技能主干名而非硬编码别名分派参数直接携带--fix --auto——既印证了“gsd-code-review-fix被--fix吸收”的迁移也展示了整合后工作流层如何与 Capability Registry 协同避免再次引入对已删除技能的依赖。七、配套机制Skill Surface 与集群定义技能面整合并非孤立存在它与 GSD 的Skill Surface运行时技能面管理机制配套工作/gsd-surface允许在不重装的前提下按集群开关技能读写~/.claude/.gsd-surface.json并原地重排~/.claude/skills/gsd-*/技能目录见 commands/gsd/surface.md。集群的权威定义位于 src/clusters.cts源码中导出了 10 个命名集群core_loopnext、new-project、onboard、discuss-phase、plan-phase、execute-phase、help、updateaudit_reviewcode-review、review、audit-fix、audit-milestone、audit-uat、verify-work、validate-phase、plan-review-convergence、eval-review、add-tests、secure-phasemilestone、research_ideate、workspace_state含 capture、workspace、inbox、thread、workstreams 等、docs、ui、ai_eval、ns_meta、utility该文件在注释中说明集群成员允许重叠同一技能可属于多个集群所有集群的并集应覆盖每个已安装的技能主干未归类的主干会被surface-clusters.test.cjs标记——也就是说整合后的每个幸存命令都必须能找到归属集群这是保持技能面可管理性的前提。八、整合对使用者的迁移影响对使用 gsd-core 的开发者来说本次整合带来的是“少记多能”的体验变化记忆负担下降原先的 31 个近义微技能名收敛为 4 个分组父技能 9 个 flag--note、--backlog、--seed、--list、--insert、--remove、--edit、--advanced、--integrations、--profile以及 6 个既有父技能上的若干 flag行为不丢失每一个被吸收的操作都可通过父技能 flag 到达原工作流门禁gates原样保留旧入口立即失效任何仍在调用gsd-add-todo、gsd-code-review-fix等裸斜杠形式的外部脚本或文档都会得到 “Unknown command”需要同步迁移到分组形式职责边界清晰推进工作流用/gsd-progress --next智能入口用/gsd-next更新 RC 通道用/gsd-update --next三者不会互相混淆。结语Skill Surface Consolidation展示了 gsd-core 在“命令面瘦身”上的工程思路以分组父技能 flag 路由替代海量微技能以“删除即删除”保证命令面清洁以集群定义与 surface 机制维持技能的模块化管理以工作流文件保留执行逻辑的拆分。它用一次不破坏行为的重构同时改善了启动开销、命令记忆负担与技能面管理的可操作性——这正是 GSDGit. Ship. Done在“快速进入工作状态”这一核心体验上的又一次收敛。赞分享【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载相关推荐gsd-core 命令整合实录/gsd-reapply-patches 折叠为 /gsd-update --reapply 及其遗留引用清理PR 3012gsd core 命令整合实录 /gsd reapply patches 折叠为 /gsd update reapply 及其遗留引用清理PR 3012gsd-core /gsd:surface 命令深度解析免重装管理 Skill 表面Surface的 Profile、Cluster 与原子应用协议gsd core /gsd:surface 命令深度解析免重装管理 Skill 表面Surface的 Profile、Cluster 与原子应用协议 在深入解析Consolidation/Robo框架构建专业命令行应用的最佳实践深入解析Consolidation/Robo框架构建专业命令行应用的最佳实践 前言为什么需要现代化的PHP任务运行器 在PHP开发中你是否经常遇到这样的开发工具上一篇SandHook调试技巧解决Hook失效与兼容性问题的终极指南下一篇宝塔面板私有化部署终极指南打造专属的第三方云端方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考