SuperAPI AI 工具集

memory-and-handoff

办公与效率

查看项目

更新于 10-16 08:08

技能介绍

用途:该技能为 cc10x 工作流提供两种模式。会话记忆模式在 .cc10x/ 目录下加载与持久化工作流状态,使上下文在压缩后仍能延续;交接包模式生成可移植、人类可读的导出文件,供非本会话的读者(同事、其他工具或无 cc10x 路由器的干净会话)接手。

主要能力:记忆文件包括 .cc10x/activeContext.md(当前焦点、近期变更、决策、学习、引用、阻塞)、.cc10x/patterns.md(可复用项目标准、陷阱、约定、技能提示)、.cc10x/progress.md(当前工作流、任务快照、已完成项、验证证据),以及机器拥有的 workflows/{wf}.json 与 .events.jsonl。路由器在路由或恢复前加载并自动修复记忆文件;写入型代理只读不改 .cc10x/*.md,通过 Router Contract 中的 MEMORY_NOTES 提交结构化笔记;路由器拥有的 memory-finalize 任务是记忆 markdown 的唯一最终写入者。

使用方式:工作流开始时必须读取三个记忆文件,并在架构决策、实现选择、调试、规划下一步、声明完成或用户说“continue”前重新读取。持久化时按 learnings、patterns、verification、deferred 分类,每条一行。压缩时按 KEEP(用户硬约束、确切下一步、未解决错误,逐字保留)、SUMMARIZE(已解决决策、已结束尝试、文件边界,各压缩为一行)、DROP(装饰性文字、逐步日记、被取代的推测)处理。交接包写入系统临时目录,命令为 HANDOFF="${TMPDIR:-/tmp}/handoff-$(date +%Y%m%d-%H%M%S).md",并打印绝对路径;按路径或 URL 引用产物,不粘贴内容;写入前按规则脱敏密钥与 PII。

适用场景与限制:适用于需要跨压缩、跨会话延续状态,或需要向外部读者交接的 cc10x 工作流。限制包括:写入型代理不得编辑 .cc10x/*.md(bug-investigator 的 [DEBUG-N] 行除外);不得编造技能 ID;交接包不得写入仓库;内部机器拥有的编排状态保持逐字不脱敏。资料未提供具体安装命令、收费与平台信息。