evolcore 0.0.33 → 0.0.35-test.0

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

@@ -39,13 +39,13 @@ license: MIT
 命令语法只在此处完整写一遍，别处引用本节：
 
 ```bash
-ec group send <selfAid> <groupId> "<text>" [选项]
+ec group send <selfAid> <groupId> '<text>' [选项]
 ```
 
 | 选项 | 说明 |
 |---|---|
 | `--encrypt` / `--no-encrypt` | 必选一个，跟随收到消息的加密状态；不得省略后依赖默认 |
-| `--mention <aid>` | @ 单个成员，可重复；同一槽位可用逗号分隔多个 |
+| `--mention '<aid1>,<aid2>'` | @ 成员。单引号包住、逗号分隔多个 aid，可重复传入 |
 | `--mention-all` | @ 所有人 |
 | `--file <path> [--as image\|video\|voice\|file]` | 发文件 |
 | `--payload '<json>'` | 附加结构化数据 |
@@ -53,7 +53,7 @@ ec group send <selfAid> <groupId> "<text>" [选项]
 其它硬约束（同见 `[reply]` 段）：
 
 - 一次 shell 调用只跑一条完整的 `ec` 命令，不拼接管道、重定向或子 shell。
-- 正文里的双引号、反引号和 `$` 前加反斜杠。
+- 正文用单引号包住；正文含单引号时改用 `$'…'` 语法（支持 `\'` `\n` `\t` `\\`）。
 - **正文必须以引号包住**。正文以 `/` 开头时尤其要注意——Git Bash 会把裸的 `/effort` 当成路径做 MSYS 转换，
   实际发出去的是 `C:/Program Files/Git/effort`。这不是命令没生效，是正文被 shell 改了。
 - 一轮任务可能发 0 到多条消息。发成功就继续做剩下的，不要重复发同一条。
@@ -132,6 +132,9 @@ ec group history <selfAid> <groupId> --limit 50 --format json
 
 **群结构和角色**：
 
+所有 `ec group` 子命令的参数顺序固定为「先发送方 AID，后群 AID」：群 ID 永远在第 2 个位置
+（`ec group members <selfAid> <groupId>`）。写成「群 ID 在前」时命令会报错并给出正确写法。
+
 | 想知道 | 命令 |
 |---|---|
 | 群名、群主、成员数、描述 | `ec group info <selfAid> <groupId>` |
@@ -150,7 +153,7 @@ ec group history <selfAid> <groupId> --limit 50 --format json
 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"
+ec fs find <groupId>:/ -name '*.md'
 ```
 
 **先 `ls` 再动别的**。新建的群空间可能是空的，`find` 返回 `[]` 是正常结果，不是命令出错；
@@ -211,7 +214,7 @@ ec group rules <selfAid> <groupId> get [--format json]
 
 ```bash
 # 发消息（唯一完整语法在第二节）
-ec group send <selfAid> <groupId> "<text>" --encrypt|--no-encrypt [--mention <aid>]
+ec group send <selfAid> <groupId> '<text>' [--encrypt|--no-encrypt] [--mention '<aid1>,<aid2>']
 
 # 查上下文
 ec group history <selfAid> <groupId> --limit 50 --format json

package/kits/skills/ec-skill/scripts/cli.mjs

@@ -15,7 +15,7 @@ const USAGE = `ec skill —— EC 技能管理
 用法:
   ec skill list [--json]                     列出所有技能
   ec skill info <name> [--json]              查看单个技能详情
-  ec skill create <name> [--desc "..."] [--force] [--enable]
+  ec skill create <name> [--desc '...'] [--force] [--enable]
                                              新建技能骨架（默认禁用）
   ec skill install <源> [--force] [--enable] 安装技能（目录 / .zip / .md，默认禁用）
   ec skill remove <name>                     删除本机技能

package/kits/skills/ec-skill/scripts/skill.mjs

@@ -367,7 +367,7 @@ export function resolveSkillDirArg(target) {
 
 export function cmdCreate(name, { desc = '', force = false, enable = false, json = false } = {}) {
   assertPermission('local'); // 骨架固定建在本机级，与 install 同档
-  if (!name) throw new Error('缺少技能名。用法：ec skill create <name> --desc "..."');
+  if (!name) throw new Error(`缺少技能名。用法：ec skill create <name> --desc '...'`);
   if (!NAME_RE.test(name)) {
     throw new Error(`技能名「${name}」不符合 kebab-case（小写字母/数字/连字符，如 my-skill）`);
   }

package/kits/skills/thread-ops/SKILL.md

@@ -113,11 +113,11 @@ ec thread history <peer>/<threadId> --self <selfAid> --after $SINCE --limit 100
 ec thread list <C的AID>
 # 如果有合适的话题（如 T2），记下 threadId
 # 如果没有，新建：
-ec thread create <C的AID> --name "项目进度查询"
+ec thread create <C的AID> --name '项目进度查询'
 # 返回：{ threadId: "thread-xxx", ... }
 
 # 步骤 2：发消息（--check-every 一步搞定复查）
-ec msg send "项目当前进度如何？" --thread <T2的threadId> --check-every 5m
+ec msg send '项目当前进度如何？' --thread <T2的threadId> --check-every 5m
 # --check-every 跨话题时必填（如 5m / 30m / 2h），周期唤醒直到显式 cancel
 # 返回：{ message_id: "m-yyy", ... }
 # 副作用：本端写入 thread-inbox + 创建周期复查 Trigger（kind=thread-check）
@@ -148,7 +148,7 @@ ec msg send "项目当前进度如何？" --thread <T2的threadId> --check-every
 
 # 步骤 2：决定是否回复
 # 情况 A：直接回复 B（在当前话题 T2 上）
-ec msg send "进度 70%，预计下周完成"
+ec msg send '进度 70%，预计下周完成'
 # 不带 --thread，消息发在当前话题上
 # 托管会话中不需要指定 from 和 to，系统推断
 
@@ -169,14 +169,14 @@ ec thread history current --limit 10
 # 或从上下文直接判断
 
 # 步骤 2A：C 已回复 → 处理回复，汇报回 A
-ec msg send "C 回复：进度 70%" --thread <T1的threadId> --check-every 30m
+ec msg send 'C 回复：进度 70%' --thread <T1的threadId> --check-every 30m
 # 汇报回 A 也是跨话题发送，同样必填 --check-every
 
 # 步骤 2B：C 还没回 → 决定下一步
 # 选项 1：继续等 → 什么都不做，原 Trigger 下个周期会再次唤醒
 #         （如需调整频率：ec trigger update <triggerId> --every 5m）
 # 选项 2：放弃等待，直接回 A
-ec msg send "C 暂无回复" --thread <T1的threadId> --check-every 30m
+ec msg send 'C 暂无回复' --thread <T1的threadId> --check-every 30m
 
 # 选项 3：什么都不做，turn 结束
 ```
