SuperAPI AI 工具集

framework-config

通用与其它

查看项目

更新于 11-06 09:11

技能介绍

用途

framework-config 是 easy-claude 技能框架中的轻量级入口技能,用于回答框架相关问题并管理用户请求的配置项,让用户无需知道具体 JSON 键名即可完成设置。它本身不授权启动无关的重型技能、扫描或工作流。

主要能力

该技能提供三种模式:

  • help:命令与分类搜索、命令详情、任务推荐、框架用法。
  • settings:查看、解释、设置或重置框架偏好。
  • workflow:查看或设置工作流路由模式 ask/auto/off,包括仅会话级变更。

未指定标志时从自然语言推断模式;无参数时展示三种模式及若干常用选项。

使用方式

基本调用形式为 $framework-config [--mode=help|settings|workflow] <request> [options]。Codex 使用 $framework-config,OpenCode 使用其原生技能加载器。

help 模式运行 .claude/scripts/ck-help.py(Windows 上用 py -3),并遵循其 @CK_OUTPUT_TYPE 标记。settings 模式通过 .claude/scripts/framework-features.cjs、ck-config-help.cjs 等发现精确键名与当前行为。workflow 模式使用 node .claude/scripts/workflow-mode.cjs --show 展示生效模式与各层级。运行时机制使用平台中立的 Node CLI:node .claude/scripts/framework-mode.cjs show --json、quiet --scope=user、off --scope=checkout、on --scope=checkout、reset --scope=checkout、apply。

写入作用域:team 对应配置的项目配置,user 对应 ~/.claude/.ck.json,checkout 对应 .claude/.ck.local.json。写入前需验证 checkout 本地配置已被 git 忽略。保存前用 validateConfig 或 validateCkConfig 校验,保存后回读并再次解析生效值。

适用场景

  • 查询框架有哪些功能、当前开启状态以及如何修改。
  • 设置或重置框架运行时模式(on/quiet/off)。
  • 关闭或恢复重型技能的自动触发。
  • 调整决策支持模式(off/suggest/auto)。
  • 设置提交审查模式(如 lightweight)。
  • 查看或切换工作流路由模式。

限制

提问、show、explain、what can I configure 或无参数均为只读,不会转为配置编辑或命令执行。只有 set、enable、disable、change、reset 才授权对应的设置变更。应用配置与无关的产品/API 问题不属于本技能范围。不得猜测键名或静默替换为其他设置;不支持的选项需要解释而非编造 JSON。团队值写入项目配置,个人偏好只写入个人层,绝不写入受跟踪文件。原生设置需要新的 Claude/Codex 会话才能生效,已交付的上下文无法撤回。恢复注册表位于 ~/.claude/framework-runtime-projects.json,禁用期间不要删除。