用途：scan 是 easyplatform 仓库中的技能，用于扫描代码库并（重新）生成一份项目参考文档。它由 --target=<key> 参数化，目标键包括 project-structure、backend-patterns、domain-entities、frontend-patterns、design-system、code-review-rules、e2e-tests、integration-tests、feature-spec、scss-styling、docs-index 等（完整清单见 references/targets.md）。
主要能力：先解析 --target 并加载 references/targets.md 中该目标的清单条目，条目决定文档路径、子代理数量与角色、Phase-0 检测表、目标章节、内容规则与特殊门禁。随后评估文档处于初始化还是同步模式，运行目标专属的框架/类型检测，并行启动子代理扫描，以 file:line 证据发现模式，写入报告，再对参考文档做外科式更新，最后经多轮复核并运行 $prompt-enhance。
使用方式：以 $scan --target=<key> 调用；未提供目标或键未知时停止并列出有效键。执行前需读取 docs/project-config.json、docs/project-reference/docs-index-reference.md、lessons.md 等；缺失或过期时先运行 $project-init 或窄范围设置路由。若 .code-graph/graph.db 存在，对关键文件运行 python .claude/scripts/code_graph trace <entry-file> --direction both --json。
限制：所有代码示例必须来自真实项目文件并带 file:line，禁止编造；仅做外科式更新，不得整体重写或在无证据时删除章节；检测置信度低于 60% 时报告不确定并停止对应扫描；部分目标为 orchestrator 类型，不运行四阶段文档引擎而执行其编排流程；Codex 镜像或 AGENTS.md 缺失时需用户运行 $sync-codex，不自动执行。具体收费、平台与效果资料暂未提供。