@@ -191,8 +191,8 @@ ec msg send "C 暂无回复" --thread <T1的threadId> --check-every 30m
 
 ```bash
 # 步骤 1：同时发出两条委托，各自创建周期复查 Trigger（--check-every 一步搞定）
-ec msg send "技术评估" --thread <T2> --check-every 10m
-ec msg send "产品评估" --thread <T3> --check-every 10m
+ec msg send '技术评估' --thread <T2> --check-every 10m
+ec msg send '产品评估' --thread <T3> --check-every 10m
 # turn 结束
 
 # 10 分钟后，T2 和 T3 各自触发新 turn
@@ -206,7 +206,7 @@ ec thread history <D的AID>/<T3> --limit 5
 # 检查 C 是否也回了
 ec thread history <C的AID>/<T2> --limit 5
 # C 也回了，合并结果
-ec msg send "综合评估：技术……产品……" --thread <T1> --check-every 30m
+ec msg send '综合评估：技术……产品……' --thread <T1> --check-every 30m
 ```
 
 **关键点**：没有"等齐"原语。想合并就在后到的 turn 里主动读另一话题，手动判断是否齐全。
@@ -221,13 +221,13 @@ ec msg send "综合评估：技术……产品……" --thread <T1> --check-ever
 # S2B 收到 C 的第一次回复："卡在 Redis 并发问题"
 # B 判断需要更多细节
 
-ec msg send "Redis 并发问题影响范围多大？"
+ec msg send 'Redis 并发问题影响范围多大？'
 # 不带 --thread，继续在当前话题上
 # 同话题追问无需 --check-every（不跨话题，不创建复查 Trigger）
 
 # C 再次回复后，触发新 turn
 # B 整合两轮对话，回 A
-ec msg send "C 反馈：Redis 问题影响……" --thread <T1>
+ec msg send 'C 反馈：Redis 问题影响……' --thread <T1>
 ```
 
 ---
@@ -256,8 +256,8 @@ ec thread history <peer>/<threadId> --after <timestamp>
 ### 流程 G：修改话题属性
 
 ```bash
-ec thread rename current "新名称"
-ec thread label current "开发"
+ec thread rename current '新名称'
+ec thread label current '开发'
 ec thread status current in_progress
 # 状态值：pending | in_progress | completed | archived
 ```
@@ -363,10 +363,10 @@ ec thread summary show current
 # 2. 自己写摘要（100 字以内，见下方规范）。
 #    增量就是本轮对话，无需再读历史；游标自动推进。
 #    --name 必填：一次写完摘要 + 标题。不想改名就显式传 `-`。
-ec thread summary set current "写好的摘要内容" --name "动词短语描述的核心动作"
-ec thread summary set current "写好的摘要内容" --name -            # 保持原话题名
+ec thread summary set current '写好的摘要内容' --name '动词短语描述的核心动作'
+ec thread summary set current '写好的摘要内容' --name -            # 保持原话题名
 # 多人协作同一话题时带 CAS 防覆盖
-ec thread summary set current "写好的摘要内容" --name "标题" --if-rev <步骤1的rev>
+ec thread summary set current '写好的摘要内容' --name '标题' --if-rev <步骤1的rev>
 ```
 
 **情形 B：从别的话题（或别处）总结某话题**（需要读增量）
@@ -384,7 +384,7 @@ ec thread history <peer>/<threadId> --before <本页最早一条的ts> --limit 5
 #    翻到覆盖游标之前即可停；注意 before 是闭区间，用 <最早ts - 1> 避免边界重复
 
 # 4. 读完增量后写摘要（游标自动推进到现在）；--name 必填，不改名传 -
