SuperAPI AI 工具集

validate-idea

办公与效率

查看项目

更新于 10-16 05:29

技能介绍

用途

validate-idea 用于对某个项目想法的文档结构与就绪度进行全面校验,判断其是否具备进入下一阶段的条件。它面向以文档驱动方式推进的项目,帮助使用者在开始规格编写、规划或实现之前发现文档缺口与不一致。

主要能力

该技能提供一份校验清单,分为必需文件与推荐文件两类。

必需文件(最小可行想法):

  • README.md:必需,用于记录状态、概览与进度。
  • project-brief.md:必需,用于记录愿景、问题、受众与解决方案。

推荐文件(按阶段而定):

  • critique.md:在规划前需要,用于风险评估。
  • competitive-analysis.md:在 MVP 前需要,用于市场定位。
  • specs/:在定义功能时使用,用于技术规格。
  • docs/adrs/:在做出重大技术决策时使用,即架构决策记录。
  • issues/:在开发过程中使用,用于工作跟踪。

阶段感知校验

技能会根据项目所处阶段调整校验标准:

概念阶段:README 与 project-brief.md 即可满足;critique.md 为可选,但建议在规划前完成。

规划阶段:应当具备 critique.md;应当具备 specs/ 或 features/。

开发/实现阶段:必须至少有一个 specs/;必须包含带 PLAN.md 文件的 issues/;若已做出重大决策,应当具备 docs/adrs/。

使用方式

通过命令调用,可指定具体项目名称:

/validate-idea coordinatr # 校验特定想法 /validate-idea yourbench # 检查另一个项目

执行流程如下:

  1. 定位项目:ls ideas/[project-name]/
  2. 检查必需文件:README.md 是否包含状态、最后更新日期与进度;project-brief.md 的愿景、问题、受众与解决方案是否完整。
  3. 按阶段检查推荐文件:依据 README 中记录的项目阶段。
  4. 验证一致性:README 状态是否与 CLAUDE.md 匹配;brief 是否与 README 描述一致;specs 是否引用 features;issues 是否链接到 specs。
  5. 建议下一步:根据当前状态给出建议,例如仅有 README 时运行 /brief;已有 brief 时运行 /critique;已有 critique 时运行 /research;已有 research 时运行 /spec;已有 specs 时运行 /plan + /issue。

校验报告

技能会输出一份校验报告,包含:状态(当前阶段与文档完整度 X/Y 文件)、必需文件检查结果、推荐文件检查结果、发现的问题、建议以及就绪度评估。就绪度评估会给出是否可进入 specs、是否可进入实现以及整体健康分。

就绪标准

可进入 /spec 的条件:project-brief.md 完整;critique.md 已存在;关键研究已完成。

可进入 /plan + /implement 的条件:至少一个 spec 完成;验收标准清晰;技术决策已做出。

适用场景

  • 开始规格工作之前
  • 项目长期暂停之后
  • 每月项目健康检查
  • 向相关方展示之前
  • 不确定下一步该做什么时

集成方式

推荐流程为:/validate-idea → 修复问题 → 再次 /validate-idea → /spec 或 /plan。

限制

资料未提供该技能的安装方式、依赖环境、支持的平台、收费模式或价格信息,暂未提供。