SKILL.md
entry-point-check: 入口设计检查
描述
验证 VS 的 entrypoints 字段是否与 SPECPRJENTRYPOINTS(WEBAPP/API/JOB/CLI/LIB/MIXED/TBD)一致,生成缺失入口清单和补充建议。
适用场景
- WORKFLOWSTEP4 Task S4-2 Round 2:生成 VS 后
- WEBAPP/API/JOB/CLI/LIB/MIXED 项目:忘记设计 entrypoints
- WORKFLOWSTEP4 Task S4-5 前:准备 CONSTRAINT 验收前
输入
- design/ 目录(所有 VS)
- 入口类型标签(从
spec/specvariables.md读取SPECPRJ_ENTRYPOINTS)
输出
- Entry Point 检查报告(markdown)
- 缺失入口清单(哪些 VS 缺少 entry_points)
- 补充建议(建议添加哪些入口)
执行策略
- 读取
spec/specvariables.md,获取SPECPRJ_ENTRYPOINTS - 扫描所有 VS,检查
entry_points字段是否存在且结构化(至少包含name与type)
- 格式约束: 使用业务语言(如 "Dashboard entry"),不写 URL/路由/HTTP 端点字符串
- 基于
SPECPRJENTRYPOINTS做最小一致性检查(不做实现细节推断):
- WEB_APP: 至少包含 1 个 type: UI 的入口 - API: 至少包含 1 个 type: API 的入口 - JOB: 至少包含 1 个 type: JOB 的入口(trigger 建议写调度触发方式) - CLI: 至少包含 1 个 type: CLI 的入口 - LIB: 至少包含 1 个 type: LIB 的入口(按“集成点/使用方式”描述) - MIXED: 同时满足实际存在的入口组合(例如 UI + API) - TBD: 标记为待确认并提示 HITL 澄清
- 识别缺失入口或类型不匹配的 VS,并给出补充建议(基于 VS 的
value_path推断入口语义)
价值
- SPEC 组织:提前发现入口设计缺失,避免 CONSTRAINT 验收失败
- PM/BA:确保设计完整
- Dev:明确系统入口