evolcore 0.0.32 → 0.0.33

package/kits/rules/07-memory-and-thread.md

@@ -0,0 +1,202 @@
+# 记忆与话题：持久化上下文的两套机制
+
+触发词：记忆/memory/话题/thread/summary/摘要/ec memory/ec thread/话题名/工作报告
+
+这两套机制共同解决"跨会话上下文丢失"的问题，但定位不同：
+
+| 机制 | 粒度 | 作用 | 写入时机 |
+|------|------|------|----------|
+| 记忆（memory） | 对端级 / agent 级 / owner 级 | 跨所有话题持久化的长期事实 | 每轮对话中识别到值得保留的事实时 |
+| 话题摘要（summary） | 话题级 | 这个话题的进展快照，供下次激活时快速恢复 | 阶段完成时、离开话题前 |
+
+两者不冲突，按粒度分工：对端的基本信息（偏好、角色、背景）写进记忆；这个任务线做了什么、结果如何写进话题摘要。
+
+---
+
+## 一、记忆系统（ec memory）
+
+记忆是写给自己、跨会话持久的事实。不要依赖会话上下文来记住用户说过的事，用记忆系统写下来。
+
+### 什么时候写记忆
+
+**必须写的情况**：
+- 用户告知了关于自己的事实（姓名、职业、偏好、背景）
+- 用户明确要求"记住"某件事
+- 发现了跨会话有用的规律（用户的工作方式、反馈模式）
+
+**不要写的情况**：
+- 当前话题的具体进展（写话题摘要，不写记忆）
+- 只在本会话有意义的临时状态
+- 代码结构、文件路径、git 历史（代码库本身就记录了）
+
+### 记忆命令
+
+```bash
+# 写入新 note
+ec memory note --slug <slug> [--tags <tag1,tag2>] "<正文>"
+
+# 修改已有 note
+ec memory note --slug <slug> --update "<新正文>"
+
+# 查看记忆概览
+ec memory show
+
+# 查看待整理 notes
+ec memory notes
+
+# 触发整理会话（将 notes 归档为正式记忆）
+ec memory consolidate
+```
+
+### 默认行为
+
+记忆写入动作默认**静默**，不打断对话。用户明确要求记住某事时，给一句简短确认（"已记下"），然后继续。
+
+---
+
+## 二、话题系统（ec thread）
+
+### 标准工作流
+
+```bash
+# 1. 列出本机所有 agent
+ec agent list
+
+# 2. 列出某 agent 有话题记录的所有对端
+ec thread peers --self <selfAid>
+
+# 3. 列出与某对端的所有话题（默认10条/页，含消息统计和摘要）
+ec thread list <peer> --self <selfAid>
+
+# 4. 翻页（页脚自动给出完整翻页命令，含真实 peer 和 selfAid）
+ec thread list <peer> --self <selfAid> --page 2 --limit 10 --sort recent
+
+# 5. 查看某话题的历史消息
+ec thread history <peer>/<threadId> --self <selfAid> --limit 20
+
+# 6. 查看/更新话题摘要
+ec thread summary show <peer>/<threadId> --self <selfAid>
+```
+
+### 跨话题发送（联系当前对端以外的对象）
+
+一个话题只有本端与对端两端。当前话题能直接回复的只有本话题的对端；要联系**其他**对象，必须换到与该对象的话题上发送：
+
+```bash
+# 1. 选中目标话题（没有就新建）
+ec thread list <对方AID> --self <selfAid>
+ec thread create <对方AID> --name "问题跟踪" --self <selfAid>   # 返回 threadId
+
+# 2. 带上话题发送；托管会话中 from/to 由话题推断，--check-every 必填
+ec msg send "<text>" --thread <threadId> --check-every 5m
+ec group send "<text>" --thread <threadId> --check-every 5m     # 群对端
+```
+
+- 不带 `--thread` 而直接把目标换成第三方，会被运行时拒绝（只能联系当前对端/群）
+- `--thread` 指定的话题必须已存在于本端索引，否则报 `TOPIC_NOT_FOUND`
+- 发送成功后本端写入 thread-inbox：目标话题下次被唤醒时注入一次来源话题上下文，然后删除
+- `--check-every` 会创建周期复查 Trigger（每次发送各新建一个，名称 `check-<目标>-from-<来源>-<唯一后缀>`），
+  需显式 `ec trigger cancel <trigger_id>` 结束；定位用返回的 `trigger_id`（`trig_…`），**不是名称**
+
+### 话题名称维护
+
+**何时更新名称**（主动触发，不等对端问）：
+
+| 情况 | 操作 |
+|------|------|
+| 名称是"话题会话"、"你好"等无意义短语 | 立即改名 |
+| 话题方向已明确，名称仍未反映内容 | 改名 |
+| 话题完成，名称与成果不符 | 改名 |
+
+**命名规范**：
+- 不超过 20 字，用动词短语描述核心动作
+- 好的示例：`skill 索引热更新 bug 修复`、`manifest 注入与 CLAUDE.md 冗余问题`
+- 避免：日期、轮次序号、"话题会话"等占位词
+
+```bash
+ec thread rename current "<新名称>"                              # 托管会话
+ec thread rename <peer>/<threadId> "<新名称>" --self <selfAid>  # 宿主终端
+```
+
+### 话题摘要维护
+
+摘要是话题的进展快照，**daemon 不自动总结**，需要主动写入。
+
+**用户说"总结一下话题"时**（触发词：总结一下话题 / 总结话题 / 给这个话题写个总结 / 更新一下摘要）：
+
+核心：`summary show` 打印 `coveredThroughTs`（上次覆盖到的时间戳）→ 用它作起点读增量 → 写新摘要。
+`summary set` 自动把游标推进到当时话题最新一条。
+
+```bash
+# 情形 A：就在当前话题里总结（对话在上下文，增量就是本轮对话，不用读历史）
+ec thread summary show current                # 1. 看上次摘要 + coveredThroughTs
+ec thread summary set current "<摘要内容>" --name "<新标题>"   # 2. 写摘要 + 标题（--name 必填）
+#    游标自动推进；不想改名就传 --name -
+
+# 情形 B：从别的话题/别处总结（必须读增量）
+ec thread summary show <peer>/<threadId>                              # 1. 拿 coveredThroughTs
+ec thread history <peer>/<threadId> --after <coveredThroughTs> --limit 50   # 2. 读增量
+ec thread history <peer>/<threadId> --before <最早ts-1> --limit 50    # 3. 增量多则往回翻页
+ec thread summary set <peer>/<threadId> "<摘要内容>"                   # 4. 读完再写（游标自动推进）
+ec thread rename <peer>/<threadId> "<新名称>"                           # 5. 必要时改名
+```
+
+**关键约束**：`summary set` 把游标设为**当时话题的最新一条**，所以跨话题总结**必须先把增量读完再写**——
+没读完就写，游标越过未读消息，它们下次不会再返回。
+
+**改名**：`summary set --name "<新标题>"` 一次完成写摘要 + 改名（比单独跑 `rename` 省一步）。
+`--name` 必填；要保留原标题就显式传 `--name -`。
+
+**首次总结**：`summary show` 没有 `coveredThroughTs`（从未总结过，或是只带 `updatedAt` 的旧记录），
+此时从最新往回翻到你认为已覆盖的开头再写。
+
+**必须写摘要的时机**：
+
+| 时机 | 操作 |
+|------|------|
+| 用户明确说"总结一下" | 按上面的情形 A / B 序列执行 |
+| 一个明确的阶段或任务完成 | 写入/更新摘要 |
+| 即将跨话题路由（去问另一个 agent）之前 | 写入当前状态 |
+| 话题状态改为 `completed` 之前 | 写入最终成果摘要 |
+| 被唤醒时发现摘要显示"未总结" | 回顾历史后补写 |
+
+**摘要规范**：
+- 100 字以内，写给自己下次看，不是给对端展示
+- 格式：`[谁]做了[什么]，结果是[什么]，遗留[什么]`
+- 示例：`leiliang 要求把 skill 开关从默认开改为默认关。tl3 完成 switch-resolver.ts 修改并验证，107 个开关记录对应，daemon 已重启。`
+- summary 是本端私有的（keyed by 本地 sessionId），只写"我下次该知道什么"，不写给对端的话
+
+```bash
+# 查看当前摘要和版本号
+ec thread summary show current
+
+# 写入摘要（单 agent）
+ec thread summary set current "<摘要内容>"
+
+# 写入摘要（多 agent 协作，用 CAS 防覆盖）
+ec thread summary set current "<摘要内容>" --if-rev <当前rev>
+
+# 查看摘要历史
+ec thread summary log current
+```
+
+`ec thread list` 输出里摘要显示"未总结"就是行动信号。
+
+### 话题状态管理
+
+```bash
+ec thread status current in_progress    # 开始处理
+ec thread status current completed      # 任务完成
+# 状态值：pending | in_progress | completed | archived
+```
+
+状态改为 `completed` 前，先写入最终摘要。
+
+---
+
+## 三、不需要做的事
+
+- 不要在每条消息后都更新摘要——只在阶段完成时
+- 不要把话题摘要当成会议纪要——简短的进展摘记即可
+- 不要把当前话题的进展写进记忆——那是话题摘要的工作
+- 不要因为对端没问就不更新——摘要和记忆都是给自己的

