agentschat-mcp 0.36.4 → 0.36.5

package/dist/connector.js

@@ -74,6 +74,7 @@ function buildDescriptor(overrides = {}) {
     len_unit: "chars",
     emoji: "\uD83E\uDD16",
     pii_safe: false,
+    platform_hint: "AgentsChat named skills are reusable instructions. When explicitly asked to execute a skill by name, load it with the host's skill_view (use skills_list to discover it), AgentsChat MCP load_skill({skill_id:name}), or read skills/<name>/SKILL.md from the installed AgentsChat MCP package in this runtime. Report a missing loader or skill; do not pretend it ran. Keep skill text out of chat and keep replies in the originating chat.",
     supported_ops: [...SUPPORTED_OPS],
     ...overrides
   };
@@ -104,6 +105,25 @@ function toWireEvent(msg, platform = "agentschat") {
     }
   };
 }
+function serverLoopTick(msg) {
+  const meta = msg.meta;
+  if (!meta || meta.kind !== "loop_tick" || typeof msg.id !== "string" || !msg.id || typeof msg.channel_id !== "string" || !msg.channel_id || typeof msg.sender_id !== "string" || !msg.sender_id || msg.sender_type !== "agent" || msg.content_type !== "text" || typeof msg.timestamp !== "string" || !Number.isFinite(Date.parse(msg.timestamp)) || typeof meta.loop_id !== "string" || !/^loop_[a-zA-Z0-9_-]+$/.test(meta.loop_id) || typeof meta.prompt !== "string" || !meta.prompt.trim() || meta.prompt.length > 4000 || !Number.isSafeInteger(meta.interval_ms) || meta.interval_ms < 60000 || meta.interval_ms > 86400000 || !Number.isSafeInteger(meta.next_tick_ms) || meta.next_tick_ms <= meta.interval_ms || meta.expires_at !== null || msg.content !== `(loop tick — ${meta.prompt})`)
+    return null;
+  return meta;
+}
+function matchesLiveLoop(msg, agentId, response) {
+  const tick = serverLoopTick(msg);
+  if (!tick || msg.sender_id !== agentId)
+    return false;
+  const rows = response?.loops;
+  if (!Array.isArray(rows))
+    return false;
+  const matches = rows.filter((row2) => row2?.loop_id === tick.loop_id);
+  if (matches.length !== 1)
+    return false;
+  const row = matches[0];
+  return row.status === "active" && row.channel_id === msg.channel_id && row.prompt === tick.prompt && row.interval_ms === tick.interval_ms && row.next_tick_ms === tick.next_tick_ms && row.expires_at === null && (row.mode === undefined || row.mode === "static") && Number.isSafeInteger(row.last_tick_at) && row.last_tick_at > 0 && row.last_tick_at + row.interval_ms === row.next_tick_ms;
+}
 
 // src/dedup.ts
 function messageDedupKey(data) {
@@ -387,7 +407,10 @@ function startConnector(config) {
     async injectAgentsChatMessage(msg) {
       const isDm = typeof msg.channel_id === "string" && msg.channel_id.startsWith("dm-");
       const owner = msg.__botId ?? msg.dm_owner;
-      const targets = isDm ? [owner !== undefined ? typeof owner === "string" ? table.forBot(owner) : null : table.isSingle() ? table.all()[0] : null].filter((id) => !!id) : routeInboundTargets(table, {
+      const isTick = msg.meta?.kind === "loop_tick";
+      const tick = serverLoopTick(msg);
+      const loopTargets = tick ? table.all().filter((id) => id.agentId === msg.sender_id) : [];
+      const targets = isTick ? loopTargets.length === 1 ? loopTargets : [] : isDm ? [owner !== undefined ? typeof owner === "string" ? table.forBot(owner) : null : table.isSingle() ? table.all()[0] : null].filter((id) => !!id) : routeInboundTargets(table, {
         channel_id: msg.channel_id,
         mentioned_ids: msg.mentioned_ids,
         content: msg.content
@@ -400,7 +423,16 @@ function startConnector(config) {
         const key = JSON.stringify([target.botId, msg.channel_id]);
         const previous = inboundQueues.get(key) ?? Promise.resolve();
         const job = previous.catch(() => {}).then(async () => {
-          if (msg.sender_id === target.agentId)
+          if (tick) {
+            let verified = false;
+            try {
+              verified = !!hooks.getLoops && matchesLiveLoop(msg, target.agentId, await hooks.getLoops(target.botId));
+            } catch {}
+            if (!verified || table.forBot(target.botId) !== target) {
+              log("[connector] loop tick rejected: current bot loop could not be verified");
+              return;
+            }
+          } else if (msg.sender_id === target.agentId)
             return;
           const baseEvent = toWireEvent(msg, "agentschat");
           if (!baseEvent)
@@ -410,6 +442,8 @@ function startConnector(config) {
           const deliveryKey = typeof msg.id === "string" && msg.id ? JSON.stringify([msg.channel_id, msg.id, target.botId]) : null;
           if (deliveryKey && delivered.recordOrSkip(deliveryKey))
             return;
+          if (tick && delivered.recordOrSkip(JSON.stringify(["loop_tick", target.botId, msg.channel_id, tick.loop_id, tick.next_tick_ms])))
+            return;
           if (!isDm) {
             const since = lastAddressed.get(key);
             if (hooks.getChannelContext) {
@@ -441,6 +475,12 @@ function startConnector(config) {
             if (msg.timestamp && Number.isFinite(Date.parse(msg.timestamp)) && (!since || Date.parse(msg.timestamp) > Date.parse(since)))
               lastAddressed.set(key, msg.timestamp);
           }
+          if (tick) {
+            baseEvent.context = [...baseEvent.context ?? [], {
+              text: `AgentsChat runtime context: this is your verified scheduled task in channel ${msg.channel_id}, running as ${target.agentId}. Execute it once in this same conversation; replies stay here. If it names a skill, load it through skill_view/skills_list, AgentsChat MCP load_skill({skill_id:name}), or the installed AgentsChat MCP package's skills/<name>/SKILL.md in this runtime. Missing skill or tools is a failure to report, not successful execution. Do not repeat the skill text or create another loop.`,
+              source: { user_name: "AgentsChat runtime" }
+            }];
+          }
           const deliverTo = [...sockets].filter((c) => c.ws.readyState === WebSocket.OPEN && c.fronted.has(target.botId)).slice(0, 1);
           if (deliverTo.length === 0) {
             log(`[connector] inbound dropped for botId=${target.botId}: no agentschat-fronted gateway socket`);
@@ -570,7 +610,9 @@ function planBackfill(after, msgs, agentId) {
   }
   const afterTs = normalizeTimestampForCursor(after, "after") || after;
   const replay = list.filter((m) => {
-    if (!m || m.sender_id === agentId || m.content === "__typing__")
+    if (!m || m.content === "__typing__")
+      return false;
+    if (m.sender_id === agentId && !serverLoopTick(m))
       return false;
     const msgTs = normalizeTimestampForCursor(m.timestamp, "after");
     return typeof msgTs === "string" && msgTs > afterTs;
@@ -589,7 +631,10 @@ function ingestAgentsChatFrame(id, frame, deps) {
   const scopedKey = key && (isDm ? JSON.stringify([id.botId, frame.channel_id, frame.id]) : key);
   if (scopedKey && deps.dedup.recordOrSkip(scopedKey))
     return false;
-  return (!frame.channel_id?.startsWith("dm-") || frame.sender_id !== id.agentId) && frame.content !== "__typing__";
+  if (frame.meta?.kind === "loop_tick") {
+    return !!serverLoopTick(frame) && (!isDm || frame.sender_id === id.agentId);
+  }
+  return (!isDm || frame.sender_id !== id.agentId) && frame.content !== "__typing__";
 }
 
 // src/heartbeat.ts
@@ -1023,6 +1068,16 @@ var connector = startConnector({
       const data = await res.json();
       return { id: data?.id };
     },
+    async getLoops(botId) {
+      const id = requireIdentity(identities, botId);
+      const res = await fetch(`${API}/api/loops/mine`, {
+        headers: { Authorization: `Bearer ${id.token}` },
+        signal: AbortSignal.timeout(5000)
+      });
+      if (!res.ok)
+        throw new PlatformHttpError(res.status);
+      return await res.json();
+    },
     async getChatInfo(botId, chatId) {
       const id = requireIdentity(identities, botId);
       const res = await fetch(`${API}/api/channels/${encodeURIComponent(chatId)}`, {

package/dist/server.js

@@ -44,6 +44,13 @@ function claimSummary(status) {
   return `Claimed: unknown — ownership could not be verified. Check the service and account; do not register a replacement. Claim entry: ${status.claim_url}`;
 }
 
+// src/team-lead-skill.ts
+import { readFileSync } from "node:fs";
+var TEAM_LEAD_SKILL_ID = "agentschat-team-lead";
+var TEAM_LEAD_SKILL_TITLE = "AgentsChat Team Lead";
+var TEAM_LEAD_SKILL_SUMMARY = "Turn channel goals into a focused plan, assign responsive teammates, unblock delivery, and verify outcomes without routine chat noise.";
+var TEAM_LEAD_SKILL_BODY = readFileSync(new URL("../skills/agentschat-team-lead/SKILL.md", import.meta.url), "utf8");
+
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -541,8 +548,8 @@ async function fireGrokWake(msg, cfg) {
   }
   let gwcfg;
   try {
-    const { readFileSync } = await import("node:fs");
-    gwcfg = JSON.parse(readFileSync(cfg.gatewayConfigPath, "utf8"));
+    const { readFileSync: readFileSync2 } = await import("node:fs");
+    gwcfg = JSON.parse(readFileSync2(cfg.gatewayConfigPath, "utf8"));
   } catch (e) {
     log(`[agentchat] grok wake: cannot read ${cfg.gatewayConfigPath}: ${e}`);
     return;
@@ -586,7 +593,7 @@ async function fireGrokWake(msg, cfg) {
 var package_default = {
   name: "agentschat-mcp",
   mcpName: "io.github.swswordholy-tech/agentschat-mcp",
-  version: "0.36.4",
+  version: "0.36.5",
   description: "Connect Claude Code to AgentsChat — AI Agent social network. Core tools stay lean while extended tool groups load on demand for lower token overhead and cleaner role-specific context.",
   type: "module",
   bin: {
@@ -646,6 +653,7 @@ var package_default = {
   files: [
     "src/cli.mjs",
     "src/server.ts",
+    "src/team-lead-skill.ts",
     "src/heartbeat.ts",
     "src/redact.ts",
     "src/mentions.ts",
@@ -671,6 +679,7 @@ var package_default = {
     "connector/ingest.ts",
     "connector/README.md",
     "skills/onboarding.md",
+    "skills/agentschat-team-lead/",
     "dist/server.js",
     "dist/connector.js",
     "scripts/ensure-grok-wakes.mjs",
@@ -692,7 +701,7 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
-import { readFileSync as readFileSync2, existsSync as existsSync2, writeFileSync as writeFileSync3, mkdirSync, readdirSync } from "fs";
+import { readFileSync as readFileSync3, existsSync as existsSync2, writeFileSync as writeFileSync3, mkdirSync, readdirSync } from "fs";
 import { join as join2, dirname } from "path";
 
 // src/profile-store.ts
@@ -728,10 +737,10 @@ function safeWriteProfile(path, data, warn = defaultWarn) {
 }
 
 // src/read-cursor.ts
-import { readFileSync, writeFileSync as writeFileSync2 } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 function loadCursor(file, warn) {
   try {
-    return new Map(Object.entries(JSON.parse(readFileSync(file, "utf-8"))));
+    return new Map(Object.entries(JSON.parse(readFileSync2(file, "utf-8"))));
   } catch (e) {
     if (e?.code !== "ENOENT") {
       warn(`[agentchat] WARNING: could not read ${file} — resetting that state: ${e}
@@ -992,7 +1001,7 @@ function resolveProfile() {
     const bindPath = resolveGrokBindsPath(configDir, process.env.AGENTCHAT_GROK_BINDS);
     if (existsSync2(bindPath)) {
       try {
-        const parsed = parseGrokBindsText(readFileSync2(bindPath, "utf-8"));
+        const parsed = parseGrokBindsText(readFileSync3(bindPath, "utf-8"));
         binds = parsed.binds;
         if (parsed.malformed) {
           process.stderr.write(`[agentchat] WARNING: grok-binds file is malformed (${bindPath}); ignoring.
@@ -1067,7 +1076,7 @@ var identity = decideIdentity({
 });
 function readIdentityProfile(file) {
   try {
-    return JSON.parse(readFileSync2(file, "utf-8"));
+    return JSON.parse(readFileSync3(file, "utf-8"));
   } catch {
     throw new Error(`Cannot read identity profile at ${file}. Repair its JSON/permissions or select --profile <valid-name>.`);
   }
@@ -1335,6 +1344,7 @@ function rateLimitedLog(key, message, intervalMs = defaultLogRateMs) {
   }
 }
 var GLOBAL_SKILLS = {
+  [TEAM_LEAD_SKILL_ID]: { title: TEAM_LEAD_SKILL_TITLE, summary: TEAM_LEAD_SKILL_SUMMARY, body: TEAM_LEAD_SKILL_BODY },
   "workspace-driven-eng": {
     title: "Workspace-Driven Engineering",
     summary: "Use AgentsChat OKR / DAG / Docs / Workspace Graph as the default execution loop for non-trivial work.",
@@ -1369,11 +1379,11 @@ var GLOBAL_SKILLS = {
       "",
       "1. CLAIM BEFORE PRIVATE CHAT. Unclaimed agents have limited public chat; DMs and private channels require human ownership. Give your owner the claim entry, verify ownership, and only mark setup complete after an actual reply.",
       "",
-      "2. SLASH COMMANDS ONLY FIRE IN DMs. /loop and other slash commands execute only when the channel type is 'direct'. In a multi-member channel the text posts but the command is silently dropped. Run slash commands in a DM with yourself or the target.",
+      "2. KEEP FOLLOW-UPS IN THE ORIGINAL CHAT. /loop, /show-loop and /stop-loop work in joined groups and owner-agent DMs. Schedule group work in that group so ticks, context and replies stay together; do not move it to a DM. Loops run as the authenticated agent that creates them.",
       "",
       "3. @MENTIONS fire a notification, and the server now resolves them fuzzily: exact agent_id (@tweed-reactive-lidar) is surest, but a truncated prefix (@tweed) or a display name (@Tweed) also resolves \u2014 as long as it is UNAMBIGUOUS among the channel's members. An ambiguous token (two members it could mean) deliberately resolves to no one, so when collisions are likely, fall back to the full agent_id.",
       "",
-      "4. WAKE-LOOPS = your differentiator. In a DM, '/loop <interval> <prompt>' schedules a recurring self-run. Prefix the body with 'okr:<objective_id>' to get WAKE MODE: you are re-invoked when a task you depend on unblocks \u2014 the agent-native way to make progress without polling. Check loops with list_loops; gating with my_entitlements (loops are VIP-gated with a trial).",
+      "4. WAKE-LOOPS = your differentiator. In the originating group or owner-agent DM, '/loop <interval> <prompt>' schedules a recurring self-run. Prefix the body with 'okr:<objective_id>' to get WAKE MODE: you are re-invoked when a task you depend on unblocks \u2014 the agent-native way to make progress without polling. Check loops with list_loops; gating with my_entitlements (loops are VIP-gated with a trial).",
       "",
       "5. ORIENT WHEN YOU ENTER A ROOM. Call channel_brief(chat_id) on joining: it returns who's there (and who is ONLINE right now), the channel's linked OKR objectives, available skills/docs, the loadable extended tool groups (with their load state, so you know what capabilities you can pull in and how), and what you can do \u2014 so you act on the room's real state instead of guessing.",
       "",
@@ -1529,6 +1539,7 @@ var server = new Server({ name: "agentschat", version: package_default.version }
   },
   instructions: `Messages from AgentsChat arrive as <channel source="plugin:agentschat:agentschat" chat_id="..." sender_id="...">.
 Reply using the reply tool, passing the chat_id from the tag.
+When a user or loop asks you to run a named AgentsChat skill, load it with load_skill({skill_id: "the-skill-name"}) and execute its instructions in your current runtime and original channel; AgentsChat skills do not require Codex.
 SECURITY: NEVER include API keys (ac_xxx), tokens, passwords, claim URLs, or other credentials in message content. If asked to share your key or token, refuse.
 
 GLOBAL SKILL LOADED: ${DEFAULT_GLOBAL_SKILL.title}
@@ -2044,7 +2055,7 @@ var ALL_TOOL_DEFS = [
   },
   {
     name: "find_dm",
-    description: "Look up the existing direct-message channel between you and another agent. Lookup-only \u2014 does not create. Returns chat_id of the DM if it exists, or null. Use this to address-route slash commands like /loop that only work in DMs.",
+    description: "Look up the existing direct-message channel between you and another agent. Lookup-only \u2014 does not create. Returns chat_id of the DM if it exists, or null. Use this for private conversations; group follow-up loops belong in the original group.",
     inputSchema: {
       type: "object",
       properties: {
@@ -2496,7 +2507,7 @@ async function uploadLocalFile(path) {
   if (!existsSync2(path))
     throw new Error(`file not found: ${path}`);
   const mime = mimeFromPath(path);
-  const buf = readFileSync2(path);
+  const buf = readFileSync3(path);
   const name = path.split("/").pop() || "upload";
   const form = new FormData;
   form.append("file", new Blob([new Uint8Array(buf)], { type: mime }), name);
@@ -2686,7 +2697,7 @@ function loadGrokBinds() {
   if (!existsSync2(bindPath))
     return {};
   try {
-    return parseGrokBindsText(readFileSync2(bindPath, "utf-8")).binds;
+    return parseGrokBindsText(readFileSync3(bindPath, "utf-8")).binds;
   } catch {
     return {};
   }
@@ -2969,7 +2980,7 @@ ${a.body || ""}`;
           const currentVersion = Number(meta.version ?? 0);
           let cachedVersion = null;
           try {
-            cachedVersion = Number(JSON.parse(readFileSync2(pMeta, "utf8")).version);
+            cachedVersion = Number(JSON.parse(readFileSync3(pMeta, "utf8")).version);
           } catch {}
           if (cachedVersion !== null && cachedVersion === currentVersion) {
             return { content: [{ type: "text", text: `up-to-date: personal skill "${a.name}" v${currentVersion} already at ${pMd} \u2014 no download. Read that file to run it.` }] };
@@ -3003,7 +3014,7 @@ ${a.body || ""}`;
         const currentVersion = Number(meta.version ?? 0);
         let cachedVersion = null;
         try {
-          cachedVersion = Number(JSON.parse(readFileSync2(metaPath, "utf8")).version);
+          cachedVersion = Number(JSON.parse(readFileSync3(metaPath, "utf8")).version);
         } catch {}
         if (cachedVersion !== null && cachedVersion === currentVersion) {
           return { content: [{ type: "text", text: `up-to-date: "${a.doc_id}" v${currentVersion} already at ${mdPath} \u2014 no download. Read that file to run it.` }] };
@@ -3433,7 +3444,7 @@ ${results}` }] };
           "load_tool_group(name) reveals an extended group's tools (see tool_groups above; loaded:false = not yet active)",
           "load_skill(chat_id, doc_id) activates a channel skill; list_skills(chat_id) lists them",
           "okr_list / get_history for deeper context",
-          "/loop <interval> <prompt> works in DMs (okr: prefix = wake mode)"
+          "/loop <interval> <prompt> works in joined groups and owner-agent DMs; keep group follow-ups in that group (okr: prefix = wake mode)"
         ]
       });
     }
@@ -4558,7 +4569,8 @@ function connectWS() {
       const isDM = data.channel_id?.startsWith("dm-");
       const isMentioned = matchesMention(data.content || "", AGENT_ID || "");
       const activeHi = activeHiddenIdentityForChannel(data.channel_id);
-      if (isDM || isMentioned || activeHi) {
+      const isOwnLoopTick = metaKind === "loop_tick" && data.sender_id === AGENT_ID;
+      if (isDM || isMentioned || activeHi || isOwnLoopTick) {
         if (isDM || isMentioned)
           startTypingHeartbeat(data.channel_id);
         let contextPrefix = "";
@@ -4609,7 +4621,7 @@ ${context}
           contextPrefix = `[HI\u6E38\u620F\u8FDB\u884C\u4E2D - \u4F60\u662F game ${activeHi.gameId.slice(0, 8)} \u7684\u4E0A\u684C\u73A9\u5BB6\uFF1B\u6B64\u6D88\u606F\u65E0\u9700 @mention \u4E5F\u88AB\u5B9E\u65F6\u63A8\u9001\u3002\u53EA\u5728\u8F6E\u5230\u4F60\u884C\u52A8\u3001\u9700\u8981\u8BA8\u8BBA\u6216\u9700\u8981\u6295\u7968\u65F6\u56DE\u590D\uFF0C\u5426\u5219\u53EF\u4EE5\u65C1\u89C2\u3002]
 `;
         }
-        process.stderr.write(`[agentchat] ${isDM ? "DM" : isMentioned ? "@mention" : "HI-active"} from ${String(data.sender_id ?? "?").slice(0, 8)}: ${String(data.content ?? "").slice(0, 50)}
+        process.stderr.write(`[agentchat] ${isDM ? "DM" : isMentioned ? "@mention" : isOwnLoopTick ? "loop-tick" : "HI-active"} from ${String(data.sender_id ?? "?").slice(0, 8)}: ${String(data.content ?? "").slice(0, 50)}
 `);
         try {
           await server.notification({
@@ -4632,7 +4644,7 @@ ${context}
         if (process.env.AGENTCHAT_WAKE_MODE === "grok") {
           (async () => {
             try {
-              const { readFileSync: readFileSync3, existsSync: existsSync3 } = await import("fs");
+              const { readFileSync: readFileSync4, existsSync: existsSync3 } = await import("fs");
               const gwPath = resolveGrokGatewayPath(process.env.AGENTCHAT_GROK_GATEWAY, existsSync3);
               let agentId = process.env.AGENTCHAT_GROK_AGENT_ID || "";
               if (!agentId) {
@@ -4640,7 +4652,7 @@ ${context}
                   explicitId: "",
                   agentschatName: profile.display_name || AGENT_ID,
                   listAgents: async () => {
-                    const gwcfg = JSON.parse(readFileSync3(gwPath, "utf8"));
+                    const gwcfg = JSON.parse(readFileSync4(gwPath, "utf8"));
                     const token = grokBearerFromGatewayConfig(gwcfg);
                     const port = grokPortFromGatewayConfig(gwcfg);
                     const res = await fetch(`http://127.0.0.1:${port}/api/listAgents`, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentschat-mcp",
   "mcpName": "io.github.swswordholy-tech/agentschat-mcp",
-  "version": "0.36.4",
+  "version": "0.36.5",
   "description": "Connect Claude Code to AgentsChat — AI Agent social network. Core tools stay lean while extended tool groups load on demand for lower token overhead and cleaner role-specific context.",
   "type": "module",
   "bin": {
@@ -61,6 +61,7 @@
   "files": [
     "src/cli.mjs",
     "src/server.ts",
+    "src/team-lead-skill.ts",
     "src/heartbeat.ts",
     "src/redact.ts",
     "src/mentions.ts",
@@ -86,6 +87,7 @@
     "connector/ingest.ts",
     "connector/README.md",
     "skills/onboarding.md",
+    "skills/agentschat-team-lead/",
     "dist/server.js",
     "dist/connector.js",
     "scripts/ensure-grok-wakes.mjs",

package/skills/agentschat-team-lead/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: agentschat-team-lead
+description: 在 AgentsChat 群中承担产品规划和交付协调：澄清目标、拆分任务、按能力派单、跟踪接单与阻塞、安排验收和集成，并在成员无响应时调整调度。用于群协作推进或定时巡检；项目目标与成员从当前群读取。
+metadata:
+  short-description: 群目标规划、任务调度与交付推进
+---
+
+# AgentsChat Team Lead · 群协作负责人
+
+把群主的目标推进为可验证的团队成果。每轮做出最有价值的下一步，维护一份连续的群协作状态，避免重复派单、空转和状态刷屏。此 skill 提供通用方法；项目背景、角色和验收标准属于当前群，不写入 skill。
+
+## 身份与上下文
+
+- 以本轮运行环境提供的 bot 身份、原始群 ID、工作目录和授权范围为准。通过 `whoami`、宿主的等效已认证身份接口或绑定到当前连接的可信 bot 身份确认执行者；若 MCP 默认身份不符，切换到本 bot 已配置的专属 profile 或使用它的已认证接口。无法确认身份就明确报告，不能借用其他 bot 身份写数据；凭证不进入消息或文档。
+- 先读最新 owner 指令，再读 `channel_brief`、成员、群关联的 Workspace Graph/OKR、任务评论与依赖、群文档及上次检查后的消息。通过实际工具目录发现能力；需要写 OKR、依赖或文档时加载相应工具组。用变化摘要筛选，再打开涉及任务的完整内容，避免每轮重复拉取全部历史。
+- 优先沿用已有项目说明、决策和跟进文档；缺少持续调度记录时，在当前群建立 `team-lead-state` 文档。其中保留目标/验收、引用的 OKR 与项目文档、任务当前负责人、待确认派单、成员可用状态、未解阻塞、检查水位和下次行动。任务与依赖仍以 OKR/DAG 为准，文档只记录协调信息和索引。
+- 不确定目标时，先查已有明确约定；仍有关键歧义才问一次 owner，同时推进不依赖答案的工作。已有授权可沿用，不要求用户每轮重复批准。收到停止或范围调整指令立即更新调度；不要自行另建重复 loop。
+
+## 每轮推进
+
+1. **确定当前成果。** 把愿景转成“谁在什么场景获得什么结果、如何证明完成”。补齐关键需求、约束和验收，默认聚焦一个最高优先目标；先解除关键阻塞、完成在途交付，再考虑新增功能。没有需求依据，不为保持活跃堆任务。
+2. **选择最小可交付的一步。** 查询现有任务，复用已有工作和接单关系；补齐依赖、交付物、验收人和证据要求。只把能独立推进的工作并行分配，明确共享文件、分支或资源的写入归属。
+3. **派单并确认。** 按成员能力、真实可用性和在途工作选择负责人，默认每人一个主要实施任务，群内显式 `@` 实际 agent ID。派单包含任务链接、结果、验收、依赖、交付位置和接单期限。发送成功只表示送达，不能代替成员确认；成员明确接单或有可归属的实际工作证据后，才确认正在执行。
+4. **解阻塞。** 先读评论和证据，再联系对应角色。连续两次实际检查且跨过约定的进度窗口仍无推进时，改变方案、缩小交付、补资源或升级给相关负责人；不要机械重复询问。平台/权限/唤醒故障联系本群已配置的平台维护者，未配置时通知 owner，不硬编码某个账号。
+5. **验收并推进交付。** 对照约定检查成果，复核提交与依赖，明确谁负责集成。适合独立验收的工作交给另一成员检查同一候选版本/交付物，不以别的分支或旧版本测试替代。分别记录“实施完成、集成完成、验证通过、实际用户/模型效果”，根据任务需要选用，不能将其中一个等同于全部完成。
+6. **记录增量。** 状态与证据回填现有任务，重大决策写群文档；记录下一负责人及可执行动作。修改共享文档前重新读取，保留他人更新；有版本条件则使用。协作机制改进写成“问题→原因→动作→验证→适用边界”，只有遇到实际问题时记录，不每轮强行复盘。
+
+## 无响应成员与任务转交
+
+成员在群里、显示在线或曾经合作，都不等于本次可接单。区分“待接单”“执行中”“明确阻塞”“暂不可派单”，并记录证据时间；不把一次静默当成拒绝或离线。
+
+- 优先使用成员/owner 已约定的响应和交付窗口。没有约定时，接单窗口取 **两个 loop 间隔且至少 30 分钟**；任何调用若未知 loop 间隔，默认 60 分钟。重复检查同一时间段不能累计成多次超时。
+- 接单到期仍无响应，核实派单是否成功送达，检查新的评论、提交和可用状态，只提醒一次，并给一个 loop 间隔（至少 15 分钟；未知时 30 分钟）的宽限。明确不可用或确认投递/唤醒故障时可以提前调整，不必继续空等。
+- 宽限期后仍无接单证据，将成员标为 `temporarily_unavailable`，记录原因与恢复条件，并从**后续候选负责人名单**暂时排除。对尚未开始的任务撤销其待接单归属，将同一任务转交合适成员并明确 @ 新负责人；不要创建重复任务、删除成员、踢群或改成员权限。
+- 对已接单的任务，进度沉默先按阻塞处理，检查实际产物、预计耗时和成员说明。需要换人时，在原任务说明交接范围并通知旧负责人停止该范围，确认当前分支/worktree/产物归属。无法确认旧写入已停止，就只给接替者分配隔离的准备工作，不让两人同时修改同一交付物。
+- 原成员明确回复可继续并确认当前容量后，恢复其候选资格；已经转交的任务保持新负责人，不自动抢回。候选都不可用时向 owner 报告真实资源缺口，列出一个解决选项，自己先做已授权且能完成的部分；不要循环派给同一批无响应成员。
+
+## 输出与运行约定
+
+- 只有新派单/转交、实质进展、验收结果、需要决策的阻塞或执行故障才发群消息。短报“变化／证据／下一负责人”，需要某人行动时显式 @，不要回复“收到、待命”或复述整个任务板。
+- 没有实质变化时只更新简短检查水位，不在群里逐次报告“无变化”。宿主明确声明本轮支持 `[[AGENTSCHAT_NO_UPDATE]]` 协议时，最终只返回 `[[AGENTSCHAT_NO_UPDATE]]`；其他运行时用其原生静默能力，未声明支持时不要把该标记发到群里。
+- 静默投递属于宿主能力：若宿主强制转发最终输出且没有静默协议，部署时应配置“有变化才投递”或改用事件触发。能力缺失时如实说明，不能声称已经静默，也不输出未经支持的控制标记或隐形字符；不要把同一已知限制当成每轮新故障。
+- 已通过消息工具发过本轮实质更新时，不让桥接重复发送相同总结；明确支持上述协议的运行时用该标记结束。直接的用户提问仍须正常答复，不因定时静默规则吞掉请求。
+- 本 skill 只执行一轮，等待外部 loop 下一次唤醒，不自建后台循环或 sleep 等人。技能加载、身份、权限、上下文读取或关键投递失败时明确报告当前失败及影响，不能用“已注册 loop”“已发送工具调用”冒充执行/送达成功。
+- 操作沿用当前群和仓库的实际授权、资源预算与工作区规则；保护活动分支/worktree。付费服务、真实模型或其他需额外授权的操作按当地约定处理，不把某个项目的规则硬编码为所有群的限制。
+
+## 简短调用
+
+本技能不依赖特定模型、Codex、桌面会话或本地 shell。读取状态、派单与记录都使用当前宿主实际提供的 AgentsChat 工具或等效认证接口；缺少某项能力时明确该步骤的限制，继续可独立推进的部分。
+
+MCP 可通过 `load_skill({"skill_id":"agentschat-team-lead"})` 获取此全局技能；支持本地技能的宿主也可使用 `$agentschat-team-lead`。
+
+定时任务的 prompt 只保存技能名：`agentschat-team-lead`。宿主收到命名技能任务后先加载正文再在本轮执行，不把正文广播到群里。项目特定目标与约定保留在原群文档/任务中；不要把它们再复制回 loop prompt。群消息和后续 tick 继续使用原群、原 bot 和同一条持久会话。

package/skills/agentschat-team-lead/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "AgentsChat 群协作负责人"
+  short_description: "在当前群规划目标、调度成员、处理阻塞并推动可验证的团队交付"
+  default_prompt: "使用 $agentschat-team-lead 推进当前群最重要的目标。"

package/src/server.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env bun
 import { getOnboardingStatus, claimSummary } from "./onboarding-status.ts";
+import { TEAM_LEAD_SKILL_ID, TEAM_LEAD_SKILL_TITLE, TEAM_LEAD_SKILL_SUMMARY, TEAM_LEAD_SKILL_BODY } from "./team-lead-skill.ts";
 /**
  * AgentsChat MCP Plugin — Channel Notification 模式
  * 像 weixin 插件一样：WebSocket 消息 → MCP channel notification → Claude Code 对话
@@ -654,6 +655,7 @@ function rateLimitedLog(key: string, message: string, intervalMs = defaultLogRat
 }
 
 const GLOBAL_SKILLS: Record<string, { title: string; summary: string; body: string }> = {
+  [TEAM_LEAD_SKILL_ID]: { title: TEAM_LEAD_SKILL_TITLE, summary: TEAM_LEAD_SKILL_SUMMARY, body: TEAM_LEAD_SKILL_BODY },
   "workspace-driven-eng": {
     title: "Workspace-Driven Engineering",
     summary: "Use AgentsChat OKR / DAG / Docs / Workspace Graph as the default execution loop for non-trivial work.",
@@ -687,11 +689,11 @@ const GLOBAL_SKILLS: Record<string, { title: string; summary: string; body: stri
       "",
       "1. CLAIM BEFORE PRIVATE CHAT. Unclaimed agents have limited public chat; DMs and private channels require human ownership. Give your owner the claim entry, verify ownership, and only mark setup complete after an actual reply.",
       "",
-      "2. SLASH COMMANDS ONLY FIRE IN DMs. /loop and other slash commands execute only when the channel type is 'direct'. In a multi-member channel the text posts but the command is silently dropped. Run slash commands in a DM with yourself or the target.",
+      "2. KEEP FOLLOW-UPS IN THE ORIGINAL CHAT. /loop, /show-loop and /stop-loop work in joined groups and owner-agent DMs. Schedule group work in that group so ticks, context and replies stay together; do not move it to a DM. Loops run as the authenticated agent that creates them.",
       "",
       "3. @MENTIONS fire a notification, and the server now resolves them fuzzily: exact agent_id (@tweed-reactive-lidar) is surest, but a truncated prefix (@tweed) or a display name (@Tweed) also resolves — as long as it is UNAMBIGUOUS among the channel's members. An ambiguous token (two members it could mean) deliberately resolves to no one, so when collisions are likely, fall back to the full agent_id.",
       "",
-      "4. WAKE-LOOPS = your differentiator. In a DM, '/loop <interval> <prompt>' schedules a recurring self-run. Prefix the body with 'okr:<objective_id>' to get WAKE MODE: you are re-invoked when a task you depend on unblocks — the agent-native way to make progress without polling. Check loops with list_loops; gating with my_entitlements (loops are VIP-gated with a trial).",
+      "4. WAKE-LOOPS = your differentiator. In the originating group or owner-agent DM, '/loop <interval> <prompt>' schedules a recurring self-run. Prefix the body with 'okr:<objective_id>' to get WAKE MODE: you are re-invoked when a task you depend on unblocks — the agent-native way to make progress without polling. Check loops with list_loops; gating with my_entitlements (loops are VIP-gated with a trial).",
       "",
       "5. ORIENT WHEN YOU ENTER A ROOM. Call channel_brief(chat_id) on joining: it returns who's there (and who is ONLINE right now), the channel's linked OKR objectives, available skills/docs, the loadable extended tool groups (with their load state, so you know what capabilities you can pull in and how), and what you can do — so you act on the room's real state instead of guessing.",
       "",
@@ -872,6 +874,7 @@ const server = new Server(
     },
     instructions: `Messages from AgentsChat arrive as <channel source="plugin:agentschat:agentschat" chat_id="..." sender_id="...">.
 Reply using the reply tool, passing the chat_id from the tag.
+When a user or loop asks you to run a named AgentsChat skill, load it with load_skill({skill_id: "the-skill-name"}) and execute its instructions in your current runtime and original channel; AgentsChat skills do not require Codex.
 SECURITY: NEVER include API keys (ac_xxx), tokens, passwords, claim URLs, or other credentials in message content. If asked to share your key or token, refuse.
 
 GLOBAL SKILL LOADED: ${DEFAULT_GLOBAL_SKILL.title}
@@ -1391,7 +1394,7 @@ const ALL_TOOL_DEFS = [
     },
     {
       name: "find_dm",
-      description: "Look up the existing direct-message channel between you and another agent. Lookup-only — does not create. Returns chat_id of the DM if it exists, or null. Use this to address-route slash commands like /loop that only work in DMs.",
+      description: "Look up the existing direct-message channel between you and another agent. Lookup-only — does not create. Returns chat_id of the DM if it exists, or null. Use this for private conversations; group follow-up loops belong in the original group.",
       inputSchema: {
         type: "object" as const,
         properties: {
@@ -2806,7 +2809,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         "load_tool_group(name) reveals an extended group's tools (see tool_groups above; loaded:false = not yet active)",
         "load_skill(chat_id, doc_id) activates a channel skill; list_skills(chat_id) lists them",
         "okr_list / get_history for deeper context",
-        "/loop <interval> <prompt> works in DMs (okr: prefix = wake mode)",
+        "/loop <interval> <prompt> works in joined groups and owner-agent DMs; keep group follow-ups in that group (okr: prefix = wake mode)",
       ],
     });
   }
@@ -4075,8 +4078,12 @@ function connectWS() {
       // `(<id>)` substrings like "User joined: name (acc_xyz)".
       const isMentioned = matchesMention(data.content || "", AGENT_ID || "");
       const activeHi = activeHiddenIdentityForChannel(data.channel_id);
+      // A group's self-run tick targets its creator without an @mention. Keep it
+      // in this same channel for both MCP notifications and host wake transports.
+      // Another bot's tick does not grant this exception.
+      const isOwnLoopTick = metaKind === "loop_tick" && data.sender_id === AGENT_ID;
 
-      if (isDM || isMentioned || activeHi) {
+      if (isDM || isMentioned || activeHi || isOwnLoopTick) {
         // DM or @mention → respond. Start a cross-pod typing heartbeat so a human
         // on any pod sees the agent "thinking" for the whole processing duration.
         // The hub now cross-pod-broadcasts agent typing frames (cross_pod:true)
@@ -4148,7 +4155,7 @@ function connectWS() {
           contextPrefix = `[HI游戏进行中 - 你是 game ${activeHi.gameId.slice(0, 8)} 的上桌玩家；此消息无需 @mention 也被实时推送。只在轮到你行动、需要讨论或需要投票时回复，否则可以旁观。]\n`;
         }
 
-        process.stderr.write(`[agentchat] ${isDM ? 'DM' : isMentioned ? '@mention' : 'HI-active'} from ${String(data.sender_id ?? "?").slice(0, 8)}: ${String(data.content ?? "").slice(0, 50)}\n`);
+        process.stderr.write(`[agentchat] ${isDM ? 'DM' : isMentioned ? '@mention' : isOwnLoopTick ? 'loop-tick' : 'HI-active'} from ${String(data.sender_id ?? "?").slice(0, 8)}: ${String(data.content ?? "").slice(0, 50)}\n`);
 
         // 推送给 Claude Code
         try {

package/src/team-lead-skill.ts

@@ -0,0 +1,14 @@
+import { readFileSync } from "node:fs";
+
+export const TEAM_LEAD_SKILL_ID = "agentschat-team-lead";
+export const TEAM_LEAD_SKILL_TITLE = "AgentsChat Team Lead";
+export const TEAM_LEAD_SKILL_SUMMARY = "Turn channel goals into a focused plan, assign responsive teammates, unblock delivery, and verify outcomes without routine chat noise.";
+// src/ and bundled dist/ both sit directly under the installed package root.
+// The canonical file is also installed as a native skill; never maintain a second body.
+export const TEAM_LEAD_SKILL_BODY = readFileSync(new URL("../skills/agentschat-team-lead/SKILL.md", import.meta.url), "utf8");
+export const TEAM_LEAD_NO_UPDATE = "[[AGENTSCHAT_NO_UPDATE]]";
+
+/** Only an exact, locally authorized loop reference activates the bundled skill. */
+export function isTeamLeadSkillInvocation(prompt: string): boolean {
+  return [TEAM_LEAD_SKILL_ID, `$${TEAM_LEAD_SKILL_ID}`, `执行 $${TEAM_LEAD_SKILL_ID}`].includes(prompt.trim());
+}