SuperAPI AI 工具集

channel-management

智能体与模型

查看项目

更新于 10-16 02:37

技能介绍

用途:管理 Claude Code --channels 会话的完整生命周期,覆盖 Telegram 机器人、Discord 机器人或任意基于插件的频道集成。它封装 .claude/tools/cli/channel-manager.cjs 与 .claude/tools/cli/terminal-tracker.cjs,提供可重复、可观测的工作流。

主要能力:在新 Windows Terminal 标签页中启动频道会话;干净地停止运行中的会话;检查状态与 PID 存活;通过终端跟踪器做健康检查;清理崩溃后残留的孤立 PID 条目。

使用方式:调用 Skill({ skill: 'channel-management' })。典型流程为:先读取 .claude/context/memory/learnings.md 与 issues.md 中的已知问题;用 isChannelRunning() 与 getChannelPid() 判断是否已在运行;未运行时确认 TELEGRAM_BOT_TOKEN 后调用 startChannel();用 listTracked() 确认 PID 已注册;用 isChannelRunning() 与 listTracked() 做健康检查;需要时调用 stopChannel() 停止;崩溃后用 killOrphaned() 清理;最后把结果追加到 learnings.md。

适用场景:CHANNEL_AUTO_START=true 时在智能体启动阶段验证会话;用户或 cron 请求手动管理频道生命周期;会话疑似崩溃需重启;排查收不到 Telegram/Discord 消息;检查或清理孤立频道 PID。该技能是幂等的,会话已运行时再次调用为安全空操作。

限制与约束:启动前必须先检查 isChannelRunning(),不得假设被跟踪的 PID 存活,崩溃重启前必须先 killOrphaned()。启动需要 TELEGRAM_BOT_TOKEN,缺失时应记录并中止。相关环境变量包括 TELEGRAM_BOT_TOKEN(必需)、CHANNEL_AUTO_START(默认 false)、CHANNEL_PLUGINS(默认 plugin:telegram@claude-plugins-official)、CHANNEL_PERMISSIONS。输入输出分别由 schemas/input.schema.json 与 schemas/output.schema.json 约束,执行前钩子校验 action 枚举与启动时的令牌守卫。不要在紧循环中反复调用 startChannel(),不要仅凭跟踪文件判断存活,不要开启自动启动却不监控,子进程不得使用 shell: true。其他平台支持与收费信息暂未提供。