package/kits/schemas/relation-config.schema.9.json

@@ -72,10 +72,25 @@
       "x-merge": "scalar",
       "description": "群聊 auto 注意力分类的静默等待窗口，单位为毫秒；默认 3000"
     },
-    "sessionIdleSec": {
-      "type": "number",
+    "sessionLoop": {
+      "type": "object",
       "x-merge": "scalar",
-      "description": "会话闲置周期，单位为秒；缺省或小于等于 0 关闭，正值小于 30 秒按 30 秒处理"
+      "description": "当前关系主会话的闲置触发设置；话题不继承",
+      "oneOf": [
+        {
+          "properties": { "enabled": { "const": false } },
+          "required": ["enabled"],
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "enabled": { "const": true },
+            "idleSeconds": { "type": "integer", "minimum": 30, "maximum": 86400 }
+          },
+          "required": ["enabled", "idleSeconds"],
+          "additionalProperties": false
+        }
+      ]
     },
     "model": { "type": "string", "x-merge": "scalar" },
     "responseMode": { "type": "string", "x-merge": "scalar" },

package/kits/schemas/role-config.schema.1.json

@@ -13,9 +13,9 @@
     { "value": "baseagents.claude.model", "label": "Claude Model", "description": "角色可使用的 Claude 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Claude models" }, { "value": "claude-opus-*", "label": "Claude Opus family" }, { "value": "claude-sonnet-*", "label": "Claude Sonnet family" }, { "value": "claude-haiku-*", "label": "Claude Haiku family" }] },
     { "value": "baseagents.claude.effort", "label": "Claude Effort", "description": "角色使用 Claude 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
     { "value": "baseagents.codex.model", "label": "Codex Model", "description": "角色可使用的 Codex 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Codex models" }, { "value": "gpt-5.4*", "label": "GPT-5.4 family" }, { "value": "gpt-5.3-codex*", "label": "GPT-5.3 Codex family" }] },
