SuperAPI AI 工具集

update-agent-docs

智能体与模型

查看项目

更新于 10-15 21:12

技能介绍

用途:这是 dotnet/roslyn 仓库使用的技能,要求在每次改动代码的任务结束时运行,用于同步更新智能体知识库文档,属于任务收尾的必做步骤。

主要能力与检查清单:新增或移动文件时,更新 .github/memory/FILE_MAP.md(顶层区域)及对应的 .github/instructions/<area>.instructions.md(目录细节);记忆文件新增、删除、重命名或用途变化时,更新 .github/memory/INDEX.md 及引用它的记忆文件;公共 API 变化时,更新对应的 .github/instructions/<area>.instructions.md(Compiler/IDE)以及所属项目的 PublicAPI.Unshipped.txt(由 RS0016 强制),API_MAP.md 仅覆盖仓库级入口点;新增编译器错误码、IDE 诊断 ID 或资源字符串时,同步到对应指令文件,并保证 ErrorCode.cs、IDEDiagnosticIds.cs、.resx(配合 /t:UpdateXlf)一致;出现新约定时,仓库级写入 .github/memory/CONVENTIONS.md,分层级写入对应指令文件;发现意外或未记录行为时,先询问用户如何记录;测试基类、位置或运行方式变化时,仓库级布局写入 .github/memory/TESTING_STRATEGY.md,分层基类与约定写入 .github/memory/testing/<area>.md。文档更新本身无需额外跟踪,Git 历史会自动记录。

文档质量要求:文档应描述仓库当前状态,而非本次改动的历史或机制;不要加入只对当前 diff 有意义的指引、已删除行为的说明或针对已不存在变通方法的警告。添加前先判断它是否有助于从干净检出开始的未来贡献者,否则不要写。

新建文档:若知识不适合现有文件,可在 .github/memory/ 下新建描述性名称的文件(如 incremental-generators.md,而非 misc.md),添加仅含 coverage 字段的 YAML frontmatter,并在 .github/memory/INDEX.md 增加一行。创建新文件无需许可。不要添加 last_updated、updated_by、confidence 或 date 字段,Git 历史已提供这些信息且可避免合并冲突。

限制:资料未提供该技能的安装方式、运行命令、适用平台或收费信息。