SuperAPI AI 工具集

gsd-surface

智能体与模型

查看项目

更新于 10-16 02:39

技能介绍

用途:gsd-surface 用于切换 GSD 中“被呈现”的技能集合,可在不重新安装的情况下应用配置档、列出状态或禁用某个技能集群。

主要能力:子命令包括 list、status、profile、disable、enable、reset。list 显示已启用与已禁用的集群和技能;status 在 list 基础上追加 token 成本摘要;profile <name> 写入 baseProfile 并重新暂存;profile <n1>,<n2> 支持逗号分隔的组合配置档;disable <cluster> 将集群加入 disabledClusters 并重新暂存;enable <cluster> 从 disabledClusters 移除;reset 删除 .gsd-surface.json,回到安装时配置档。无参数时按 list 处理。

使用方式:有效集群名为 core_loop、audit_review、milestone、research_ideate、workspace_state、docs、ui、ai_eval、ns_meta、utility。已知配置档为 core、standard、full。状态文件位于 ~/.claude/.gsd-surface.json,安装配置档标记为 ~/.claude/.gsd-profile,技能目录为 ~/.claude/skills/gsd-*/,引擎模块为 ~/.claude/gsd-core/bin/lib/surface.cjs。runtimeConfigDir 使用基础 Claude 配置目录(~/.claude),而非 skills 子目录;可通过 CLAUDE_CONFIG_DIR 环境变量覆盖。变更时先在内存中推导 surfaceState 并传给 applySurface 的 opts.surfaceState,不先调用 writeSurface;传 null 可重置为安装时配置档。

限制与错误处理:未知集群名会列出有效名称并退出且不写入;未知配置档名会列出已知配置档并退出;缺少 surface.cjs 时提示运行 npm i -g @opengsd/gsd-core 重新安装 GSD。