workspace-initializer

Files (1)

• SKILL.md

SKILL.md (first lines)

# Workspace Initializer - 工作目录初始化

## Overview

本技能用于**空工作目录的初始化**，是一个需要用户配合的工作流。当用户切换到一个新的、空的工作目录时，AI 需要：

1. 判断当前工作目录**是否已经初始化**。
2. 若未初始化，**向用户提问收集完整信息**后，为其建立文件夹结构。
3. 把工作目录的**结构、各目录用途、使用规则**简洁地写入**项目记忆**，让后续会话的 AI 能快速理解并遵循该工作目录的架构。

**核心原则**：初始化必须由用户配合完成。AI 先提问、收集齐信息，才可以执行建立目录的操作。

---

## Routing Table

| 关键词 | 描述 |
|--------|------|
| `初始化工作目录`, `initialize workspace`, `新工作目录` | 启动工作目录初始化流程 |
| `工作目录是空的`, `这个目录没东西` | 检测并初始化空工作目录 |
| `工作目录怎么用`, `目录结构` | 确认当前工作目录的架构与使用规则 |
| `是否已初始化`, `check initialized` | 判断当前工作目录初始化状态 |
| `重新初始化`, `reinitialize` | 在用户确认后重建工作目录结构 |
| `目录对不上`, `记忆和实际不一致` | 处理项目记忆与实际目录不匹配 |

---

## Scope

本技能涵盖以下功能：

1. **初始化状态检测** - 依据上下文中的项目记忆判断工作目录是否已初始化
2. **空目录判断** - 列出工作目录内容，确认是否为空
3. **信息收集流程** - 向用户提问，收集初始化所需的完整信息
4. **目录结构建立** - 根据用户要求建立文件夹和 README
5. **基础目录保证** - 确保 README、临时数据目录、日志目录等最基本要素存在
6. **中英文目录命名** - 让用户选择采用中文目录还是英文目录
7. **项目记忆写入** - 把工作目录结构、用途、使用规则简洁地写入项目记忆
8. **一致性维护** - 当实际目录与记忆不匹配时，提醒用户并在确认后更新记忆

---

## 判定标准：是否已初始化

**每个工作目录都有独立的项目记忆，其内容会随每次会话自动进入 AI 上下文。因此判断"是否已初始化"无需调用任何读取工具，直接看当前上下文中是否存在初始化标记即可。**

初始化标记为项目记忆中的这一行：

```
- 初始化状态: 已初始化
```

- **上下文中存在该标记** → 视为已初始化。
- **上下文中不存在该标记** → 视为未初始化，需**主动提醒用户**（见下文）。

## 主动提醒初始化

当判定为**未初始化**，或用户切换到一个**空工作目录**时，AI 应**主动提醒**用户，而不是被动等待指令：

> 当前工作目录尚未初始化（或为空）。是否需要我帮你初始化目录结构？

- 用户**同意** → 进入下方初始化工作流（从阶段二收集信息开始）。
- 用户**拒绝或暂不需要** → 不做任何创建操作，正常继续当前任务。
- 提醒只需一次，用户明确拒绝后本次会话内不再重复打扰。

---

## 可用工具

直接调用真实工具名，路径使用相对工作目录的相对路径，不要手写绝对路径。

| 用途 | 工具 |
|------|------|
| 获取当前工作目录路径 | `sys_get_workspace_directory` |
| 列出目录内容（判断是否为空 / 与记忆比对） | `sys_list_directory` |
| 创建目录（含父级） | `sys_create_directory` |
| 记录初始化信息到项目记忆 | `sys_write_settings` |

> README 等文本文件用标准文件写入能力创建即可。所有操作都被系统强制限定在当前工作目录内。

---

## 初始化工作流

### 阶段一：检测状态（先判断，不要直接建目录）

1. 查看当前上下文中的项目记忆，按上文判定标准确认是否已初始化。
   - **已初始化** → 告知用户"当前工作目录已初始化"，并按记忆简述已有结构与使用规则。除非用户明确要求"重新初始化"，否则**结束流程**。
2. 未初始化时，调用 `sys_get_workspace_directory` 取路径，再调用 `sys_list_directory` 确认目录内容。
   - 目录**为空** → 按"主动提醒初始化"提醒用户；用户同意后进入阶段二。
   - 目录**非空** → 提示用户该目录已有内容，询问是否仍要初始化，避免覆盖既有文件；得到确认后再继续。

### 阶段二：收集信息（必须提问，信息不全不得执行）

向用户提问，收集初始化所需信息。至少需要明确：

1. **目录命名语言**：采用**中文目录**还是**英文目录**？（必答）
2. **行业 / 用途**：这个工作目录主要用来做什么？（决定要建立哪些业务目录）
3. **自定义目录**：除基础目录外，是否还需要其他文件夹？
4. **工作习惯 / 约定**：有没有希望 AI 在此目录下遵循的规则（如命名规范、文件归档方式）？

> 用户的行业和习惯各不相同，目录结构没有统一规范。以提问澄清为准，不要臆测。信息收集齐全前，不要调用任何创建工具。

### 阶段三：确定结构

无论用户如何定制，**必须包含以下最基本要素**：

- **README 说明文档** - 描述该工作目录的用途和结构。
- **临时数据目录** - 存放临时/中间文件，以及 AI 为完成任务临时编写的脚本（见"临时目录使用约定"）。
- **日志目录** - 存放运行/操作日志。

根据语言选择套用命名（示例，可按用户要求调整）：

| 要素 | 英文命名 | 中文命名 |
|------|----------|----------|
| 说明文档 | `README.md` | `说明.md` |
| 临时数据 | `temp/` | `临时数据/` |
| 日志 | `logs/` | `日志/` |

在此基础上叠加用户要求的业务目录（如 `docs/`、`data/`、`output/`、`资料/`、`成果/` 等）。

From sunyonghuan/Netor.Madorin, MIT.

More from sunyonghuan/Netor.Madorin