studyzy 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: 询问优化等级
使用 AskUserQuestion 向用户呈现三个选项（单选）：
- 初级
- 初级 + 中级
- 全部（初级 + 中级 + 高级）
阶段 3: 筛选任务
按用户选择保留对应等级的任务集合：
- 初级 → 仅
[初级] - 初级+中级 →
[初级]+[中级] - 全部 →
[初级]+[中级]+[高级]
已勾选（- [x]）与 no-op 任务不进入执行队列（no-op 落盘 skipped）。
阶段 4: 按序路由派发
严格遵循 tasks.md 中的出现顺序，逐条派发到对应子 Agent。每条任务完成后，主 SKILL 等待子 Agent 回报结果，立即回写 tasks.md 状态，再处理下一条。
路由规则：按 operationType + target 匹配：
| operationType | target 匹配 | 子 Agent | 说明 |
|---|---|---|---|
install-tool |
— | @agents/install-tool.md |
执行 stk install 安装工具 |
disable-skill |
— | @agents/skill-opt.md |
修改 settings.json 禁用 Skill |
migrate-skill |
— | @agents/skill-opt.md |
修改 settings.json 迁移 Skill 作用域 |
disable-mcp |
— | @agents/mcp-opt.md |
修改 .mcp.json 禁用 MCP |
defer-mcp |
— | @agents/mcp-opt.md |
修改 .mcp.json 设置 defer_loading |
replace-mcp-with-cli |
tapd / mcp-server-tapd |
@agents/cli-replace-tapd.md |
安装 tapd-ai-cli + 禁用 TAPD MCP |
replace-mcp-with-cli |
gongfeng / gongfeng-mcp |
@agents/cli-replace-gongfeng.md |
安装 gongfeng-cli + 禁用工蜂 MCP |
replace-mcp-with-cli |
github / github-mcp |
@agents/cli-replace-gh.md |
安装 gh CLI + 禁用 GitHub MCP |
disable-plugin |
— | @agents/plugin-opt.md |
修改 settings.json 禁用 Plugin |
migrate-plugin |
— | @agents/plugin-opt.md |
修改 settings.json 迁移 Plugin 作用域 |
memory-md-review |
— | @agents/memory-md.md |
精简/优化指令主文件（CODEBUDDY.md / CLAUDE.md / AGENTS.md） |
rules-opt |
— | @agents/rules-opt.md |
修改 rules 配置 |
tool-opt |
codebuddy / claude（诊断 agentName） |
@agents/tool-opt.md |
收窄低频内置工具：CodeBuddy 建 cblite alias（Defer 延迟），Claude 写 permissions.deny（禁用，需用户确认） |
tool-opt平台限制：按诊断agentName分支——CodeBuddy 走cblitealias（--tools "Defer(...)"延迟加载），Claude Code 走~/.claude/settings.json的permissions.deny（禁用语义，仅落地用户明确确认不使用的工具）；CodeX 无此等价机制，遇到tool-opt任务时回报跳过并标注原因。 | 其他 | — |@agents/generic.md| 兜底，按 detail 描述执行 |
CLI 替代 Agent 说明：
replace-mcp-with-cli按target名匹配到对应 CLI 安装 Agent。这些 Agent 会先安装 CLI 工具、引导用户认证、再禁用对应 MCP。安装与禁用解耦：安装失败不影响禁用操作。
阶段 5: 回写任务状态
每条任务完成后立即回写 tasks.md，将该任务对应行的复选框置为已完成：
- 成功 / 已落地修改 →
- [x]（保留原有等级标签与描述）。 - 失败 →
- [x]外加注（如原因），或在原因行追加状态: 失败。 - no-op / 跳过 → 保持
- [ ]不变，或改为- [x]并在原因行标注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 跟踪的文件）时才先备份再改。
边界
- 单个任务失败：记录
failed并继续下一任务（整体流程可见）；如需遇错即停，执行前与用户确认。 - 本 SKILL 仅指导修改，不自动回滚；回滚依赖用户侧备份手动恢复。
- 支持
codebuddy/claude/codex平台（stk init/stk install --agent均生效）；memory-md任务按当前平台实际指令主文件（CODEBUDDY.md / CLAUDE.md / AGENTS.md）处理。 - 子 Agent 详细规则见
agents/目录下对应文件，按需读取。