apitestspec-surface-scan

Scan backend source code to identify HTTP API endpoints and export Markdown or JSON documentation.

5|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/winhok/testkit --skill apitestspec-surface-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apitestspec-surface-scan
Source: https://github.com/winhok/testkit/tree/main/skills/apitestspec-surface-scan
Command: npx skills add https://github.com/winhok/testkit --skill apitestspec-surface-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

从后端源码中快速识别并清单化 HTTP API 接口,帮助团队在缺乏正式 API 文档时迅速理解系统暴露的端点与行为。

Core Features & Use Cases

  • 从 Java、Go、Python、Node.js 等后端代码中扫描路由定义,生成可读的接口清单。
  • 输出为 Markdown 或 JSON 文档,方便落盘、评审和后续的测试用例生成。
  • 支持按模块、仓库范围或 URL 前缀筛选接口,扫描完成后可交付给后续的 spec 生成阶段。
  • 提供清晰的输出范围、数量摘要与阶段性产出,便于审计与追踪。

Quick Start

对后端代码库执行扫描,生成接口清单文档(Markdown 或 JSON)并落盘。

Frequently Asked Questions about apitestspec-surface-scan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate API documentation from backend source code?

To generate API documentation from backend source code, scan the repository to identify HTTP endpoints and export them as structured Markdown or JSON files. This approach quickly inventories endpoints without requiring formal documentation.

How do I extract HTTP endpoints from a Java or Go project?

You can extract HTTP endpoints from a Java or Go project by scanning the backend source code to identify route definitions. The tool infers endpoint details directly from the code and exports a readable inventory.

Can I scan specific modules instead of an entire repository for API endpoints?

Yes, you can target specific modules rather than scanning an entire repository. The scanning process supports filtering by module scope and optional URL prefix to narrow down the identified HTTP endpoints.

Does endpoint discovery from code fabricate request and response structures?

No, endpoint discovery from code avoids fabricating request and response structures. It infers endpoint details directly from existing source code definitions to ensure the exported Markdown or JSON documentation reflects actual behavior.

What is the best way to discover API endpoints when there is no formal documentation?

The best way to discover API endpoints without formal documentation is to scan backend source code like Python or Node.js projects. This automatically identifies route definitions and exports a clear checklist for review.

How do I prepare for test generation after discovering API endpoints?

To prepare for test generation after discovering API endpoints, export the scanned route inventory as Markdown or JSON. This output can then be handed off to a spec composer to generate subsequent test cases.