功能描述

按任务阶段而不是按文件类型整理混合产物。当编码、写作、脚本处理、研究、自动化或多步骤任务产生多个文件，且文件开始散落、临时产物与最终产物混在一起、目录结构不清晰，或用户提出“整理目录”“整理工作区”“归类”“归档”“收整产物”“文件有点乱”“帮我理一理结构”时，使用此技能。既支持任务开始前先规划 staged 目...

使用说明 (SKILL.md)

Artifact Organizer

Name: artifact-organizer
Author: big-dust

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

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

也就是说，通常应该：

先识别这个任务真实经历了哪些阶段
围绕这些阶段创建或调整目录
允许同一阶段下同时存在多种类型的文件
不要一上来就把所有东西粗暴塞进全局 scripts/、docs/、data/ 目录，除非那样对当前任务明显更好

什么时候使用这个技能

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

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

适用于：

用户刚开始一个新任务
这个任务大概率会生成多个文件
任务包含多个步骤、阶段或交接点
希望在开始产出前先把目录结构搭清楚

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

适用于：

文件已经开始散落
临时文件和最终结果混在一起
脚本、静态数据、说明、截图、日志、输出物难以追踪
用户提出“整理一下”“收整一下”“归类一下”“把目录理清楚”
任务后续还要继续维护、复用或交接

核心规则

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

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

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

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

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

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

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

一个阶段下可能同时有：

scripts
static data
notes
screenshots
logs
generated outputs
configs

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

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

如果发现以下内容：

密码
API key
token
服务器登录凭据
账号密钥
其他需要精确保存的敏感值

处理原则：

不要把这类精确敏感值长期混放在普通任务目录里
需要长期精确保存时，优先归入现有 workspace 根目录下的 secrets/ 体系
本地 secrets/ 视为精确敏感值的事实来源
任务目录里如有需要，只保留非敏感引用说明

例如：

secrets/server-credentials.md
secrets/ccnu-account.md

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

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

不要为了好看而大搬家。

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

清晰度
可维护性
可追踪性
交付质量
后续继续做的便利性

避免无意义折腾。

5. 保留任务连续性

整理已有任务时：

先识别任务根目录
再根据真实文件和用户目标反推 workflow stages
移动方式要让后续还能看懂任务是怎么演变的
不要把最终交付物埋到很深的处理中间目录里
保证重要输出容易找到

阶段设计启发

常见阶段名包括：

input-prep
collection
extraction
processing
transformation
verification
delivery
reporting
handoff

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

好的阶段名示例：

01_source-collection
02_cleaning-and-normalization
03_generation
04_review-and-delivery

不好的示例：

step1
misc
temp2

整理时要优先优化什么

优先优化：

以后继续接手这个任务时能快速进入状态
用户一眼能看懂这个任务都经历了什么
重要输出容易定位
精确敏感信息该进 secrets/ 时能正确归位
整体结构不要让人意外

输出方式要求

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

给出最终目录树
简短解释阶段划分逻辑
标出哪些敏感文件已经或建议归到 secrets/
说明哪些内容你刻意没有动，以及为什么没动

反模式

避免：

把所有内容都丢进一个全局 scripts/ 目录
只按文件扩展名分类，而忽视 workflow
把 secrets 放进普通任务目录
小任务硬建很深的层级
没有明确收益却大量重命名文件

目标结果

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

任务根目录更清楚
结构以阶段为主轴
输出物更容易找到
临时产物与最终产物混放更少
敏感信息按现有 secrets/ 约定处理

安全使用建议

This is an instruction-only organizer and is coherent with its purpose, but consider: (1) the agent will examine files in the task workspace — if you have sensitive data you do not want scanned or moved, either exclude those paths or tell the agent explicitly; (2) moving secrets into a local secrets/ folder can break scripts that expect files in place — back up or run a dry-run before large moves; (3) confirm any destructive actions (deletions/renames) and prefer manual approval for changes that could affect runtime or deployments.

功能分析

Type: OpenClaw Skill Name: artifact-organizer Version: 1.0.0 The skill bundle contains instructions in SKILL.md that direct the AI agent to actively identify and consolidate sensitive information—including passwords, API keys, tokens, and server credentials—into a centralized `secrets/` directory whenever a user asks to 'organize' the workspace. While framed as an organizational best practice, this 'secret-seeking' behavior is a high-risk capability that could be used to surface or centralize sensitive data. The instructions also include a curiously specific reference to `secrets/ccnu-account.md` (Central China Normal University).

能力评估

✓ Purpose & Capability

Name/description describe organizing task artifacts by workflow stage; the skill requires no binaries, env vars, or installs. All declared requirements match the stated purpose and nothing requested is extraneous.

✓ Instruction Scope

SKILL.md gives only local directory-organizing guidance (create stage folders, move/rename files, recommend moving precise secrets into a local secrets/ area). It does not instruct contacting external endpoints or accessing unrelated system config. The guidance to identify/relocate sensitive files is expected for this task.

✓ Install Mechanism

No install spec and no code files — instruction-only skills have minimal surface and nothing will be written to disk by an installer.

✓ Credentials

The skill requests no environment variables, credentials, or config paths. Mentions of 'secrets/' are advisory and not a request for secret values or credentials from the environment.

✓ Persistence & Privilege

always is false and the skill has no install or background components. It does not request persistent presence or modifications to other skills or system-wide settings.

版本历史

v1.0.0

初次发布：按任务阶段整理产物，支持 secrets 归位与工作区重组。

元数据

Slug artifact-organizer

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题