SuperAPI AI 工具集

update-doc

写作与研究

查看项目

更新于 10-15 22:41

技能介绍

用途:更新 .chalk/docs/ 目录中已存在的文档文件,适用于用户要求更新、编辑或修订文档的场景。

工作流程:先在 .chalk/docs/ 中按文件名、路径或内容查找与 $ARGUMENTS 匹配的文件;若存在歧义,列出候选并请用户确认。随后读取现有内容,按用户请求修改,尽量保留原有结构与章节,除非明确要求否则不删除内容。接着更新“Last updated”行,设为当天日期并附简短变更说明。最后写回同一路径并告知用户变更内容与文件路径。

规则:保留现有 # 与 ## 标题,除非用户要求重组;只改相关部分,不重写无关内容;必须更新日期行,格式为 Last updated: YYYY-MM-DD (<brief change note>);文档为纯 Markdown,不添加 YAML frontmatter;遵循各垂直领域语气——产品文档面向业务,AI 文档面向智能体的参考风格,工程文档偏技术且全面。

查找策略(按优先级):用户给出路径如 ai/0_AI_PROFILE.md 时直接使用;在 .chalk/docs/ 中按 /[slug]*.md 进行 glob 文件名匹配;在 .chalk/docs//*.md 中 grep 关键词做内容搜索;也可按垂直领域加主题查找,例如“工程架构文档”在 engineering/ 中搜索架构相关文件名。

限制:以上信息来自公开资料,其余细节暂未提供。