Skip to main content
ClaudeWave
ES, Spanish
Slash Command1.1k estrellas del repoactualizado 2mo ago

new-feature

新功能全流程(需求审问 → 设计 → 实现)

Instalar en Claude Code
Copiar
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/doccker/cc-use-exp/HEAD/.claude/commands/new-feature.md -o ~/.claude/commands/new-feature.md
Después abre una sesión nueva de Claude Code; el slash command carga automáticamente.

new-feature.md

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

一站式完成新功能开发,支持中断恢复。

## 输入

「$ARGUMENTS」— 功能描述,或 `--resume` 恢复未完成任务

## 任务文件

位置:`.claude/tasks/{功能名}-{日期}.md`
作用:持久化任务状态,支持中断恢复

## 流程

### 第 0 步:检查恢复

1. 检查 `.claude/tasks/` 目录(不含 archived 子目录)是否存在 .md 文件
2. 如果有未完成任务:
   - 列出任务文件名和状态
   - 询问:「检测到未完成任务 [任务名],是否继续?(Y/N)」
   - Y → 读取任务文件,从未完成步骤继续
   - N → 将旧任务移动到 archived,然后开始新任务
3. 如果没有未完成任务 → 进入第 1 步

### 第 1 步:需求审问

针对「$ARGUMENTS」,快速提出 3-5 个关键问题:
- 边界条件
- 异常处理
- 依赖关系

等待用户回答后继续。

### 第 2 步:技术设计 + 创建任务文件

基于回答,输出:
- 涉及文件(3-5 个)
- 数据结构(如有)
- 关键步骤(3-5 步)

**用户确认后**,创建任务文件 `.claude/tasks/{功能名}-{日期}.md`:

```markdown
# 任务:{功能名}
状态:进行中
创建:{时间}
更新:{时间}

## 需求摘要
- {一句话描述}

## 关键决策
- {决策1}
- {决策2}

## 实现计划
- [ ] 1. {步骤1}
- [ ] 2. {步骤2}
- [ ] 3. {步骤3}

## 已修改文件
(实现过程中更新)
```

### 第 3 步:实现 + 同步更新

按步骤实现,**每完成一个步骤**:

1. 更新任务文件:
   - 将已完成步骤标记为 `[x]`
   - 将当前步骤标记为 `[~]`(进行中)
   - 在「已修改文件」添加本步骤修改的文件
   - 更新「更新时间」
2. 报告进度
3. 继续下一步

### 第 4 步:自审 + 归档

1. 执行 `/review quick`
2. 更新任务文件状态为「已完成」
3. 将任务文件移动到 `.claude/tasks/archived/`

## 中断恢复说明

如果任务中断(网络断开、上下文超限、手动停止):
1. 下次执行 `/new-feature` 或 `/new-feature --resume` 会自动检测
2. 读取任务文件恢复上下文
3. 从未完成的步骤继续执行
api-design-safetySkill

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

api-proxy-safetySkill

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

async-task-patternSkill

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

bash-styleSkill

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

cc-api-contract-safetySkill

前后端接口契约安全规范,适用于接口新增或调整、联调、列表分页异常与临时兼容治理;用于避免响应结构漂移被前端兼容长期掩盖。

cc-api-design-safetySkill

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

cc-api-proxy-safetySkill

网关/代理/WAF/CDN 中间件响应判定与关键词匹配安全规范。适用于 proxy/gateway/waf/cdn/nginx/openresty/rewrite/redirect 等代码,防止把正常长正文中的 Cloudflare、502、bad gateway、error 等技术术语误判为上游错误。

cc-async-task-patternSkill

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