SuperAPI AI 工具集

writer

写作与研究

查看项目

更新于 10-16 08:10

技能介绍

writer 技能用于文件编辑、更新文档、替换文本、润色写作风格以及文本处理任务。资料指出,当用户要求对文件中的文本进行 update、replace、change、modify 或 edit 时,必须使用该技能,而不应使用 grep、sed 等软件工程工具,原因是这类工具脆弱、不理解文档语义且可能造成非预期修改。

主要能力围绕对文本结构和语义的理解,包括文件结构与语法、Markdown 格式、代码块保留以及文档语义。其写作风格要点为:简洁优于冗长;使用主动语态;文档只保留一个 H1 标题;每段最多 3 至 4 句;去掉冗余词,例如 utilize 改为 use、facilitate 改为 help、in order to 改为 to。

使用方式上,编辑文件是主要场景:先用 filesystem.read_files 只读一次文件,不要再调用 cat、head 或 read_file 重复读取;在上下文中分析并规划修改;使用 writer.replace 或 writer.rewrite 并传入第一步中的精确字符串执行修改;完成后无需再次读取。资料明确禁止对同一文件反复读取。

写作文档时,按上下文中已自动加载的风格指南撰写,必要时在保存前使用 writer.polish_text(),再用 filesystem.write_file() 或 writer.rewrite() 保存;除非明确要求,否则不要运行 vale 等外部校验工具,资料称上下文中的风格指南已足够。

限制与缺失:资料未提供安装命令、价格、平台支持、具体 API 细节或性能指标,这些暂未提供。