Feature Analyzer 用于在 MVP 构建流程中加载并分析某个功能的全部产物文档,构建完整的上下文理解,供后续操作使用。
用途 该技能面向下游操作前的上下文准备,加载完成后可用于任务执行(依据 tasks.md 实现)、清单生成(需求验证)、架构查询和技术指导。
主要能力
- 扫描:运行脚本 scripts/check-prerequisites.sh 检查功能目录中可用的产物,输出包含 AVAILABLE 与 MISSING 数组的 JSON;若缺少核心文件则报错退出。检查范围包括核心产物(spec.md、ux.md、plan.md、tasks.md)、数据产物(data-model.md、contracts/)、支持产物(research.md、setup.md)。
- 加载:按优先级读取所有可用产物。核心文档中,spec.md 提供需求(FR-XXX)、用户故事与验收标准;ux.md 提供用户流程、交互、状态与错误;plan.md 提供架构、组件与技术栈;tasks.md 提供实现阶段、TDD 周期与执行顺序。数据与契约包括 data-model.md(实体、校验、状态机)以及 contracts/(API、消息、schema,如 openapi.yaml、contracts.md)。支持文档包括 research.md(技术决策与理由)和 setup.md(环境、依赖、命令)。
- 构建心智模型:从各产物中提取关键信息,例如从 spec.md 提取主流程与目标、带编号的需求、测试场景、边界情况与约束;从 ux.md 提取完整流程与触发条件、状态与转换、错误处理模式;从 plan.md 提取代码结构(A/B/C/D 模式)、需求到组件的映射、技术约束;从 tasks.md 提取实现顺序、TDD 覆盖目标、文件创建路径与依赖;从 data-model.md 提取字段定义与规则、常量与限制、实体关系;从契约提取端点规范、消息格式与协议定义。
- 确认就绪:输出简短确认信息,列出已加载的产物,并标明可进入实现、清单或查询环节。
使用方式 在技能所在目录中执行 bash "<this skill's directory>/scripts/check-prerequisites.sh" <feature-directory> 完成扫描,随后按上述优先级读取产物并构建心智模型。上下文会在整个对话期间保留在内存中。
适用场景 适用于 MVP 构建中的功能上下文准备、依据任务文档的实现、需求验证清单生成、架构查询与技术指导等环节。
限制 缺失核心文件时会停止并报告缺失文件;内容格式异常时报告文件与解析错误;访问受限时报告权限问题。除此之外的更多能力与边界暂未提供。