SuperAPI AI 工具集

alignfirst-developer-openclaw-playbook

通用与其它

查看项目

更新于 10-16 09:49

技能介绍

用途:这是运行在 OpenClaw 上的 AlignFirst Developer 的操作指令分发器,用于把用户消息(含线程交接消息)路由到对应通道的处理流程。

主要能力与规则:

  1. 每次激活时,先读 surface playbook。若会话元数据带 topic_id,说明已在工作线程中,读 references/working-session.md 并继续,即使这是首条人类消息、尚未出现服务提示也不改变;有 channel: 前缀或 channel 标签也不另建线程。否则按 channel 或 DM 会话处理,读 references/channel-handling.md;conversation_label 即频道名。选择只依据元数据,读完 playbook 前不做 ls、grep、find 或项目查找。
  2. 通道会话直接回答普通对话;项目调查、变更、生命周期与运维委派会开启工作线程并结束通道回合,通道会话本身不做这些项目工作、不建工作区、不委派 alcode、不检查代码库。DM 保留其访问策略但不能启动此插件的工作线程流程。
  3. 投递:纯文本流入绑定路由,线程中是回复,频道中是根回复;只有结束回合的那条消息保证发出。每回合以用户必须看到的消息收尾,不要再用 message 重发。message 工具用于 starter、历史读取、Discord 改名、跨 surface 发布和附件;thread_handoff 启动后,通道回合以 NO_REPLY 结束。
  4. 项目:alproject list --json --root ~/projects 是权威清单。区分 PROJECT(主工作树目录名)与 PROJECT_PATH(规范绝对主工作树路径),后者锚定项目文件读取、主工作树 Git 命令、工作区工具与生命周期委派;工作区建立后用返回的链接工作树路径做分支工作与 alcode。通道/DM 按流程获取,线程从 starter 读取恢复,绝不凭记忆或由 ticket 前缀推导。
  5. 工单与协议:单项目开发任务需要 TICKET_ID;无票据系统访问时跳过外部操作并向用户要 ID;用户明确说无工单时,工作会话在建立工作区前预留 side-N。AlignFirst 协议仅用于单项目工作,项目引导、无主项目的多项目请求、工作区清理、基线刷新等运维工作委派给 alcode 且不使用协议。协议别名映射:alspec→spec、alplan→plan、al 或 AAD→aad、almerge→merge、alreview→review、aldescription→description;alcatchup 用 --catchup,alcatchupaad/alcatchupspec 为 --catchup 加 aad 或 spec。
  6. 委派 alcode:用 exec 从 PROJECT_PATH 或其链接工作树运行 alcode CLI;首次运行前先执行 alcode --openclaw-guide 并遵循它。必须走该 CLI,不用 sessions_spawn 等子会话。接手回合中首次编码委派前,需再次读取当前线程以捕获设置期间到达的人工指令。编码运行耗时长,用后台方式运行(background: true,timeoutSeconds: 0),退出时由心跳唤醒,按指南收尾。

限制:DM 无法启动工作线程流程;努力程度不得用时长表示;chat_id 须保留前缀完整传入,threadId 只传裸 ID;临时产物放 ~/.openclaw/workspace/scratch/ 或项目内被 gitignore 的 .local/,不放入受跟踪的 git 目录。具体项目与部署的工单权限取决于其自身说明。