用途:审计插件和技能中的文件路径引用,确保代码里的 ./ 引用真实存在且不越界。适合在开发技能或插件后检查引用完整性时使用。
主要能力:三阶段审计,SCAN 扫描 .py、.md、.mmd、.json、.sh 中的 ./ 引用并写入 temp/inventory.json;VERIFY 校验每个引用状态(exists/missing/symlink/broken);REPORT 从清单生成 summary、missing、broken_symlinks 等报告,无需重新扫描。另有技能边界检查和插件边界检查,标出指向技能或插件外部的引用。
使用方式:依赖 Python 3.8+ 且仅用标准库。基本命令:python ./scripts/path_reference_auditor.py --project . --phase scan;再执行 --phase verify;随后可为报告加 --report summary 等。边界检查:python ./scripts/check_skill_boundaries.py temp/inventory.json --batch all 或 --skill 名称;python ./scripts/check_plugin_boundaries.py temp/inventory.json --batch all 或 --plugin 名称。
边界规则:技能内引用必须解析在技能目录内,插件根层引用必须解析在插件内;越界时可创建指向资源内部的符号链接。清单可复用,扫描一次后可多次分析,支持单技能或单插件过滤测试,输出 JSON 便于自动化。
局限与未提供:除上述内容外无更多功能说明;安装细节需参考 INSTALL.md,具体收费、平台与效果信息暂未提供。