Cc New Feature

---
name: cc-new-feature
description: 结构化新功能交付工作流，适用于显式 new feature、从需求到实现的一站式功能开发或恢复未完成任务场景；通过项目内 .codex/tasks/ 持久化状态。
---

# New Feature

> **流程主权声明**：本技能是用户显式调用的完整工作流，拥有从需求到实现的全流程控制权。
> 禁止在本流程执行期间调用 `superpowers:brainstorming`、`superpowers:writing-plans` 或任何会接管设计/实现流程的外部 skill。
> 设计文档必须写入 `.codex/tasks/`，不得写入 `docs/superpowers/` 或其他路径。
> 本声明依据 superpowers 自身的优先级规则：用户显式指令 > superpowers skills。

当用户明确要求开发新功能、完整推进一个 feature，或提到 `new-feature`、恢复未完成任务时，使用本技能。

若用户当前只想补记需求、登记进展、标记“还没开始 / 被打断 / 稍后继续”，而不要求立即进入实现，优先使用 `cc-task-state`。

不要用于：

- 小范围 bug 修复
- 纯需求文档或纯设计文档
- 只做一次性代码评审

## 核心方式

1. 运行开始必须先在**当前项目根目录**确保 `.codex/tasks/` 与 `.codex/tasks/archived/` 存在；即使目录已存在，也必须先确认项目根目录写入动作可执行，不能因为“看起来已有骨架”就跳过创建/移动尝试；若目录缺失，必须先执行 `mkdir -p .codex/tasks/archived` 创建后再继续，不要把“目录不存在”直接判成“不可写”。
2. 再检查 `.codex/tasks/` 根目录，发现状态已是“已完成”的任务文件时，直接移动到 `.codex/tasks/archived/`。
3. 再检查 `.codex/tasks/` 是否已有未完成任务，检查时忽略 `archived/`；需要恢复时，优先续做而不是重复开题。
4. 验证当前会话对项目内 `.codex/tasks/` 具有写权限时，先基于已创建完成的目录判断；若 `mkdir -p .codex/tasks/archived` 命中权限边界，必须优先走平台审批提示。只有项目目录在目录已创建后仍确实不可写，才说明约束，并明确是否回退到 `~/.codex/tasks/` 继续持久化；禁止在未尝试项目根目录初始化前，直接以文本提示替代写入授权流程。
5. 在开工前先判断任务状态：若用户明确表示“还没开始”“先记一下”“等当前主线收尾再做”，则只创建或更新任务文件，并将状态标记为 `需求中` 或 `待开始`，不要误写为 `进行中`。
6. 确认准备进入实现时，再做 3-5 个关键澄清问题，补齐边界、异常和依赖。
7. 再产出实现范围、关键决策和步骤计划；方向明显不止一种时必须先确认。
8. 一旦确认进入实际实现，必须把当前主任务状态更新为 `进行中`；不要让显式开工的任务长期停留在 `待开始`。
9. 使用 `templates/task.md` 持久化任务状态；必须优先写入项目内 `.codex/tasks/`。若项目根目录下 `.codex/tasks/` 尚不存在，先尝试 `mkdir -p .codex/tasks/archived`；若该写入触发平台审批，则必须让用户授权后继续。只有项目目录在完成初始化后仍确认不可写，才允许回退到 `~/.codex/tasks/`。默认情况下，不把 `~/.codex/tasks/` 作为首选落点。
10. 按步骤实现，每完成一步就更新状态、已改文件和验证结果。
11. 完成后做一次 quick review 视角的自查，更新任务状态为“已完成”，再将任务文件移动到对应 `tasks/archived/`。

## 协作约束

- 需要需求深挖时，套用 `requirement` 的方式
- 需要技术设计时，套用 `design` 的方式
- 若当前只需沉淀任务状态、恢复入口或中断点，套用 `cc-task-state`
- 涉及接口新增或调整、前后端联调、列表页、分页或筛选页时，套用 `cc-api-contract-safety` 的方式
- 完成前自审时，套用 `cc-review` 的优先级
- 语言和框架细节交给对应语言 skills

## 输出要求

- 明确区分需求澄清、设计决定、实现步骤和验证结果
- 若当前信息不足以安全开工，先问关键问题
- 若用户当前没有要求开工，而只是登记或澄清需求，任务状态应保持在 `需求中` 或 `待开始`
- 若已经确认进入实现，必须把主任务状态切换为 `进行中`
- 任务文件始终与当前进度保持一致
- 若发生任务目录回退，必须明确说明“项目目录不可写”还是“仅缺目录且已自动创建”；禁止把“目录不存在”直接表述成“不可写”
- 若项目根目录下 `.codex/tasks/` / `.codex/tasks/archived/` 尚不存在，优先在项目根目录执行初始化；若当前会话没有该目录写权限，应让平台审批先接管，而不是直接文本化地回退到用户级目录
- 若当前项目已存在 `.codex/tasks/` 但任务文件仍无法写入，必须先确认是否真正执行了项目根目录写入动作；即使已有骨架，也不能跳过创建/移动步骤
- 同一时刻只应有一个主任务处于 `进行中`；若有其他候选功能，应保持在 `需求中`、`待开始` 或 `待恢复`
- 若存在接口或联调工作，任务文件需记录接口契约确认和临时兼容退出条件
- 完成后说明残余风险和后续建议

## 按需展开

- 恢复策略：`references/resume-policy.md`
- 编排方式：`references/orchestration.md`
- 任务模板：`templates/task.md`