ecc-skill-defer

/ecc-skill-defer — ECC Skill 渐进式加载管理

管理 ECC skills 的 defer/restore 状态，减少 init token 消耗。

Instructions

在此 skill 的目录下运行脚本：ecc-skill-defer/ecc-skill-defer.sh（相对于 skills 仓库根目录），或运行已安装的副本 ~/.claude/scripts/ecc-skill-defer.sh。

Available commands

Command	Description
status	显示 active/deferred 数量
list	显示所有 skill 及其状态
apply	defer 配置文件中列出的 skill（ECC 更新后使用）
restore <name>	激活单个 deferred skill
restore --all	恢复所有 deferred skill
apply --reason "<text>"	defer 并将明确原因记录到 DEFER_LOG.md

Default behavior

如果用户未提供参数，运行 status，然后运行 list。

Config

defer 列表位于 ecc-skill-defer.conf（与脚本位于同一目录）。若要在 defer 列表中添加或移除 skill，请编辑此文件，然后运行 apply。

After restoring a skill

告知用户："Skill 已恢复。它将在下一会话（或上下文重新加载后）可用。"

Notes

• defer 原因追踪： apply --reason 会将 defer 原因记录到 DEFER_LOG.md（仅追加），格式为 <date> | <skill> | <reason>。list 指令可选择显示最后一次 defer 原因。
• Portfolio 健康确认： defer/restore 操作后，建议运行 /skill-health，检查当前 skill 组合是否存在冗余或缺口。

核心 skill 保护（HITL Guard）

执行 apply 前，必须先扫描即将 defer 的 skill 列表（ecc-skill-defer.conf）：

如果列表包含 design 或 assist，使用 AskUserQuestion 强制确认（这是 Hard Stop，不得略过）：

即将 defer 的列表包含核心规划 skill：

• [列出检测到的核心 skill]

design / assist 是核心规划 skill，defer 后将失去行业/学术参照能力与 ECC 资源分配质量。

1. 确认 defer — 我了解影响，仍要继续
2. 取消 — 保留这些 skill，不执行 apply

只有用户明确选择「确认 defer」后，才能继续执行 apply。

apply 操作验证（依据：DAMA-DMBOK Completeness — manifest vs. actual）

执行 apply 后，必须通过 list 重新验证状态：

1. 执行 apply 前，记录预计 defer 的 skill 列表（manifest）

2. apply 完成后，执行 list 获取当前状态

3. 逐条对照 manifest 进行验证（依据：OpenAI Developer Community 共识 — Checklist-driven）：

   Skill	预期状态	实际状态	结果
   foo	deferred	deferred	PASS
   bar	deferred	active	FAIL

4. 若有任何 FAIL → 输出警告，提示手动检查 ecc-skill-defer.conf 和脚本执行结果

5. 全部 PASS → 输出当前可用的 skill 列表，确保用户了解现有资源

restore 操作验证（依据：DAMA-DMBOK Completeness）

执行 restore <name> 或 restore --all 后：

1. 执行 list，验证目标 skill 状态为 active
2. 输出验证结果：[PASS] <skill> 已恢复为 active 或 [FAIL] <skill> 状态仍为 deferred
3. 告知用户：「Skill 已恢复。它将在下一会话（或上下文重新加载后）可用。」