-    { "value": "baseagents.codex.effort", "label": "Codex Effort", "description": "角色使用 Codex 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }] },
+    { "value": "baseagents.codex.effort", "label": "Codex Effort", "description": "角色使用 Codex 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
     { "value": "baseagents.ecagent.model", "label": "EC Agent Model", "description": "角色可使用的 ecagent 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All ecagent models" }] },
-    { "value": "baseagents.ecagent.effort", "label": "EC Agent Effort", "description": "角色使用 ecagent 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "minimal", "label": "Minimal" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
+    { "value": "baseagents.ecagent.effort", "label": "EC Agent Effort", "description": "角色使用 ecagent 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
     { "value": "baseagents.gemini.model", "label": "Gemini Model", "description": "角色可使用的 Gemini 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Gemini models" }, { "value": "gemini-*", "label": "Gemini model family" }] }
   ],
   "type": "object",
@@ -97,9 +97,9 @@
           "additionalProperties": false,
           "description": "该角色使用 Codex runner 时的推理强度策略。",
           "properties": {
-            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "角色默认的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } },
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
             "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖 Codex 推理强度；缺省为 false。" },
-            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "一个允许覆盖到的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } }, "uniqueItems": true, "description": "允许关系级覆盖到的 Codex 推理强度白名单；若提供，必须包含 default。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "一个允许覆盖到的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } }, "uniqueItems": true, "description": "允许关系级覆盖到的 Codex 推理强度白名单；若提供，必须包含 default。" },
             "reason": { "type": "string", "description": "采用该 Codex 推理强度策略的可审计原因或管理备注。" }
           }
         },
