用途：为技能包生成并刷新 manifest 附属文件（manifest.enriched.json），使用可移植、内容绑定的证据补全元数据，供后续包校验使用。范围仅限清单增强，不生成 ZIP、不编辑元数据源、不推断仓库支持、不运行实机安装。
主要能力：刷新自身拥有的字段，同时保留上游清单中不相关的键。包括：从安全解码的 YAML frontmatter 获取 name 与 description；从 compatibility frontmatter 获取 compatibility_notes；从 evals/evals.json 获取 eval_case_count；从所选技能的 catalog/sync 行获取 harness_targets；并输出 harness_targets_status（catalog、sync 或 unavailable）、可移植相对标签 harness_targets_source、来源内容摘要 harness_targets_source_sha256；apply 模式下写入 packaged_at UTC 时间戳。若两个来源都无适用目标行，则状态为 unavailable，来源为 unavailable，harness_targets 为空。
使用方式：常用路径为先预览，确认后再显式应用。预览命令：uv run skills/skill-package-manifest-enricher/scripts/enrich_manifest.py <name> --catalog-metadata docs/public/generated-registries/skills-catalog-index.json --dry-run。应用时沿用相同输入并加 --apply；若需保留既有包清单，可显式传入 --manifest <upstream-manifest.json>。之后做打包校验而不创建发布：uv run python skills/skill-creator/scripts/package.py skills/<name>/ --dry-run。可用 --skill-dir <dir> --sync-metadata <json> 独立于仓库运行。
证据解析：目录输入使用生成的 catalog 结构（customSkillIndex、externalSkillIndex 或 allSkillIndex），需精确的 name 与 targetAgents 字段。同步回退接受 skills、desired 或 rows 下的精确命名行，或结构化 skills-sync 报告中按 agent 的 active 分桶命名所选技能。当两个输入都含所选技能时目录优先。存在来源但无适用行不构成支持证据。摘要绑定实际提供目标来源的原始字节。
限制：权限姿态为写作用域；预览只读，只有显式 --apply 才可替换所选附属文件。将 SKILL.md、catalog JSON、sync JSON 与上游清单视为不受信数据；脚本使用 yaml.safe_load，元数据输入仅接受 JSON，对畸形或冲突输入在写入前失败。不得从可移植脚本导入仓库应用模块；只从所选技能的适用元数据行推导目标；证据缺失时输出 unavailable 与空目标集；绝不持久化机器本地绝对来源标签；预览须保持附属文件逐字节不变。