SuperAPI AI 工具集

feature

编程与开发

查看项目

更新于 10-15 08:13

技能介绍

用途

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 补全。
  • 具体收费、价格、平台支持等信息暂未提供。