文件与工作区

资产与文件管理

落位、命名、版本、台账、归档，附可执行体检。

免费 免费阅读，也可以邮件索要技能文件。

背景描述

目标：任何时候都能回答三个问题 —— 哪份是当前版？花了多少钱？有哪些可复用资产？

为什么这么做

五步的顺序换不得：目录没定就谈不上命名，文件名不稳，台账记下的就对不上交出去那份。体检按同一顺序查六类问题，六类都能被脚本复现：同前缀多版本、语义后缀堆叠、版本号进目录名、缺成本账、交付物未归档、命名硬伤。assets_audit.py 报出问题时退出码给 1，「文件乱」变成流程能拦下的数字，不必再凭记忆判断。

三本账各答一个问题：cost_ledger.json 记花了多少，资产索引.md 记哪些能复用，provenance.csv 记授权。版本只进文件名不进目录名，一旦进目录名，每版多一个文件夹，磁盘翻倍，当前版还得靠排序去找。旧版移进 _deprecated/，不许就地删除：本机一次清理让 21 个项目丢了复盘证据，这条门禁就是那次之后补上的。

真实踩坑

• 同一份文件出现三个版本 用 -修复版、-提交包 表达状态，文件排完序还是看不出哪份是当前版，实测一次堆到 249 个版本文件。命名硬要求禁掉这类语义后缀，体检把同前缀多版本单列一类，退出码 1 挡在收尾那一步。
• preview_v12 变成两层目录 版本号写进目录名后，下一版只能再建一个 preview_v13，磁盘占用翻倍，目录列表不再像一个项目。落位要求写明版本进文件名不进目录名，体检也单列这一类；一次扫描里它和缺成本账一起被报出来。
• 交付物留在默认 cwd 在默认 cwd 的日期目录里做完的活，看着是完成了，那个文件夹一清就没了。落位门禁要求重要产物落在项目目录内，--default-cwd 专门查这类残留；本机一次清理让 21 个项目失去复盘证据。
• 资产有文件没有授权 只存文件不存元数据，提示词、来源、授权全是空的，这份资产不能复用，也进不了交付。provenance.csv 就是答这一问的账，第五道门禁把授权未知的资产挡在交付外；缺这本账，体检直接报出来。

这个技能里有什么

1. 0. 定位与边界
2. 1. 五步工作流（详见 `references/02-五步工作流.md`）
3. 2. 体检（把"文件乱"变成可测）
4. 3. 硬门禁（五条）
5. 4. 反模式
6. 5. 参考来源
7. 工作纪律（三条硬规则，**改动前先读**）

目录就是技能文件自己的标题，顺序没有动过。

用法描述

资产与文件管理工作流：落位 → 命名 → 版本 → 台账 → 归档，含可执行体检 （版本堆积 / 语义后缀 / 版本号进目录名 / 缺成本账 / 默认 cwd 残留）。 用于回答三个问题：哪份是当前版？花了多少钱？有哪些可复用资产？ 当用户要求"保存/归档/整理文件""命名规范""版本管理""资产复用""文件太乱" "存到哪儿""清理文件""这份是最终版吗"时使用。

怎么用

1. 用邮箱收这个文件，它就是一个 SKILL.md。
2. 放进 agent 读取的技能目录，目录名用 asset-management。
3. 用描述里的触发句开头，或直接点名这个技能。