用途:整理项目里既有的技术文档,将其归类到合适的目录结构中,适用于文档散落、需要按类别重组的仓库。\n\n主要能力与流程:先用 Glob 查找文档(docs/.md 查找 docs 根目录下的散落文件,docs/**/.md 查找包含子目录在内的全部文件),并用 ls docs/*/ 查看已有目录。随后向用户展示检测到的既有分类,并给出建议分类:specs/ 用于功能或系统规格,planning/ 用于进行中的实施计划,archive/ 用于已完成或已被取代的文档,architecture/ 用于 ADR 与架构决策,reference/ 用于技术参考文档,由用户选择要使用的分类。\n\n分类前会读取每个文档的前约 50 行,按关键词判断类型:出现 ADR、Decision、Status: Accepted/Proposed、Context、Consequences 建议归入 architecture/;出现 Specification、Requirements、Spec、Technical Approach 建议归入 specs/;出现 Plan、Implementation、Steps、Timeline、Goal 建议归入 planning/;出现 Reference、Guide、How to、Examples、Usage 建议归入 reference/。分析结果会先展示给用户确认,用户可批准、拒绝或为单个文件另选分类。\n\n执行方式:对确认的文件,若目标目录不存在先执行 mkdir -p docs/<categoria>/,再用 git mv docs/<archivo>.md docs/<categoria>/<archivo>.md 移动以保留 git 历史。可选择重命名为 YYYY-MM-DD-<name>.md 的标准格式,ADR 例外使用 NNNN-<name>.md,重命名前需先询问用户。最后输出汇总,包括各分类的文件数量、已重组的文件清单,以及未能分类的文件。\n\n限制:该技能只处理既有 Markdown 文档,不创建文档内容;所有移动与重命名均需用户确认;涉及的分类名称、命令与重命名格式以资料为准,其他功能暂未提供。
doc-organizer
通用与其它
更新于 10-16 03:04