peon-ping 会话重命名
为当前 Claude 会话自定义名称,显示在通知标题和终端标签页上。
该技能(peon-ping-rename)仅写入本地状态文件(.state.json)和修改终端标签页,不涉及敏感数据或外部副作用。但是,技能文档未明确说明写入的数据类型(仅提及会话ID和名称),也未提供删除或回滚机制(仅提到手动移除)。未发现恶意行为,但权限和确认机制描述不完整,存在未明确说明的写入操作。
技能描述清晰,提供了操作步骤和手动备用方案,但未提供自动化测试或关键路径的验证。执行环境(Claude Code 钩子)可能因版本差异而行为不同,可能影响可靠性。文档提到钩子可能失败,但未提供充分的错误反馈或调试信息。静态审阅无法实际运行,可靠性评分受限于此。
技能具有清晰的适用场景和触发条件(用户提出重命名请求时),且提供了重置功能。但未明确声明不适用的场景(如非Claude Code环境或自定义配置),也未提及中国的可访问性。考虑到该技能是本地操作,不依赖海外网络,故降分较少。
技能包含名称、描述、版本、许可证元数据,文档结构良好。但未提供变更日志、已知限制或维护责任说明。手动备用方案中的路径硬编码在~/.claude,可能与其他安装方式冲突。总体可读性良好,但版本管理和维护信息不完整。
该技能的核心功能(重命名会话)描述清晰,易于手动实现,但未提供直接的自动化验证证据。输出为命令行修改,可能受终端环境限制。边际价值有限,因为用户可以直接编辑状态文件,但技能提供了便捷的斜杠命令接口。静态审阅无法执行,只能依靠文档描述。
静态审阅无法验证技能的实际运行效果。文档描述了工作流程,但没有附带测试代码或CI对该技能的覆盖。相关CI工作流(release.yml)仅生成校验和,不包含测试。因此,关键声明缺乏可验证证据。
- 技能仅依赖文档描述,静态审阅无法执行验证,实际效果需在Claude Code中测试。
- 未提供回滚或删除机制,可能造成状态文件残留。
- 手动备用方案硬编码路径,可能与其他安装方式不一致。
- 发布者未经验证,身份信息有限,影响信任评估。
这个 Skill 能做什么,适合哪些场景?
该技能为当前 Claude Code 会话设置自定义名称,显示在桌面通知标题和终端标签页标题中。它通过 UserPromptSubmit 钩子拦截 /peon-ping-rename 命令,在 .state.json 中存储会话名称,并立即更新终端标签标题,且不消耗任何令牌。名称优先级高于其他自动检测方法,并可随时重置为自动检测。
当用户输入 /peon-ping-rename <名称> 时,该技能通过 UserPromptSubmit 钩子拦截命令,从 .state.json 中提取会话 ID 和名称,将 session_names[session_id] = name 写入 .state.json,并通过 ANSI 转义序列立即更新终端标签标题,且返回确认,不消耗令牌。它还支持手动回退,包括获取会话 ID、编辑 .state.json 以及触发钩子事件以刷新标签标题。
- 用户希望为当前 Claude Code 会话设置自定义名称,以清楚识别通知来源。
- 用户在同一仓库中运行多个会话,希望为每个会话设置不同的名称。
- 用户希望将终端标签标题设置为更有意义的名称,以区分不同的任务。
- 用户希望重置会话名称,恢复自动检测。
这个 Skill 有哪些优点和局限?
- 立即生效,且不消耗令牌。
- 名称显示在通知标题和终端标签页中,提高可识别性。
- 支持每个会话独立命名,便于多标签管理。
- 提供手动回退步骤,以防钩子失败。
- 专为 Claude Code 设计,可能不适用于其他 IDE。
- 需要安装整个 peon-ping 集合,无法单独使用该技能。
- 手动回退需要了解会话 ID 和编辑 JSON 文件,对不熟悉命令行的用户有门槛。
如何安装这个 Skill?
安装整个 peon-ping 集合,使用官方安装方式之一,例如 Homebrew: brew install PeonPing/tap/peon-ping,或运行 install.sh 脚本(macOS/Linux/WSL2),或使用 Windows 的 install.ps1。该技能(skills/peon-ping-rename/SKILL.md)将随安装放置。
如何使用这个 Skill?
在 Claude Code 会话中,输入 /peon-ping-rename 后跟所需的名称(例如 /peon-ping-rename Auth Refactor)以设置自定义名称。要重置为自动检测,请输入 /peon-ping-rename 不带任何参数。