用途
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 # 检查另一个项目
执行流程如下:
- 定位项目:ls ideas/[project-name]/
- 检查必需文件:README.md 是否包含状态、最后更新日期与进度;project-brief.md 的愿景、问题、受众与解决方案是否完整。
- 按阶段检查推荐文件:依据 README 中记录的项目阶段。
- 验证一致性:README 状态是否与 CLAUDE.md 匹配;brief 是否与 README 描述一致;specs 是否引用 features;issues 是否链接到 specs。
- 建议下一步:根据当前状态给出建议,例如仅有 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。
限制
资料未提供该技能的安装方式、依赖环境、支持的平台、收费模式或价格信息,暂未提供。