# Using Workspace

> 使用 harness 虚拟文件系统（workspace）来组织多步骤工作；用读写文件代替把所有内容塞进聊天。

- Skill: `tencentcloud/using-workspace` (Agent Skill)
- Install (CLI): `npx get-skill add tencentcloud/using-workspace`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tencentcloud/using-workspace/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tencentcloud (https://skillmd.com/u/tencentcloud)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/tencentcloud/using-workspace

---


# 使用工作区

你在一个由 octop-harness 文件系统工具（`ls`、`read_file`、`write_file`、`edit_file`、`glob`、`grep`）支撑的**虚拟工作区**中操作。将这个工作区视为任何产生制品或跨越多次对话的任务的**长期记忆**。

## 何时使用工作区

- **任何生成内容超过约 200 词。** 将其写入一个有意义的路径下的文件，而不是粘贴到聊天中。回复时附上简短摘要和文件路径。
- **计划、待办事项或任务清单**——用户会回头参考。将它们保存在 `plans/<topic>.md` 下，或者在使用可用时使用规划工具。
- **中间制品**（草稿、研究笔记、原始抓取数据）。持久化到磁盘，以便后续步骤可以通过 grep/read 获取，而无需重新询问用户。
- **用户上传或要求你研究的参考资料。**

## 约定

- **每个主题一个目录。** 将相关文件分组到以主题命名的文件夹下，例如 `research/customer-X/`，而不是将 `customer-X-1.md`、`customer-X-2.md` 散落在根目录。
- **散文用 Markdown，结构化数据用 JSON/YAML，代码用对应扩展名的语言文件。** 当扩展名诚实时，读者（LLM 或人类）能获得更好的支持。
- **优先使用当前工作目录下的相对路径**，除非用户明确要求其他做法。不要触及系统目录。
- **写之前先读。** 更新现有文件时，先 `read_file` 确认当前内容，避免覆盖式编辑。
- **使用 `edit_file` 进行精准修改**（字符串替换），使用 `write_file` 处理新建或完全重写的文件。不要仅仅为了修改一行而用 `write_file` 覆盖大型现有文件。

## 工作流模式

1. **计划 → 写入 → 反思。** 对于非平凡任务，先将计划保存到文件，然后执行，在步骤完成时更新文件。这给你和用户都提供了一个检查点。
2. **在重新创建之前先搜索。** 在生成类似内容之前，运行 `glob`/`grep` 查看是否已有相关文件存在。
3. **摘要中引用路径。** 完成时在回复中包含你创建或修改的文件列表。用户想知道东西存放在哪里。

