crossref-progress-scanner

Scan TypeScript files and compare them against cross-ref-code.md mappings.

3|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/eaglhuang/cocos_new --skill crossref-progress-scanner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crossref-progress-scanner
Source: https://github.com/eaglhuang/cocos_new/tree/main/.github/skills/crossref-progress-scanner
Command: npx skills add https://github.com/eaglhuang/cocos_new --skill crossref-progress-scanner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-Reference 進度掃描器自動掃描 assets/scripts/**/.ts 與 tests/.ts,比對 cross-ref-code.md (doc_index_0001) B-1 表格,產生進度差異報告,並更新 cross-ref-進度.md (doc_index_0017) 摘要節。

Core Features & Use Cases

  • Scans TypeScript source files and test files to detect missing or stale entries, and generates a structured progress report.
  • Compares findings against the B-1 mapping in cross-ref-code.md and updates the cross-ref-進度.md summary section accordingly.

Quick Start

Scan the project to generate a proposal for cross-reference progress updates and review the results before applying changes.

Frequently Asked Questions about crossref-progress-scanner

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

FAQPage Schema
How do I track TypeScript cross-reference progress against a mapping document?

To track cross-reference progress, this scanner compares assets/scripts/**/*.ts and tests/*.ts files against the cross-ref-code.md mapping, generating a structured difference report. It detects missing or stale script entries to keep documentation synchronized.

What is the best way to detect stale or new scripts for documentation sync?

Detecting stale or new scripts relies on filename matching without AST parsing. The scanner compares existing TypeScript source and test files against the cross-ref-code.md B-1 table to identify discrepancies and propose updates for the cross-reference documentation.

Does the cross-reference progress scanner automatically apply updates to documentation?

The cross-reference progress scanner does not automatically apply updates. It proposes changes to the cross-ref-進度.md summary section based on scan results, awaiting user confirmation before modifying the cross-reference documentation.

Can I scan test files alongside source scripts for progress tracking?

Yes, you can scan test files alongside source scripts. The scanner processes both assets/scripts/**/*.ts and tests/*.ts directories, comparing the combined results against the cross-ref-code.md mapping to generate a comprehensive progress report.

Do I need AST parsing to update cross-reference documentation?

You do not need AST parsing to update cross-reference documentation. This scanner relies entirely on filename matching to detect missing or stale TypeScript files, making the progress tracking process lightweight and efficient.