用途:在编写代码前,把技术需求中约定好的模式固化为具体代码示例(风格锚点),为后续实现提供可引用的模板,防止实现偏离既定架构。
前提:需要已完成的 technical-requirements.yaml;可选访问现有代码库或参考仓库。
主要能力:加载技术需求,识别需收集的典型模式类别(服务、测试、校验、API、数据访问、错误处理等);与用户交互式收集每个类别的示例文件路径、行范围、演示内容与适用时机;读取并预览代码后确认;生成索引与单个锚点文档,并附带模式的必做要求与常见错误。
用法:运行 /style-anchors-collection [base-directory]。若未提供目录,会查找当前目录下的 requirements/technical-requirements.yaml,找不到则提示用户提供路径。随后按步骤加载技术上下文、展示收集计划并逐类收集,最后在 {base_directory}/artifacts/style-anchors/ 下生成 index.yaml 和各锚点的 .md 文件,并显示收集摘要。
输出:index.yaml 含版本、项目、生成日期、技术需求引用、类别、锚点定义、使用矩阵与统计;每个锚点 .md 含 YAML frontmatter 及概述、来源引用、代码示例、演示内容、适用时机、模式要求、常见错误、相关锚点等章节。
集成与限制:实现规划器可读取 index.yaml,按任务类型与文件模式查询使用矩阵,将 2-3 个相关锚点写入任务指令。收集时的红旗包括示例含 TODO/FIXME、使用已弃用模式、无法编译运行、过短或过长、缺少测试。若无现有代码库或用户跳过所有类别,可选择跳过、引用外部示例或创建最小示例;不收集会降低示例具体性并增加架构漂移风险。文件不可访问时可更换路径、直接粘贴代码、提供 URL 或跳过。资料未提供具体收费、价格或平台支持信息。