stk-optimize

# SKILL: stk-optimize 本 SKILL 指导 AI Agent 执行 `/stk-optimize`：读取分级待办清单，按用户选定的等级筛选，按 operationType 路由到对应子 Agent 逐项落地优化。 ## 前置条件 - `./save-token/tasks.md` 存在（由 `/stk-analyze` 生成）。 - 若缺失：提示用户先运行 `/stk-analyze`，停止。不要凭空生成任务。 ## 执行流程 ### 阶段 1: 读取并解析 tasks.md 读取 `./save-token/tasks.md`，识别每条任务： - 复选框：`- [ ]`（未完成）/ `- [x]`（已完成，可跳过）。 - 编号：`- [ ]` 与等级标签之间的 `<N.M>`（如 `1.1`），为用户可见的全局唯一编号，可用于向用户引用/指定任务。 - 等级标签：`[初级]` / `[中级]` / `[高级]`，位于编号之后。 - 动作描述：等级标签后的文本（如"禁用 skill: ponytail-help"、"启用 Headroom"）。 - 原因：缩进两空格的 `原因：` 行。 - no-op 识别：描述以"保持/保留/当前配置"开头且预估节省为 0 → 标记 `skipped`，不执行任何修改。 ### 阶段 2: 展示清单并让用户选择执行哪些任务（任务级选择） 解析完成后，先在对话中展示完整任务清单（编号 + 等级 + 动作描述 + 预估节省），随后 **MUST** 用 `AskUserQuestion` 询问「本次执行哪些任务？」： - 选项（单选）： 1. **全部（推荐）** 2. **仅初级** 3. **初级 + 中级** - 自由输入：用户可在 Other 中直接输入编号清单圈定任意子集（如 `1.1, 2.3, 3.1`）。 **硬性约束**：用户未显式回答前，**不得执行任何任务、不得修改任何文件**。默认推荐项仅为降低操作成本，绝不代替确认。 ### 阶段 3: 确定执行集合 按用户回答确定任务集合： - 全部 → 所有未完成、非 no-op 任务 - 仅初级 → 所有 `[初级]` 任务 - 初级 + 中级 → 所有 `[初级]` + `[中级]` 任务 - 编号清单 → 精确匹配编号的任务（编号不存在时提示并请用户更正，不猜测） 已勾选（`- [x]`）任务不进入执行队列；用户圈定集合外的任务保持 `- [ ]` 不变（留待下次执行）。no-op 任务不进入执行队列（no-op 落盘 `skipped`）。 ### 阶段 4: 按序路由派发 严格遵循 `tasks.md` 中的出现顺序，逐条派发到对应子 Agent。每条任务完成后，主 SKILL 等待子 Agent 回报结果，立即回写 `tasks.md` 状态，再处理下一条。 **路由规则**：按 `operationType` + `target` 匹配。本表仅指向**本阶段（stk-optimize）**的 agents，一律使用相对于本 SKILL.md 的锚定路径 `../stk-optimize/agents/`；**禁止**引用 stk-analyze 下的同名 agent（两者语义相反：analyze 只产建议 JSON，optimize 直接改配置）。 | operationType | target 匹配 | 子 Agent | 说明 | | -------------------------- | ---------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | `install-toolkit` | — | `../stk-optimize/agents/install-toolkit.md` | 执行 `stk install` 安装工具 | | `disable-skill` | — | `../stk-optimize/agents/skill-opt.md` | 改 Skill 自身 frontmatter/移除文件（**非** settings.json，Skill 不受 `enabledPlugins` 控制） | | `migrate-skill` | — | `../stk-optimize/agents/skill-opt.md` | 移动 Skill 目录（user↔project 作用域迁移） | | `disable-model-invocation` | — | `../stk-optimize/agents/skill-opt.md` | 加 `disable-model-invocation: true`，改为仅斜杠调用 | | `skill-model-downgrade` | — | `../stk-optimize/agents/skill-opt.md` | 加 `context: fork` + 平台合法的便宜模型名（CodeBuddy/WorkBuddy `lite`、Claude Code `haiku`） | | `disable-mcp` | — | `../stk-optimize/agents/mcp-opt.md` | 修改 .mcp.json 禁用 MCP | | `defer-mcp` | — | `../stk-optimize/agents/mcp-opt.md` | 修改 .mcp.json 设置 defer_loading | | `replace-mcp-with-cli` | `tapd` / `mcp-server-tapd` | `../stk-optimize/agents/cli-replace-tapd.md` | 安装 tapd-ai-cli + 禁用 TAPD MCP | | `replace-mcp-with-cli` | `gongfeng` / `gongfeng-mcp` | `../stk-optimize/agents/cli-replace-gongfeng.md` | 安装 gongfeng-cli + 禁用工蜂 MCP | | `replace-mcp-with-cli` | `github` / `github-mcp` | `../stk-optimize/agents/cli-replace-gh.md` | 安装 gh CLI + 禁用 GitHub MCP | | `disable-plugin` | — | `../stk-optimize/agents/plugin-opt.md` | 修改 settings.json 禁用 Plugin | | `migrate-plugin` | — | `../stk-optimize/agents/plugin-opt.md` | 修改 settings.json 迁移 Plugin 作用域 | | `memory-md-review` | — | `../stk-optimize/agents/memory-md.md` | 精简/优化指令主文件（CODEBUDDY.md / CLAUDE.md / AGENTS.md） | | `rules-opt` | — | `../stk-optimize/agents/rules-opt.md` | 修改 rules 配置 | | `tool-opt` | `codebuddy` / `claude`（诊断 agentName） | `../stk-optimize/agents/tool-opt.md` | 收窄低频内置工具：CodeBuddy 建 cblite alias（Top 20 常驻、其余 Defer 延迟），Claude 写 permissions.deny（禁用，需用户确认） | | 其他 | — | `../stk-optimize/agents/generic.md` | 兜底，按 detail 描述执行 | > **`tool-opt` 平台限制**：按诊断 `agentName` 分支——**CodeBuddy** 走 `cblite` alias（`--tools "Defer(...)"` 延迟加载），**Claude Code** 走 `~/.claude/settings.json` 的 `permissions.deny`（禁用语义，仅落地用户明确确认不使用的工具）；**CodeX 无此等价机制**，遇到 `tool-opt` 任务时回报跳过并标注原因。 > **CLI 替代 Agent 说明**：`replace-mcp-with-cli` 按 `target` 名匹配到对应 CLI 安装 Agent。这些 Agent 会先安装 CLI 工具、引导用户认证、再禁用对应 MCP。安装与禁用解耦：安装失败不影响禁用操作。 ### 阶段 5: 回写任务状态 每条任务完成后**立即**回写 `tasks.md`，将该任务对应行的复选框置为已完成： - 成功 / 已落地修改 → `- [x]`（保留原有等级标签与描述）。 - **失败 → 保持 `- [ ]` 不变**，并在该行后追加一行 `⚠️ 失败：<原因>`。**禁止**把失败任务勾为 `- [x]`——`/stk` 依据勾选状态推导流水线阶段，失败任务被勾选会让 tasks.md 看起来"全部完成"，从而误判进入报告阶段，产出"节省为 0"的误导性报告。 - no-op / 跳过 → 保持 `- [ ]` 不变，并在原因行标注 `skipped`。 **每完成一条就改一条，不要等全部结束再批量更新。** ### 阶段 6: 输出执行摘要 所有任务完成后，向用户输出执行摘要： - 全部成功：`共 N 条任务全部完成，预计节省 ~XXXXX Token` - 部分失败：`成功 X 条 / 失败 Y 条 / 共 N 条`，列出失败任务 ID 和原因 ## 子 Agent 派发规范 每个子 Agent 接收单条任务上下文： ``` operationType: "<type>" target: "<target>" title: "<title>" detail: "<detail>" id: "<task id>" ``` 子 Agent 直接执行系统修改，回报结果给主 SKILL。不产出中间 JSON 文件。 > 本 SKILL 操作对象均为当前 Git 仓库内的受版本管理文件，**无需手动备份，直接修改即可**——误改可由 `git checkout` / `git restore` 还原。仅当任务明确指向仓库外用户配置（如 `~/.codebuddy/settings.json`、`.mcp.json` 等脱离 Git 跟踪的文件）时才先备份再改，备份到 `~/.save-token-kit-backup/`。 > > ⚠️ **平台路径按诊断 `agentName` 选择，勿写死 `~/.codebuddy`**：各子 Agent 均在开头给出平台路径表，执行前必须替换为 `codebuddy`/`workbuddy`/`claude`/`codex` 对应的 `~/.<agent>/` 目录，避免误改其他 Agent 的配置。 ## 边界 - 单个任务失败：记录 `failed` 并继续下一任务（整体流程可见）；如需遇错即停，执行前与用户确认。 - 本 SKILL 仅指导修改，不自动回滚；回滚依赖用户侧备份手动恢复。 - 支持 `codebuddy`/`claude`/`codex` 平台（`stk init`/`stk install --agent` 均生效）；`memory-md` 任务按当前平台实际指令主文件（CODEBUDDY.md / CLAUDE.md / AGENTS.md）处理。 - 子 Agent 详细规则见 `agents/` 目录下对应文件，按需读取。