specstory-organize

specstory-organize 技能为使用 SpecStory 进行 AI 辅助编码的开发人员提供了流畅且自动化的工作流程。随着项目的演进，.specstory/history/ 目录往往会累积大量 Markdown 文件，导致难以快速检索特定会话、进行项目归档或维持工作空间整洁。此技能能够系统性地扫描您的历史记录目录，解析文件名中内嵌的日期信息，并将这些文件迁移至按年与月整理的子目录中（例如 2026/01/）。该工具旨在确保高度的稳定性，在保持项目结构清晰的同时，仅处理合规的文件。

• 通过解析文件名中的时间戳，自动将 Markdown 文件归类存放。

• 通过构建可扩展的 YYYY/MM 目录层级，有效消除历史记录根目录的杂乱感。

• 支持模拟运行 (Dry-run) 模式，允许您在执行任何磁盘操作前先行预演文件迁移过程。

• 完美适配 Claude Code、Cursor 或类似命令行 AI 编码代理部署的环境。

• 具备良好的大数据集处理安全性，仅处理尚未归类的文件，自动跳过已整理的内容。

• 适用于需要对 AI 交互日志进行高效归档管理的高频 AI 编码用户。

• 若要启动整理过程，请直接调用斜线指令 /specstory-organize 或在项目根目录运行 Python 脚本。

• 强烈建议在执行过程中使用 --dry-run 参数，以便在提交文件系统更改前安全审计受影响的文件列表。

• 请注意，本技能基于文件名内部的时间戳格式而非操作系统的文件修改时间，这确保了跨不同文件系统的一致表现。

• 脚本会自动跳过文件名中不含可识别日期格式的文件，以及已存放在子目录中的文件，从而避免意外错误。

• 本工具适配标准 POSIX 环境，且兼容 Python 2.7+ 及 3.x 版本。