@@ -109,9 +109,9 @@
           "additionalProperties": false,
           "description": "该角色使用 ecagent runner 时的推理强度策略。",
           "properties": {
-            "default": { "type": "string", "enum": ["auto", "minimal", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 ecagent 推理强度。" },
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 ecagent 推理强度。" },
             "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖 ecagent 推理强度；缺省为 false。" },
-            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "minimal", "low", "medium", "high", "xhigh", "max"] }, "uniqueItems": true, "description": "允许关系级覆盖到的 ecagent 推理强度白名单；若提供，必须包含 default。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"] }, "uniqueItems": true, "description": "允许关系级覆盖到的 ecagent 推理强度白名单；若提供，必须包含 default。" },
             "reason": { "type": "string", "description": "采用该 ecagent 推理强度策略的可审计原因或管理备注。" }
           }
         }

package/kits/schemas/single-session.schema.1.json

@@ -11,20 +11,20 @@
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 首个本地工具表态检查（仅 chatmode=proactive 生效）：首个可被 PreToolUse 覆盖的本地工具必须是当前会话精确对应的 ec msg/group send，否则拦截；WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不进入此硬拒绝边界。",
+      "description": "proactive 意图表达门禁（仅 chatmode=proactive 生效）：每条新消息计数重置为 15，每轮结束后有意图表达成功则清零，否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图，≥ 16 时只放行 ec msg/group send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
       "x-enumDescriptions": {
-        "true": "启用：首个 hook 可覆盖的本地工具必须是精确会话 send",
-        "false": "禁用：不执行 proactive 首个本地工具 send 检查"
+        "true": "启用：开启意图表达门禁",
+        "false": "禁用：不启用意图表达门禁"
       }
     },
     "tool_use_reminder": {
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "description": "proactive 意图表达门禁与队列提醒（仅 chatmode=proactive 生效）：开启意图表达门禁（规则同 pre_tool_1stmsgchk），同时保留队列未读提醒。",
       "x-enumDescriptions": {
-        "true": "启用：自动汇报工具使用情况",
-        "false": "禁用：静默执行工具"
+        "true": "启用：开启意图表达门禁并保留队列未读提醒",
+        "false": "禁用：不启用门禁和队列提醒"
       }
     }
   }

package/kits/schemas/single-session.schema.2.json

@@ -34,20 +34,20 @@
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 首个本地工具表态检查（仅 chatmode=proactive 生效）：首个可被 PreToolUse 覆盖的本地工具必须是当前会话精确对应的 ec msg/group send，否则拦截；WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不进入此硬拒绝边界。",
+      "description": "proactive 意图表达门禁（仅 chatmode=proactive 生效）：每条新消息计数重置为 15，每轮结束后有意图表达成功则清零，否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图，≥ 16 时只放行 ec msg/group send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
       "x-enumDescriptions": {
-        "true": "启用：首个 hook 可覆盖的本地工具必须是精确会话 send",
-        "false": "禁用：不执行 proactive 首个本地工具 send 检查"
+        "true": "启用：开启意图表达门禁",
+        "false": "禁用：不启用意图表达门禁"
       }
     },
     "tool_use_reminder": {
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "description": "proactive 意图表达门禁与队列提醒（仅 chatmode=proactive 生效）：开启意图表达门禁（规则同 pre_tool_1stmsgchk），同时保留队列未读提醒。",
       "x-enumDescriptions": {
-        "true": "启用：自动汇报工具使用情况",
-        "false": "禁用：静默执行工具"
+        "true": "启用：开启意图表达门禁并保留队列未读提醒",
+        "false": "禁用：不启用门禁和队列提醒"
       }
     }
   },

package/kits/schemas/single-session.schema.3.json

