根据项目文档制作智能体技能并保持更新

## 编辑前先弄清技能由谁维护 创建或更新文件之前，先确定每项技能的归属方式。对于发布文档但不维护智能体技能包的项目，使用生成型技能；对于已经发布自有技能的项目，使用同步型技能；对于有意精选的专业知识，使用手工编写的技能。 不要混用这些工作流。生成型技能从文档中综合生成，同步型技能从其上游技能来源复制，而手工编写的技能除非明确包含在当前任务范围内，否则保持不变。 ## 只从文档中挑选对智能体做任务有用的内容 重点关注能力、决策点、实用的使用模式、可运行的示例，以及智能体应在何种情况下选择一种方法而非另一种方法。优先选择能实质性改善任务执行的知识。 略过面向用户的介绍、安装演练、通用入门资料、宣传性文字，以及能力足够的模型已经能够可靠处理的概念。重写并综合来源材料，而不是逐字复制文档。 保持技能紧凑。只创建涵盖不同概念所需的参考文件，避免冗余文件，并同时说明一种模式如何运作，以及为什么或何时应使用它。 ## 把新项目加入注册表并生成技能 将新的生成型来源添加到存储库的权威项目注册表中，并包含其来源位置和稳定的项目标识符。通过存储库支持的工作流初始化或同步该来源，而不是创建不受跟踪的本地副本。 充分阅读项目文档和所有项目专用生成指令，以便理解其能力和惯例。将有用材料整理为核心概念、功能、最佳实践和高级工作流等类别。 创建名称与已注册生成来源标识符一致的输出目录。编写参考文件，构建技能索引，并记录包含确切来源修订号的生成元数据。 ## 只在文档有变化的地方更新生成型技能 读取生成元数据中记录的来源修订号，并将其与当前来源比较。将来源差异限定在管理该生成型技能的文档区域内。 只更新受该差异影响的参考文件，然后在必要时更新索引中的项目版本、生成日期、主题表和说明。保留未受影响的参考文件，不要仅仅因为来源存储库有了进展就重新生成无关内容。 审核后，将已记录的修订号替换为本次更新所使用的确切修订号，使下一次比较拥有可信的基准。 ## 不手动修改，通过复制来同步上游维护的技能 对于由上游维护的技能，使用注册表确定要复制哪个来源技能以及要使用哪个输出名称。输出名称可能有意与上游目录不同，因此绝不要仅根据来源名称进行推断。 首次导入时，复制配置指定的技能树，并在同步元数据中记录上游修订号。更新时，将已记录的修订号与当前上游技能目录比较，只复制配置范围内发生变化的文件，然后推进已记录的修订号。 绝不要手动修改同步型技能的内容。将修正提交给上游所有者，再通过同步工作流将其引入，从而避免本地副本发生偏离。 ## 编写列出各参考文件链接的简短技能索引 为技能索引设置有效的文首元数据，其中包含采用 kebab-case（短横线命名法）的名称、简洁的能力说明、溯源元数据、生成日期或同步日期，以及相关工具或项目的版本。 添加一段简短的引导文字，然后将参考文件归入清晰的类别。对于每个主题，提供简要说明和指向相应参考文件的相对链接，使智能体只加载当前任务所需的材料。 让索引保持简洁并专注于导航。不要在索引中重复参考文件的完整内容，也不要为不存在的文件添加条目。 ## 每个参考文件只写一个实用主题 为每个参考文件设置包含稳定名称和聚焦说明的文首元数据，随后给出清晰的概念标题。每个文件只涵盖一项连贯的能力或工作流，不要把无关功能合并在一起。 包括实用的使用指引；如果概念可执行，则包括可运行的代码示例；还要包括关键约束和推荐模式背后的理由。移除无助于智能体作出或执行决策的背景内容。 在末尾列出来源引用，明确用于综合内容的文档。保持这些引用可追溯，同时不要让技能变成来源材料的复制品。 ## 记录制作每个技能时所用的来源修订号和日期 对于生成型技能，记录来源位置、确切的来源修订号和生成日期。对于同步型技能，记录上游技能位置、确切的上游修订号和同步日期。 使索引版本与实际来源状态一致，并根据存储库策略使用最近一次生成或同步的日期。不要声称项目版本或修订号比内容所依据的版本更新。 将注册表视为受支持项目和来源位置的规范列表。当这些信息已由注册表管理时，避免在多个技能文件中重复可能变化的存储库 URL 或归属映射。 ## 在最终差异中检查失效链接和过时的修订号 完成前，确认来源分类、注册表条目、输出命名规则、索引链接、参考文件的文首元数据、类别组织、修订元数据和来源引用全部一致。 验证生成内容是综合所得而非复制所得，同步内容不存在手工造成的偏离，手工编写的技能在未纳入范围时没有被改动，并且每个参考文件都能为智能体提供不同的价值。 检查最终差异中是否存在无关文件、过多的参考文件、过时版本、缺失示例、失效链接和未记录的来源变更。报告任何妨碍完整生成或同步的来源限制或工具限制。