SuperAPI AI 工具集

perfectcode-zen-implement

编程与开发

查看项目

更新于 10-16 05:24

技能介绍

用途

PerfectCode Zen — Implement 是一个结构化的实现工作流:它执行位于 .opencode/plans/ 中的书面实施计划,采用并行工程智能体实现,随后经过质量门与测试验证。资料明确说明:在所有测试通过之前,不宣告任何工作完成。

前置条件

必须先存在一个计划文件于 .opencode/plans/。执行前需仔细、完整地阅读该计划,后续每个决策都必须能追溯到计划本身,不得即兴发挥、跳过或重新解释范围。

主要流程

第 1 步 — 以 Build Agent 启动:工作流由 build 智能体贯穿始终拥有。build 智能体不写代码,只负责编排:读取并深入理解计划、将计划拆解为原子实现任务、委派给 developer-prime 与 developer-fast、在不确定/阻塞/有风险时立即升级咨询、验证质量门并确保所有测试通过后才收尾。它是整个工作流的唯一责任点。

第 2 步 — 仔细彻底地阅读计划:关注目标与范围、架构与设计决策、实现任务及其依赖、安全/性能/数据库考量、测试策略与验收标准。计划是唯一事实来源,若计划指定了某种做法就严格照做;若计划存在歧义,先咨询相应顾问再继续。

第 3 步 — 拆解并跟踪所有任务:把计划中的每个实现项拆为原子、可执行的任务并立即登记到 TodoWrite。规则:开始某任务时立即标记 in_progress;可验证完成时立即标记 completed(不要批量处理);同一时间只应有一个任务处于 in_progress;无证据(测试通过、代码审查)不得宣称完成。

第 4 步 — 委派给编码智能体:按任务类型分配——复杂、多文件或长上下文工作交给 developer-prime;范围明确、单文件、模板化或高量任务交给 developer-fast。相互独立的任务并行运行,不得串行化可并行的工作。

委派前加载与目标技术匹配的技能,使编码智能体继承正确的风格约定:TypeScript / TSX → typescript-style;JavaScript / JSX → javascript;Python → python;Go → go;CSS → css;HTML → html;Tailwind → tailwind-css。

每个编码智能体都需给出完整成型的提示词(任务、上下文、需求、要修改的文件、要创建的文件、各顾问指导、成功标准),不得使用模糊描述。

每个任务完成后的验证:运行相关测试(npm test / pytest / go test ./...)、检查类型错误(tsc --noEmit / mypy / go vet)、运行 linter / formatter、确认预期行为,然后立即标记 todo 完成。当前任务存在失败检查时不得进入下一任务。

第 5 步 — 遇到阻塞或不确定立即咨询:出现任何问题、卡住、需要计划未覆盖的决策,或涉及架构/安全/数据风险时,停止并在继续前咨询。需要多视角时可并行升级:架构或系统设计问题 → principal-architect;服务设计或跨组件决策 → solution-architect;数据模型、schema 或查询问题 → database-architect;安全、认证或威胁建模问题 → security-expert。顾问以 Think → Advise → Review 模式运作:分析情况、给出具体建议并审查结果,其指导须在工作继续前纳入。被阻塞时咨询是必需环节。

第 6 步 — 质量门:所有编码任务完成后、宣告实现完成前,并行运行以下审查:security-expert 验证计划中所有安全缓解措施已正确实现;principal-architect 验证实现符合既定设计;solution-architect 验证服务边界与接口正确;database-architect 验证 schema、迁移与查询合理。移入测试前须处理全部发现项。

第 7 步 — 测试与验证:运行项目完整测试套件。若新代码缺少测试,按计划中定义的测试策略委派 developer-fast 补充。工作流关闭前所有测试必须通过,无例外。

第 8 步 — 文档与 Git 审查:收尾前做一次清理:为所有新公开 API 添加 JSDoc / docstrings,为非显而易见逻辑添加行内注释;若功能需要新安装步骤、环境变量或行为变化则更新 README;新增环境变量则更新 .env.example;移除全部调试产物(无 console.log、无注释掉的代码、无临时文件);运行 git status 与 git diff --stat 确认只改动预期文件。

第 9 步 — 最终总结:涵盖构建内容、参与的智能体、完成任务数、变更文件数(新增与修改)、测试结果(通过/总数,如有覆盖率)、与原计划的偏差及理由、警告或部署后注意事项(迁移、环境变量等)、建议的后续步骤(审查 git diff、提交、开 PR、部署)。

关键规则

build 智能体拥有工作流(开始与结束均由其负责);仔细彻底阅读计划,每个动作都可追溯到计划;彻底遵循指令,严格照计划执行,不重新解释或跳步;委派前加载语言技能;使用任务提示词模板,绝不用模糊描述委派;每个任务前进前先验证(测试、类型检查、lint),不累积失败;委派对象为 developer-prime 与 developer-fast;被阻塞时立即咨询,principal-architect、solution-architect、database-architect、security-expert 随时待命;默认并行,独立任务或咨询不串行;全程用 TodoWrite 跟踪每个任务;质量门为强制项;所有测试必须通过;关闭前清理(更新文档、移除调试代码、核对 git status)。

智能体名册

  • 编排者:build — 工作流所有者,读取计划、委派、升级、关闭。
  • 实现者:developer-prime — 复杂、多文件、长上下文与前端任务;developer-fast — 范围明确、单文件、模板化与高量任务。
  • 顾问(Think → Advise → Review,只读、不修改代码):principal-architect — 高层系统策略、跨服务架构、技术治理;solution-architect — 具体服务设计、跨组件接口;database-architect — 数据建模、schema、查询优化、迁移;security-expert — 威胁建模、密码学、认证、安全编码。

适用场景与限制

该技能适用于需要按既定计划执行实现、并强调并行执行、逐任务验证、强制质量门与全量测试通过的场景;其前提是已有计划文件并采用 OpenCode 智能体体系(build、developer-prime、developer-fast、各顾问)。资料未提供关于收费、价格、支持平台或安装命令的信息,暂未提供。