ask-light

Ask Light

ask-light 是 Light 工作流顾问、导航器和路由器——一个由用户调用的入口，可理解用户想要完成的任务，检查项目的实际状态，了解 Light 技能及其约定，判断下一步的最佳操作，解释原因，等待批准，并在宿主环境允许时转入获准的技能。

工作原理

代码确立事实；模型进行判断；代码验证选择。 scripts/ask_light.py（Python 3.9+）会返回证据包，且绝不会指定技能。 light-skill-map.json 中的模式仅是候选提示。完整的证据、验证和批准协议见 discovery-contract.md。

会话流程

1. 解读请求。 判断当前情形：当前工作流、明确的任务或具名技能、新的工作事项、独立任务、工作流概览，或集合导航。根据情形决定哪些证据具有约束力。
2. 收集证据。 运行 python3 scripts/ask_light.py --mode next --context-json '{"projectRoot": "..."}' （添加 --host-name 并指定你的宿主环境，例如 claude-code 或 codex；如果已知集合根目录，则添加 --roots-json；如果不指定 --host-name，脚本会根据环境进行推测）。从证据包中的目录生成候选列表；切勿为了路由而读取每个 SKILL.md。
3. 了解候选项。 选出 2–4 个合理的技能。如果相邻技能在实质上很接近，则阅读它们的 SKILL.md。
4. 判断。 阅读 routing-judgment.md，然后选出 一个主要技能，最多再选一个备选。绝不能虚构与证据包相矛盾的状态。
5. 验证。 运行 python3 scripts/ask_light.py --mode validate --skill <name> --scope <scope> （验证范围）。 如果结果为 BLOCKED，则报告逻辑上的建议及其原因，然后停止。绝不能换用另一个技能。
6. 像顾问一样解释。 引用观察到的事实，说明为什么该技能适合当前情形，以及为什么显而易见的相邻技能不适合 （routing-judgment.md）。
7. 等待批准。 在用户明确同意之前，不执行任何操作。
8. 转接。 重新验证，然后仅在调用类型和宿主环境已验证的能力允许时启动获准的技能。否则，原样显示准确的调用方式并停止。绝不能越过获准的技能继续调用其他技能 （modes-and-transition.md）。

模式

• $ask-light next — 基于工作流推理，给出一个下一步技能建议。
• $ask-light workflow — 以当前状态为基础，给出一个范围明确的工作流方案。
• $ask-light <category> — 浏览集合（例如 project Skills、review Skills、learning Skills），并说明各技能的作用及相邻技能。
• 对于普通的独立请求（Explain this like I'm five、Investigate this bug），无需深入检查项目即可进行路由。

结果约定

按 result-contract.md 返回记录。

可选功能

• 仍有多个可行技能，或需要处理歧义或升级问题 → 语义模式（--mode semantic）会通过 light-decide 脚本路径进行提问；如果你未使用脚本进行判断，则使用问题 ID ask-light/next-action、ask-light/material-ambiguity 或 ask-light/reasoning-escalation 调用 light-decide。它只会在项目的 Decision data: 限制范围内提问（无此行表示在设备端处理），并且仅在用户的策略文件为相应问题设置校准规则时应用答案。按照 light-decide 的日志格式记录返回的 decisions。如果不可用或未经校准，则保留确定性基线。判断本身不授予转接权限；只有用户批准才有此权限。