用途:为项目的 specs/ 目录生成或整体重新生成 specs/OVERVIEW.md,集中列出所有功能规格。前提是项目根目录存在 specs/,且至少有一个含规格文件的子目录(如 requirements.md、smolspec.md、design.md、plan.md 等)。生成时先遍历 specs/ 下的子目录,排除 specs/bugfixes/,收集目录名(作为规格标识,并转为 Title Case 显示名)、创建日期(取该目录最早添加文件的 git 提交,命令为 git log --diff-filter=A --format='%aI' -- 'specs/{dirname}/',取最旧一条并格式化为 YYYY-MM-DD)、状态(依任务文件判定:全部完成 Done、部分完成 In Progress、有任务但均未完成 Planned、无 tasks.md 为 No Tasks)、摘要(从主文档首个实质性段落提取,最多约15词)和该目录下所有 .md 文件。输出结构为:# Specs Overview 标题、按创建日期从早到晚排序的表格(列为 Name、Creation Date、Status、Summary,Name 链接到下方锚点);表格后以 --- 分隔,每个规格一个 H2 小节,重复摘要并列出该目录所有 .md 文件的链接。写入时完全覆盖已有 OVERVIEW.md,不得创建除 specs/OVERVIEW.md 之外的文件;必须使用 git 历史而非文件系统时间戳,状态必须依据任务文件而非猜测,且不得包含 specs/bugfixes/ 中的规格。
specs-overview
办公与效率
更新于 10-15 18:46