diff --git a/README.md b/README.md
index e7f166a..73e3836 100644
--- a/README.md
+++ b/README.md
@@ -14,13 +14,13 @@ Vala SkillHub 技能管理 —— 让数字员工推送、安装和自动同步
 推送和安装均不在 `./skills` 目录内产生 `.git`，确保不影响 workspace 级别的 git 备份：
 - **推送 / 自动同步**：复制到 `./tmp/skill_push/` 临时目录，完成 git 推送后清理
 - **安装**：通过 Gitea API 下载归档解压，不使用 git clone
-- **变更检测**：通过 `~/.vala_skill_hashes` 记录每个 skill 的内容哈希，对比检测变更
+- **变更检测**：通过 `./.vala_skill_hashes` 记录每个 skill 的内容哈希，对比检测变更
 
 ## 自动同步机制
 
 数字员工在新增或修改 skill 后，**必须自动执行 check_and_push**：
 1. 计算 skill 目录的综合哈希（含文件路径 + 内容）
-2. 与 `~/.vala_skill_hashes` 中的历史哈希对比
+2. 与 `./.vala_skill_hashes` 中的历史哈希对比
 3. 仅推送有变更的 skill，推送成功后更新哈希记录
 
 可选配合 `cron_job` 技能设置定时全量同步作为安全网。
@@ -38,7 +38,7 @@ Vala SkillHub 技能管理 —— 让数字员工推送、安装和自动同步
 
 ## 配置
 
-首次使用需提供配置，保存在 `~/.vala_skillhub_config`：
+首次使用需提供配置，保存在 `./.vala_skillhub_config`（当前 workspace 根目录下，各数字员工独立）：
 
 - `GITEA_URL` — Gitea 服务地址（默认 `https://git.valavala.com`）
 - `GITEA_TOKEN` — API Token（需有组织仓库的创建和推送权限）
diff --git a/SKILL.md b/SKILL.md
index 934b262..c88d90a 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -18,7 +18,7 @@ SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时
 
 ## 配置
 
-操作前需要确认以下配置（保存到 `~/.vala_skillhub_config`）：
+操作前需要确认以下配置（保存到 `./.vala_skillhub_config`，即当前 workspace 根目录下）：
 
 | 配置项 | 说明 | 默认值 |
 |--------|------|--------|
@@ -30,7 +30,7 @@ SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时
 如果配置文件不存在，请询问用户获取以上信息后创建：
 
 ```bash
-cat > ~/.vala_skillhub_config <<EOF
+cat > ./.vala_skillhub_config <<EOF
 GITEA_URL=https://git.valavala.com
 GITEA_TOKEN=<token>
 GITEA_OWNER=vala_skillhub
@@ -40,7 +40,7 @@ EOF
 
 后续操作前先加载配置：
 ```bash
-source ~/.vala_skillhub_config
+source ./.vala_skillhub_config
 ```
 
 ---
@@ -151,7 +151,7 @@ curl -s "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos?page=1&limit=50&sort=upda
 
 ### 哈希状态文件
 
-使用 `~/.vala_skill_hashes` 记录每个 skill 上次推送时的内容哈希，格式为每行一条记录：
+使用 `./.vala_skill_hashes`（workspace 根目录下）记录每个 skill 上次推送时的内容哈希，格式为每行一条记录：
 
 ```
 skill_dir_name hash
@@ -178,8 +178,8 @@ compute_skill_hash() {
 
 1. **加载配置和哈希状态**：
    ```bash
-   source ~/.vala_skillhub_config
-   HASH_FILE=~/.vala_skill_hashes
+   source ./.vala_skillhub_config
+   HASH_FILE=./.vala_skill_hashes
    touch "${HASH_FILE}"
    ```
 
diff --git a/skill.json b/skill.json
index 2c79a02..97684fd 100644
--- a/skill.json
+++ b/skill.json
@@ -1,8 +1,14 @@
 {
-  "name": "use_vala_skillhub",
-  "version": "4.0.0",
-  "description": "管理 Vala SkillHub 上的技能：推送、安装、自动同步（变更检测 + 自动推送，不影响 workspace git 备份）",
-  "author": "vala",
-  "tags": ["skillhub", "git", "管理", "备份", "自动同步"],
-  "config_file": "~/.vala_skillhub_config"
+    "name": "use_vala_skillhub",
+    "version": "4.0.0",
+    "description": "管理 Vala SkillHub 上的技能：推送、安装、自动同步（变更检测 + 自动推送，不影响 workspace git 备份）",
+    "author": "vala",
+    "tags": [
+        "skillhub",
+        "git",
+        "管理",
+        "备份",
+        "自动同步"
+    ],
+    "config_file": "./.vala_skillhub_config"
 }