SuperAPI AI 工具集

ae-things

办公与效率

查看项目

更新于 10-16 21:56

技能介绍

用途

ae-things 用于操作当前明确指定的 AgentSpace 中的事项(things)。通过 ae-cli things 命令完成事项的创建、查询、更新和推进。使用前需先读 CLI reference,不猜测 ID,不自动选择其他空间。当对话出现分工指派(谁负责什么)、要交付的产出、推进节奏、待办、下一步、里程碑或阶段计划时,应主动使用本技能,无需用户显式说出「创建事项」。

何时创建事项

由使用者自行判断是否创建,不必等待显式指令,个人空间与共享空间一视同仁。出现以下任一信号即可直接创建:出现「谁做什么」的分工指派;出现要交付的产出加上推进意图;出现承诺、待办、下一步、里程碑或多阶段计划;用户在复述已定下来的事并指向后续执行。

以下情况不要创建:纯信息问答、概念解释、闲聊;仍在比较方案、假设性推演,或用户明确说「先不定」;查重命中已有同义事项(应指出已存在,不重复建);用户说过不要建。不确定时,把拟建清单(标题、负责人、描述要点)在回复中列出,一次性请用户确认,不允许什么都不做就把分工排版成清单交差。

创建流程

动作顺序为:确认已绑定明确的 AgentSpace(未绑定则不创建);用 members 取成员列表,把对话中提到的人名映射到成员 ID,唯一命中即作为 --assignee-id,命中 0 个或多个时负责人留空(服务端默认当前用户)并在回复中点名待确认;用 list --query 或 options --query 查重;逐个 create,标题写可交付物而非原话复述,描述写清目标与验收要点,带 --command-id 保证重试幂等;需要时用 conversation bind 绑定主事项或用 link-conversation 建普通引用;最后在回复中报告已创建的事项编号、标题、负责人及待确认的负责人。

粒度上,按「可独立交付、可独立负责」的单位建事项,没有子事项和分组,不要试图建层级。例如「A、B、C 各自梳理一块,然后合成一份总方案」对应 4 个事项,而不是 1 个,也不是每句话一个。

授权边界

可自主执行的操作:创建新事项;为自己刚建的事项补第一条记录。对于用户已授权推进/完成的事项,可直接追加或更新相应进展,并自动关联本次涉及的交付附件,完成发布与回读,发布仍传 --confirm-share;授权事项的交付即包含向该事项所在空间共享这些交付文件。其他已有事项的改写、负责人变更、归档/恢复、解绑及永久删除仍需明确授权,历史绑定本身不是授权。不自动发消息或创建定时任务。

交付附件闭环

追加/更新进展时,逐个核对本次实际交付文件:用 asset available 查本空间文件并翻完分页,已登记文件按 assetId 关联,未登记文件按返回的相对 path 关联;尚未进入空间的新文件用 asset publish(本轮未登记产物使用 --conversation-id --run-id --source-path,已有产物使用 --artifact-id 或 --file-token),每个文件保存独立 commandId,重试原样复用;linked:false 表示已发布未关联,只用返回 assetId 补 asset link,不重复复制;只发布本次交付文件,不发布临时文件或整个会话目录。最后用 asset list --id 回读,核实每个附件存在且 availability=available,再回读进展记录,只有两者均成功才报告「进展和附件已更新」,失败时明确区分已发布、已关联、待恢复。附件使用文件关联接口,本地路径文本链接不能代替附件,仅复制文件也不算交付完成。

会话绑定与执行快照

以本轮冻结的绑定声明确定本轮默认事项。涉及当前事项执行、审查、总结或更新前,按声明中的 readCommand 读取本次执行快照,普通聊天无需读取。运行中切换或解绑只立即改变会话归属,本轮(含等待、恢复、重试)仍用原快照;原先无事项则本轮继续无默认事项,下一次新 Run 才使用最新绑定。用户明确指定其他事项时仍按权限读取和操作,不将会话最新归属误认为本轮快照。

用户明确要求将当前对话绑定到某事项时,唯一定位目标后执行 conversation bind,再用 conversation primary 回读确认;同名事项不能唯一确定时询问用户。成功说明「已绑定,事项上下文从下一轮生效」,解绑也须回读确认。不得将 link-conversation 普通引用当成主事项绑定成功的替代;接口失败应如实说明。context --id <thing-id> --run-id <run-id> 返回执行受理时的业务文本和版本;需要最新事实或写入前版本时额外读取不带 --run-id 的实时上下文,并明确区分采集时间与快照版本;读取失败时披露缺失,不凭标题猜测,也不自动改读实时数据。

字段与记录

字段为标题、描述、标签、状态、负责人、协作者。状态为 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。运行冲突时等待,不自动终止运行。已获明确授权的具体修改直接执行,不重复询问。

命令示例

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-progress,二者按完整采集事实归纳,保留未读文件、截断和非事务采集边界。用 things conversations 列出关联会话,用 things conversation get 读取单个会话;新会话从工作空间 UI 发起,Things CLI 只管理事项链接和主事项绑定。

限制

创建前必须已绑定明确的 AgentSpace,否则不创建。负责人映射到成员 ID 时命中 0 个或多个则留空待确认。改写、负责人变更、归档/恢复、解绑及永久删除需明确授权。不自动发消息或创建定时任务。附件以文件关联接口为准,本地路径文本链接不能代替附件。文档未提供收费、价格、平台或效果等信息。