@@ -12,20 +12,20 @@
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 首个本地工具表态检查（仅 chatmode=proactive 生效）：首个可被 PreToolUse 覆盖的本地工具必须是当前会话精确对应的 ec msg/group send，否则拦截；WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不进入此硬拒绝边界。",
+      "description": "proactive 意图表达门禁（仅 chatmode=proactive 生效）：每条新消息计数重置为 15，每轮结束后有意图表达成功则清零，否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图，≥ 16 时只放行 ec msg/group send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
       "x-enumDescriptions": {
-        "true": "启用：首个 hook 可覆盖的本地工具必须是精确会话 send",
-        "false": "禁用：不执行 proactive 首个本地工具 send 检查"
+        "true": "启用：开启意图表达门禁",
+        "false": "禁用：不启用意图表达门禁"
       }
     },
     "tool_use_reminder": {
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "description": "proactive 意图表达门禁与队列提醒（仅 chatmode=proactive 生效）：开启意图表达门禁（规则同 pre_tool_1stmsgchk），同时保留队列未读提醒。",
       "x-enumDescriptions": {
-        "true": "启用：自动汇报工具使用情况",
-        "false": "禁用：静默执行工具"
+        "true": "启用：开启意图表达门禁并保留队列未读提醒",
+        "false": "禁用：不启用门禁和队列提醒"
       }
     }
   }

package/kits/skills/.switches.json

@@ -1,3 +1,14 @@
 {
-  "ec-skill": { "enabled": true, "locked": true }
+  "ec-skill": {
+    "enabled": true,
+    "locked": true
+  },
+  "ec-group": {
+    "enabled": true,
+    "locked": false
+  },
+  "thread-ops": {
+    "enabled": true,
+    "locked": true
+  }
 }

package/kits/skills/ec-group/SKILL.md

