name: code-execution description: 当子任务准备好实现并且有包含接受标准和交付物的子任务 JSON 文件时使用。 context: fork agent: coder-agent

代码执行

概述

通过自审和质量验证执行编码子任务。在预加载标准的独立 coder-agent 上下文中运行。

开始前宣布: “我使用代码执行技能来实现 [子任务标题]。”

过程

步骤 1: 读取子任务 JSON

加载 $ARGUMENTS 中指定的子任务文件：

Read: .tmp/tasks/{feature}/subtask_{seq}.json

提取：

title — 要实现什么
acceptance_criteria — 成功的定义
deliverables — 要创建的文件/端点
context_files — 要应用的标准
reference_files — 要研究的现有代码

步骤 2: 加载上下文文件

读取 context_files 中的每个文件：

Read: .opencode/context/core/standards/code-quality.md
Read: .opencode/context/core/standards/security-patterns.md

理解：

项目编码标准
命名约定
安全模式
代码质量要求

步骤 3: 加载参考文件

读取 reference_files 中的每个文件：

Read: src/middleware/auth.middleware.ts

研究：

现有模式
代码结构
使用的约定

步骤 4: 更新状态为进行中

编辑子任务 JSON：

"status": "in_progress",
"agent_id": "coder-agent",
"started_at": "2026-02-16T00:00:00Z"

步骤 5: 实现交付物

对于每个交付物：

创建或修改指定文件
严格遵循接受标准
应用来自上下文文件的标准
使用来自参考文件的模式
编写干净、模块化、功能性的代码

步骤 6: 运行自审（强制）

类型和导入验证：

✅ 函数签名匹配用法
✅ 所有导入/导出存在
✅ 无缺失类型注释
✅ 无循环依赖

反模式扫描：

grep "console.log" deliverables  # 不允许调试语句
grep "TODO\|FIXME" deliverables  # 不允许未完成工作
grep "api[_-]key\|secret" deliverables  # 不允许硬编码秘密

接受标准检查：

重新读取 acceptance_criteria 数组
确认每个标准已满足
在继续之前修复未满足的标准

步骤 7: 标记完成

更新子任务状态：

bash .opencode/skills/task-management/router.sh complete {feature} {seq} "{summary}"

验证：

bash .opencode/skills/task-management/router.sh status {feature}

步骤 8: 返回报告

✅ 子任务 {feature}-{seq} 已完成

自审：✅ 类型 | ✅ 导入 | ✅ 无调试代码 | ✅ 标准满足

交付物：
- src/auth/jwt.service.ts
- src/auth/jwt.service.test.ts

摘要：带有 RS256 签名和 15 分钟令牌过期的 JWT 服务

错误处理

缺少子任务 JSON：

主代理必须在调用此技能前创建子任务

上下文文件未找到：

主代理必须先运行 /context-discovery

接受标准未满足：

不要标记完成—先修复问题

红旗警告

如果您想到以下任何一点，请停止并重读此技能：

“我了解这个模式，不需要读上下文文件”
“我最后快速做自审”
“接受标准很明显，不需要检查”
“我标记完成，稍后修复边缘情况”

常见合理化

借口	现实
“我以前见过这个模式，上下文文件只会确认我所知道的”	项目会偏离常见模式。一个错误假设 = 返工。请读取文件。
“自审只是检查我自己的工作”	自审在主代理看到之前捕获类型错误、缺失导入和调试代码。
“标准由任务标题暗示”	暗示的标准无法验证。如果没有写下来，就不是一个门控。
“我稍后在跟进中处理边缘情况”	留给跟进的边缘情况会成为生产中的错误。现在就处理它们。

记住

上下文优先，代码其次—始终在实现前读取上下文文件
一次一个子任务—完全完成后才继续下一个
自审是强制性的—标记完成前的质量门控
功能性、声明性、模块化—仅使用干净的代码模式
返回结果给主代理—报告完成以进行协调

代码执行Skill code-execution