SuperAPI AI 工具集

conditional-docs-setup

写作与研究

查看项目

更新于 10-16 00:23

技能介绍

用途:该技能用于为项目建立“条件式文档加载”机制,让智能体只在任务条件匹配时读取对应文档,避免一次性加载过多文档造成上下文污染、降低专注度。

主要能力:盘点项目中的文档文件,按用途分类(如 Setup、API、Architecture、Features、Testing),为每份文档定义明确的加载条件,并创建一个条件文档清单文件(如 .claude/commands/conditional_docs.md)。清单中注明“仅当条件匹配任务时才阅读文档”,还可将条件检查集成到规划命令中。

使用方式:可按工作流操作。先用 find . -name ".md" -path "/docs/"、find . -name "README"、find . -name "CONTRIBUTING*" 等命令盘点文档;再按用途分类;为每份文档列出触发条件;创建条件文档清单;最后在规划命令中加入提示,要求读取 conditional_docs.md 并判断任务是否匹配条件。

条件撰写要点:条件要具体,例如“添加新 API 端点”“修改用户认证”,避免“做后端工作”这类模糊表述;覆盖常见场景;各文档条件应互不重叠,避免同一条件指向多份文档。

维护流程:新增文档时创建文件、在 conditional_docs.md 添加条目并定义条件;更新文档时复查并增删条件;删除文档时移除文件及清单条目。

适用场景:新项目文档组织、既有项目减少上下文污染、创建按需加载的文档、优化智能体上下文使用。

限制:资料未提供该技能的具体安装方式、依赖要求、支持平台与收费信息,暂未提供。