Skip to content
cccskills
FreePublished on GitHub

cc-task-state

任务状态沉淀与恢复工作流,适用于补记进展、记录未开始需求、标记被打断或阻塞、整理恢复入口与下一步场景;通过项目内 .codex/tasks/ 持久化任务状态。

The English summary is being prepared. Showing the original description.

See how to install

Files included (4)

  • SKILL.md3.1 KB
  • agents/openai.yaml804 B
  • references/capture-rules.md1.3 KB
  • references/state-model.md1018 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

CC Task State

当用户明确要求记录当前进展、补记需求、说明“还没开始/先记一下/被 fix 打断/稍后继续”、整理恢复入口,或需要把自然语言进展沉淀为项目任务状态时,使用本技能。

不要用于:

  • 直接实现完整 feature
  • 代替 bug 修复或 debug
  • 只做配置状态诊断

核心方式

  1. 先确认当前项目根目录的 .codex/tasks/ 与 .codex/tasks/archived/ 可用;目录缺失时优先初始化,不把“缺目录”直接当成“不可写”。
  2. 即使目录已存在,也必须先确认当前会话对项目根目录的写入动作可执行;不能因为“看起来已有骨架”就跳过项目内写入检查。
  3. 若项目内初始化或任务写入命中权限边界,优先走平台原生审批提示;只有项目目录在审批后仍确实不可写,才说明约束,并明确是否回退到 ~/.codex/tasks/ 继续持久化。
  4. 识别用户消息中的任务主体;一段话里有多个任务时,必须拆成多条任务状态,而不是混写成一条。
  5. 对每个任务判断状态:需求中、待开始、进行中、被打断、阻塞中、待恢复、已完成、已取消。
  6. 若当前已有主线任务,再出现短期插入的 fix 或调查,优先在主线任务的“中断记录”中补 checkpoint;只有范围独立、可能跨多轮的插入任务才单独建任务文件。
  7. 用户明确说“还没开始”“先别写代码”“等主线收尾再做”时,只能落为 需求中 或 待开始,不能误写成 进行中。
  8. 更新任务文件时,至少补齐“当前结论”“未开始 / 被打断 / 阻塞原因”“恢复入口”“下一步”中的相关字段,避免只写一句状态。
  9. 若任务已结束,更新状态后移动到 .codex/tasks/archived/;不要让已完成或已取消任务长期留在根目录。

协作约束

  • 需要完整实现 feature 时,转交 new-feature
  • 需要修 bug 或 debug 时,转交 fix
  • 需要查看任务盘点或配置状态时,转交 cc-status
  • 涉及接口新增、分页、筛选、详情或响应格式判断时,遵循 cc-api-contract-safety

输出要求

  • 明确列出识别出的任务主体和对应状态
  • 明确区分“当前主线”“候选任务”“插入任务”
  • 若用户一句话包含多个任务,必须拆开说明,不合并成模糊总结
  • 说明本次是“新建任务 / 更新任务 / 归档任务 / 只补 checkpoint”中的哪一种
  • 若发生任务目录回退,必须明确说明是“目录缺失已初始化”“项目目录确实不可写”还是“当前会话受限导致写入被拦截”
  • 若当前信息不足以判断状态,先说明缺口,不臆测已经开工

按需展开

  • 状态模型:references/state-model.md
  • 抽取规则:references/capture-rules.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

当设计或修改 REST API 响应结构、处理 API 返回值时触发。防止 API 设计缺陷导致的字段错位、类型歧义等问题。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

Bash 脚本与系统命令规范。禁止行尾注释,强制使用 tee/heredoc 写入,提升命令执行的可维护性。

The English summary is being prepared. Showing the original description.

doccker/cc-use-exp1.1KUpdated Aug 26, 2026

See all skills by doccker

Report a problem with this skill