From devark
General-purpose ets_runtime development orchestrator for feature work, bug fixes, refactors, and tests under arkcompiler/ets_runtime. Use when Codex should clarify requirements, persist a plan and task list, coordinate implementation/review loops, and finish with build verification for ets_runtime changes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/devark:devarkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
负责把 ets_runtime 开发任务拆成可恢复、可审查的原子任务,并协调实现、评审、编译验证。
负责把 ets_runtime 开发任务拆成可恢复、可审查的原子任务,并协调实现、评审、编译验证。
启动时先确定 SKILL_ROOT(devark 资源目录,包含 review.md、format.sh 等文件):
**/devark/review.mdreview.md 所在目录作为 SKILL_ROOT后续所有 SKILL_ROOT/ 引用均指此路径。
以下文件位于 SKILL_ROOT/,按需读取,不要一次性全部加载:
| 文件 | 用途 |
|---|---|
review.md | 5 项评分标准 |
mistakes.md | 常见错误模式(可追加) |
.clang-format | 代码格式化配置 |
format.sh | 格式化 git 工作区中已修改的 C/C++ 文件(仅修改行) |
ets_runtime.md | ets_runtime 编译、测试、运行参考(按需读取) |
states.md | Task 状态定义 |
plan-template.md | Plan 输出模板 |
tasks-template.md | tasks.md 模板 |
Task 状态定义详见 SKILL_ROOT/states.md。
在开始需求确认之前,先检查当前分支是否有已存在的 plan/tasks:
git branch --show-current.agents/devark/<branch-name>/plan.md 是否存在plan.md 和 tasks.md,询问用户是继续未完成的任务,还是开始新任务覆盖旧文件先与用户确认工作分支:
git checkout -b <branch-name> <base-branch>在写任何代码之前,必须先完成需求确认:
只在会影响设计或验证结果的点上追问用户,避免把简单任务问成访谈。
需求确认后,参照 SKILL_ROOT/plan-template.md 输出实现计划,并立即持久化:
git branch --show-current.agents/devark/<branch-name>/.agents/devark/<branch-name>/docs/.agents/devark/<branch-name>/plan.md:保存完整 Plan 内容.agents/devark/<branch-name>/tasks.md:参照 SKILL_ROOT/tasks-template.md 生成⚠️ 持久化后先让用户确认 Plan 没有问题,再进入下一步。
如果当前环境不支持按名称派发 devark-worker / devark-reviewer,Planner 仍要维护同一套状态机、产物位置和提交边界,不要退化成临时手工流程。
本地执行 Worker 时,严格按 devark-worker 的 contract 自行完成:
in_progressSKILL_ROOT/review.md、mistakes.md、states.md,按 TDD 顺序完成测试和实现.agents/devark/<branch-name>/docs/,不要把这类工作文档写到源码目录或 repo 根目录test/jittest/...),不要用临时 C++ harness、repo-local 草稿文档或一次性脚本代替最终交付;若临时验证文件确实必要,验证后删除,不能留在最终工作区状态里SKILL_ROOT/format.shtasks.md:完成后置为 in_review,阻塞时置为 blockedgit add 代码、文档和任务跟踪文件;首轮创建 Task commit,后续返工、review/build 元数据更新都通过 git commit --amend 折叠回同一个 Task commit。不要把变更留在未提交状态下进入 Review 或结束任务,也不要为同一 Task 追加 persist review/build state 之类的 follow-up commit本地执行 Reviewer 时,严格按 devark-reviewer 的 contract 自行完成:
git show HEAD 审查最近一次提交,而不是审查未提交工作区review.md 固定档位打分,并对照 mistakes.md.agents/devark/<branch-name>/docs/review_round_<N>.md(或等价命名)completed,不通过则置为 reworktasks.md 或后续 build 记录导致工作区再次变脏,git add 这些 workflow 文件并执行 git commit --amend --no-edit,把状态变化折叠回当前 Task commit;不要再追加 chore(devark): persist review/build state for task N 这类 follow-up commit优先将每个原子任务委派给 devark-worker;如果当前环境不支持命名 worker,就按上面的本地 fallback 规则自行实现。
委派时提供以下上下文:
SKILL_ROOT)project_root)docs_dir).agents/devark/<branch-name>/tasks.md)Task N)禁止编译Worker 完成后会执行 SKILL_ROOT/format.sh 格式化代码。本地 fallback 也必须执行同样的格式化、任务状态更新和 commit,并保证同一 Task 最终只保留一个 commit。
Worker 返回 BLOCKED 时,读取 tasks.md 中对应 Task 的 Reason,按原因处理:
clang-format not found:提示用户安装 clang-format(如 apt install clang-format 或 brew install clang-format),安装后重新派发该 Task优先将代码审查委派给 devark-reviewer;如果当前环境不支持命名 reviewer,就按上面的本地 fallback 规则执行一次完整 Review。
委派时提供以下上下文:
SKILL_ROOT).agents/devark/<branch-name>/docs/).agents/devark/<branch-name>/tasks.md)Task N)Review 结果处理:
| 结果 | 动作 |
|---|---|
| ≥95 分 | 通过,进入下一步 |
| <95 分(第 1-3 轮) | 将 Reviewer 的修复建议附给 Worker,重新派发 |
| <95 分(第 3 轮后) | 升级给用户决策 |
返工轮继续沿用当前 Task commit,修复后通过 git commit --amend 更新;不要为同一 Task 叠加新的代码 commit。
Read SKILL_ROOT/ets_runtime.md("Planner 编译验证流程"章节)获取详细流程,简要:
buildingblocked,Reason 写 not an ets_runtime repo, build command unknown,向用户询问编译命令donebuild_failed,Reason 写编译错误摘要,附错误信息重新派发 Worker本地 fallback 完成编译验证后,如果 tasks.md、review/build 文档或其他 workflow 元数据发生变化,也要把这些变化持久化;持久化方式应为 git commit --amend --no-edit 折叠回当前 Task commit,不要只把代码提交掉而把状态文件留在未提交状态,也不要再追加单独的 workflow commit。
所有 Task 状态为 done 后,汇总报告结果。
plan.md 和 tasks.md 不删除,作为历史记录保留。
工作过程中如果发现新的错误模式(Worker 或 Reviewer 反复犯的错),应追加到 SKILL_ROOT/mistakes.md。
persist review/build state 一类独立 commit.agents/devark/<branch>/docs/、tasks.md 或 commitnpx claudepluginhub ekil1100/claude-markplace --plugin devarkPlans, implements, and tests code features locally using agent teams with parallel git worktrees and autonomous execution. For build requests, bugs, improvements, or task files; no deploys.
Executes implementation plans with independent tasks in the current session by dispatching fresh subagents per task with two-stage self-review and final global review.
Initiates tasks by interviewing user for requirements, setting up git-wt worktrees or branches, checking tools like direnv/dotenvx, and creating plans for review.