-ec thread summary set <peer>/<threadId> "写好的摘要内容" --name "新名称"
+ec thread summary set <peer>/<threadId> '写好的摘要内容' --name '新名称'
 ```
 
 **关键约束**：`summary set` 把游标设为**当时话题的最新一条**，所以跨话题总结**必须先把增量读完再写**。
@@ -470,7 +470,7 @@ ec thread summary show $PEER/<threadId> --self $SELF
 
 2. **不要忘记创建 Trigger**：如果不创建，对端不回复时你永远不会知道。分支合并场景必须用 Trigger。
 
-3. **不要在托管会话中手动指定 from 和 to**：`ec msg send "文本" --thread T2` 就够了。
+3. **不要在托管会话中手动指定 from 和 to**：`ec msg send '文本' --thread T2` 就够了。
 
 4. **不要把 Trigger 当作"强制回复"或"执行脚本"**：Trigger 只是唤醒信号，到期后 agent 自主决定下一步。
 
@@ -487,6 +487,6 @@ ec thread summary show $PEER/<threadId> --self $SELF
 3. **Trigger 是唤醒信号，不是执行脚本**：到期时提醒检查，不指示执行任何操作，不保证对端已回复。
 4. **决策权在自己**：收到委托要不要回、何时回、回什么，完全自主判断。
 5. **分支合并靠主动查询**：想等多个对端都回，就在各自 turn 里用 `ec thread history` 读另一话题。
-6. **from/to 托管会话中不需要**：会话唯一确定对端，命令简化为 `ec msg send "文本" --thread T`。
+6. **from/to 托管会话中不需要**：会话唯一确定对端，命令简化为 `ec msg send '文本' --thread T`。
 7. **话题名是本端的**：对端可能改名，threadId 才是跨端统一标识。
 

package/kits/templates/memory-consolidation/forget.md

@@ -63,9 +63,9 @@ ec memory archive <路径>
 若干条超期记忆**单独每一条都不值得续期，但合起来值得留一条**时，产出一条合并版：
 
 ```bash
-ec memory create --scope <本次会话的 scope> --slug <slug> --desc "一句话描述" \
+ec memory create --scope <本次会话的 scope> --slug <slug> --desc '一句话描述' \
   --tags <...> [--keywords <...>] \
-  --replaces "<旧文件1>,<旧文件2>,..." \
+  --replaces '<旧文件1>,<旧文件2>,...' \
   "<合并后的完整内容>"
 ```
 

package/kits/templates/memory-consolidation/generalize.md

@@ -42,7 +42,7 @@
 **评估后认为不该泛化的，用 `update` 把 `to-generalize` 标签去掉。** 否则每次定时检查都会重新扫到它，反复评估同一条。
 
 ```bash
-ec memory update <关系级记忆路径> --tags "<去掉 to-generalize 后的标签>"
+ec memory update <关系级记忆路径> --tags '<去掉 to-generalize 后的标签>'
 ```
 
 ### 已经存在同类 agent 级记忆
@@ -50,9 +50,9 @@ ec memory update <关系级记忆路径> --tags "<去掉 to-generalize 后的标
 如果 agent 级里已经有讲同一件事的记忆，**用 `--replaces` 同时替换两边**，产出合并后的版本：
 
 ```bash
-ec memory create --scope agent --slug commit-chinese --desc "commit 消息用中文" \
-  --tags "rule,long-term" --keywords "commit,git" \
-  --replaces "consolidated/20260901-120000-commit.md,$RELATIONS_DIR/<peerKey>/memory/consolidated/20261002-103100-commit-chinese.md" \
+ec memory create --scope agent --slug commit-chinese --desc 'commit 消息用中文' \
+  --tags 'rule,long-term' --keywords 'commit,git' \
+  --replaces 'consolidated/20260901-120000-commit.md,$RELATIONS_DIR/<peerKey>/memory/consolidated/20261002-103100-commit-chinese.md' \
   "（合并后的完整内容）"
 ```
 

package/kits/templates/memory-consolidation/notes.md

@@ -25,17 +25,17 @@
 ### ① 是新的稳定结论 → create
 
 ```bash
-ec memory create --scope relation --slug commit-chinese --desc "对端要求 commit 消息用中文" \
-  --tags "rule,long-term,verified" --keywords "commit,git" \
+ec memory create --scope relation --slug commit-chinese --desc '对端要求 commit 消息用中文' \
+  --tags 'rule,long-term,verified' --keywords 'commit,git' \
   "对端明确要求：commit message 必须用中文，并列出所有功能改动点。"
 ```
 
 ### ② 和已有记忆是同一条，但内容更全或更准 → create --replaces
 
 ```bash
-ec memory create --scope relation --slug commit-chinese --desc "对端要求 commit 用中文，注释不限" \
-  --tags "rule,long-term,verified" --keywords "commit,git" \
-  --replaces "consolidated/20261001-103100-commit-chinese.md" \
+ec memory create --scope relation --slug commit-chinese --desc '对端要求 commit 用中文，注释不限' \
+  --tags 'rule,long-term,verified' --keywords 'commit,git' \
+  --replaces 'consolidated/20261001-103100-commit-chinese.md' \
   "对端要求 commit message 用中文；代码注释可以是英文。"
 ```
 
@@ -44,12 +44,12 @@ ec memory create --scope relation --slug commit-chinese --desc "对端要求 com
 ### ③ 已有记忆还成立，只是状态变了 → update
 
 ```bash
-ec memory update consolidated/20261002-090000-refactor-plan.md --tags "rule,done"
+ec memory update consolidated/20261002-090000-refactor-plan.md --tags 'rule,done'
 ```
 
 ### ④ 不值得长期保留 → 丢弃
 
-一次性任务的进展、临时状态、闲聊内容。什么都不用写。
+一次性任务的进展、临时状态、闲聊内容。不写记忆，在反馈里列出丢弃了哪几条、为什么丢弃。
 
 ## 什么时候打升级标记
 
@@ -70,9 +70,9 @@ ec memory update consolidated/20261002-090000-refactor-plan.md --tags "rule,done
 
 ```bash
 ec memory create --scope relation --slug commit-convention \
