- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add dongshuyan/compass-skills --skill manage-title -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add dongshuyan/compass-skills --skill manage-title -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add dongshuyan/compass-skills --skill manage-title -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add dongshuyan/compass-skills --skill manage-title -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/dongshuyan/compass-skills/tree/HEAD/plugins/clarity-session-titles/skills/manage-title來自發布者
本 Skill 随 Codex 插件安装。参考并改编自 panda-z519/agent-session-titles 的 manage-session-title;许可见插件 LICENSES/agent-session-titles.txt。
本 Skill 依赖同一插件中的 scripts/title_runtime.py、Hooks 和安装记录。若它被单独复制到普通 Skill 目录、配套脚本缺失,保留标题,在本会话首次遇到时说明一次:需要从 dongshuyan/compass-skills 使用 scripts/title_plugin.py 安装完整插件。不要自行安装、创建状态或尝试其他改名方式。metadata.internal 用于让通用 skills CLI 默认跳过此内部 Skill,不影响 Codex 加载完整插件。
安装范围由脚本检查:共享包使用安装时固定的全局状态位置;普通包使用当前 CODEX_HOME/agent-clarity/。没有已启用的全局安装时,再检查当前 Git 根目录的项目安装。共享安装的启用记录和标题保护不会因切换 Codex/Harbor 账户而改变。没有启用记录时直接继续用户任务,不自行安装或启用。只管理调用者自己的会话,不能选择别的会话 ID。
全局模式覆盖各目录的新会话和继续对话的已有会话,也支持非 Git 目录及用户分叉;不批量处理未继续的历史会话,不处理内部子代理。项目模式继续只接管启用后新建的根会话。
明确初始需求后尽早更新;阶段或具体进展明显变化时再更新;每轮最终回复前按真实状态核对一次(标题仍准确也调用一次,脚本不会重复写入)。简短问答、没有其他工具调用的回合也要执行。不需要用户每次要求改名,不向用户汇报后台改名过程。
格式固定为 状态|初始需求|当前进展:
验证手动改名保护 比 正在验证 更有信息。两个描述段各尽量控制在 6–18 个中文字符,硬上限各 28 字符;不塞入路径、项目名前缀或枝节,不用分隔符或换行。格式示例:验证中|会话标题自动化|检查手动改名保护。
使用执行工具调用本 Skill 所属插件的 scripts/title_runtime.py。从本文件位置向上两级即插件根目录;使用其绝对路径,不能假设源仓库还在原位置。默认自动选择已启用的全局或项目范围:
python3 "/插件实际安装路径/scripts/title_runtime.py" set --topic "初始需求" --status "验证中" --progress "当前进展"
脚本读取当前 CODEX_THREAD_ID,通过 Codex API 检查调用目录、会话来源和启用范围,再实际改名并回读。首次接管已有三段式标题时保留中间的初始需求。需要显式选择时使用 --global 或 --project "/当前 Git 根目录",放在 set 前。
用户手动改过哪一段,就保留那一段;其他段继续自动更新。无法可靠拆成三段的外部名称会整体保留,返回 paused。返回 disabled、out_of_scope、pending 或出错时保留标题并继续用户任务;不要反复重试、访问数据库或修改全局配置。
在已启用 Agent Clarity 标题插件的范围内,每轮结束前维护“状态|初始需求|当前进展”。支持跨 Codex/Harbor 账户的共享安装、账户全局或指定项目,简短问答也要核对。
---name: manage-titledescription: 在已启用 Agent Clarity 标题插件的范围内,每轮结束前维护“状态|初始需求|当前进展”。支持跨 Codex/Harbor 账户的共享安装、账户全局或指定项目,简短问答也要核对。---# plugins/clarity-session-titles/skills/manage-title/SKILL.md常見問題
從發布者下載 plugins/clarity-session-titles/skills/manage-title/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/dongshuyan/compass-skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。