SuperAPI AI 工具集

framework-config

通用与其它

查看项目

更新于 11-04 20:00

技能介绍

用途

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。