MCP 工具清单

按能力分组,覆盖 AI 记忆的完整生命周期。每条只讲三件事:参数是什么意思、会不会丢数据、有没有副作用。

本页不承诺任何会变的数字。工具会增减,以你调用 tools/list 得到的清单为准; 本页只说明「有哪些能力、各自适合什么场景」。

① 会话开场

check_my_todoslist_recent_memories

每次会话先看「有什么没做完」和「最近改了什么」。两者都只读,不改任何数据。

② 检索与阅读

search_experienceget_experience_detailget_experience_history export_documentdiff_experiences

全部只读。get_experience_detail 超长时分段返回(照抄回执里的 offset 续读,不会只给一截); get_experience_history 能读被归档搬走的旧版;diff_experiences 直接给两篇的共同行与各自独有行, 判断「是否重复」不必读两篇全文。

③ 写入与修改

create_experienceappend_experiencepatch_experience update_experienceimport_document

先选对入口,比事后恢复便宜:只改一段用 patch_experience(find→replace,必须唯一命中); 补一段用 append_experience(服务端拼接,不读全文,不会因截断丢原文); 整篇重写才用 import_document / update_experience。每次改动都留版本快照。

④ 记忆整理

scan_similar_docslist_review_candidatesadd_review_candidate resolve_candidateset_flags mark_supersededclear_superseded

只提建议,不替代判断,不删任何内容。扫描只入队、不判定;resolve_candidate 的 duplicate 只打标记(不合并正文)、superseded 只写指针;set_flags 不递增版本、不写快照。 判错了可以用 clear_superseded 撤销。要看两篇差在哪,用 ② 里的 diff_experiences(逐行差异)。

⑤ 生命周期与瘦身

update_experience_statusmark_for_deletioncancel_deletion archive_old_versionslist_archived_versions

删除这一步 AI 做不了:它只能标记「待删」并写明原因,需要你在后台确认才真正删除,标错可撤销。 历史版本可以归档瘦身(默认 dryRun 只算不写),归档是搬位置,不是删除,之后仍能原样读回。

⑥ 模板

get_template

创建前先取模板。返回当前可用的全部模板类型与各自字段要求(只读)。

⑦ 项目空间

create_projectlist_projectsget_projectupdate_project delete_projectlist_project_experiencesget_project_agents update_project_agents_mainupdate_project_agents_chapter export_project_agentsappend_project_progressget_project_progress promote_to_globalgenerate_workflow_prompt

项目手册按章分片(先读 MAIN 索引,再按需读章节,省上下文)。 promote_to_global 是「显式提升为全局经验」的开关 —— 提升后即进全局检索; delete_project 只删项目本身,不删文档,且项目里还有文档时会被拒。

⑧ 观测与反馈

get_tool_statsreport_experience_result

get_tool_stats 只读统计(含「从未被调用的工具」),用来判断哪些工具值得保留; report_experience_result 反馈某条经验有没有帮上忙 —— 没帮上时请写清原因,下一个助手才不会重复踩。

经验模板

用 get_template 取当前清单与字段要求。模板决定正文结构,选错会让后来的人搜得到、用不上。

problem_solutionknowledge_doctodo_listschedule_plan bug_fixconfig_guidehow_togoal

依次为:问题解决方案 / 知识文档 / 待办事项 / 计划排期 / Bug 修复记录 / 配置指南 / 操作指南 / 目标。 选择原则:要「下次照着做」选操作类(how_to、config_guide),要「知道是什么」选知识类(knowledge_doc)。

← 返回首页