workspace-file-edit

name	workspace-file-edit
description	人设文件编辑：修改工作区的SOUL.md、USER.md、BOOTSTRAP.md文件。当用户要求更新人设、个人信息、引导配置时触发。
metadata	{"category":"tools","tools":"write_persona_file","tree_id":"fs/write_persona_file","tree_group":"fs","min_tier":"task_write","approval_type":"plan_confirm","emoji":"📝","enabled_when":"always","file_access":"scoped_write","scope_check":"workspace","security_level":"allowlist","policy_groups":["group:fs"],"profiles":["coding","full"],"wizard_group":"workspace","sort_order":28,"exclude_from":["task_delete"],"intent_keywords":{"zh":["人设","更新人设","修改人设","SOUL","USER","个人信息","档案","引导","改一下人设","设置身份","配置引导"],"en":["persona","update persona","edit persona","soul file","user profile","identity","bootstrap","update my profile","change my name"]},"intent_priority":12,"related_tools":["read_file","write_file"],"scene_hint":"改SOUL.md/USER.md/BOOTSTRAP.md用此→其他文件用write_file→MEMORY.md由系统管理不可手动改","summary":"Edit workspace persona files (SOUL.md, USER.md, BOOTSTRAP.md)","title":"Workspace File Edit","verb":"Edit","detail_keys":"name","tool_description":"编辑工作区人设文件(SOUL.md/USER.md/BOOTSTRAP.md)。用于更新智能体人设、用户档案或引导配置。MEMORY.md由记忆系统自动管理，不可通过此工具编辑。","tool_input_schema":{"type":"object","properties":{"name":{"type":"string","enum":["SOUL.md","USER.md","BOOTSTRAP.md"],"description":"要编辑的文件: SOUL.md(人设), USER.md(用户档案), BOOTSTRAP.md(引导配置)"},"content":{"type":"string","description":"完整文件内容（全量替换）"}},"required":["name","content"]}}

Workspace File Edit -- 人设文件编辑

参数

参数	必填	说明
name	是	文件名: SOUL.md / USER.md / BOOTSTRAP.md（白名单严格限制）
content	是	完整的新文件内容（全量替换）

使用指南

• 通过独立工具 write_persona_file 执行，enum 白名单在 backend 强制生效：仅允许 SOUL.md / USER.md / BOOTSTRAP.md
• 需要 plan_confirm 确认后才会写入
• 内容是全量替换 -- 写入前务必先用 read_file 读取当前内容
• MEMORY.md 由记忆系统自动管理，不在可编辑范围内
• 写入后下一轮对话自动重新加载到系统提示词，无需重启

文件用途

文件	用途	编辑场景
SOUL.md	智能体人设、语气、风格	用户想改变助手性格
USER.md	用户档案、偏好	用户分享个人信息、姓名、时区
BOOTSTRAP.md	初始引导配置	高级自定义（少见）

工作流

1. 先读取当前文件: read_file path="SOUL.md"
2. 与用户讨论要修改的内容
3. 写入更新: write_persona_file name="SOUL.md" content="..."
4. 确认变更已生效

与 write_file 的区别

维度	write_persona_file	write_file
文件名约束	enum 白名单：仅 3 个人设文件	工作区任意路径
路径参数	name（不接受路径）	path（任意工作区路径）
适用场景	用户说"改人设/个人信息/引导"	普通文件创建/覆盖
误改风险	0（白名单外直接拒）	依赖 LLM 自觉