speclite-check-canonical-source-change

name	speclite-check-canonical-source-change
description	检查 SpecLite canonical source 变更后的派生一致性。用于用户要求 canonical source check、检查 assets/source/speclite、canonical 变更闭环、更新 skill/hook/agent 后验收或扫描 sdlc/core/total 数量。核心能力：对齐 root counts、module-help.csv、hook source、baseline 常量、fixtures、docs 和 packaging manifest。
allowed-tools	Read, Bash, Grep, Glob
metadata	{"version":"1.0.0","author":"fancyliu","catalog":"speclite"}

[Overview（技能说明）] 只读检查 assets/source/speclite/ 作为 SpecLite canonical source 发生新增或修改后的闭环一致性。它把 canonical skill、hook、agent、fixture、docs 和 release packaging 的派生关系集中成一份可执行检查清单，避免 root counts、module-help.csv、hook descriptor、安装 fixture 或发布 manifest 漂移。

[Core Capabilities（核心能力）] - Root counts 对齐：统计 core-skills、sdlc-skills、support-skills 和 hooks，确认默认安装 baseline 仍是 core+sdlc。 - module-help.csv 对齐：检查 core / sdlc package roots 是否都有 help row，并报告重复、缺失或未知 row。 - Hook source 完整性：检查每个 canonical hook package 的 README.md、hook-manifest.json、runner.mjs、Claude/Codex fragment 和 manifest id。 - Agent lint 路由提醒：识别 speclite-agent-* 变更时提醒使用 speclite-agent-lint，避免套用 workflow-only 规则。 - 派生产物扫描：检查 CORE_SDLC_BASELINE_ENTRY_COUNT、文档旧数字、fixture 旧数字、legacy Codex hook array shape 和 release/packaging-manifest.json。 - 验证命令建议：输出 scoped script、skill density、focused tests、build、full tests、packaging check 和 git diff --check。

[Workflow（执行流程）] 1. 确认仓库根目录，默认在 SpecLite 仓库根运行。 2. 读取 references/canonical-change-checklist.md，确认本次 canonical 变更涉及 skill、hook、agent、docs、fixtures 或 packaging 哪些面。 3. 运行只读脚本： node assets/source/speclite/support-skills/speclite-check-canonical-source-change/scripts/check_canonical_source_change.mjs --project-root . --scope all --format json 4. 对脚本 findings 做人工复核：warning 表示需要同步派生产物；failure 表示脚本本身无法读取必要输入。 5. 若涉及 Agent 定义包，补跑： python3 assets/source/speclite/support-skills/speclite-agent-lint/scripts/check_agent_skill.py <agent-dir> 6. 若涉及普通 Skill 包，补跑： python3 assets/source/speclite/support-skills/speclite-skill-lint/scripts/check_skill_density.py <skill-dir> 7. 完成修复后重新运行 Step 3，并按脚本输出的 recommended commands 执行聚焦测试和 release packaging check。

[Notes（注意事项）] - 本 Skill 只读，不直接修改 canonical source 或派生产物。 - support-skills 不进入默认目标项目 skill mirrors；默认安装 baseline 只计算 core+sdlc。 - Hook guardrail 是 deterministic 保护层，不替代开发流程或人工 review。 - canonical-source-change-check hook 是 warning-only：提醒运行本 Skill 和验证命令，不阻断 Claude/Codex 会话。 - 检查报告必须用实际文件和脚本结果支撑，不凭记忆更新 sdlc、core、support 或 total 数字。

[Generation Metadata（生成信息）] 本 Skill 由 speclite-skill-creator 体系维护并纳入 SpecLite support-skills。修改时必须同步 SKILL.md、SKILL.en.md、CHANGELOG.md、references/ 和 scripts/。