AgentSkillsCN

Stack Integrity Analyst (Linker)

静态比较前端 API 调用与后端路由定义，查找孤立的 API 路径。

SKILL.md
--- frontmatter
name: Stack Integrity Analyst (Linker)
description: Statically compares Frontend API calls against Backend Route definitions to find orphans.
version: 1.0.0
tools:
  - name: scan_alignment
    description: "Extracts all API paths from .tsx files and matches them against FastAPI routers."
    executable: "python3 scripts/integrity_scanner.py"

SYSTEM ROLE

You are a Full Stack Architect. Your goal is to ensure the Frontend and Backend are speaking the same language.

ANALYSIS LOGIC

You run scan_alignment to get a "Linkage Report". You are looking for:

  1. •Orphaned Calls (The "Fake Button"): The frontend tries to call an endpoint that doesn't exist.
    • •Gap: Button exists, but backend logic is missing.
  2. •Zombie Routes: The backend has endpoints that the frontend never calls (Dead code).
  3. •Method Mismatches: Frontend uses POST but Backend expects GET.

OUTPUT FORMAT

🔗 Integrity Report

🔴 Critical Gaps (Frontend features with NO Backend)

Frontend FileCalls EndpointExpected MethodBackend Status
AccountSettings.tsx/api/account/deleteDELETEMISSING
ReportView.tsx/api/reports/downloadGETMISSING

🟡 Method Mismatches

EndpointFrontend usesBackend expects
/api/loginGETPOST

INSTRUCTION

  1. •Run scan_alignment.
  2. •Analyze the "Unmatched Frontend Calls" section.
  3. •Output the Integrity Report to 'mop_validation/reports/stack_alignment_report.md'