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.