SuperAPI AI 工具集

dotnet-mcaf-feature-spec

编程与开发

查看项目

更新于 10-16 00:05

技能介绍

用途:为新增或变更的非平凡行为编写可执行的功能规格文档,减少需求含糊导致的猜测,并为测试提供稳定的行为依据。触发场景包括:新增或修改非平凡行为、行为描述不充分、测试需要稳定的行为来源。不适用于需要权衡取舍的架构决策,以及无行为影响的微小改动。

主要能力:产出具体项目增量(代码、文档、配置、测试、CI 或评审产物);通过显式规划、验证与最终校验降低歧义;沉淀可复用的项目上下文。

使用方式:先阅读最近的 AGENTS.md 确认范围与约束;按 Ralph Loop 执行工作流——先头脑风暴(分析现状、定义问题与目标、约束与风险、生成选项并权衡),再制定详细执行计划并列出最终校验技能及顺序,然后逐步执行、评审、小批量修复并更新计划,直至结果可接受。若功能文档缺失,可基于 references/feature-template.md 搭建。规格需保持可执行:编号规则、主流程、边界与失败流程、系统行为、验证步骤。输入包括 docs/Architecture.md、最近的 AGENTS.md、当前用户流程与业务规则及验收预期。交付物为 docs/Features/feature-name.md。若功能引入新依赖、边界或重大策略变化,需同步更新 ADR。

结果格式:status(complete/clean/improved/configured/not_applicable/blocked)、plan、actions_taken、validation_skills、verification、remaining。仅配置类请求返回 status: configured 及后续命令。

限制:不用于架构选型;规则须可测试而非空泛;边界情况需覆盖;验证步骤须与预期行为一致;文档应能驱动实现而不依赖隐性知识。依赖缺失时可引导初始化,或返回 not_applicable 并说明原因与回退路径。