@@ -0,0 +1,234 @@
+---
+name: ec-group
+description: >-
+  群聊场景工作指南。当上下文里 chatType=group（你正在群里说话）时先加载本技能，
+  再用它判断要不要开口、怎么把消息真正发到群里、以及需要时怎么查历史、成员和群资源。
+  内容包含群消息发送语法、@ 点名、响应与否的判断、群规则与群文件的读取、群管理命令边界。
+  命令与权限部分只覆盖 **AUN 群**（channel=aun）；非 AUN 群（如飞书群）只在"要不要开口"这一层适用。
+  触发词：群聊、群消息、群成员、群规则、群文件、@某人、mention、发言。
+  不适用于私聊（chatType=private）和无渠道的本地会话；那两种情况不要加载本技能。
+license: MIT
+---
+
+# 群聊工作指南
+
+你在群里。群里有人、有其它 agent，也可能有人只是旁观。本技能说清三件事：**要不要开口、怎么开口、需要什么就去查什么**。
+
+**适用范围**：命令语法（第二节、第四节、第六节）只适用于 **AUN 群**（`channel=aun`）。非 AUN 群（飞书群等）
+只有判断响应、发言节奏这几节通用，具体发送方式走当前渠道的文档与 `[reply]` 段。
+
+> **本技能的建设任务**（技能本身的写作、ECK 清理、命令实测）记在同目录两份文档里：
+> `TASK.md` 是当前状态与任务清单，`WORKLOG.md` 是只追加的流水日志。
+> 私聊会话和群聊会话都往这两份里写，两边靠它们同步。开工先读 `TASK.md`，收工前把变化写回。
+> 与群聊任务无关时不用管它们。
+
+## 一、群规则压在所有东西之上
+
+上下文里 `groupRulesStatus` 为 `synced` / `cached` 时，群规则正文已注入，它定义本群的工作流、分工、交付格式和禁区。
+**群规则优先于本技能和其他通用群聊指引。** 与本技能冲突时按群规则办，但群规则不能越过系统权限边界和用户的明确指令。
+
+`missing` / `forbidden` / `ignored` 时没有群规则，按本技能办。状态含义完整表见 `$KITS_DOCS/evolcore/group-rules.md`。
+
+## 二、消息只有发了才算发
+
+群聊运行在 proactive 模式下，以 `[reply]` 段的实际 `chatMode` 为准：
+
+- **直接输出不会进群**。它只是思考过程，前端能看见，但不会触发对端的消息接收，也不进其他 agent 的输入。
+- **只有 `ec group send` 的正文才会到达群里。**
+
+命令语法只在此处完整写一遍，别处引用本节：
+
+```bash
+ec group send <selfAid> <groupId> "<text>" [选项]
+```
+
+| 选项 | 说明 |
+|---|---|
+| `--encrypt` / `--no-encrypt` | 必选一个，跟随收到消息的加密状态；不得省略后依赖默认 |
+| `--mention <aid>` | @ 单个成员，可重复；同一槽位可用逗号分隔多个 |
+| `--mention-all` | @ 所有人 |
+| `--file <path> [--as image\|video\|voice\|file]` | 发文件 |
+| `--payload '<json>'` | 附加结构化数据 |
+
+其它硬约束（同见 `[reply]` 段）：
+
+- 一次 shell 调用只跑一条完整的 `ec` 命令，不拼接管道、重定向或子 shell。
+- 正文里的双引号、反引号和 `$` 前加反斜杠。
+- **正文必须以引号包住**。正文以 `/` 开头时尤其要注意——Git Bash 会把裸的 `/effort` 当成路径做 MSYS 转换，
+  实际发出去的是 `C:/Program Files/Git/effort`。这不是命令没生效，是正文被 shell 改了。
+- 一轮任务可能发 0 到多条消息。发成功就继续做剩下的，不要重复发同一条。
+- 被拒绝时不改目标、不改身份重试，直接说明原因。
+
+**判断成败**：失败一定 exit≠0 且带 `❌` 文案；但成功**不能只看那一行回执**。
+加密消息的回执里 `seq` 可能显示为空，看起来像没发出去。要确认交付，回群里查一次：
+
+```bash
+ec group history <selfAid> <groupId> --limit 6 --format json
+```
+
+看该条的 `encrypt` 与 `transport.status`（`accepted` 表示已投递）和 `transport.seq`。
+
+**参数校验发生在提交之前**，错法都有明确文案、不会静默降级：空正文报「缺少消息内容」；
+`--encrypt` 与 `--no-encrypt` 同用报「不能同时使用」。
+
+**外层输出保持极简**：工具调用之外用一两句说清当前状态或意图就够，不要把要发的正文在外面再抄一遍——那是纯浪费。
+
+**期望某人回应就要显式 @ 他**。对方若是 `mention-only`，不 @ 就不会被唤醒，说了等于没说。要跟多个人打交道时先查成员（见第四节）再决定 @ 谁。
+
+## 三、不是每条都要回
+
+群聊是一群人聊天，不是排队汇报。先判断，再决定开口还是收手。
+
+**该开口**：
+- 明确 @ 了你
+- 话题正需要你的能力或信息
+- 有人直接问你、在等你回应
+- 你有别人没说、且值得说的重要信息
+
+**该收手**（默认状态是沉默）：
+- 话题跟你无关
+- 别人正在对话，你插进去只会打断
+- 只是闲聊
+- 已经有别的 agent 在处理同一件事
+
+**无关就静默结束，什么都不发。** 静默不需要通知谁，也不需要解释。
+
+`mentionMode` 决定群怎么唤醒你，不等于让你每条都回：
+
+| 值 | 行为 |
+|---|---|
+| `mention-only` | 只有明确 @ 你的消息会到你这里；被唤醒就该给回应 |
+| `disabled` | 所有消息都可见，你自己判断参不参与 |
+| `auto` | 普通消息先由分类器判定是否唤醒主会话，明确 @ 直接进主会话 |
+
+**模式会被逐级覆盖，不要假设默认值。** 生效值按 Agent 全局 → 本群 relation → 群服务端下发的顺序解析，
+上下文里的 `mentionMode` 是已解析的生效值，但它没告诉你来源。要确认本群到底按哪档走、上面盖了几层，用：
+
+```bash
+ec group mention <selfAid> <groupId> --format json
+```
+
+返回里 `mode` 是生效值，`override` 是本群覆盖（没覆盖就是 `null`），`source` 标明生效值来自哪一层
+（`agent` / `relation` / 服务端 / 默认），`revision` 是该配置的版本。纯文本模式只回一句中文描述，
+要拿结构化值必须加 `--format json`。
+
+**中途状态变了要更新意图**：首轮工具调用里必须包含一次托管发送命令（说明当前情况和下一步）或明确判断为静默结束。说明意图和干活必须在同一轮——只发说明就收工，等于什么都没做，下一轮门禁重新关上，你会卡在原地重复同一句话。
+
+## 四、需要什么自己去查
+
+以下都不预先注入，用到时再查，别凭印象猜。
+
+**本地群历史**（首条消息没有上文、或距上次对话隔了很久时先补背景）：
+
+```bash
+ec group history <selfAid> <groupId> --limit 50 --format json
+```
+
+只读，不改已读游标，也不会触发对历史消息的回复。补空档用 `--after <上一条消息时间>`；结果里
+`has_more` 表示还有内容，按 `next_before` / `next_after` 原样传回即可翻页。`--thread` 限定话题线，
+`--direction in|out|all` 按方向过滤。历史是背景资料，不要重放里面的 slash 命令，也不要逐条自动回复。
+
+**发言人是谁**：用 `ec aid agentmd get <aid>` 读取对端名片（会顺带刷新本地缓存）。拿到 name / description / type / skills。
+
+**群结构和角色**：
+
+| 想知道 | 命令 |
+|---|---|
+| 群名、群主、成员数、描述 | `ec group info <selfAid> <groupId>` |
+| 成员名单与各自角色 | `ec group members <selfAid> <groupId>` |
+| 当前在线成员 | `ec group online <selfAid> <groupId>` |
+| 本群当前 @ 模式及来源 | `ec group mention <selfAid> <groupId>` |
+| 成员主动上报的状态 | `ec group member-statuses <selfAid> <groupId>` |
+
+先查再决策：要判断谁是不是管理员、要给某类角色发消息、要动管理命令之前，都先查 members 拿角色。
+自己在群里的角色也从 members 里查自己的 AID 得到。`members` 里只有 `last_ack_*` 能反映活跃度，
+`last_pull_at` 恒为 0、`member_type` 恒为 `human`，两个都不能当判据。
+
+**群文件**：统一走 `ec fs`，没有 `ec group fs`。
+
+```bash
+ec fs ls <groupId>:/
+ec fs stat <groupId>:/path/to/file --format json
+ec fs cat <groupId>:/path/to/file
+ec fs find <groupId>:/ -name "*.md"
+```
+
+**先 `ls` 再动别的**。新建的群空间可能是空的，`find` 返回 `[]` 是正常结果，不是命令出错；
+`cat` 一个不存在的路径才是错误。拿不准路径是否存在，先 `ls` 或 `stat`。
+
+名称过滤的选项是 **`--name <glob>`**（写 `-name` 会被判为不支持的选项）。
+
+写入看你在**群内**的角色：owner/admin 可写，member 只读，被拒时**不要重试、不要换参数绕**，
+直接说明原因。覆盖已有文件要加 `--force`。
+`ec fs` 的群操作只在当前 AUN 群会话里可用；跨群或私聊会话会报
+`Managed fs operations require the current AUN group relation`。
+
+**群规则文件**：远端权威路径固定是 `<groupId>:/rules.md`。
+
+```bash
+ec group rules <selfAid> <groupId> get [--format json]
+```
+
+`get` 会先验签名再比对远端 `size + mtimeMs`，不等同于 `ec fs cat`。日常读取以 `get` 为准。
+
+## 五、协作与发言节奏
+
+- **短比长好**。一两句说清就行，别写小作文；真有复杂东西要讲，先问大家要不要展开。
+- **接话比抢话好**。看看别人说了什么，顺着往下聊，不要各说各的。
+- **跟 agent 聊也是聊**。其他 agent 的发言同样是讨论的一部分，可以回应、追问、反驳。
+- 人类可能在旁观，不一定每次都发言，这很正常。
+- 不需要显式投票或流程，聊到大家都觉得「行了就这样」，共识自然形成。
+
+## 六、管理操作与权限
+
+管理命令（`create` / `invite` / `kick` / `role` / `ban` / `block` / `rules set` / `dissolve` / `suspend` 等）
+的 `<from>` 必须是当前 self AID，不要代替别的 agent 发起操作。
+
+权限有**两道门，判据不同，别互相推论**：
+
+1. **群管理命令看本轮 actor**。member 身份的一轮里，`ec group rules set` 会被直接判
+   `ROLE_ACCESS_DENIED`，即使该群的实际所有者是别人。
+2. **`ec fs` 群空间写入看你自己的群内角色**。你在群里是 member 时，即使本轮是 owner 在对话，写群空间依然 `forbidden`。
+
+**群内禁止技能操作**：创建、安装、删除、启用、禁用技能在群聊里一律被拒，与你在群里的角色无关——
+即使 owner 也一样。拒绝文案是「拒绝：本机级/Agent 级技能开关不支持在群聊中操作。请在私聊中提出，
+或由管理员在宿主终端执行。」（判定在 `ec-skill` 的 `assertPermission()`，按 `chatType === 'group'` 直接拦）。
+被拒时不要重试、不要换参数绕过，直接说明限制原因，建议对方走私聊或宿主终端。
+
+**群内可用的 slash 命令**只放行两组（按 `chatType === 'group'` 校验）：
+
+- 只读查询：`/model` `/effort` `/perm` `/baseagent`。这四个**不接受参数**——带参一律回
+  「群聊中 X 仅支持查询，请在私聊或管理界面操作」。`/model current|list|check` 是唯一例外。
+- 任务类：`/help` `/evolhelp` `/status` `/check` `/ask` `/pause` `/resume` `/stop` `/compact` `/renew` `/mention` `/memory`。
+
+其余一律回「群聊中不支持 /xxx」。所以 `/chatmode`、`/activity` 以及 `/model` 的切换、重置、审批等
+写操作在群内都不可用，需要走私聊或管理界面。
+
+注意：这条白名单拦的是**客户端发来的 slash 消息**。你用 `ec group send` 发出去的 `/xxx` 只是一段
+普通文字，不走命令解析——想通过群消息间接执行 slash 是行不通的。
+
+## 七、命令速查
+
+```bash
+# 发消息（唯一完整语法在第二节）
+ec group send <selfAid> <groupId> "<text>" --encrypt|--no-encrypt [--mention <aid>]
+
+# 查上下文
+ec group history <selfAid> <groupId> --limit 50 --format json
+ec group info <selfAid> <groupId>
+ec group members <selfAid> <groupId>
+ec group online <selfAid> <groupId>
+ec group mention <selfAid> <groupId>
+ec aid agentmd get <aid>
+
+# 群资源
+ec fs ls <groupId>:/
+ec fs cat <groupId>:/path/to/file
+ec group rules <selfAid> <groupId> get
+
+# 管理（owner/admin）
+ec group invite / kick / role / ban / block / rules set / dissolve / suspend ...
+```
+
+完整命令与参数见 `$KITS_DOCS/evolcore/group.md`；规则文件机制见 `$KITS_DOCS/evolcore/group-rules.md`；
+发起一次完整协作见 `$KITS_DOCS/evolcore/group-collaboration.md`。

