用途:这是一套面向 Opensquad 最佳实践库(_opensquad/core/best-practices/)的创建与维护工作流,用于规范新增、更新、移除最佳实践文件时的格式、交叉引用与版本管理。
主要能力:创建新文件(Best-Practice Creator)时需先做预检——读取 _catalog.yaml 提取各条目的 id、name、whenToUse、file 并检查范围重叠,同时读取 skills/*/SKILL.md 提取技能信息。新文件须包含 YAML frontmatter(id 用小写 kebab-case、name、whenToUse 含正向范围与“NOT for: ...”负向范围、version 初始为 1.0.0)以及强制章节:Core Principles(6+ 条编号规则)、Techniques & Frameworks(3+ 具体方法)、Quality Criteria(4+ 可勾选项)、Output Examples(2+ 完整示例,各 15+ 行)、Anti-Patterns(Never Do 4+ 与 Always Do 3+)、Vocabulary Guidance(Always Use 5+、Never Use 3+、Tone Rules 2+)。全文件需 200+ 行。创建后需更新重叠文件的 whenToUse 并递增版本,更新 _catalog.yaml,并将文件放入指定目录后重读校验。
更新能力(Best-Practice Updater):按 Semver 管理版本——修补号用于措辞修正,次版本号用于新增内容,主版本号用于重构或范围变更;每次改动都要更新 frontmatter 的 version。还覆盖移除文件、新增文件、修改内容、修改 whenToUse 等场景,需同步目录、清理失效交叉引用并更新其他文件版本。另提供批量校验:核对目录条目与文件的一致性、检测孤立文件与交叉引用错误。
使用方式与限制:通过给定的工作流步骤执行,涉及的文件路径如 _opensquad/core/best-practices/_catalog.yaml 与 _opensquad/core/best-practices/{id}.md 保持原样。资料未提供该技能的具体安装命令、运行方式、收费模式与平台信息,暂未提供。