用途
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,禁用期间不要删除。