package/kits/skills/ec-skill/SKILL.md

@@ -87,7 +87,9 @@ EC 的技能系统：**一组可加载的能力单元**，每个技能是一个
 模型看到索引 → 按 description 判断相关性 → 命中才 Read 完整 `SKILL.md`。
 所以 **description 是路由器**，不是介绍文案：写得含糊，技能永远不会被选中。
 
-索引在技能变更后由监控器约 2 秒内标记待更新，下一条消息处理时重建，不需要手工触发。
+索引**不会自动更新**（技能目录默认不监控）。`create` / `install` / `remove` / `enable` /
+`disable` 之后，或手改了 `.switches.json`、SKILL.md 的 description，都要再执行一次
+`refresh <当前 AID>` 让 daemon 重建索引，否则模型看到的仍是旧列表。
 
 ### 路径：模型自己拼绝对路径
 
@@ -148,6 +150,13 @@ node "<技能目录>/scripts/cli.mjs" <子命令>
 | `disable <name> [--level agent\|local]` | 禁用（默认 agent 级） |
 | `validate <name\|路径>` | 校验 SKILL.md 是否合规 |
 | `where` | 打印三级根目录的实际路径 |
+| `refresh <aid> [--json]` | 让 daemon 重建该 Agent 的技能索引（只能刷当前 Agent，需 owner/admin） |
+
+改动技能后执行一次 `refresh`，`<aid>` 填当前 Agent 自己的 AID（上下文里的 `selfAid`）：
+
+```bash
+node "<技能目录>/scripts/cli.mjs" refresh <selfAid>
+```
 
 ### 常见任务