@thinkingai/ae-cli 6.0.52 → 6.0.54

package/skills/ae-things/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: ae-things
+description: "工作空间事项（things）：在明确的 AgentSpace 中用 ae-cli things 创建、查询、更新和推进事项。当对话出现分工指派（谁负责什么）、要交付的产出、推进节奏、待办、下一步、里程碑或阶段计划时主动使用——不需要用户显式说「创建事项」。"
+---
+
+# 工作空间事项
+
+使用 `ae-cli things` 操作当前明确指定的 TE 空间事项。先读 [CLI reference](references/cli.md)，不猜 ID，不自动选择其他空间。
+
+## 何时创建事项
+
+**由你自己判断要不要建，不要等「帮我创建事项」这种显式指令。** 个人空间与共享空间一视同仁。
+
+出现下列任一信号就直接创建，不必先问：
+
+- 出现「谁做什么」的分工指派，例如「让 A 梳理 X，B 梳理 Y」。
+- 出现要交付的产出加上推进意图，例如「输出一份最终方案」「按这个节奏推进」「安排一下」。
+- 出现承诺、待办、下一步、里程碑或多阶段计划。
+- 用户在复述已经定下来的事，并指向后续执行。
+
+下列情况不要创建：
+
+- 纯信息问答、概念解释、闲聊。
+- 还在比较方案、假设性推演，或用户明确说「先不定」。
+- 查重命中已有同义事项——指出已存在，不重复建。
+- 用户说过不要建。
+
+**不确定时，把拟建清单（标题、负责人、描述要点）在回复里列出来，一次性问用户确认。不允许什么都不做就把分工排版成清单交差。**
+
+### 创建时的动作顺序
+
+1. 确认已绑定明确的 AgentSpace；没有绑定就不创建。
+2. `members` 取成员列表，把对话里提到的人名映射到成员 ID。唯一命中就直接作为 `--assignee-id`；命中 0 个或多个时该事项负责人留空（服务端默认当前用户），并在回复里点名待确认。
+3. `list --query` 或 `options --query` 查重。
+4. 逐个 `create`：标题写可交付物而不是原话复述，描述写清目标与验收要点，带 `--command-id` 保证重试幂等。
+5. 需要时用 `conversation bind` 绑定主事项，或 `link-conversation` 建普通引用。
+6. 在回复里报告已创建的事项编号、标题、负责人，以及哪些负责人待确认。
+
+**粒度**：按「可独立交付、可独立负责」的单位建事项。没有子事项和分组，不要试图建层级。例如「A、B、C 各自梳理一块，然后合成一份总方案」对应 4 个事项，而不是 1 个，也不是每句话一个。
+
+### 授权边界
+
+自主执行：创建新事项；为自己刚建的事项补第一条记录。
+
+用户已授权推进/完成的事项：直接追加或更新相应进展，并自动关联本次涉及的交付附件，按下节完成发布与回读。个人与共享空间一致，发布仍传 `--confirm-share`；授权事项交付即包含向该事项所在空间共享这些交付文件。
+
+其他已有事项改写、负责人变更、归档/恢复、解绑及永久删除仍需明确授权；历史绑定本身不是授权。不自动发消息或创建定时任务。
+
+### 交付附件闭环
+
+追加/更新进展时，逐个核对本次实际交付文件：
+
+1. 用 `asset available` 查本空间文件并翻完分页。已登记文件按 assetId 关联，未登记文件按返回的相对 path 关联。
+2. 尚未进入空间的新文件用 `asset publish`：本轮未登记产物使用 `--conversation-id --run-id --source-path`；已有产物使用 `--artifact-id` 或 `--file-token`。每个文件保存独立 commandId，重试原样复用。
+3. `linked:false` 表示已发布未关联，只用返回 assetId 补 `asset link`，不重复复制。只发布本次交付文件，不发布临时文件或整个会话目录。
+4. `asset list --id` 回读，核实每个附件存在且 availability=available，再回读进展记录。只有两者均成功才报告“进展和附件已更新”；失败明确区分已发布、已关联、待恢复。
+
+附件使用上述文件关联接口；本地路径文本链接不能代替附件，仅复制文件也不算交付完成。完整参数见 CLI reference。
+
+## 当前会话绑定与执行快照
+
+以本轮冻结的绑定声明确定本轮默认事项。涉及当前事项执行、审查、总结或更新前，按声明中的 `readCommand` 读取本次执行快照；普通聊天无需读取。运行中切换或解绑只立即改变会话归属，本轮（含等待、恢复、重试）仍用原快照；原先无事项则本轮继续无默认事项，下一次新 Run 才使用最新绑定。用户明确指定其他事项时仍按权限读取和操作，不将会话最新归属误认为本轮快照。
+
+用户明确要求将当前对话绑定到某事项时，唯一定位目标后执行 `conversation bind`，再用 `conversation primary` 回读确认；同名事项不能唯一确定时询问用户。成功说明「已绑定，事项上下文从下一轮生效」。解绑也须回读确认。不得将 `link-conversation` 普通引用当成主事项绑定成功的替代；接口失败应如实说明，不绕过权限。
+
+`context --id <thing-id> --run-id <run-id>` 返回执行受理时的业务文本和版本。需要最新事实或写入前版本时额外读取不带 `--run-id` 的实时上下文，并明确区分采集时间与快照版本。读取失败时披露缺失，不凭标题猜测，也不自动改读实时数据。具体契约见 [CLI reference](references/cli.md#执行快照与实时上下文)。
+
+- 字段为标题、描述、标签、状态、负责人、协作者。状态 open/paused/done；归档与恢复是独立动作。新建描述必填，创建时省略负责人默认本人，显式 null 被拒绝。
+- 用 members/options 查询成员和事项候选；创建、编辑和协作者管理遵循服务端权限。修改前读最新 version，409 后比较变化，不仅替换版本号。
+- 记录使用 url/note/progress；省略类型时服务端将单个 HTTP(S) URL 保存为链接，其余为备注。更新进展用 entry append --type progress；修改记录用 entry update 和 expected-updated-at，支持单独修改标题、类型或正文；--clear-title 清空标题。
+- 从会话消息整理事项用 from-message，提供已核实的 conversation-id/message-id 和确认正文；按上面的创建信号判断是否该整理，不要求用户显式点名该命令。推断出来的内容先在会话中呈现建议；不使用已删除的持久化修改草稿命令。
+- 主事项使用 conversation primary/bind/unbind，普通引用用 link-conversation，conversations 查询关联。关联不改变会话隐私和权限。
+- 阶段成果使用进展记录；交接使用备注写清已完成内容、证据和下一步。负责人和协作者是唯一人员协作关系，不额外认领。
+- 文件使用 asset available/list/link/unlink/publish，遵循上面的授权边界与交付附件闭环；解除关联不删除文件。
+- 永久删除先读最新版本，解释不可恢复及会话/文件保留边界，明确确认后使用 delete --confirm-delete --yes。运行冲突时等待，不自动终止运行。
+- 已获明确授权的具体修改直接执行，不重复询问。
+
+```bash
+ae-cli things create --agent-space-id <space-id> --title '接口验收' --description '验证权限与数据一致性' --format json
+ae-cli things entry append --agent-space-id <space-id> --id <thing-id> --type progress --content '已完成接口联调' --format json
+```
+
+审查使用 [ae-things-review](../ae-things-review/SKILL.md)，周期汇总使用 [ae-things-progress](../ae-things-progress/SKILL.md)。二者按完整采集事实归纳，保留未读文件、截断和非事务采集边界。
+
+Use `things conversations` to list linked conversations and `things conversation get` to read one. Start new conversations from the workspace UI; Things CLI only manages thing links and primary-thing binding.

package/skills/ae-things/references/cli.md

@@ -0,0 +1,103 @@
+# 工作空间事项 CLI reference
+
+本 reference 描述已实现命令，不重复维护权限和数据业务规则。[主 Spec](https://gitlab.thinkingdata.cn/te-ai/te-claude/-/blob/feat/workspace-issues-convergence/docs/specs/2026-09-17-workspace-issues-convergence/spec.md)。
+
+Transition status: transitional
+Owning module: te-claude / src/lib/agent-space-things
+Current transport: TE REST /api/cli/things/v1; cli-token
+Gateway target: Capability Gateway things domain (TBD)
+Review after: 2026-10-14
+Exit condition: Gateway 提供等价空间校验、幂等、权限、分页和会话关联能力后迁移 transport。
+
+事项尚未接入 Gateway。类型化 flags、JSON/stdin、正文脱敏 dry-run、默认值和目标一致性检查提供必要的 Transitional 入口。
+
+## 公共参数
+
+`--agent-space-id` 在会话外必填，会话内须与当前会话空间一致。`--id` 为事项 ID。写请求用 `--command-id <uuid>` 支持原样重试，省略时生成；编辑、归档和恢复须带 `--expected-version`。分页为 `--limit 1..100 --cursor <opaque>`，默认 50。通用 `--format json` 输出结构化结果；`--dry-run` 不请求业务 API、不读取文件/stdin、不泄露正文。主事项解除、删除资产关联或协作者属于 high-risk-write，已获授权的脚本使用 `--yes`。
+
+## 字段和记录
+
+事项字段仅为 title、description、tags、status、assigneeId、collaboratorIds。新建标题 1–200 字符、描述 1–10000 字符必填。活跃状态 `open | paused | done`，归档和恢复使用独立动作。个人或共享空间创建时省略负责人均默认当前用户；更新省略保持不变，`null` 被拒绝。`--tags '["标签"]'`、`--collaborator-ids '["member-id"]'`，空数组清空。`--assignee-id` 只能指定有效空间成员。
+
+新建/更新可用 `--file fields.json` 或 `--stdin` 读取 camelCase 字段对象，显式 flags 覆盖同名字段。失效的验收、优先级、分组、截止时间、进展快照、阻塞、下一步、父子事项字段被拒绝；group 和 draft 命令已移除。
+
+| 命令                      | 参数和结果                                                                                                                                                                                                         |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `list`                    | `--query --status open\|paused\|done\|archived --assignee-id`；返回 items/nextCursor                                                                                                                               |
+| `get`                     | `--id`；字段、权限、version、协作者及 latestProgress                                                                                                                                                               |
+| `create`                  | `--title --description` 和可选业务字段                                                                                                                                                                             |
+| `update`                  | `--id --expected-version` 和业务字段                                                                                                                                                                               |
+| `archive/restore`         | `--id --expected-version`                                                                                                                                                                                          |
+| `delete`                  | `--id --expected-version --confirm-delete --yes`；不可恢复，清理事项及所有关联，保留会话、消息、历史运行快照与空间文件；活动运行冲突返回 THING_RUNNING_CONFLICT                                                    |
+| `members/options`         | 分页查询成员/事项候选；options 支持 `--query`                                                                                                                                                                      |
+| `collaborator add/remove` | `--id --user-id`                                                                                                                                                                                                   |
+| `entry list`              | `--id` 和分页，按 createdAt、id 倒序                                                                                                                                                                               |
+| `entry append`            | `--id --type url\|note\|progress`；省略时服务端自动识别链接或备注，可选 `--title`；`--content`、`--file`、`--stdin` 三选一                                                                                         |
+| `entry update`            | `--id --entry-id --expected-updated-at`；至少一个修改字段：`--title`、`--clear-title`、`--type note\|url\|progress` 或正文输入；可只改标题或类型，title 与 clear-title 互斥                                        |
+| `from-message`            | `--conversation-id --message-id` 和正文；`--id` 追加或 `--title` 新建二选一；仅 `--id` 追加模式可选 `--entry-type note\|progress`，默认 note；`--title` 新建模式传入会报错，新建以正文作为描述，不生成额外进展记录 |
+
+```bash
+ae-cli things create --agent-space-id <space-id> --title '验收事项' --description '验证成员操作与权限' --format json
+ae-cli things entry append --agent-space-id <space-id> --id <thing-id> --type progress --content '完成接口联调' --format json
+```
+
+## 会话
+
+| 命令                       | 参数和含义                                            |
+| -------------------------- | ----------------------------------------------------- |
+| `conversation get`         | `--conversation-id`；读取可访问会话快照及当前模型投影 |
+| `conversation primary`     | `--conversation-id`；读取主事项关联                   |
+| `conversation bind/unbind` | `--conversation-id`；bind 额外需要 `--id`             |
+| `conversations`            | `--id` 和分页；关联会话                               |
+| `link-conversation`        | `--id --conversation-id`；追加引用，不替换主事项      |
+
+关联不授予会话访问权；不能读取其他用户私有会话。会话排队、运行或等待交互时允许绑定/解绑，立即更新归属但不修改已受理 Run 的冻结上下文，下一次新 Run 生效。绑定后用 `conversation primary` 回读，不使用普通引用代替主事项绑定。
+
+## 进展与汇总
+
+阶段成果写 `entry append --type progress`；交接写 `--type note`，用标题和正文说明已完成内容、证据、下一步。人员关系使用负责人和协作者，不需要认领。
+
+`+detail --id` 收集事项、全部可读 entries/assets 和实时 context。`+digest` 支持负责人筛选或 `--thing-ids id-a,id-b`，不能同时指定两种范围；可选 `--from --to --time-zone`，时间须带时区，窗口左闭右开。默认分别分页采集活动与归档事项，跨集合按 ID 去重。返回 open/paused/done 三态 counts、archivedCount、items 和采集边界。latestProgress 使用服务端最新 progress 记录；effectiveProgressCount 只统计 progress 记录，不代表模型已核实内容；status 时间线的 before/after 用于重建基线。
+
+每链最多 100 页/10000 条。异常、重复游标、空页继续或达到上限标 truncated；重复 ID 不解释为完整。报告核对 fetchedCount、truncated、consistency、collectedAt。non_transactional 不是事务快照；changed_during_collection 或截断时 baseline 为 null。counts 是采集时状态，不能当周期末状态。未记录不等于未推进，附件可用不表示已读取或已验收。
+
+## 错误与恢复
+
+THING_INVALID_INPUT 修正参数；THING_FORBIDDEN/THING_NOT_FOUND 不推断不可见资源；THING_READ_ONLY 表示资源只读：归档事项需恢复后编辑，不可用空间需先恢复空间可用性，操作日志不可编辑、应追加新记录；THING_VERSION_CONFLICT/记录时间戳冲突重读并比较，不能只换版本号；THING_COMMAND_CONFLICT 表示同 UUID 不同请求；THING_RATE_LIMITED 等待后用原 commandId 重试。主事项绑定不因运行中而拒绝；永久删除仍保留 THING_RUNNING_CONFLICT 活动运行保护。
+
+## 文件与交付物（阶段4）
+
+`asset available` 分页合并当前空间实际文件和登记元数据；已登记项返回稳定 `assetId`，未登记项 assetId=null、path 为相对路径。`asset link` 接受 `--asset-id` 或 `--path` 二选一，路径关联时校验、登记并关联，列表读取不登记。`asset list --id` 分页读取事项关联。核对 availability 及 scanStatus/scanReason；部分扫描不代表目录完整。
+
+```bash
+ae-cli things asset available --agent-space-id <space-id> --limit 100 --format json
+ae-cli things asset list --agent-space-id <space-id> --id <thing-id> --format json
+ae-cli things asset link --agent-space-id <space-id> --id <thing-id> --asset-id <asset-id> --role attachment --command-id <uuid> --format json
+ae-cli things asset publish --id <thing-id> --conversation-id <conversation-id> --artifact-id <artifact-id> --confirm-share --command-id <uuid> --format json
+ae-cli things asset publish --id <thing-id> --conversation-id <conversation-id> --run-id <run-id> --source-path <absolute-delivered-file> --confirm-share --command-id <uuid> --format json
+ae-cli things asset link --agent-space-id <space-id> --id <thing-id> --path <space-relative-path> --command-id <uuid> --format json
+ae-cli things asset unlink --agent-space-id <space-id> --id <thing-id> --asset-id <asset-id> --command-id <uuid> --format json
+```
+
+- `role` 仅接受 attachment（默认）；deliverable 在正常执行与 dry-run 的参数校验阶段均被拒绝。同一事项与资产只有一个关联。
+- 发布传 `--confirm-share`，授权边界见 Skill。来源为 artifact-id、file-token、source-path 三选一；source-path 必须同时带 run-id，服务端验证执行归属、真实沙箱文件及会话 artifacts 目录边界。发布到空间后所有成员可见。
+- 发布使用既有会话产物发布器。发布回执与资产元数据同事务，使用原 commandId 重试不会再复制。返回 `linked:false, assetId, code:THING_ASSET_LINK_FAILED` 时文件已经共享，用 asset link 只补关联；不重复发布、不声称已交付。
+- 解除关联不删除文件、不恢复私有；被引用的资产删除返回 `AGENT_SPACE_ASSET_REFERENCED`，须先解除关联。
+- `THING_ASSET_UNAVAILABLE` 表示文件缺失或不能验证，`THING_ASSET_PUBLISH_FAILED` 表示发布未完成。文件引用只冻结 ID 和引用文本，不代表不可变正文。上下文最多选取前10份引用，超出会明确提示，完整文件列表按需读取。
+
+## 执行快照与实时上下文
+
+```bash
+# 本次执行使用的冻结事实；参数取自本轮绑定声明
+ae-cli things context --agent-space-id <space-id> --id <thing-id> --run-id <run-id> --format json
+# 显式读取当前事实；不带 run-id 的既有行为保持不变
+ae-cli things context --agent-space-id <space-id> --id <thing-id> --format json
+```
+
+带 `--run-id` 时请求现有 GET context 的 `runId` 参数，返回保存的快照及 `source: {kind: "run_snapshot", runId}`、`currentFiles`、`fileReferencePolicy`。`thing.version`/`capturedAt` 为受理时版本/时间，`currentFiles` 为当前可用路径；文件正文不保证版本冻结，使用前读取。原 `notices` 保留。无参数时返回原实时上下文；不从环境变量自动选择执行，`+detail`/`+digest` 也继续实时采集。
+
+执行、会话、空间及快照中的原事项必须匹配，且操作者仍有访问权限；执行 ID 不是授权。会话当前主事项可以已切换或解除，本轮等待/恢复/重试仍读取原快照。`THING_TARGET_CONFLICT` 表示快照与请求目标不一致，应重新确认目标；`THING_CONTEXT_UNAVAILABLE` 表示快照缺失或损坏，应重新发起执行，不自动降级实时读取。`THING_NOT_FOUND` 不区分不存在和不可见。归档或不可用文件沿用 `THING_READ_ONLY` / `THING_ASSET_UNAVAILABLE`。
+
+切换或解绑保留历史和 provider session，只改变会话归属及下一新 Run 默认目标；不是遗忘或撤权。普通聊天无需查事项，具体事项工作先读快照；当前状态及写入前版本需额外显式实时读取。工具失败时披露缺失。**对已有事项的修改**只按用户明确授权或确认执行，不能因为历史关联过就默认回写；创建新事项不受此限，按 [SKILL 的创建信号](../SKILL.md#何时创建事项)自主判断。
+
+维护模块沿用 Things Transitional transport；新增参数不创建同义命令或独立 Gateway 入口，迁移出口沿用本 reference 的收录记录。跨仓实施契约见 te-claude `docs/specs/2026-09-17-workspace-issues-convergence/spec.md`；应用与 CLI/Skill 配套交付。

package/skills/ae-things-progress/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: ae-things-progress
+description: "工作空间事项进展、日报和周报：使用 ae-cli things 采集当前空间、负责人或显式事项集合的周期事实，由当前会话模型归纳并披露数据边界。"
+---
+
+# 事项进展汇总
+
+从 aha-links 的事实采集和输出契约适配；先读 [事项操作](../ae-things/SKILL.md) 和 [CLI reference](../ae-things/references/cli.md)。CLI 收事实，当前模型做归纳，不调用独立报告后台。
+
+涉及本轮绑定事项时，先遵循 [执行快照与实时上下文](../ae-things/references/cli.md#执行快照与实时上下文) 读取本次执行快照，再按以下流程采集最新审查或周期事实；两种来源分开表述。无绑定时仅使用用户明确指定的范围。
+
+## 范围和时间
+
+```bash
+ae-cli things +digest --agent-space-id <space-id> --from 2026-09-07T00:00:00+08:00 --to 2026-09-14T00:00:00+08:00 --time-zone Asia/Shanghai --format json
+ae-cli things +digest --agent-space-id <space-id> --assignee-id <member-id> --format json
+ae-cli things +digest --agent-space-id <space-id> --thing-ids <id-a>,<id-b> --format json
+```
+
+不猜 ID、不选择个人默认空间；不支持关注清单、群或跨空间汇总。日报按自然日，周报按周一 00:00 到下周一 00:00，默认 Asia/Shanghai。今日／本周的截止点用当前时刻，昨日／上周用完整周期。自定义区间必须明确；命令的 from/to 都必须含时区，区间为左闭右开。
+
+输出时将记录的 ISO 时间转换为报告时区，并在时间窗、采集时间和证据日期旁明确标注时区。例：`2026-09-10T04:50:00Z` 在 Asia/Shanghai 应展示为 `2026-09-10 12:50（Asia/Shanghai）`；不能删除 Z 后直接写成“上海时间 04:50”。无法可靠转换时保留原始 ISO 并标注 UTC，披露尚未转换，不能伪造本地时刻。
+
+## 证据和完整性
+
+核对 `fetchedCount`、`truncated`、`consistency`、`collectedAt`；显式集合再核对 `requestedCount` 和 `unreadable`。字段缺失停止生成全量结论。CLI 自动分页最多每链 100 页／10000 项，异常和上限会标记截断；不能换成单页 list 冒充完整采集。
+
+- `thing` 是当前状态，`entries` 是时间窗内记录，`baseline` 是利用完整业务变更记录倒推的窗口前状态；没有基线或采集发生版本变化时不要补造。
+- `lastEffectiveRecordBeforeWindow` 供定位窗口前证据。当前状态不等于周期内变化，周期末状态也不能直接用当前状态代替。
+- 输出前比较 `collectedAt` 与窗口 `to`。当 `collectedAt < to`（包括用户指定尚未结束的完整自然周）时，报告必须注明“截至采集时刻的阶段汇总，周期尚未结束”；三态统计标为“采集时状态”，禁止写“周期末状态”或“无后续更新”。例：9月10日采集9月7日至14日的周报，不能断言9月14日状态与当前相同。即使窗口已经结束，也只有完整的窗口后变更证据支持时才能还原周期末状态。
+- open/paused/done 分别统计，归档另列；最新进展来自 thing.latestProgress，历史变化读取 progress/status 记录。
+- 备注和重复过程描述不算有效进展；`effectiveProgressCount` 是待核查候选，正文没有新信息时排除。
+- 没有记录只能说“未记录更新”。此约束同样适用于摘要和下一步建议；open 不能证明尚未开始，只能报告当前状态和未记录事实。附件未读、不可读取、截断及多次请求的非事务采集边界必须披露。`changed_during_collection` 时先重读；仍有变化则保留限制，不声称静态全量。
+
+## 输出与写回
+
+先写范围、时间窗、采集时间及覆盖边界，再给三态和归档统计、周期变化、阻塞、下一步。每个重要判断附事项来源和日期，区分事实、推断与建议。不默认展示内部记录 ID。
+
+默认只输出到会话。明确要求写回时：用 `+detail` 完整读取目标事项的报告记录，检查同范围同周期标题，再用 `ae-cli things entry append --id <target-id> --type note --title "事项周报｜起止日期｜范围" --stdin --command-id <uuid> --format json` 写入最终正文。建议标题为 `事项周报｜起止日期｜范围`（日报同理）。已有同范围同周期报告时提示修订，不静默覆盖或重复追加；用户明确要求追加修订后才写新记录，保留原报告。写回已授权无需再问同一许可。
+
+不自动发送消息、修改状态、指派负责人或建立定时任务。
+
+文件证据：+detail/+digest 自动翻页收集资产关联，availability=missing 或 verification_failed 的文件不算可用交付；即使 available，也只代表引用可用，不代表已读取正文或验收通过。披露未读文件及非事务采集边界。私有会话来源只在当前用户有权时读取，报告引用共享事项事实，不能把私有历史自动公开。

package/skills/ae-things-review/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: ae-things-review
+description: "工作空间事项审查：基于 ae-cli things 的标题、描述、状态与完整时间线，诊断范围漂移、未记录有效更新、拆解和责任、完成证据；默认只读。"
+---
+
+# 事项推进审查
+
+沿用 aha-links 的证据化审查方法，使用 TE 空间权限和三态及独立归档。先读 [事项操作](../ae-things/SKILL.md) 和 [采集契约](../ae-things/references/cli.md)。不猜事项、空间或负责人 ID。
+
+涉及本轮绑定事项时，先遵循 [执行快照与实时上下文](../ae-things/references/cli.md#执行快照与实时上下文) 读取本次执行快照，再按以下流程采集最新审查或周期事实；两种来源分开表述。无绑定时仅使用用户明确指定的范围。
+
+## 读取事实
+
+```bash
+ae-cli things +detail --agent-space-id <space-id> --id <thing-id> --format json
+ae-cli things +digest --agent-space-id <space-id> --format json
+ae-cli things +digest --agent-space-id <space-id> --thing-ids <id-a>,<id-b> --format json
+```
+
+范围只支持当前空间、负责人或显式事项集合。不要迁入关注清单和飞书群范围。大范围先筛查，再每批深审最多 20 项，披露筛查数和深审数。
+
+必须核对 `fetchedCount`、`truncated`、`consistency`、`collectedAt`。缺字段视为契约不兼容。截断或不可读取时只对已覆盖事实下结论，不能把首 100 项称为全量。`changed_during_collection` 时重读受影响事项；`non_transactional` 仍不是某时刻的严格快照。未读附件、私有历史和缺失初始目标均明确披露。
+
+## 审查顺序
+
+1. 目标与验收：是否明确、合理、可验证；用最早 `created` 记录对照当前目标。无法还原时只审当前目标。
+2. 范围漂移：目标变更是否有明确记录；不把后来结论当作原目标。
+3. 有效更新：结果、变化、阻塞或明确下一步才是进展。进展记录是待核查候选；占位、重复状态、备注和仅改标题不重置提醒节奏；采集的计数只是候选，模型仍需核查正文是否有效。
+4. 责任：负责人和协作者是否可用，描述与进展中是否明确下一步。
+5. 完成证据：产物是否可访问、是否符合验收；未读文件不能声称通过验收。
+
+优先采用明确约定的节奏。open 表示未完成，不区分尚未开始与进行中；没有约定时只报告最后记录时间，不臆造停滞。paused 检查记录中的暂停原因和恢复条件。只写“未记录更新”，不推断“没有推进”。
+
+引用时刻必须注明时区；需要按 Asia/Shanghai 判断自然日时先正确转换 ISO 的 Z/偏移量，不能只删除后缀。例如 `2026-09-10T04:50:00Z` 对应上海时间 12:50。无法转换则保留 UTC 原值并披露限制。
+
+## 输出与边界
+
+给出健康／需关注／高风险／信息不足，附目标基线、证据（事项链接和日期）、影响、置信度及最多三条优先动作。空间审查先共性问题，再逐项摘要；不评价个人绩效，不制造总分。
+
+默认只诊断，不改状态或负责人。用户明确要求落实的具体修改重新读取版本后执行，不再重复索要相同授权；推断变化先给待确认建议。不要自动发消息或创建定时任务。
+
+文件证据：+detail/+digest 自动翻页收集资产关联，availability=missing 或 verification_failed 的文件不算可用交付；即使 available，也只代表引用可用，不代表已读取正文或验收通过。披露未读文件及非事务采集边界。私有会话来源只在当前用户有权时读取，报告引用共享事项事实，不能把私有历史自动公开。

package/skills/ae-workspace/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: ae-workspace
+version: 1.1.0
+description: "Manage AE AgentSpaces with ae-cli: resolve current workspace context, list or update workspace profiles, transfer files, configure Agent/MCP/Skill/knowledge-base capabilities, manage shared-space members, inspect activities, or scope automations and archived conversations. Use for the new Workspace product; legacy sandbox Workspace sync/model behavior is separate."
+---
+
+# ae-workspace
+
+Use `ae-cli workspace` for AgentSpace operations. Here, `workspace_id` and `--workspace-id` always mean `AgentSpace.id`; they never mean the legacy sandbox `Workspace.id` or a filesystem directory name.
+
+Before composing a workspace command, read [references/commands.md](references/commands.md). It contains the command matrix, mutation prerequisites, and file-transfer rules.
+
+## Targeting
+
+1. Prefer an explicit `--workspace-id` supplied by the user or returned by `workspace list`.
+2. Inside a run, the CLI may use `TE_AGENT_CURRENT_AGENT_SPACE_ID`, derive the ID from the canonical `/spaces/actived/<id>/.conversations/...` runtime directory, or ask the server to resolve `TE_AGENT_CONVERSATION_ID`.
+3. When both workspace and conversation are available, send both so the server can reject a scope mismatch.
+4. Outside a run, if the target is unknown, run `workspace list` and select from real IDs. Never fall back to an account default.
+
+Use `workspace current` to verify the resolved ID, space type, role, and capabilities before a multi-step mutation.
+
+## Safety
+
+- Read the latest record or revision before mutations that require `--version`.
+- Treat capability and membership changes as `high-risk-write`; preview them with `--dry-run` and obtain explicit confirmation before passing `--yes`.
+- Treat file and workspace deletion as `high-risk-write`.
+- Shared AgentSpace provisioning is administrator-owned. `workspace create` creates only a personal AgentSpace.
+- `ae-cli sync` and `ae-cli model` manage the legacy sandbox Workspace. In an AgentSpace runtime, use workspace capability commands instead.
+
+## Related domains
+
+- Memory: `ae-cli memory ...` uses the same strict AgentSpace target.
+- Automations: use `ae-cli automation ... --agent-space-id ...` and follow the `ae-automation` Skill.
+- Archived conversations: `ae-cli agent +find-archived-conversations|+restore-conversation --workspace-id ...`.
+
+## Transition record
+
+Transition status: transitional
+Owning module: te-claude AgentSpace
+Current transport: CLI-token REST under `/api/cli/workspace/v1`
+Gateway target: TBD
+Review after: 2026-12-01
+Exit condition: equivalent stable Gateway capabilities exist; keep only commands that still add orchestration, file handling, safety, or stable typed output.

package/skills/ae-workspace/references/commands.md

@@ -0,0 +1,51 @@
+# Workspace command reference
+
+## Context and profile
+
+| Command | Risk | Required input | Result boundary |
+|---|---:|---|---|
+| `list` | read | none | Accessible AgentSpaces and stable IDs. |
+| `get` | read | workspace or conversation target | Resolved profile and access. |
+| `current` | read | workspace or conversation target | Server-verified target, role, and capabilities. |
+| `create` | write | `--name`; optional description | Creates only a personal AgentSpace. |
+| `update` | write | target, `--name` | Updates profile only. |
+| `delete` | high-risk-write | target | Soft-deletes an AgentSpace. |
+| `recover` | write | target | Requests runtime recovery for an active but unavailable AgentSpace; it does not undo archival or deletion. |
+| `activity list` | read | target | Recent workspace activity, up to 20 items. |
+
+## Files
+
+| Command | Risk | Required input |
+|---|---:|---|
+| `asset list` | read | target; optional folder `--path` |
+| `asset read` | read | target, text file `--path` |
+| `asset upload` | write | target, local `--file`; optional destination `--path` |
+| `asset download` | read | target, remote `--path`, local `--output` |
+| `asset mkdir` | write | target, `--name`; optional parent `--path` |
+| `asset move` | write | target, `--path`, `--destination` |
+| `asset delete` | high-risk-write | target, `--path` |
+
+Uploads are capped at 50 MB. Downloads preserve raw bytes and refuse to replace an existing local file unless `--overwrite true` is explicit.
+
+## Capabilities
+
+`capability list` returns the current revision and available selections. `capability set` replaces exactly one type: `agent`, `mcp`, `skill`, or `knowledge_base`.
+
+```bash
+ae-cli workspace capability list --workspace-id <agent-space-id>
+ae-cli workspace capability set --workspace-id <agent-space-id> --version <revision> --capability-type skill --selected-ids '["<skill-id>"]'
+```
+
+`--selected-ids '[]'` clears that type. When changing Agent capabilities, pass `--default-agent-id` only when the selected default is valid in the new set. A version conflict means the settings changed; list again and reassess.
+
+## Shared-space members
+
+| Command | Risk | Required input |
+|---|---:|---|
+| `member list` | read | target; optional `--candidate-query` |
+| `member add` | high-risk-write | target, `--user-id`, `--role ADMIN|MEMBER` |
+| `member update` | high-risk-write | target, `--user-id`, `--role ADMIN|MEMBER` |
+| `member transfer-owner` | high-risk-write | target, new owner `--user-id` |
+| `member remove` | high-risk-write | target, `--user-id` |
+
+Discover users through `member list --candidate-query` and use returned IDs. Ownership transfer is a distinct command so it cannot be confused with an ordinary role update.

package/dist/chunk-E2JKXMVO.js

@@ -1,29 +0,0 @@
-import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-
-// src/core/package-info.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-function getLocalCliPackageInfo() {
-  let dir = path.dirname(fileURLToPath(import.meta.url));
-  for (let i = 0; i < 8; i += 1) {
-    const candidate = path.join(dir, "package.json");
-    try {
-      if (fs.existsSync(candidate)) {
-        const pkg = JSON.parse(fs.readFileSync(candidate, "utf8"));
-        if (pkg.name && pkg.version && String(pkg.name).includes("ae-cli")) {
-          return { name: pkg.name, version: pkg.version };
-        }
-      }
-    } catch {
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return { name: "@tant/ae-cli", version: "0.0.0" };
-}
-
-export {
-  getLocalCliPackageInfo
-};

package/dist/context-IFJI3LIT.js

@@ -1,46 +0,0 @@
-import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-import {
-  getFromMainApp
-} from "./chunk-HBGADCKA.js";
-import "./chunk-Y74WTIKJ.js";
-import "./chunk-7XGFSUOM.js";
-import "./chunk-7FTTULED.js";
-import {
-  CliValidationError
-} from "./chunk-MAPZ7VB6.js";
-
-// src/commands/context/current.ts
-var CURRENT_PAGE_CONTEXT_PATH = "/api/sandbox/agent/context/current";
-function createCurrentPageContextCommand(read = getFromMainApp, readConversationId = () => process.env.TE_AGENT_CONVERSATION_ID) {
-  return {
-    service: "context",
-    command: "+current",
-    description: "Read the current page context bound to the active Agent Run",
-    flags: [],
-    risk: "read",
-    usesAeHost: false,
-    execute: async () => {
-      const conversationId = readConversationId()?.trim();
-      if (!conversationId) {
-        throw new CliValidationError(
-          "Current page context is available only inside an active Agent Run.",
-          {
-            code: "CURRENT_PAGE_CONTEXT_RUN_REQUIRED",
-            hint: "Open AE Agent from a supported product page and ask about the current page."
-          }
-        );
-      }
-      const query = new URLSearchParams({ conversationId });
-      return read(`${CURRENT_PAGE_CONTEXT_PATH}?${query.toString()}`);
-    }
-  };
-}
-var currentPageContext = createCurrentPageContextCommand();
-
-// src/commands/context/index.ts
-var commands = [currentPageContext];
-var context_default = commands;
-export {
-  currentPageContext,
-  context_default as default
-};