用途：初始化项目参考文档。先确认 session-init-docs.cjs 钩子已在 docs/ 下创建占位文件，再运行扫描技能填充内容。
主要能力：读取 docs/project-config.json 的 referenceDocs[*].filename 作为文件清单来源；若为空则使用 .claude/hooks/lib/session-init-helpers.cjs 中的 DEFAULT_REFERENCE_DOCS。检测占位状态（文件前 512 字节含 <!-- Fill in your project's details below. --> 即为占位）。提供选项：运行 $claude-md-init 加全部配置扫描技能、仅运行扫描技能、选择特定技能、跳过。
用法：每个参考文档对应一个扫描技能，例如 $scan --target=project-structure、$scan --target=backend-patterns、$scan --target=frontend-patterns、$scan --target=integration-tests、$scan --target=e2e-tests、$scan --target=domain-entities、$scan --target=docs-index、$scan --target=code-review-rules、$scan --target=scss-styling、$scan --target=design-system、$scan --target=seed-test-data、$scan --target=feature-spec。spec-system-reference.md、spec-principles.md、workflow-spec-test-code-cycle-reference.md 为静态模板，无扫描技能；lessons.md 由 $learn 单独管理。生成后需通过 M1-M5/M7 合规门禁并运行项目文档化的 SDD 合规验证器。
限制：不要手动创建缺失文档，应先修正项目配置或模板条目再重跑；扫描技能耗时约 5-15 分钟/个；若必需步骤或工具无法运行，应停止并询问用户；Codex 镜像或 AGENTS.md 缺失时需用户运行 $sync-codex，不自动执行。具体验证器命令与项目配置细节暂未提供。