From 67f6467da09c9cc300b384a24d310c26385093da Mon Sep 17 00:00:00 2001
From: hc <huang.c00@qq.com>
Date: Fri, 10 Apr 2026 20:53:10 +0800
Subject: [PATCH] =?UTF-8?q?feat(PHASE-05):=20=E6=9C=80=E5=B0=8F=20Write=20?=
 =?UTF-8?q?=E5=B7=A5=E5=85=B7=20+=20=E5=B7=A5=E5=85=B7=E4=BC=98=E5=85=88?=
 =?UTF-8?q?=E7=BA=A7=E4=BC=98=E5=8C=96=EF=BC=88=E5=86=99=E6=96=87=E4=BB=B6?=
 =?UTF-8?q?=E8=B0=83=E7=94=A8=E6=AC=A1=E6=95=B0=E5=A4=A7=E5=B9=85=E4=B8=8B?=
 =?UTF-8?q?=E9=99=8D=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore           |  2 +-
 AGENTS.md            |  2 ++
 SKILLS/cli-core.md   |  1 +
 src/cc_slim/tools.py | 29 +++++++++++++++++++++++++++++
 4 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 6c4ee52..ce230a9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,7 +14,7 @@ venv/
 *.log
 logs/
 .tmp/
-
+test/
 # IDE
 .vscode/
 .idea/
diff --git a/AGENTS.md b/AGENTS.md
index ecf646d..a360984 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -38,8 +38,10 @@
 
 - `Read`：用于读取文件内容。
 - `Glob`：用于按模式查找文件。
+- 创建或覆盖文件时，优先使用 `Write` 工具。
 - `Bash`：用于执行必须通过 shell 完成的最小命令。
 - 只有在 Bash 确实必要时才使用 Bash。
+- 不要用 Bash 拼接文件内容。
 - Windows 环境下优先使用兼容写法，不默认使用 `cat <<EOF`、`ls -la` 等 Unix 风格写法。
 - 同一写入或创建目标，最多尝试 2 种不同 Bash 方案。
 - 如果两次 Bash 方案失败，应立即收敛：
diff --git a/SKILLS/cli-core.md b/SKILLS/cli-core.md
index 9d83971..feec13a 100644
--- a/SKILLS/cli-core.md
+++ b/SKILLS/cli-core.md
@@ -20,6 +20,7 @@
 - 重构时：
   - 先找全部用法
   - 避免修改无关文件
+- 需要创建或覆盖文件时，优先使用 `Write` 工具，而不是 `Bash`
 - Windows 下先验证 shell 兼容性，再选择命令写法
 
 ## 沟通风格
diff --git a/src/cc_slim/tools.py b/src/cc_slim/tools.py
index 52367bd..8774a4e 100644
--- a/src/cc_slim/tools.py
+++ b/src/cc_slim/tools.py
@@ -43,6 +43,21 @@ def build_default_tools(workspace: Path) -> list[Tool]:
             },
             execute=lambda data: glob_tool(workspace, data),
         ),
+        Tool(
+            name="Write",
+            description="创建或覆盖工作区内的文本文件。",
+            input_schema={
+                "type": "object",
+                "properties": {
+                    "path": {"type": "string", "description": "相对工作区的文件路径"},
+                    "content": {"type": "string", "description": "要写入的完整文本内容"},
+                    "encoding": {"type": "string", "description": "文件编码，默认 utf-8"},
+                },
+                "required": ["path", "content"],
+                "additionalProperties": False,
+            },
+            execute=lambda data: write_tool(workspace, data),
+        ),
         Tool(
             name="Bash",
             description="在工作区中执行一条 shell 命令。",
@@ -82,6 +97,20 @@ def glob_tool(workspace: Path, data: dict[str, Any]) -> str:
     return "\n".join(matches[:200])
 
 
+def write_tool(workspace: Path, data: dict[str, Any]) -> str:
+    path = _safe_path(workspace, str(data["path"]))
+    if path.exists() and path.is_dir():
+        return f"目标是目录，不能写入文件: {path.relative_to(workspace)}"
+    if not path.parent.exists():
+        return f"父目录不存在: {path.parent.relative_to(workspace)}"
+
+    existed = path.exists()
+    encoding = str(data.get("encoding") or "utf-8")
+    path.write_text(str(data["content"]), encoding=encoding)
+    action = "已覆盖" if existed else "已创建"
+    return f"{action}文件: {path.relative_to(workspace)}"
+
+
 def bash_tool(workspace: Path, data: dict[str, Any]) -> str:
     command = str(data["command"])
     proc = subprocess.run(