Forward Implementation First — 防止 AI 编程 Agent 陷入内部事务的技能

技能简介

Forward Implementation First 是一款让 AI 编程 Agent 不再被「元任务」绊住脚的 Skill。当 Agent 需要处理长流程的 Pipeline（数据处理、代码迁移、构建发布、批量分析等）时，它很容易把administrative metadata（哈希校验、锁文件、收据记录、进度面板）当成实际任务来做——花几个小时「修复收据」，而最终产出和开始时一模一样。这个 Skill 通过一套三分类决策框架，在每个 Action 之前强制 Agent 区分「语义实现」「聚焦验证」和「行政事务」，并明确要求跳过第三类，除非用户明确要求。

核心能力（6条）

1. 三分类决策框架：每个 Action 执行前必须归类为「语义实现」「聚焦验证」或「行政事务」，并按规则决定是否执行
2. 元任务识别：自动识别哈希校验、锁文件更新、收据修复、仪表板写入等行政性工作，防止 Agent 在无意义的事务中空转
3. 前进光标规则（Forward Cursor Rule）：阶段只能因输入语义变更、目标变更、输出异常等真实原因回退，因缺失元数据而阻塞时必须手动运行并继续前进
4. 并行工人池规范：区分高成本串行任务（编译器、全量测试）与低成本并行任务，合理分配计算资源
5. 证据 vs 迷信区分：保留真实证据（执行记录含命令 / 输入 / 结果 / 预期对比），去除无效断言（无关阶段的历史哈希校验）
6. 轻量级实现：仅约 150 行 Markdown，无模型依赖、无工具依赖、无领域限制，适用任何 Agent

安装配置（3步）

方法一：自动安装脚本（推荐）

git clone https://github.com/Vuk97/forward-implementation-first
cd forward-implementation-first
./install.sh

install.sh 自动检测机器上安装的 Agent，将 SKILL.md 复制到对应目录：

• Claude Code → ~/.claude/skills/forward-implementation-first/
• Codex → ~/.codex/skills/forward-implementation-first/
• 其他兼容格式 → ~/.agents/skills/forward-implementation-first/

方法二：手动安装（项目级） 将仓库中 SKILL.md 复制到 .claude/skills/forward-implementation-first/（项目内安装，仅在该项目生效）。

方法三：Always-On 规则（永久生效） 将 SKILL.md 内容粘贴到 Agent 的 always-on 规则或 Hook 配置中，确保 Agent 在每个 Session 都加载此规则，防止在长流程中不知不觉陷入元任务。

使用步骤（5步）

1. 安装 Skill（一次性）并重启 Agent Session
2. 发出 Pipeline 任务（如「跑完这 40 个阶段的 ETL」「完成这个代码库迁移」）
3. Agent 自动执行三分类：每个 Action 前先判断类型，再决定是否执行
4. 元任务被跳过时：Agent 会标注「行政事务已跳过」，继续执行实际构建步骤
5. 发现阶段阻塞时：Agent 手动运行该阶段，验证输出，然后继续前进，最后删除无意义的行政门控

适用场景（5个）

1. 长周期代码迁移：几百个文件的重构或迁移，Agent 不会因为某个中间哈希不匹配而回退几十个步骤
2. 多阶段数据处理 Pipeline：ETL / 数据清洗 / 分析流水线，元任务不再消耗主要运行时间
3. 构建发布自动化：持续集成中的多阶段发布流程，防止 Agent 在「等待票据」中空转
4. 批量文档生成：大量输入文件的自动化处理任务，避免 Agent 在某个中间状态的元数据上卡住
5. 多人协作的长 roadmap：Agent 跨多天多 session 推进的复杂项目，每个 session 都要重新判断当前 cursor

适用人群

• 使用 Claude Code / Codex 进行复杂长流程开发的工程师
• 需要 AI Agent 跑 Pipeline 的数据工程师和 DevOps
• 有大规模代码迁移或重构需求的开发团队
• 研究 AI Agent 工具行为优化的高级用户

工作原理

Forward Implementation First 通过规则约束而非工具调用来实现干预。每个 Action 执行前，Agent 必须回答一个问题：「这个 Action 属于哪一类？」

三分类定义：

前进光标规则核心：当一个阶段仅因缺失的元数据被阻塞时，Agent 手动运行该阶段、验证输出、继续前进，然后删除那个无意义的行政门控。回放仅影响变更依赖锥，而非全部历史。

特色优势

1. 根治元任务空转：通过三分类强制区分，从根本上杜绝 Agent 在行政事务里打转
2. 保留关键验证：不因跳过元任务而损失真实性，行为测试、Schema 校验等真实证据依然保留
3. 适用任何模型和工具：纯 Markdown 规则，不依赖任何特定 API 或工具集
4. 并行效率提升：明确区分串行重任务与并行轻任务，减少 GPU/CPU 争抢
5. 解决「卡住不前进」问题：多个 Agent 协作时不再出现「第一个 Agent 守着哈希等第二个」的僵局

官方链接

• GitHub：https://github.com/Vuk97/forward-implementation-first
• Agent Skills 规范：https://agentskills.io