AgentSkillsCN

audit-api-coverage

对 Andamio API 端点在三大子系统的使用情况进行全面审计。

SKILL.md
--- frontmatter
name: audit-api-coverage
description: Audit the usage of Andamio API endpoints across all three sub-systems.

Audit API Coverage

Track which Andamio Gateway API endpoints are implemented in the app.

Purpose

This skill answers one question: "Which API endpoints have hooks/implementations?"

For hook patterns, creating hooks, or auditing hook quality, use /hooks-architect instead.

Quick Links

ResourceDescription
API DocsLive Swagger UI
OpenAPI SpecMachine-readable spec

Reference Files

FilePurpose
api-coverage.mdEndpoint-by-endpoint implementation status
unified-api-endpoints.mdFull list of gateway endpoints
tx-state-machine.mdTX registration and polling flow

Coverage Summary

CategoryTotalImplementedCoverage
Authentication66100%
API Key66100%
Courses41~28~68%
Projects17~14~82%
TX: All2121100%
Admin400%
User Mgmt4125%

Overall: ~71% of endpoints have implementations.

Running the Audit

Quick Check

bash
# Run the audit script
npx tsx .claude/skills/audit-api-coverage/scripts/audit-coverage.ts

Manual Check

For a specific endpoint category, check api-coverage.md and look for:

  • •DONE - Implemented and hooked
  • •TODO - Not yet implemented
  • •SKIP - Deprecated or not needed

Key Directories

DirectoryContents
src/hooks/api/course/Course endpoint hooks
src/hooks/api/project/Project endpoint hooks
src/lib/andamio-auth.tsAuth endpoint implementations
src/config/Transaction endpoint config

Related Skills

SkillWhen to Use
/hooks-architectFor hook patterns, creating hooks, auditing hook quality
/transaction-auditorTX schema sync with gateway spec
/typescript-types-expertType issues with API responses

When to Update Coverage

Update api-coverage.md when:

  1. •A new hook is created that covers an endpoint
  2. •The gateway adds new endpoints (check OpenAPI spec)
  3. •An endpoint is deprecated or removed

Migration Note

Hook patterns and rules have moved to /hooks-architect.

This skill now focuses purely on endpoint coverage metrics. For:

  • •Learning hook patterns → /hooks-architect Learn mode
  • •Creating new hooks → /hooks-architect Implement mode
  • •Auditing hook quality → /hooks-architect Audit mode
  • •Extracting API calls → /hooks-architect Extract mode

Last Updated: January 28, 2026