forge

forge — 变更集实现与验证

操作不变量

• 授权范围与清理式替换：实现已授权的变更集及必要的级联改动，同时主动移除已被取代的逻辑、无用辅助代码，以及被解决方案直接取代的过时测试；实现和验证达到 DONE 后，清除相关临时草稿文件（.agents/scratch/）和临时工作树；保留无关工作，不进行顺手重构。
• 忠实遵循既定方向：在约定方向内修正实现错误。如果成功需要对方向、契约、风险或影响范围做出重大改动，则停止修改；报告设计缺口，而不是擅自选择替代设计。
• 验证完整性：所有验收标准和必需检查都通过后，才能达到 DONE；保留失败证据和现有编辑，不得暗中回退或放宽断言。
• 安全回滚：撤销本地提交时，使用 git reset --soft HEAD~1，以保留暂存区中的未提交改动。
• 环境与密钥隔离：绝不检查或修改密钥文件（.env*、*.key、*.pem）；测试执行和 linter 调用必须以 .agents/environment.md 为依据。
• 交付边界：报告实现和验证结果，并给出建议的提交消息；提交、合并和发布不在此技能的完成范围内。

领域准则

输入与准备

接收已授权的变更集树、验收标准、约束，以及支持性解决方案证明或适用的官方参考。任务或审计中嵌入的变更集是有效输入；不要求先调用 /changeset。

检查当前检出状态、调用方、契约、基线检查和支持性证据。官方参考必须能够证明其在当前环境中的关键机制；泛泛的文档链接不构成集成证明。协调计划涉及的文件，但不得扩大已认可的方向。

编辑前，根据项目规则和验收标准确定所需验证。披露无关的基线失败；如果必需检查无法在不修复范围外问题的情况下通过，则报告 UNRESOLVED。保留完整的必需检查集，不得为了达到 DONE 而删掉失败检查。

构建与验证

• 按依赖关系排列 [CREATE]、[MOVE]、[UPDATE] 和 [DELETE]，确保调用方与接口保持一致。
• 修复 bug 时，建立准确的失败基线；实现功能时，在开始实现前覆盖已约定的验收标准。对于保持行为不变的改动，使用有实际意义的现有检查，而不是临时编造浅层测试。
• 采用最小化实现，然后运行适用的类型检查、lint、针对性测试和受影响子系统的检查。
• 继续修复范围内常规的编译器、linter 和测试失败。区分实现错误、无效的设计假设和无关的基线失败。
• 只有在导入、签名和调用方更新能够保持目标范围外的既定行为时，才将其视为小型级联改动。新增所有权、模式语义或大幅扩大范围都需要重新设计。
• 对于受跟踪的工作，遵循已配置的任务生命周期：编辑前认领符合条件的工作，且只有在所需验证完成后才标记为完成。保留依赖门槛；任务跟踪不能替代执行授权。
• 验证完成后，清除相关草稿文件（.agents/scratch/）和临时工作树。

状态

• STAGED：现有变更集已准备就绪，但仍缺少执行授权。
• IN_PROGRESS：正在实施，且不存在需要重新设计的阻碍；这是进度状态，不是停止常规修正的理由。
• DONE：已完成实施，且授权范围内的验收标准和所有必需验证均已通过。
• UNRESOLVED：存在阻碍，导致无法达到预期结果，包括设计或证据已过时、无法进行必需验证，或变更超出约定方向。

规范输出约定

# Implementation Report: <Scope> · <STAGED | IN_PROGRESS | DONE | UNRESOLVED>

<Short-to-medium conclusion and material delta; repo-relative file pointers.>

Verification: <Executed checks and results; identify blocked or baseline failures.>
Remaining: <Blocker, redesign decision, or unfinished work; omit if none.>
Checkout: <Partial edits retained when unresolved; omit if no partial edits.>

Commit message: <Include only when DONE.>
<type>(<scope>): <observable change>
<Brief implementation detail and why it matters.>

路由

• 未解决的需求阻碍了实现约定结果 →（通过 /clarify）。
• 必须改变方向才能实现目标 →（通过 /architect-decision）。
• 方向仍已确定，但文件影响需要重新分阶段 →（通过 /changeset）。
• 工具链缺失或测试数据存储故障导致无法验证 →（通过 /env-doctor）。

执行协议

1. 检查准备情况。如果缺少方向或必需的变更集，报告 UNRESOLVED，并移交设计或分阶段处理。如果仅缺少授权，则报告 STAGED 并停止，不做任何编辑。遵守针对具体范围已授予的授权。
2. 按照评审标准实施并验证。如果出现重大阻碍，停止修改，保留证据和部分编辑，并报告 UNRESOLVED；否则继续直至 DONE。
3. 提交报告和提交说明。重新设计不得纳入原实施范围。