Agent skill

entry-point-check

验证 VS 的 entry_points 字段是否与 SPEC_PRJ_ENTRYPOINTS（入口类型标签）一致，生成缺失入口清单和补充建议。当准备 CONSTRAINT 验收前使用。

View SKILL.md on GitHub Repository
Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/design/entry-point-check

SKILL.md

entry-point-check: 入口设计检查

描述

验证 VS 的 entry_points 字段是否与 SPEC_PRJ_ENTRYPOINTS（WEB_APP/API/JOB/CLI/LIB/MIXED/TBD）一致，生成缺失入口清单和补充建议。

适用场景

  • WORKFLOW_STEP_4 Task S4-2 Round 2：生成 VS 后
  • WEB_APP/API/JOB/CLI/LIB/MIXED 项目：忘记设计 entry_points
  • WORKFLOW_STEP_4 Task S4-5 前：准备 CONSTRAINT 验收前

输入

  • design/ 目录（所有 VS）
  • 入口类型标签（从 spec/spec_variables.md 读取 SPEC_PRJ_ENTRYPOINTS）

输出

  • Entry Point 检查报告（markdown）
  • 缺失入口清单（哪些 VS 缺少 entry_points）
  • 补充建议（建议添加哪些入口）

执行策略

  1. 读取 spec/spec_variables.md，获取 SPEC_PRJ_ENTRYPOINTS
  2. 扫描所有 VS，检查 entry_points 字段是否存在且结构化（至少包含 name 与 type）
    • 格式约束: 使用业务语言（如 "Dashboard entry"），不写 URL/路由/HTTP 端点字符串
  3. 基于 SPEC_PRJ_ENTRYPOINTS 做最小一致性检查（不做实现细节推断）：
    • 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 澄清
  4. 识别缺失入口或类型不匹配的 VS，并给出补充建议（基于 VS 的 value_path 推断入口语义）

价值

  • SPEC 组织：提前发现入口设计缺失，避免 CONSTRAINT 验收失败
  • PM/BA：确保设计完整
  • Dev：明确系统入口

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程（提交PR→自查→同行审查→反馈修改→合并），覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查（测试通过→覆盖率→Lint→GOAL追溯→可提交），验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环（RED→GREEN→REFACTOR→REPEAT），通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案（单体/微服务等），从SOLID原则、成本、复杂度等维度评分，生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节（数据库/API/通信协议），帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results