-  --desc "对端要求 commit 用中文、按功能列出改动" \
-  --tags "rule,long-term,verified" --keywords "commit,git" \
-  --replaces "consolidated/a.md,consolidated/b.md" \
+  --desc '对端要求 commit 用中文、按功能列出改动' \
+  --tags 'rule,long-term,verified' --keywords 'commit,git' \
+  --replaces 'consolidated/a.md,consolidated/b.md' \
   "（合并后的完整内容）"
 ```
 
@@ -92,13 +92,13 @@ note 的 frontmatter 里如果有 `chatType: group`，整理时需要按信息
 ```bash
 # 关于群本身的记忆（默认路由，不加 --peer）
 ec memory create --scope relation --slug group-meeting-schedule \
-  --desc "群每周一开技术会" --tags "rule,verified" \
+  --desc '群每周一开技术会' --tags 'rule,verified' \
   "该群约定每周一 10:00 召开技术同步会。"
 
 # 关于发言人自身的记忆（指定发言人的 relation）
 ec memory create --scope relation --peer aun#alice.agentid.pub \
   --slug alice-ts-preference \
-  --desc "Alice 偏好 TypeScript，不喜欢注释" --tags "preference,verified" \
+  --desc 'Alice 偏好 TypeScript，不喜欢注释' --tags 'preference,verified' \
   "Alice 明确表示偏好 TypeScript，认为代码自解释，不需要额外注释。"
 ```
 

package/kits/templates/memory-consolidation/profile.md

@@ -23,9 +23,9 @@
 
 ```bash
 ec memory create --scope relation --slug profile \
-  --desc "对端画像：沟通风格与协作习惯" \
-  --tags "profile,long-term" --keywords "画像" \
-  --replaces "consolidated/profile.md" \
+  --desc '对端画像：沟通风格与协作习惯' \
+  --tags 'profile,long-term' --keywords '画像' \
+  --replaces 'consolidated/profile.md' \
   "（画像正文）"
 ```
 

package/kits/templates/memory-consolidation/promote.md

@@ -56,9 +56,9 @@ daemon 会检查：
 
 ```bash
 ec memory create --scope owner --slug no-self-commit \
