用途
feature 用于在已有 keel 项目中追加或迭代功能,确保编号延续、文档一致。它适合已经存在 keel 文档目录(docs/devdocs/)并希望以规范化流程扩展功能的场景。修复缺陷应使用 bugfix,新项目应使用 /pipeline init,已有代码但无文档应使用 /retrofit。
主要能力
- 自动扫描现有文档,获取需求、任务等最大编号,保证新增编号不重复。
- 根据需求描述的影响面自动推荐运行模式:轻量模式、完整模式或深度模式。
- 轻量模式仅更新 01-requirements.md 和 04-dev-tasks.md,不新建功能点,仅追加验收标准到现有功能。
- 完整模式分步编排:Step 0 扫描编号与架构摘要,Step 1 需求追加,Step 2 设计追加,Step 3 测试追加,Step 4 任务追加,Step 4.5 就绪检查,Step 5 生成功能日志,Step 6 可选衔接开发工作流。
- 深度模式在开发衔接时自动附加 --review,开发完成后自动执行 /verify --docs 进行文档层间对齐。
- 支持 realign 模式:/feature F-XX realign 只对齐指定功能关联产物。
- 作为子 Agent 运行时返回结构化摘要,包含状态、模式、步骤、新增编号列表和推荐下一步。
使用方式
最常见用法:/feature "功能描述",自动选择档位。也可强制指定档位或减少确认。
模式选择示例:
- /feature "功能描述" → 自动检测模式(Lite/Standard/Deep)
- /feature F-XX realign → 只对齐 F-XX 关联产物
前置条件:已存在 keel 文档目录 docs/devdocs/,且存在 01-requirements.md 或 00-baseline.md。若只有 00-baseline.md 而无 01-requirements.md(基线项目),本技能会创建 01-requirements.md,F-001 从这个新需求起,存量代码不编号。若两者都不存在,建议新项目走 /requirements,已有代码无文档走 /retrofit。
适用场景
- 在已有 keel 项目中添加新功能、追加需求、扩展现有功能。
- 需要延续编号并保持需求、设计、测试、任务文档一致。
- 需要按影响面自动选择轻量、完整或深度流程。
- 需要分步确认、逐步推进的增量开发编排。
限制
- 文档阶段(Step 0-5)不得产出实现代码,需要编码时必须通过 Step 6 衔接 /dev-workflow。
- 轻量模式跳过 02 系统设计和 03 测试用例文档更新,追溯链不完整,用户确认时会显示警告。
- 轻量模式不新建 F-XXX,仅追加 AC 到现有功能;检测到架构影响时必须提示用户。
- 完整模式 Step 1-4、Step 4.5、Step 6 必须通过 Task tool 启动子 Agent,步骤间只传递 YAML 摘要和编号列表。
- 深度模式检测到 Deep 信号时必须提示用户确认模式选择。
- 修改现有接口必须说明向后兼容性,必须列出回归风险点,高影响变更需用户确认。
- 大规模功能(超过 3 个功能点)建议按模块拆分为多次迭代。
- 文档结构不完整时提示缺失文档,建议 /retrofit 补全。
- 具体收费、价格、平台支持等信息暂未提供。