Artifact Organizer

---

name: artifact-organizer

description: 按任务阶段而不是按文件类型整理混合产物。当编码、写作、脚本处理、研究、自动化或多步骤任务产生多个文件，且文件开始散落、临时产物与最终产物混在一起、目录结构不清晰，或用户提出“整理目录”“整理工作区”“归类”“归档”“收整产物”“文件有点乱”“帮我理一理结构”时，使用此技能。既支持任务开始前先规划 staged 目录结构，也支持对已经变乱的任务目录做清理和重组；遇到密码、token、API key、服务器凭据等精确敏感信息时，优先归入现有 secrets/ 体系。

---

# Artifact Organizer

这个技能用于把任务产物整理得更清楚、更容易继续做、更方便后续维护。

默认原则是：**按任务阶段优先，按文件类型次之**。

也就是说，通常应该：

什么时候使用这个技能

以下两类情况都适合触发：

1）任务开始前先规划结构

适用于：

2）任务进行中或结束后做整理

适用于：

核心规则

1. 按任务阶段组织，而不是只按扩展名分类

优先考虑类似这样的结构：

<task-root>/
├── 01_input-prep/
├── 02_processing/
├── 03_verification/
└── 04_delivery/

然后再在某个阶段下按需要细分：

02_processing/
├── scripts/
├── data/
├── notes/
└── outputs/

不要强迫所有任务套用同一个固定模板。阶段名应该跟着真实 workflow 走。

2. 同一阶段下允许多种产物并存

一个阶段下可能同时有：

这很正常。只要它们属于同一个步骤，就应该允许放在一起，而不是为了“整齐”强行拆散。

3. 精确敏感信息优先归入现有 `secrets/`

如果发现以下内容：

处理原则：

例如：

如果直接移动会影响现有代码运行、脚本加载或任务连续性，则优先保证功能不坏，并明确说明取舍。

4. 只做有意义的整理，避免为整齐而整齐

不要为了好看而大搬家。

只有在以下方面明显变好时，才值得移动、重命名或重组：

避免无意义折腾。

5. 保留任务连续性

整理已有任务时：

推荐工作流

模式 A：开始前先规划结构

1. 理解任务目标。

2. 推断可能经历的阶段。

3. 建立一个紧凑、够用的阶段式结构。

4. 后续新产物尽量直接落到对应阶段。

模式 B：对已有混乱目录做整理

1. 先检查当前已有文件。

2. 按 workflow 角色分组，而不是只看扩展名。

3. 定义能反映真实过程的阶段目录。

4. 只移动或重命名那些确实能提升清晰度的内容。

5. 明确指出哪些敏感信息应该归入 `secrets/`。

6. 最后向用户总结整理后的结构。

阶段设计启发

常见阶段名包括：

但不要机械套用，要根据任务实际情况调整。

好的阶段名示例：

不好的示例：

整理时要优先优化什么

优先优化：

输出方式要求

实际整理或提出整理方案时，尽量做到：

反模式

避免：

目标结果

如果正确使用这个技能，最终应该达到：