mcpField
S
settings-and-tuning

settings-and-tuning

github.com/terrylica其他1108 次安装1 天前更新
代码仓库

关于 settings-and-tuning

用于调整 TTS 引擎、Telegram 机器人及配套基础设施设置的技能，配置集中在 mise.toml。它提供选择、编辑、验证和应用配置变更的操作流程。

主要功能

  1. 01在 mise.toml 中集中配置
  2. 02调整 TTS 声音与语速
  3. 03调节超时和队列
  4. 04配置速率限制与熔断器
  5. 05调整会话与审计设置
  6. 06提供验证和重启指引

适用场景

  1. 01更改 TTS 声音或语速
  2. 02调整生成超时和队列限制
  3. 03设置通知或提示词执行节流
  4. 04更改会话限制或审计日志保留期

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill settings-and-tuning

安装后在 Claude Code 中输入/settings-and-tuning确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
config-reference.md
evolution-log.md
mise-toml-reference.md

详细介绍

设置与调优

配置 TTS 引擎、Telegram 机器人和支持基础设施的所有可调参数。所有设置都集中在 mise.toml 这一 SSoT 中。

平台：macOS（Apple Silicon）

自我改进技能：本技能会在使用过程中持续改进。如果说明有误、参数发生偏移或需要变通方案，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

何时使用此技能

  • 更改 TTS 语音（英语、中文或 macOS say 语音）
  • 调整语速
  • 调整 TTS 超时或队列深度
  • 配置通知速率限制或熔断器
  • 调整提示词执行器的节流设置
  • 修改会话选择器限制
  • 更改审计日志保留时间

要求

组件必需安装方式
mise是brew install mise（用于加载环境）
机器人运行中建议更改 TTS/队列设置后需要重启机器人

工作流阶段

阶段 0：读取当前配置

读取当前 mise.toml，查看所有生效的设置：

cat ~/.claude/automation/claude-telegram-sync/mise.toml

所有可配置值都位于 [env] 部分。此文件是整个技术栈的唯一事实来源。

阶段 1：确定要更改的内容

通过 AskUserQuestion 向用户展示配置组。配置组如下：

组设置描述
TTS 语音TTS_VOICE_EN、TTS_VOICE_ZH、TTS_VOICE_SAY_EN、TTS_VOICE_SAY_ZH按语言选择语音
TTS 速度TTS_SPEED语速倍率
TTS 超时TTS_GENERATE_TIMEOUT_MS、TTS_SAY_TIMEOUT_MS生成和播放超时
TTS 队列TTS_MAX_QUEUE_DEPTH、TTS_STALE_TTL_MS、TTS_MAX_TEXT_LEN队列限制和过期时间
TTS 信号TTS_SIGNAL_SOUND信号声音路径（留空则禁用）
速率限制NOTIFICATION_MIN_INTERVAL_MS、SUMMARIZER_*通知和摘要器节流
提示词执行器PROMPT_*提示词执行节流和熔断器
会话选择器SESSION_*会话扫描和显示限制
审计AUDIT_RETENTION_DAYS日志保留期限
模型HAIKU_MODEL用于 Agent SDK 调用的 Claude 模型
阶段 2：编辑配置

编辑 ~/.claude/automation/claude-telegram-sync/mise.toml 中相应的行。使用 Edit 工具精确修改特定值。

阶段 3：验证并应用
  1. 确认编辑后的值在有效范围内（参见配置参考）
  2. 如果更改了 TTS、队列或速率限制设置，请重启机器人：
# Option A: If using mise tasks
cd ~/.claude/automation/claude-telegram-sync && mise run bot:restart

# Option B: Manual restart
pkill -f "bun.*main.ts" && cd ~/.claude/automation/claude-telegram-sync && bun --watch run src/main.ts
  1. 通过检查机器人日志或测试受影响的功能，确认新设置已生效

TodoWrite 任务模板

模板：调整设置
1. [Read] Read current mise.toml configuration
2. [Identify] Present config groups to user via AskUserQuestion
3. [Select] User selects setting category to modify
4. [Edit] Update mise.toml with new values
5. [Validate] Verify values are in valid range
6. [Apply] Restart bot to apply changes (if TTS or queue settings changed)
7. [Verify] Confirm new settings are active

变更后检查清单

修改此技能后：

  1. 确认 SKILL.md 中的所有配置组都与当前的 mise.toml 一致
  2. 如果新增了环境变量，请更新 config-reference.md
  3. 测试机器人重启后，更改的设置是否生效
  4. 在 references/evolution-log.md 中更新变更说明

故障排除

问题原因解决方案
设置未生效机器人未重启修改 mise.toml 后重启机器人
mise.toml 解析错误TOML 语法无效检查是否缺少引号或存在未转义的字符
找不到语音语音名称无效检查语音目录（Kokoro 语音名称区分大小写）
速度过快／过慢值超出范围TTS_SPEED 使用 0.5 到 2.0 的范围
断路器卡在开启状态失败次数过多等待断路器超时，或重启机器人
超时时间过短首次运行时 TTS 生成较慢模型预热耗时较长；请增加超时时间

参考文档

  • 配置参考 - 包含所有环境变量、默认值、有效范围和组件归属的完整参考表
  • mise.toml 参考 - Hub／spoke mise 架构、密钥加载和任务文件结构
  • 演进日志 - 此技能的变更历史

执行后回顾

此技能完成后，请在结束任务前进行回顾：

  1. 确定文件位置。 — 编辑前，使用 Glob 搜索此技能的名称，找到此 SKILL.md 的规范路径。所有修正都针对此文件及其同级的 references/，绝不针对其他文档。
  2. 哪些地方失败了？ — 修复导致失败的指令。如果问题可能再次发生，请将其列为反模式。
  3. 哪些地方比预期更顺利？ — 将其提升为推荐实践，并说明原因。
  4. 哪些内容偏离了实际情况？ — 如果脚本、参考资料或外部依赖不再符合实际情况，请立即修正。
  5. 记录下来。 — 每项变更都要在演进日志中添加条目，记录触发原因、修复内容和证据。

不要推迟处理。下次调用时，你留下的内容将成为后续工作的基础。

评论

支持 Markdown