SuperAPI AI 工具集

ce-work

编程与开发

查看项目

更新于 10-16 06:09

技能介绍

用途

ce-work 是一条工作流命令,用于把一份工作文档(计划、规格说明或待办文件)系统化地执行落地。它的目标是:在保持质量的前提下高效地交付功能,并将功能完整收尾。

主要能力

该命令将计划视为决策产物而非逐行执行脚本,围绕以下环节组织工作:

  1. 读取计划并澄清:完整阅读工作文档,识别其中的 Implementation Units、Work Breakdown、Requirements Trace、Files、Test Scenarios、Verification 等章节作为执行素材;关注每个实现单元的 Execution note(如 test-first 或 characterization-first)以及 Deferred to Implementation、Implementation-Time Unknowns、Scope Boundaries 等章节。若用户明确要求 TDD、test-first 或 characterization-first,则即使计划中没有 Execution note 也需遵从。
  2. 获取用户批准:存在不清晰或歧义之处,需先提出澄清问题,并获得用户批准后再继续。
  3. 环境设置:检查当前分支,判断是否已在功能分支上;若在默认分支上,则提供三种方式:新建功能分支、使用 worktree(推荐用于并行开发)、在默认分支上继续(需用户显式确认)。文档强调未经明确许可,绝不直接提交到默认分支。
  4. 创建任务清单:使用可用的任务跟踪工具把计划拆解为可执行任务,包含任务间依赖、优先级、测试与质量检查任务。
  5. 选择执行策略:根据计划规模和依赖结构,选择内联(1-2 个小任务或需要中途交互)、串行子代理(3 个以上有依赖的任务,避免上下文退化)或并行子代理(无共享依赖、文件不重叠的独立单元)。
  6. 执行循环:标记任务进行中、读取计划引用的文件、在代码库中寻找相似模式、遵循既有约定实现、为新功能编写测试、执行全局测试检查、运行测试、标记完成、评估是否增量提交。
  7. 全局测试检查(System-Wide Test Check):在任务完成前,追问本次改动会触发哪些回调、中间件、观察者或事件处理器;测试是否覆盖了真实链路;失败是否会留下孤儿状态;还有哪些接口暴露该行为;各层错误策略是否一致。对没有回调、无状态持久化、无并行接口的叶子节点改动可跳过。
  8. 增量提交:在逻辑单元完成、测试通过且有实质进展、即将切换上下文或即将尝试高风险改动时提交;不使用“WIP”式提交信息。文档给出了 git add 与 git commit 的示例命令。
  9. 遵循既有模式:优先阅读计划引用的相似代码,精确匹配命名约定,复用现有组件,遵循项目编码规范(AGENTS.md,仅在仓库仍保留兼容层时使用 CLAUDE.md)。
  10. 持续测试:每次重要改动后运行相关测试,立即修复失败,为新功能补充测试,并同时具备单元测试与集成测试。
  11. 边做边简化:在一簇相关实现单元完成后(或每 2-3 个单元)审查最近改动文件,合并重复模式、抽取共享辅助方法。若有 /simplify 技能则使用,否则自行审查。
  12. Figma 设计同步(如适用):按设计规范实现组件,迭代使用 figma-design-sync 代理比对并修复视觉差异,直到实现与设计一致。
  13. 质量检查:运行完整测试套件与 lint;针对复杂、高风险或大型改动,可选加载 ce:review 技能(mode:autofix);进行最终验证,包括任务完成、测试通过、lint 通过、遵循既有模式、Figma 设计匹配、无控制台错误或警告,并核对 Requirements Trace 与已解决的 Deferred to Implementation 问题。
  14. 编写运营验证计划(必需):在 PR 描述中加入 ## Post-Deploy Monitoring & Validation 章节,包含日志查询/搜索词、需关注的指标或仪表盘、预期健康信号、失败信号与回滚/缓解触发条件、验证窗口与负责人;若无生产/运行时影响,也需保留该章节并写明原因。
  15. 发布:执行 git add、git status、git diff --staged,然后以 conventional 格式提交,提交信息中包含 [MODEL]、[CONTEXT]、[THINKING]、[HARNESS]、[HARNESS_URL]、[VERSION] 等占位符的填写说明。
  16. 截图上传(UI 改动必需):启动开发服务器,使用 agent-browser CLI 打开页面、抓取快照并截图,再用 imgup 技能上传(如 imgup -h pixhost screenshot.png)。需截取新界面、修改界面的前后对比、以及设计实现匹配情况,并在 PR 描述中包含上传后的图片 URL。
  17. 创建 PR:推送分支并用 gh pr create 创建,PR 正文包含 Summary、Testing、Post-Deploy Monitoring & Validation、Before/After 截图表格、Figma 设计链接等。
  18. 更新计划状态:若输入文档的 YAML frontmatter 含 status 字段,将其更新为 completed。

使用方式

该技能以命令形式调用,接收一份工作文档作为输入参数(input_document,来源于 $ARGUMENTS)。调用后可选择执行策略,并在过程中按阶段推进:快速启动、执行、质量检查、发布。

适用场景

  • 需要按一份已有计划或规格说明系统化交付功能的开发工作。
  • 涉及 UI 改动并需要视觉验证与截图留档的前端任务。
  • 大型计划中可拆分为多个独立单元、适合并行或串行子代理执行的场景。

限制与说明

  • 文档明确指出:计划不应被期望包含实现代码、微步骤 TDD 指令或精确的 shell 命令。
  • 未经用户明确许可,绝不直接提交到默认分支。
  • 子代理创建提交/PR 时同样需要保证归属信息准确。
  • 该技能涉及外部依赖与工具(如 git、agent-browser、imgup、figma-design-sync、ce:review、Swarm Mode/Agent Teams),其中部分工具的具体用法在本文档中未完整提供。
  • 本技能是否收费、具体价格、支持的运行环境等事实,资料中暂未提供。