SuperAPI AI 工具集

tidy

通用与其它

查看项目

更新于 10-15 22:14

技能介绍

用途:清理 docs/arc/plans/ 中已完成的计划文档,归档或删除已实现计划,保持计划目录整洁。

主要能力:发现计划文件(默认 docs/arc/plans/.md,回退 docs/plans/.md);从文件名解析日期、主题与类型(-design.md 或 -implementation.md);从计划内容提取文件路径、函数/组件/类型名和测试路径;通过检查文件是否存在、git log 与 grep 判断实现状态,分为 Implemented、Partial、Outstanding、Unknown。

使用方式:默认完整模式审查全部计划;--quick 仅显示可归档的已实现计划。逐条展示计划摘要、状态与证据,并用 AskUserQuestion 询问处置:Archive、Delete、Keep、Skip。归档执行 mkdir -p docs/arc/archive/ 与 mv;删除执行 rm 及关联资源清理。全部处理后输出统计表,并询问是否提交,确认后执行 git add docs/arc/plans/ docs/arc/archive/ 与 git commit -m "docs: tidy up completed plans"。

适用场景:arc 工作流中 /arc:ideate 生成设计计划、/arc:implement 生成并执行实现计划后,用 /arc:tidy 做收尾清理。

限制:不修改计划内容、不创建新计划、不触碰 docs/arc/plans/ 之外的内容、不擅自决策、不未经确认自动删除。配对的设计与实现计划会一起分析处置;带资源的计划会检查 docs/arc/specs/assets/YYYY-MM-DD-topic/;超过 60 天且无活动的计划会附加提示;无法解析的计划展示文件名与开头内容交由用户决定。交互要求一次只问一个问题,保持简洁友好。