light-implement

实施

light-implement 是由用户调用的有界执行器。仅在用户明确请求 $light-implement 后运行。它会将一个已就绪的工作项转化为经过验证的成果，并将其交由审查。

核心循环

1. 确定一个工作项。 准确选定一个工单、Spec 章节或明确的对话片段，并将其记录为目标。对于跟踪器工单，在更改任何其他文件之前，将其设置为 Status: claimed。
2. 检查相关上下文。 如果存在 docs/agents/light-project.md，请读取其中的跟踪器、领域上下文和审查配置文件字段。然后只浏览该工作项涉及的术语表、ADR 和文件；记录来源位置。
3. 在确有实际帮助时提供执行路由选项。 对于界限明确、可独立完成的工作，跳过路由，不作判断（WORKFLOW §3A）。否则，通过 light-decide（可选能力）判断「路由是否会带来实质帮助？」。如果模型规格调整、推理力度调优、由更强审查配合的委派实施，或执行拓扑会带来实质帮助，请让用户选择调用 agent-config 或直接继续。如果用户明确要求路由，则直接调用 agent-config；如果用户拒绝或禁用了路由，或者工作属于界限明确、可独立完成的情况，则直接继续，不要阻塞。agent-config 返回后，按 WORKFLOW.md §3E 中的说明遵循其 readiness。NEED_PROJECT_TICKETS 始终会停止流程：建议使用 $project-tickets 并停止。
4. 执行有界任务，然后验证。 在适用时，对代码使用 light-tdd；非代码成果按其约定产出。在本地验证（测试、渲染、架构或领域检查）。
5. 交由 review-loop 审查，并匹配相应的审查者：代码使用 light-code-review，非代码使用 generic-review 或领域审查者。
6. 撰写实施报告并停止。 对于跟踪器工单，在工单的 ## Comments 下追加报告：范围、已修复的问题、验证结果、review-loop 遗留的未解决发现，以及 Plan gap:（见 WORKFLOW.md §7）。 project-review 会在后续会话中读取该报告。

可选能力

• 步骤 3 会询问路由是否会带来实质帮助，适用于并非明显属于界限明确、可独立完成的工作，且用户既未要求也未拒绝路由的情况 → 调用 light-decide，问题 ID 为 light-implement/offer-agent-config（是或否）。如果不可用 → 自行判断。
• 计划缺口（已批准的 SPEC、工单或验收项不再成立）在任一步骤中出现 → 如果工单尚未认领，则先认领；停止该工作项；撰写报告，将 Outcome: BLOCKED 和缺口写入 Plan gap:；然后使用工单路径调用 light-redirect。如果它返回本地修复方案，则继续该工作项；下一份报告会取代这份报告。 对于 SPEC 或对话片段，跳过认领，并将返回的报告作为触发条件传入。 如果不可用或用户拒绝 → 报告缺口并停止。
• 如果存在 .scratch/<feature>/plan.html → 撰写报告后，调用 light-html-plan 刷新该文件。如果页面或能力不存在 → 跳过。

组合

light-implement
   ↓
inspect bounded task
   ↓
would routing materially help?
   ├─ no  → execute directly
   └─ yes → offer agent-config
              ├─ accept  → agent-config → consume AgentConfigResult (READY / NEED_INPUT / NEED_PROJECT_TICKETS / BLOCKED / UNSUPPORTED)
              └─ decline → execute directly
   ↓
light-tdd when appropriate
   ↓
review-loop → light-code-review (code) / generic-review (non-code)

light-implement 组合这些能力，而非重新实现它们。 agent-config 是可选增强项：拒绝使用它，或在不具备模型路由能力的 Host 上运行，都不会阻碍实现。如果路由问题仅影响可选增强项，且当前会话已证明具备相应能力并获得授权，同时用户未要求使用该路由，则直接继续处理范围明确的事项，并说明回退方案，不要再询问设置问题。 绝不要绕过模型限制、配置预览审批、必需的独立审核或用户要求的执行方式。拒绝含糊不清或缺少任务前提条件仍属于 BLOCKED 交接缺口：向调用方返回诊断信息和最小解除阻塞措施。技能完成时返回此事项的状态；这不代表更大请求已完成，也不授权处理其他事项。各类产物的完整流程见 WORKFLOW.md；示例见 EXAMPLES.md。