SuperAPI AI 工具集

setup-git-lite

编程与开发

查看项目

更新于 10-16 07:29

技能介绍

用途

setup-git-lite 用于管理 Claude Code 内置 includeGitInstructions 的 token 消耗。Claude Code 内置的 git 指令会在每次会话注入约 2,200 token(包含 git status 快照以及完整的 commit/PR 工作流说明)。本技能将其禁用,并注入一份约 280 token 的精简替代内容(11 条覆盖规则 + 带文件列表的紧凑 git 状态行),实现约 88% 的 token 缩减,同时保留 95% 以上的安全规则。其他风格/工作流指导被移除,因为 Claude 的训练数据已覆盖这些内容(例如 PR 标题约定、HEREDOC 格式意识、gh 用法)。

主要能力

技能通过子命令路由实现不同操作:

  • install:🔴 破坏性,仅限用户调用。修改 ~/.claude/settings.json 并在 shell profile 中追加标记块。需要显式 <command-name>claude-code-token-saver:setup-git-lite</command-name> 标签及 <command-args>install</command-args>。
  • revert:🔴 破坏性,仅限用户调用。执行激进清理,门控条件与 install 相同。
  • status:🟢 安全,允许 AI 调用。只读诊断。
  • dismiss-banner:🟢 安全,允许 AI 调用。通过 preferences.json 标志抑制推荐横幅。
  • undismiss-banner:🟢 安全,允许 AI 调用。重新启用横幅。
  • help:🟢 安全,允许 AI 调用。打印用法。
  • (空参数):🟢 安全,允许 AI 调用。运行 status,然后追加一行用法提示:“Subcommands: install, revert, status, dismiss-banner, undismiss-banner, help”。

使用方式

调用守卫仅对破坏性子命令(install、revert)强制执行:

  1. 验证显式调用:触发用户消息必须包含 <command-name>claude-code-token-saver:setup-git-lite</command-name> 以及 <command-args>install</command-args>(或 revert)。若缺少这些标签(即从自然语言上下文推断意图),则停止并提示用户显式输入 /setup-git-lite install(或 revert)。
  2. 执行前用户确认:即使标签存在,也需打印一行摘要并要求用户输入字面量“yes”确认。install 的摘要为:在 ~/.claude/settings.json 中设置 includeGitInstructions: false;在 shell profile 中追加标记块导出 CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1。仅当用户输入字面量“yes”时才继续,其他任何响应均取消。

安全子命令(status、dismiss-banner、undismiss-banner、help)完全跳过守卫。

通过守卫与确认后,执行:

node ${CLAUDE_PLUGIN_ROOT}/scripts/setup-git-lite.js <subcommand>

将 stdout 原样转发给用户;非零退出时展示 stderr。

语言方面:从对话中检测用户语言,将所有面向用户的输出翻译为该语言。脚本输出为英文,转发前必须翻译,但技术标识符(文件路径、环境变量名、命令名、设置键)保持原样。

输出约定:status 翻译 stdout 后转发;install 翻译 stdout 后附加一行指向 README 说明理由;revert 翻译 stdout 后提示“当前 shell 环境可能仍设置该变量——请重启 shell 或运行 unset CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS.”;dismiss/undismiss 翻译 stdout 后转发;help 翻译 stdout 后转发。

错误处理:退出码 1(一般错误)打印 stderr 并建议运行 status;退出码 2(未知子命令)展示脚本提示,不再继续。

适用场景

适用于使用 Claude Code 并希望降低每次会话与调用 token 消耗的用户,尤其是频繁使用 git 相关功能、关注上下文预算的场景。

限制

install 与 revert 会修改全局 Claude Code 设置和 shell profile,属于破坏性操作,仅限用户显式调用并需二次确认,AI 不得自行推断执行。revert 后当前 shell 环境可能仍保留变量,需重启 shell 或手动 unset。其他功能细节、收费与价格、支持平台等信息暂未提供。