Codex Title Curator Skill 技能

Codex Title Curator：让任务标题跟上会话的实际内容

产品简介

Codex Title Curator 是一款社区开发的 Codex Skill，专注于解决 Codex 会话管理中的核心体验问题：用 Codex 聊了很久已经聊到具体目标了，任务列表里的标题却还停留在开头那句「帮我看看」。任务一多，就很难通过标题快速找到之前的工作。Codex Title Curator 会结合原始需求和近期会话内容，自动重新概括任务标题，让每次回头找资料都能一击必中。

核心能力（≥5条）

• 智能标题重写：分析任务的首次需求描述和最近活跃内容，判断原标题是否已过时，自动生成能反映真实讨论主题的新标题
• 保留有效标题：对于已经足够清晰的用户指定标题、可识别外部改名、或已经是好标题的任务，不做修改，避免误伤
• 本地 SQLite 枚举：通过本地数据库读取未归档的主任务列表，不处理子代理、运行中任务和巡检类任务，保护用户隐私
• 空闲触发机制：支持 macOS 键盘鼠标活动检测，电脑闲置至少 15 分钟后启动整理，每小时最多运行一次，完成后安静退出不打扰用户
• 回退记录保留：每次修改前记录旧标题到仓库外状态目录，支持手动回退，用户可随时撤销最近的修改
• 多系统兼容：macOS 有内置空闲检测；其他操作系统在具备任务管理工具时可手动触发或自定义调度

安装配置（≥3条）

前置依赖：

• Codex 桌面会话（提供任务列表读取、会话读取和标题修改工具）
• Node.js（使用 skills CLI 安装时需要）
• Python 3.9+（使用辅助脚本时需要）

安装步骤（CLI 方式）：

1. 确认已安装 Node.js，在终端运行 npx skills add chrispinkyang/codex-title-curator --agent codex --skill codex-title-curator --global
2. 打开 Codex 桌面应用，确认会话列表和标题修改工具可用
3. 在 Codex 中输入：使用 $codex-title-curator，检查最近 30 天活跃任务的标题，先列出建议，不要修改
4. 确认效果和工具可用性后，再决定是否开启自动化后台维护

安装步骤（Git 方式）：

1. 运行 mkdir -p ~/.agents/skills && git clone https://github.com/chrispinkyang/codex-title-curator.git ~/.agents/skills/codex-title-curator
2. 重启 Codex 桌面会话，在新会话中确认 skill 加载成功
3. 第一次使用建议先触发一次检查，确认标题整理效果符合预期

使用步骤（≥4步）

1. 检查任务标题：在 Codex 中输入「使用 $codex-title-curator，检查最近 30 天活跃任务的标题，先列出建议，不要修改」，查看系统推荐的标题更新列表
2. 确认整理：确认建议的标题都能准确反映对应会话的实际内容后，输入「使用 $codex-title-curator，整理最近 30 天活跃任务的标题」，执行实际修改
3. 开启自动化后台维护（可选）：输入「使用 $codex-title-curator，每天在电脑闲置时整理一次任务标题，成功不要通知我，我回来时看到更新就好」，开启每日自动整理
4. 查看整理记录：修改完成后，前往 $CODEX_HOME/title-curator/（未设置时为 ~/.codex/title-curator/）查看新旧标题对照日志
5. 手动回退：若发现某次整理结果不理想，从日志中查找旧标题，通过 Codex 手动恢复或联系维护者反馈问题

适用场景（≥4个）

• 每天使用 Codex 处理多个开发任务，任务列表超过 20 个，靠旧标题找不到之前的会话
• 习惯一个会话聊很久，开始聊的是一个需求，聊到结尾已经变成了另一个需求，但标题没更新
• Codex 作为长期项目工具使用，需要通过有意义的标题做会话检索和归档
• 团队或个人用 Codex 做知识积累，希望任务列表本身就是一个可搜索的知识索引
• 想开启自动整理但不希望整理过程打扰正常工作节奏

适用人群

Codex 深度用户，尤其是每天与 Codex 进行多个并行任务的软件开发者、技术管理者和 AI 工具爱好者。也适用于将 Codex 作为个人知识管理和工作流工具的知识工作者群体。

工作原理

Codex Title Curator 由 Python 辅助脚本和 SKILL.md 定义文件组成。Python 脚本负责任务枚举、空闲检测、定时调度和数据库访问；标题的实际判断和改写由 Codex 模型结合上下文完成，脚本只负责提供候选列表和进度状态。状态文件（包含新旧标题对照）存储在 $CODEX_HOME/title-curator/ 目录下，不会被提交到仓库。所有会话内容仍由当前 Codex 会话处理，遵循用户的产品数据隐私设置。

官方链接

• GitHub 仓库：https://github.com/chrispinkyang/codex-title-curator
• SKILL.md 规则定义：仓库内 SKILL.md 文件
• 反馈渠道：GitHub Issues（请附上操作系统、Codex 版本和经过改写的虚构示例，不要上传真实会话内容）