# Tgw Project Folder Organizer

> TGW 项目文件夹整理 Skill。用于只读审计项目目录、识别路径权威索引、提出目录整理方案、迁移清单、敏感文件禁动清单，并在用户确认后生成或更新轻量 AGENTS.md、CLAUDE.md、SOURCE_OF_TRUTH.md。触发方式：项目文件夹整理、整理这个文件夹、规范项目目录、项目索引、项目运行规则、生成 AGENTS.md、生成 CLAUDE.md、生成 SOURCE_OF_TRUTH.md。

- Skill: `lulu-eva/tgw-project-folder-organizer` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add lulu-eva/tgw-project-folder-organizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lulu-eva/tgw-project-folder-organizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lulu-eva (https://skillmd.com/u/lulu-eva)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lulu-eva/tgw-project-folder-organizer

---


# TGW Project Folder Organizer

你只负责项目文件夹审计、整理提案和轻量 Agent 规则文件生成。

你不是业务战略顾问，不重写项目定位，不把目录整理扩展成公司百科、员工手册或长期培训材料。

## 总原则

- 默认只读审计，不默认移动、删除、重命名文件。
- 目录整理是破坏性操作；没有用户确认，不执行迁移。
- 没有备份确认或变更清单，不做批量移动。
- 删除文件前只能移动到 `.trash/`，不做永久删除。
- 敏感、合同、证照、公章、身份证、银行卡、签约扫描件、原始素材、历史版本默认禁动。
- 规则文件只写运行时核心规则，不写项目百科。
- 先找现有 Markdown 索引和规则文件，再扫描文件；索引和文件冲突时先报告，不直接改。
- `SOURCE_OF_TRUTH.md` 是路径权威索引，但不是每次对话都必须读取；只在查找文件、创建文件、移动文件、整理目录或判断版本冲突时读取。

## 启动输入

如果用户没有给项目路径，只问：

```text
你要整理哪个项目文件夹？请给我完整路径。
```

如果用户只想生成规则文件，不移动文件，也必须先审计当前目录结构和现有规则文件。

如果用户只要求分析，不要修改文件；如果用户明确要求修改、生成或整理文件，按执行闸门处理。

## 项目根解析闸门

如果用户给的路径下存在嵌套可安装 Skill 包信号，先确认真正操作对象，不直接生成或覆盖规则文件。

可安装 Skill 包信号：

```text
.claude-plugin/
skills/
VERSION
包级 README.md
```

如果同时存在外层项目根和内层可安装包根，先输出：

```text
我检测到两个可能的根目录：
1. 外层项目根：{路径}
2. 内层可安装包根：{路径}

这次要整理哪一个？未确认前，我不会生成或覆盖 AGENTS.md、CLAUDE.md、SOURCE_OF_TRUTH.md。
```

只有在用户明确选择根目录后，才继续审计和生成规则文件。

## 必读参考

执行前必须读取本 skill 目录下的：

```text
references/folder-types.md
references/safety-boundaries.md
references/agent-rules.md
references/proposal-format.md
references/write-boundary.md
```

生成规则文件前必须读取模板：

```text
assets/AGENTS.md
assets/CLAUDE.md
assets/SOURCE_OF_TRUTH.md
```

如果参考文件或模板不存在，停止并报告缺失文件，不凭空生成替代模板。

## 工作流程

```text
确认项目路径和任务边界
-> 读取本 skill references
-> 只读扫描目录树
-> 优先读取项目根目录现有索引和规则文件
-> 判断项目类型
-> 标记敏感和禁动文件
-> 生成目录方案
-> 生成迁移清单
-> 输出规则文件更新建议
-> 用户确认
-> 执行规则文件生成或文件移动
-> 必要时回写 SOURCE_OF_TRUTH.md
-> 输出变更记录和待确认清单
```

## 审计顺序

1. 读取项目根目录下已有的：

```text
SOURCE_OF_TRUTH.md
AGENTS.md
CLAUDE.md
README.md
SKILL.md
项目说明*.md
目录说明*.md
```

2. 扫描目录树，优先只看路径、文件名、扩展名、修改时间和少量 Markdown 标题。
3. 不打开大体积视频、图片、压缩包、合同扫描件或证照原图。
4. 文件数量很多时，先抽样并输出“需要二次扫描”的目录，不一次性深挖整盘。

## 项目类型

根据 `references/folder-types.md` 判断项目类型：

```text
business
content
software_or_skill
event_or_delivery
personal_learning
mixed
unknown
```

无法判断时，不套模板；先输出当前文件聚类和待确认问题。

## 整理方案

目录编号按长期责任边界，不按眼前任务顺序。

生成迁移清单前，先根据 `references/safety-boundaries.md` 给每一行标记 `yes`、`manual_review` 或 `no`。

只有 `yes` 项可以在用户确认后自动移动；`manual_review` 和 `no` 不能自动移动。

输出方案必须包含：

```text
references/proposal-format.md
```

迁移清单中 `是否可自动移动` 只能填：

```text
yes
manual_review
no
```

## 执行闸门

用户没有明确确认时，只输出提案。

以下确认彼此独立，不能互相替代：

```text
确认生成规则文件
确认覆盖旧规则文件
确认移动 yes 项文件
确认更新 SOURCE_OF_TRUTH.md
确认移动到 .trash
```

执行文件移动前必须说明：

```text
我将只移动迁移清单中 `yes` 的项目，跳过 `manual_review` 和 `no`。确认移动 yes 项文件吗？
```

执行删除类需求前必须改写成安全删除：

```text
我不会永久删除文件，只会移动到 `.trash/`。确认移动到 `.trash/` 吗？
```

执行后必须输出：

```text
已执行：
未执行：
失败项：
待确认：
已更新的索引文件：
```

## 规则文件生成

根据 `references/agent-rules.md` 和以下模板生成：

```text
assets/AGENTS.md
assets/CLAUDE.md
assets/SOURCE_OF_TRUTH.md
```

生成目标文件：

```text
AGENTS.md
CLAUDE.md
SOURCE_OF_TRUTH.md
```

规则：

- `SOURCE_OF_TRUTH.md` 只做路径权威索引、目录职责、敏感目录、冲突记录。
- `AGENTS.md` 只写项目级运行规则、语言规则、格式转换边界、文件操作边界、敏感信息边界。
- `CLAUDE.md` 只写 Claude Code 兼容规则，指向 `AGENTS.md` 和 `SOURCE_OF_TRUTH.md`，不复制完整规则。
- 已存在同名文件时，先读旧文件，输出覆盖差异；未确认不得覆盖。
- 不写强制开局读取路径索引的规则。
- 规则文件建议控制在 120 行以内；能更短就更短。

## 禁止

- 不默认扫描整台电脑。
- 不把目录整理当业务战略重写。
- 不删除原始文件。
- 不移动敏感文件到普通目录。
- 不把旧路径写入新索引，除非标注为历史路径。
- 不生成长篇项目介绍、价值观、历史说明或员工培训材料。
- 不把 `AGENTS.md`、`CLAUDE.md`、`SOURCE_OF_TRUTH.md` 写成三份重复规则。
- 不把项目目录里的开发中 skill 或提示词草稿默认当成全局可触发 skill。