用途
framework-config 是 easyplatform 技能框架的轻量级入口技能,用于回答框架相关问题并管理用户请求的配置项,让用户无需了解具体 JSON 键名即可完成配置。它保持可被自动选中,即使重型技能自动触发被禁用时依然可用。它不授权无关的重型技能、扫描或工作流。
主要能力
该技能提供三种模式:
- help:命令/分类搜索、命令详情、任务推荐、框架用法。
- settings:显示、解释、设置或重置框架偏好。
- workflow:显示或设置工作流路由模式 ask/auto/off,包括仅会话级变更。
无参数时显示三种模式及若干常用选项。模式可由自然语言推断。
使用方式
调用形式为 $framework-config [--mode=help|settings|workflow] <request> [options]。Codex 使用 $framework-config;OpenCode 使用其原生技能加载器。
只读与写入的区分:提问、show、explain、what can I configure 或缺少参数均为只读操作,绝不会把提问或命令推荐变成配置编辑或执行该命令。set、enable、disable、change、reset 仅授权所请求的设置变更。
默认写入范围:settings 默认 checkout;workflow 模式对裸 ask/auto/off 选择默认 session。显式 --scope=session|checkout|user|team 优先;session 范围仅支持工作流路由。user 表示每个项目;team 表示配置的项目默认值。
帮助模式运行 .claude/scripts/ck-help.py(Windows 用 py -3),使用相关英文查询词(非英文搜索词需翻译)。配置/设置/选项/开关/环境变量查询使用 node .claude/scripts/ck-config-help.cjs。
工作流模式使用 node .claude/scripts/workflow-mode.cjs --show 显示生效模式与各层。优先级:default ask → team → user → checkout → environment → session directive。
设置模式通过技能配置,例如:
$framework-config --mode=settings show framework runtime
$framework-config --mode=settings quiet --scope=user
$framework-config --mode=settings off --scope=checkout
$framework-config --mode=settings on --scope=checkout
$framework-config --mode=settings reset framework runtime --scope=checkout
$framework-config --mode=settings apply framework runtime
$framework-config --mode=settings use lightweight commit reviews --scope=checkout
$framework-config --mode=settings choose commit reviews by risk --scope=user
$framework-config --mode=settings make <skill-name> explicit-only --scope=team
每行是独立请求,不是一起执行的设置序列。
运行时机制使用平台中立的 Node CLI:
node .claude/scripts/framework-mode.cjs show --json
node .claude/scripts/framework-mode.cjs quiet --scope=user
node .claude/scripts/framework-mode.cjs off --scope=checkout
node .claude/scripts/framework-mode.cjs on --scope=checkout
node .claude/scripts/framework-mode.cjs reset --scope=checkout
node .claude/scripts/framework-mode.cjs apply
运行时模式含义:on 为正常框架钩子;quiet 为不注入钩子指令、路由、账本或自动上下文准备,但提交审查、文档检查、格式化和通知保持活跃;off 为所有已发布框架钩子在解析输入或执行工作前返回,CLI 还会在 Claude 和 Codex 原生发现中禁用此 checkout 的框架技能;apply 在不改变偏好的情况下协调原生技能可见性;reset 仅移除此层的 frameworkRuntime.mode,暴露下一层。
适用场景
- 查询框架命令、分类或任务推荐。
- 查看、解释、设置或重置框架偏好(如运行时模式、技能自动触发、提交审查模式、工作流路由模式)。
- 将指定技能设为团队范围的 explicit-only。
- 切换框架运行时模式 on/quiet/off。
限制
- 应用配置及无关产品/API 问题不在本技能范围内。
- 项目事实使用配置的项目信息,不得从通用框架文档编造项目事实。
- 不得猜测键名或静默替换为其他设置;不支持的选项需要解释而非编造 JSON。
- 现有环境变量覆盖可能掩盖已保存的选择,需明确报告。
- 原生设置需要新的 Claude/Codex 会话;已交付的上下文无法撤回。
- 用户范围原生变更覆盖已注册的现有 checkout;每个新 checkout 在其镜像存在后需运行一次 apply。
- 较旧的框架副本必须先更新才能遵循此设置。
- 恢复注册表为 ~/.claude/framework-runtime-projects.json,禁用期间不要删除。
- 冲突的原生技能设置会在偏好保存前失败。
- 不要为消除拒绝而移除用户设置。
- 不要手动编辑生成的镜像。
- 团队范围的原生手动选择需合并到配置项目配置的 skillProfile.commandOnly 中,保留其预设和无关列表项;不要将此团队专用配置保存到个人运行时覆盖中。
- 验证使用
.claude/scripts/sync-skill-profile.cjs的 resolveProfile(root, candidate) 及团队 schema;验证抛错或 refusals 非空时不保存。 - 恢复与范围限制参见
.claude/docs/configuration/README.md#framework-runtime-mode。 - 验证原生发现与显式调用参见
.claude/docs/configuration/native-session-smoke.md。 - 保持 CLAUDE.md 和 AGENTS.md 仅用于项目;绝不要把框架模式通知或回退指令放入其中。
- 主机工具权限与仓库 Git/CI 钩子保持独立。
- OpenCode 目前仅接收钩子控制。
常见语言到设置的映射
- “Set framework runtime to on / quiet / off” → frameworkRuntime.mode: "on" / "quiet" / "off",默认 on。
- “Don't automatically start heavy skills” → portability.skillAutoTrigger: false。
- “Restore automatic skills” → portability.skillAutoTrigger: true,或按请求重置,默认 true。
- “Use lightweight commit reviews” → commit.reviewMode: "lightweight"。
- “Choose commit reviews by risk” → commit.reviewMode: "risk-based"。
- “Workflows should ask / recommend the full workflow first / only run explicitly” → portability.workflowRouteMode: "ask" / "auto" / "off"。
- “Make these skills explicit-only for the team” → 项目配置中的 skillProfile.commandOnly。
技能自动触发优先级:default → team → user → checkout → CK_SKILL_AUTO_TRIGGER。提交审查优先级:default lightweight → team → user → checkout → CK_COMMIT_REVIEW_MODE。