-  --desc "任何 agent 都不许自己提交代码" \
-  --tags "prohibition,important,long-term" --keywords "commit,权限" \
-  --replaces "$RELATIONS_DIR/<ownerPeerKey>/memory/consolidated/20261002-153000-no-self-commit.md" \
+  --desc '任何 agent 都不许自己提交代码' \
+  --tags 'prohibition,important,long-term' --keywords 'commit,权限' \
+  --replaces '$RELATIONS_DIR/<ownerPeerKey>/memory/consolidated/20261002-153000-no-self-commit.md' \
   "owner 明确要求：所有 agent 都不许自己执行 git commit，必须由 owner 确认后才能提交。"
 ```
 

package/kits/templates/memory-consolidation/workflow.md

@@ -8,8 +8,42 @@
 2. **读候选内容**。`notes` 模式读 `processing/` 里的 note；其余模式读上下文文件里列出的候选记忆（先只读描述，按需读正文）。
 3. **查重**（见下）。
 4. **写**。用 `create` / `update` / `archive`。索引由程序在会话结束后统一重建。
-5. **反馈**。结束前必须调用 `ec memory feedback`，把本次整理的结果按要求写清楚（见下）。
-6. **结束**。写完直接结束，不需要在会话里汇报「已完成」——反馈由 `ec memory feedback` 投递。
+5. **反馈**。结束前必须把本次整理的结果写到任务书给出的反馈文件路径（见下）。
+6. **结束**。写完直接结束，不需要在会话里汇报「已完成」——反馈由程序读取反馈文件后投递。
+
+## 工具使用约束
+
+整理会话的读取范围限于：**批次目录**、**关系记忆目录**（processing/、consolidated/、MEMORY.md）、**本次会话消息流水**。当前工作目录（cwd）本身不可读。
+
+**只读工具的正确用法：**
+
+- **Read**：传绝对路径，路径必须在可读范围内
+  ```
+  Read  file_path=<任务书里给出的 consolidatedDir>/xxx.md
+  ```
+
+- **Glob**：`path` 参数必填且必须是绝对路径（不传时起点是 cwd，会被拒绝）
+  ```
+  Glob  path=<任务书里的 processingDir>  pattern=*.md
+  ```
+
+- **Grep**：`path` 参数必填且必须是绝对路径
+  ```
+  Grep  path=<任务书里的 consolidatedDir>  pattern=关键词
+  ```
+
+- **Bash**：仅允许 `ec memory create|update|archive` 单条命令，或落在批次目录内的只读查询（不能拼接命令）
+  - ✅ 允许：`ec memory create --scope relation --slug xxx '...'`
+  - ✅ 允许：`ls "<批次目录>/threads"`（单条、绝对路径、无拼接）
+  - ❌ 不允许：`cd ... && ls ...`（用绝对路径代替 cd）
+  - ❌ 不允许：`ls ... 2>&1`（不需要，工具会同时收两路输出）
+  - ❌ 不允许：`ls "..."/*`（通配符不支持，用 Glob 代替）
+  - ❌ 不允许：`cmd1 && cmd2 && cmd3`（只允许单条命令或两条只读命令用 && 连接）
+
+**任务书里已给出的可读路径**（复制粘贴即可）：
+- 批次目录：本次任务初始消息里的 `整理上下文文件路径` 的父目录
+- processingDir / consolidatedDir / indexPath：任务书「整理目标」章节里列出
+- 消息流水：任务书里的 `historyJsonlPath`（如有）
 
 ## 写入前必须先查重
 
@@ -30,7 +64,7 @@
 - 会话内因上下文压缩会丢失的关键信息。
 - 对端明确表达过的态度。
 
-不值得写的：一次性任务的进展、临时状态、闲聊内容。直接丢弃，不用写任何东西。
+不值得写的：一次性任务的进展、临时状态、闲聊内容。不写记忆，在反馈里说明丢弃了哪些、为什么。
 
 ## update 还是 create --replaces
 
@@ -48,13 +82,13 @@ update 只用于正文不变、状态变了的情况：
 
 输出 `[[NOOP]]`，然后结束。不要为了「有产出」而硬造记忆。
 
-## 反馈（必须调用）
+## 反馈（必须写）
 
-**结束前必须调用 `ec memory feedback`**，把本次整理结果写成一段 markdown 文本。这段文本会被投递回发起整理的会话（手动、上下文压缩、新会话三类触发都会投递；定时触发只写日志，不投递）。
+**结束前必须把本次整理结果写成一段 markdown 文本，写到任务书给出的反馈文件路径。** 这段文本会被投递回发起整理的会话（手动、上下文压缩、新会话三类触发都会投递；定时触发只写日志，不投递）。
 
 要求：
 
-- 调用格式：`ec memory feedback "<文本>"`，文本用单引号或双引号包住。
+- 写入方式：用文件写入工具（Write / Edit）写到任务书里给出的那个反馈文件路径。这是本会话唯一可以写的文件；不要写别的路径，也不要用 shell 重定向。文件已经建好，直接写即可。
 - 内容用 markdown，包含：
   - **模式**：本次模式（notes / generalize / promote / profile / forget）
   - **处理结果**：新建 / 更新 / 归档的记忆条数
@@ -63,7 +97,7 @@ update 只用于正文不变、状态变了的情况：
   - 若过程中遇到异常（某条候选读不了、写入被拒），如实写出来。
 - 不要在反馈文本里堆砌日志路径和原始文件列表——那些在批次目录里有，反馈是给人看的一句话级结论。
 
-未调用反馈时，程序会回退到默认模板（只含模式、触发方式、条数统计），信息量少，所以务必显式调用。
+没有写反馈文件时，程序会回退到默认模板（只含模式、触发方式、条数统计），信息量少，所以务必显式写。
 
 ## 收尾
 
@@ -71,5 +105,6 @@ update 只用于正文不变、状态变了的情况：
 
 - 成功 → 移入 `archive/notes/` 留底。
 - 失败 → 移回 `pending/`，下次重新整理。
+- 认领了 note，却既没写记忆也没写反馈 → 按失败处理，note 移回 `pending/`。
 
 程序还会重建索引，并把本次整理的日志（模式、候选、产出）落到 `$EVOLCORE_HOME/memory/consolidation-batches/`。

package/kits/templates/message-fragments/handoff-request-to-target.md

@@ -3,7 +3,7 @@
 - 请结合请求列表与当前对端回复，分别判断哪些请求已经得到充分回答。
 - 不要在对外回复中主动提及 handoff、ID、return 命令或内部路由机制。
 - 通常请直接在当前回复中给出完整处理结果，本端会自动把回复绑定并回流到原请求会话。
-- 如果请求因权限、网络或其它原因无法完成，且需要把失败/阻塞原因明确回传给原会话，可执行已有命令 `ec handoff return <handoff-id> "<失败原因>"`；required 请求允许用同一个 ID 追加多次结果。
+- 如果请求因权限、网络或其它原因无法完成，且需要把失败/阻塞原因明确回传给原会话，可执行已有命令 `ec handoff return <handoff-id> '<失败原因>'`；required 请求允许用同一个 ID 追加多次结果。
 - 不要在对外回复中主动提及 handoff、ID 或内部路由机制。
 
 待回流请求：

package/kits/templates/system-fragments/bash-description.md

@@ -0,0 +1,9 @@
+[bash-description] Bash 调用的 description 格式（代码层强制校验）
+每次调用 Bash 都必须传 description，格式为 `<命令目标描述> [<风险等级>]`：
+- 命令目标描述：一句话说明这条命令要达成什么，不复述命令原文、参数或路径
+- 风险等级：写在末尾的方括号内，取 `低`、`中`、`高` 之一
+  - 低：只读，不改变文件、进程或远端状态
+  - 中：改变状态但可恢复（写或改工作区文件、安装依赖、构建、本地 git commit）
+  - 高：不可逆，或影响超出当前工作区（删除、丢弃未提交改动、git push、发布、终止进程、修改系统配置）
+示例：`查看工作区未提交的改动 [低]`、`安装项目依赖 [中]`、`推送 main 分支到远端 [高]`
+缺少目标描述、缺少风险等级标记或标记不在三个等级之内，调用都会被直接拒绝。

package/kits/templates/system-fragments/bootstrap.md

@@ -51,12 +51,13 @@ Bootstrap 是首次自我设定的生命周期门禁：补齐基础名片、保
 
 设定齐全、待确认内容已解决后，按以下顺序推进；已有有效结果只核对，不重复写入或发布：
 1. 用 `ec aid agentmd set {{selfAid}} <field> <value>` 修改本 Agent 名片的 `name`、`description`、`tags`（保留其它 frontmatter 和正文，命令会校验格式并签名）；不要用文件工具直接编辑名片。
-2. 将明确的职责、协作边界、重要约束和待继续事项忠实整理到 `{{PERSONAL_DIR}}/personal.md` 的 `## Bootstrap 交接` 段落。此摘要是 Agent 的内部交接工作，不要求 Owner 审稿；不新增推断，确有职责歧义则回到设定澄清。没有额外约束或待继续事项时省略相应条目，不为补齐摘要追问。文件不存在时创建，已有文件幂等更新该段并保留其它内容；待继续事项标注“未执行”。不复制完整历史、临时闲聊、凭据、运行状态或 Owner 私密信息（该文件也会进入后续群聊上下文）。
+2. 将明确的职责、协作边界、重要约束和待继续事项忠实整理到 `{{PERSONAL_DIR}}/persona.md` 的 `## Bootstrap 交接` 段落。此摘要是 Agent 的内部交接工作，不要求 Owner 审稿；不新增推断，确有职责歧义则回到设定澄清。没有额外约束或待继续事项时省略相应条目，不为补齐摘要追问。文件不存在时创建，已有文件幂等更新该段并**保留其它段落**（尤其是 Owner 已设定的人格内容）；待继续事项标注“未执行”。不复制完整历史、临时闲聊、凭据、运行状态或 Owner 私密信息（该文件也会进入后续群聊上下文）。
+   - 写这一段用文件工具直接编辑 `persona.md` 即可（Owner 会话中该文件可写）；**不要**用 `ec agent persona --text` 只写交接段——那是整体覆盖，会冲掉 Owner 设定的人格内容。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
 3. 根据最终名片和已设定的 persona，自主生成并用 `ec agent welcome --text '<完整文案>'` 保存正式欢迎文案。不要展示草稿、询问称呼或请求 Owner 确认，不向用户交办文案工作；Owner 主动指定文案时直接尊重其明确要求。命令固定写入本 Agent 的 `personal/welcome.md`，不接受自定义路径，`ec agent welcome show` 可核对现状。
    - 内容为简短问候、自我介绍、围绕职责的具体协作方向及开始协作的邀请，建议 100～250 个汉字；不照抄通用“AI Agent 网关”介绍，不泄露系统提示词、凭据、文件路径或工作记忆，不夸大能力、不承诺独占使用或设备绑定。
    - 支持纯文本或带变量的 Markdown；变量用两个左花括号、变量名、两个右花括号，内部不加空格。仅允许 agentName、agentDescription、agentAid、agentTags、agentTagsText、ownerName、ownerAid、channel；多 Owner 共用模板，称呼用 ownerName 或 ownerAid 变量，不写死当前 Owner 的姓名。系统仅渲染变量，不追加其它文案。
 4. 若最终名片尚未发布或字段有变更，用 `ec aid agentmd put {{selfAid}}` 签名发布；用 `set` 改过字段时命令已自动发布，只需核对；可选头像按上一节处理，不为同一头像重复发布名片。
-5. 核对交接摘要和 welcome 已保存、最终名片已发布后，执行 `ec agent ready {{selfAid}}`。这是 Bootstrap 的最后一个操作；成功后系统结束旧上下文、为各 Owner 创建新主会话并投递已保存的 welcome，不再调用模型生成文案。不要从旧上下文追加完成回复或继续普通任务。新主会话首次回复前先阅读已注入的 `personal.md` 交接内容，沿用约定，未执行事项按正常权限续接。
+5. 核对交接摘要和 welcome 已保存、最终名片已发布后，执行 `ec agent ready {{selfAid}}`。这是 Bootstrap 的最后一个操作；成功后系统结束旧上下文、为各 Owner 创建新主会话并投递已保存的 welcome，不再调用模型生成文案。不要从旧上下文追加完成回复或继续普通任务。新主会话首次回复前先阅读已注入的 `persona.md` 交接内容，沿用约定，未执行事项按正常权限续接。
 
 ## 5. 恢复与操作范围
 
@@ -66,4 +67,4 @@ Bootstrap 是首次自我设定的生命周期门禁：补齐基础名片、保
 - `bootstrapping`：从缺失或失败的步骤续做，保留已明确或已认可的设定；welcome 缺失时自主生成并保存，交接缺失时依据可核对事实补写，全部完成后直接 `ready`，不增加确认轮次。收到 `WELCOME_FROZEN` 表示投递快照已准备，不改文案，只续做剩余步骤。
 - 必需步骤失败时说明具体原因，修正后再继续，不调用 `ready`、不盲目重试；可选头像失败按上一节处理。
 
-仅允许读取本 Agent 名片并编辑上述三个字段、读写固定的 `personal.md` 交接段、读取 Owner 为设定提供的文本或图片附件、执行上述本 Agent 状态查询、persona、welcome、名片发布、头像及 ready 命令，以及向当前 Owner 回复。不得修改其它文件、联系其它主体或进行无关配置操作；完成前不承诺已经进入正常工作状态。
+仅允许读取本 Agent 名片并编辑上述三个字段、读写 `persona.md` 的 `## Bootstrap 交接` 段、读取 Owner 为设定提供的文本或图片附件、执行上述本 Agent 状态查询、persona、welcome、名片发布、头像及 ready 命令，以及向当前 Owner 回复。不得修改其它文件、联系其它主体或进行无关配置操作；完成前不承诺已经进入正常工作状态。

package/kits/templates/system-fragments/channel.md

@@ -14,11 +14,11 @@ capabilities: {{capabilities}} # 当前渠道支持的能力
 {{/}}
 {{?channel=aun}}
 {{?groupId}}
-ec group send {{selfAid}} {{groupId}} "<text>" [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention <aid>] [--mention-all]
+ec group send {{selfAid}} {{groupId}} '<text>' [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention '<aid1>,<aid2>'] [--mention-all]
 group-send 用于群内公开发送：proactive 下是正式回复；interactive 下普通回复直接输出，需要 @某人、发文件或手动控制加密时使用此命令。
 {{/}}
 {{?peerId}}
-ec msg send {{selfAid}} {{peerId}} "<text>" [--text-from-file <path>] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title "<title>"] [--payload '<json>']
+ec msg send {{selfAid}} {{peerId}} '<text>' [--text-from-file <path>] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title '<title>'] [--payload '<json>']
 msg-send 用于私聊发送：proactive 下是正式回复；interactive 下普通回复直接输出，需要文件、链接或手动控制加密时使用此命令。群聊仅在确需私下联系本条消息发送者且已获授权时使用，公开回复使用 group-send。
 {{/}}
 每次调用仍须遵守 `[reply]` 的单条命令及加密要求。

package/kits/templates/system-fragments/memory.md

@@ -1,7 +1,7 @@
 [memory] 记忆系统  
 {{?sessionType!=memory}}  
 **静默规则**：记忆操作完全静默。仅当用户明确表达让你记住某事时，才给一句不超过一行的简短确认，其余情况禁止出现「记下了」「已记录」「我记住了」等表达。  
-`ec memory` 是唯一写入路径。**不要用 Write / Edit 直接写记忆文件，也不要用 baseagent 原生记忆工具**：绕过签名和索引，整理会话不感知。  
+`ec memory` 是唯一写入路径。**不要用 Write / Edit 直接写记忆文件，也不要用 baseagent 原生记忆工具**：绕过完整性台账和索引，会被当作带外修改恢复掉，整理会话也不感知。  
 **召回**：上方已注入三级 `MEMORY.md` 索引，按描述判断相关性，再 Read 对应 `consolidated/` 正文；不要全部读一遍。  
 {{?peerKey}}  
 **写入判据**：开新会话后这条信息拿不到，会不会有影响？会就写，不会就不写。  
@@ -17,15 +17,15 @@
     **命令**（`--slug` 必填，字母/数字/连字符，1-64 字符，当前关系内唯一）：
 
 ```bash
-ec memory note --slug <slug> [--tags <tag1,tag2>] "<正文>"
-ec memory note update <slug> [--slug <新slug>] [--tags <...>] ["<新正文>"]
+ec memory note --slug <slug> [--tags '<tag1>,<tag2>'] '<正文>'
+ec memory note update <slug> [--slug <新slug>] [--tags '<tag1>,<tag2>'] ['<新正文>']
 ec memory note drop <slug>
 ec memory note list
 
 ```
 
 {{?chatType=group}}
-群聊场景可附加 `--speakers <id1,id2,...>` 记录本条 note 涉及的发言人（逗号分隔，填 AID 或渠道原生 ID）。整理会话会据此把发言人相关信息分流到各发言人自己的 relation 记忆里。
+群聊场景可附加 `--speakers '<aid1>,<aid2>'` 记录本条 note 涉及的发言人（单引号包住、逗号分隔，填 AID 或渠道原生 ID）。整理会话会据此把发言人相关信息分流到各发言人自己的 relation 记忆里。
 {{/}}
 slug 撞名改用 `update`。完整用法见 `$KITS_DOCS/evolcore/memory.md`。  
 **整理**（触发后不等结果）：
@@ -43,13 +43,18 @@ slug 撞名改用 `update`。完整用法见 `$KITS_DOCS/evolcore/memory.md`。
 **只能用三个命令**：
 
 ```bash
-ec memory create --scope <relation|agent|owner> --slug <slug> --desc "一句话描述" \
-  [--peer <peerKey>] --tags <tag1,tag2,...> [--keywords <kw1,kw2,...>] [--replaces <路径,...>] "<正文>"
-ec memory update <路径> --tags <tag1,tag2,...>    # 整体替换标签，不是追加；改不了正文
+ec memory create --scope <relation|agent|owner> --slug <slug> --desc '一句话描述' \
+  [--peer <peerKey>] --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>'] '<正文>'
+ec memory update <路径> --tags '<tag1>,<tag2>'      # 整体替换标签，不是追加；改不了正文
 ec memory update <路径> --touch                  # 只刷新时间戳（遗忘续期）
 ec memory archive <路径...>                      # 下线记忆，移入 archive/
-
 ```
+
+整理结束后，把本次整理的整体反馈写入任务书里指定的**反馈文件路径**。未写入则收尾时回退到默认统计模板（模式、触发方式、耗时、新建/更新/归档条数等）。
+
+自由文本参数（`--desc`、正文、`--keywords`）用**单引号**包住（`'…'`）；
+用双引号的话，文本里的 `` ` `` 或 `$` 会被 shell 展开，命令被拒。
+正文本身含单引号时，改用 `$'…'` 语法（ANSI-C quoting），支持 `\'` `\n` `\t` `\\`。
 | 参数 | 说明 |
 | --- | --- |
 | --scope | 必填，只能是本次模式允许的取值（见下表） |
@@ -59,6 +64,8 @@ ec memory archive <路径...>                      # 下线记忆，移入 archi
 | --keywords | 可选，串起相关记忆的内容关键词 |
 | --replaces | 可选，要替换的旧文件，自动归档。合并、纠正、升格作用域都走它，是唯一的防重复手段 |
 
+`--tags`、`--keywords`、`--replaces` 的值写成单引号包住、逗号分隔：`--tags 'rule,long-term'`、`--replaces 'consolidated/a.md,consolidated/b.md'`。
+
 **模式与允许的** `--scope`（越权会被 daemon 拒绝）：
 
 | 模式 | --scope |
@@ -73,7 +80,7 @@ ec memory archive <路径...>                      # 下线记忆，移入 archi
 
 **禁止**：
 
--   用 Write / Edit 直接写 `consolidated/`：会被判为未签名、移入 `archive/invalid/`。
+-   用 Write / Edit 直接写 `consolidated/`：绕过完整性台账，下次使用时会被恢复到最后登记的版本。
 -   写 `pending/` 或调用 `ec memory note`：note 是主会话入口，整理会话用了会形成循环。
 -   删除文件：只能 `archive`。  
     {{/}}

package/kits/templates/system-fragments/reply.md

@@ -23,19 +23,19 @@ proactive：普通输出作为思考过程展示，不作为正式回复、不
 {{?selfAid}}
 {{?chatType=private}}
 {{?peerId}}
-ec msg send {{selfAid}} {{peerId}} "<text>" [--encrypt|--no-encrypt]
+ec msg send {{selfAid}} {{peerId}} '<text>' [--encrypt|--no-encrypt]
 {{/}}
 {{/}}
 {{?chatType=group}}
 {{?groupId}}
-ec group send {{selfAid}} {{groupId}} "<text>" [--encrypt|--no-encrypt]
+ec group send {{selfAid}} {{groupId}} '<text>' [--encrypt|--no-encrypt]
 {{/}}
 {{/}}
 {{/}}
 AUN 私聊向 peerId 发送，群聊向 groupId 发送，不把群内发言者当作公开回复目标。
 {{/}}
 {{?channel!=aun}}
-ec ctl send "<text>"
+ec ctl send '<text>'
 非 AUN 渠道使用上述命令向当前会话正式回复，不使用 AUN 的 msg/group 命令。
 {{/}}
 发送成功后继续本轮必要步骤，不重复发送同一正文或补发“已发送”回执。
@@ -47,12 +47,12 @@ ec ctl send "<text>"
 {{/}}
 
 发送约束（适用于正式回复及 active 阶段的附加发送）：
-- 只能使用当前会话的 delegated sender，经 daemon IPC 发送；保留托管环境，不另建 SDK 连接。当前会话回复使用注入的 self 和目标，不为绕过限制改写身份、对端或 thread 路由。显式 msg/group send 必须写全 from/to；拿不到 self 或目标参数时改用 ec ctl send "<text>" 继承当前会话，不猜测身份或地址。
+- 只能使用当前会话的 delegated sender，经 daemon IPC 发送；保留托管环境，不另建 SDK 连接。当前会话回复使用注入的 self 和目标，不为绕过限制改写身份、对端或 thread 路由。显式 msg/group send 必须写全 from/to；拿不到 self 或目标参数时改用 ec ctl send '<text>' 继承当前会话，不猜测身份或地址。
 - 调用发送命令时，每次 shell 调用只能执行一条完整的 ec 命令。不要拼接探测、管道、重定向、子 shell 或其它命令；不要读取外部 coding-agent skill 寻找发送方式。
 - 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠。
 - 以退出码和发送回执判断成败；被拒绝时说明具体原因，不通过改目标、改身份或绕开托管通道重试。
-- 跨会话发送：一个话题只有本端与对端两端，当前话题只能直接回复 peerId/groupId。要联系当前对端（{{peerId}}）或当前群（{{groupId}}）以外的对象，属于**跨话题**发送：先 `ec thread list <对方AID>` 选中一个已有话题，没有合适话题就 `ec thread create <对方AID> --name "..."`，再用 `ec msg send "<text>" --thread <threadId> --check-every <时长>`（群聊为 `ec group send "<text>" --thread <threadId> --check-every <时长>`）发送；from/to 由话题推断，不必手写，`--check-every` 必填。不带 `--thread` 直接改目标发送会被拒绝；同会话回复当前对端/群不需要 `--thread`。
+- 跨会话发送：一个话题只有本端与对端两端，当前话题只能直接回复 peerId/groupId。要联系当前对端（{{peerId}}）或当前群（{{groupId}}）以外的对象，属于**跨话题**发送：先 `ec thread list <对方AID>` 选中一个已有话题，没有合适话题就 `ec thread create <对方AID> --name '...'`，再用 `ec msg send '<text>' --thread <threadId> --check-every <时长>`（群聊为 `ec group send '<text>' --thread <threadId> --check-every <时长>`）发送；from/to 由话题推断，不必手写，`--check-every` 必填。不带 `--thread` 直接改目标发送会被拒绝；同会话回复当前对端/群不需要 `--thread`。
 {{?channel=aun}}
-- 显式调用 msg/group send 时必须选择加密参数：回复 🔒密文用 --encrypt，回复 ✉明文用 --no-encrypt；批次含密文则用 --encrypt。不得省略参数后依赖默认明文；加密状态不明时使用继承当前会话状态的 ec ctl send "<text>"。
+- 显式调用 msg/group send 时必须选择加密参数：回复 🔒密文用 --encrypt，回复 ✉明文用 --no-encrypt；批次含密文则用 --encrypt。不得省略参数后依赖默认明文；加密状态不明时使用继承当前会话状态的 ec ctl send '<text>'。
 - interactive 的直接输出和 ec ctl send 由框架继承当前会话的加密状态、目标和话题，无需手动改写路由。
 {{/}}

package/kits/templates/system-fragments/session.md

@@ -44,7 +44,7 @@ readonly: true — 禁止写入项目目录及临时目录；如需生成文件
 #   群内公开发送用 ec group send；语法与选项见 [channel] 段。
 {{/}}
 {{?chatType=private}}
-#   当前话题私聊回复（proactive 自主模式）：ec msg send {{selfAid}} {{peerId}} "<text>" [--encrypt|--no-encrypt]
+#   当前话题私聊回复（proactive 自主模式）：ec msg send {{selfAid}} {{peerId}} '<text>' [--encrypt|--no-encrypt]
 #   from/to 必须显式写出（权限层逐字校验发送者与目标）；仅 --thread 跨话题发送和 ec ctl send 可省略。文件/链接/跨话题/完整选项见 $KITS_DOCS/evolcore/msg.md
 {{/}}
 {{/}}