chore(env): rename optional-mcps -> optional_mcps and make enabled.json local-only

- 目录重命名 env/optional-mcps/ -> env/optional_mcps/，与 optional_mcps.sh 及 env 下其它子目录（无连字符）命名一致
- 修正 optional_mcps README 用法示例 playwright -> puppeteer（puppeteer 为默认 env/mcp/playwright.json 的可选替代）
- enabled.json 不再提交：加入 .gitignore 并从索引移除（磁盘保留，脚本缺失时自动重建为 {}）
- 同步更新脚本、schema 校验、env/README、sync/README、CHANGELOG 的引用

Author: i-stack

.gitignore

@@ -8,6 +8,8 @@ skills-engineering/scripts/config.local.sh
 # User only needs to create env/secrets.json from env/secrets.json.example.
 env/secrets.json
 env/backup.json
+# 可选 MCP 启用状态（本机本地状态，不提交；脚本缺失时自动重建为 {}）
+env/optional_mcps/enabled.json
 
 *__pycache__*/
 .analysis_output/
@@ -28,8 +30,9 @@ skills-engineering/ios-engineer/evolution/usage/*
 skills-engineering/ios-engineer/evolution/.auto_proposal_registry.json
 # skill_bundles.sh 导出的 agentskills.io bundle 产物
 skills-engineering/.bundles/
-# 用户个人画像（从 USER.md.example 复制，不提交）
-USER.md
+# 用户个人画像（从 env/user-profile.md.example 复制，不提交）
+env/user-profile.md
+env/user-profile.json
 # 技能完整性校验基线（由 validate-skill-integrity.sh 生成）
 skills-engineering/.integrity/
 templates/portability-ecosystem.md

CHANGELOG.md

@@ -26,8 +26,9 @@ All notable changes to ai-coding-kit will be documented in this file.
 - **P0-1 Skill 自我改进闭环**: 新增 `ios-engineer/scripts/suggest_skill_proposals.sh`，读取 `summarize_usage_ledger.sh --json` 的提案候选信号，自动生成 draft proposal（仅 draft，不自动晋升），并用 `evolution/.auto_proposal_registry.json` 去重。对齐 Hermes 学习循环，但落在既有受控演进闸门内（观测 → 建议 → 人工审批）
 - **P0-2 agentskills.io 兼容打包/导入/校验**: 新增 `scripts/skill_bundles.sh`（`export` / `validate` / `import` / `list`），把任一 skill 打包成 agentskills.io 兼容产物（`SKILL.md` + `references/` + `bundle.json` 含 sha256），支持从社区 Skills Hub / Hermes 兼容 bundle 导入。导出产物落在 `skills-engineering/.bundles/`（已 gitignore）
 - **P1-3 定时同步自动化**: 新增 `cron/`（launchd 默认、`--cron` 可选 crontab），`run-sync.sh` 复用 `sync.sh` + 技能同步 + preamble + 校验，日志滚动保留 30 份
-- **P1-4 可选 MCP 服务器目录**: 新增 `env/optional-mcps/`（playwright 改名 `puppeteer` 避免与默认 `env/mcp/playwright.json` 冲突；另含 `filesystem-extra`、`wechat-bridge` 示例）与 `sync/scripts/optional_mcps.sh`（`enable` / `disable` / `list` / `sync`）。`disable` 带护栏：只移除由本工具启用的服务器，绝不删除仓库默认 `env/mcp/*.json`
+- **P1-4 可选 MCP 服务器目录**: 新增 `env/optional_mcps/`（playwright 改名 `puppeteer` 避免与默认 `env/mcp/playwright.json` 冲突；另含 `filesystem-extra`、`wechat-bridge` 示例）与 `sync/scripts/optional_mcps.sh`（`enable` / `disable` / `list` / `sync`）。`disable` 带护栏：只移除由本工具启用的服务器，绝不删除仓库默认 `env/mcp/*.json`
 - **P1-5 跨会话用户画像**: 新增仓库根 `USER.md.example` 与 `scripts/sync-user-profile.sh`，把用户画像同步到 `~/.ai-coding-kit/USER.md` 并注入各端 preamble 的 `user-profile` 托管块（与 agent-preamble 块标记独立、互不干扰）；个人 `USER.md` 已 gitignore。已接入 `sync-skill-full.sh` / `bootstrap.sh`（含 `SKIP_USER_PROFILE`）/ `cron/run-sync.sh`
+- **用户画像配置迁移**: `USER.md.example` 迁移并统一命名为 `env/user-profile.md.example`，新增 `env/user-profile.json.example` 管理 `auto/on/off` 开关与画像路径；`sync.sh` 现在会通过 `sync_all.sh` 执行可选用户画像同步。
 - **P1-5b 跨会话事件记忆**: 新增 `scripts/sync-memory.sh`，落 `~/.ai-coding-kit/MEMORY.md`（仓库外、跨端共享），提供 `remember "..." [--tag]` / `recall [关键词]` 子命令；向各端 preamble 注入独立的 `user-memory` 托管块，并把脚本自复制到 `~/.ai-coding-kit/sync-memory.sh` 作为 Agent 稳定调用入口。补齐 Hermes 持久记忆中「从交互自动累积」的那一层（user-profile 为静态手维护，memory 为事件级累积，二者互补）。同样接入 `sync-skill-full.sh` / `bootstrap.sh`（`SKIP_MEMORY`）/ `cron/run-sync.sh`
 - **P2-6 多平台模型路由抽象**: 新增 `sync/scripts/list_models.sh`（跨平台 model/provider 配置总览，密钥打码）与 `sync/model_routing.md`（统一 Provider 层设计说明）
 - **P2-7 子代理并行同步**: `scripts/sync-skills.sh` 支持 `PARALLEL=1`（默认 `MAX_PARALLEL=4`），把 (skill × target) 同步以子代理式后台并行执行

env/README.md

@@ -13,6 +13,10 @@ env/
 ├── review.json.example       ← review 配置模板（已提交）
 ├── backup.json               ← 配置备份保存路径（gitignored）
 ├── backup.json.example       ← backup 配置模板（已提交）
+├── user-profile.json         ← 跨会话用户画像同步开关（gitignored）
+├── user-profile.json.example ← 用户画像同步配置模板（已提交）
+├── user-profile.md           ← 跨会话用户画像内容（gitignored）
+├── user-profile.md.example   ← 用户画像内容模板（已提交）
 │
 ├── mcp/                      ← 默认启用的 MCP 服务器定义
 │   ├── github.json
@@ -26,7 +30,7 @@ env/
 │   ├── postgres.json
 │   └── sqlite.json
 │
-├── optional-mcps/            ← 可选 MCP 服务器（需手动启用）
+├── optional_mcps/            ← 可选 MCP 服务器（需手动启用）
 │   ├── enabled.json          ← 启用状态记录
 │   ├── filesystem-extra.json
 │   ├── puppeteer.json
@@ -102,16 +106,47 @@ env/
 - 相对路径会按仓库根目录解析。
 - `env/backup.json` 是本地用户配置，不提交。
 
-## optional-mcps — 可选 MCP 服务器
+## user-profile.json + user-profile.md
+
+跨会话用户画像用于让 Codex / Claude / Gemini 等 Agent 在不同会话中共享你的稳定偏好、角色和约束。
+
+```bash
+cp env/user-profile.md.example env/user-profile.md
+cp env/user-profile.json.example env/user-profile.json
+bash sync.sh
+```
+
+`env/user-profile.json`：
+
+```json
+{
+  "enabled": "auto",
+  "source": "env/user-profile.md"
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `enabled` | `auto`：画像文件存在则同步，不存在则跳过；`on`：强制同步，不存在时报错；`off`：跳过同步 |
+| `source` | 用户画像 Markdown 路径，支持 `~`、环境变量和相对仓库根目录的路径 |
+
+同步时会把画像复制到 `~/.ai-coding-kit/USER.md`，并向各端 Agent preamble 注入 `user-profile` 托管块。
+如需清理已注入托管块，运行：
+
+```bash
+bash skills-engineering/scripts/sync-user-profile.sh --remove
+```
+
+## optional_mcps — 可选 MCP 服务器
 
 将**非默认、社区/高级**的 MCP 服务器与开箱即用的 `env/mcp/` 集合分开，避免污染默认配置，同时保留「一键启用」能力。
 
 ### 工作机制
 
-- `env/optional-mcps/*.json`：可选的 MCP 服务器定义（**不**自动同步）
+- `env/optional_mcps/*.json`：可选的 MCP 服务器定义（**不**自动同步）
 - `sync/scripts/optional_mcps.sh enable <name>`：启用并同步到 `env/mcp/`
 - `sync/scripts/optional_mcps.sh disable <name>`：禁用并移除
-- 启用状态记录在 `env/optional-mcps/enabled.json`
+- 启用状态记录在 `env/optional_mcps/enabled.json`
 
 ### 用法
 
@@ -134,7 +169,7 @@ bash sync/scripts/optional_mcps.sh disable puppeteer
 | `filesystem-extra` | 扩展文件系统访问 | 是（`filesystem_extra.root`） |
 | `wechat-bridge` | 微信桥接 | 是（`wechat.token`） |
 
-详见 [optional-mcps/README.md](optional-mcps/README.md)。
+详见 [optional_mcps/README.md](optional_mcps/README.md)。
 
 ## 自定义安装路径（paths）
 

env/optional-mcps/enabled.json

@@ -1,13 +1,13 @@
-# optional-mcps — 可选 MCP 服务器目录
+# optional_mcps — 可选 MCP 服务器目录
 
-对齐 Hermes Agent 的 `optional-mcps/` 思路：把**非默认、社区/高级**的 MCP 服务器与开箱即用的 `env/mcp/` 集合分开，避免污染默认配置，同时保留「一键启用」能力。
+对齐 Hermes Agent 的 `optional_mcps/` 思路：把**非默认、社区/高级**的 MCP 服务器与开箱即用的 `env/mcp/` 集合分开，避免污染默认配置，同时保留「一键启用」能力。
 
 ## 工作机制
 
-- `env/optional-mcps/*.json`：可选的 MCP 服务器定义（**不**自动同步）。
+- `env/optional_mcps/*.json`：可选的 MCP 服务器定义（**不**自动同步）。
 - `sync/scripts/optional_mcps.sh enable <name>`：把定义复制到 `env/mcp/<name>.json`，由于 `env/mcp/*.json` 会被 `sync.sh` 自动发现，下一次 `sync.sh` 即生效。
 - `sync/scripts/optional_mcps.sh disable <name>`：从 `env/mcp/` 移除并停止同步。
-- 启用状态记录在 `env/optional-mcps/enabled.json`（git 提交，便于团队共享「已启用集合」）。
+- 启用状态记录在 `env/optional_mcps/enabled.json`（本地状态，**不提交**，已加入 `.gitignore`；脚本缺失时自动重建为 `{}`）。
 
 ## 用法
 
@@ -16,18 +16,18 @@
 bash sync/scripts/optional_mcps.sh list
 
 # 启用一个
-bash sync/scripts/optional_mcps.sh enable playwright
+bash sync/scripts/optional_mcps.sh enable puppeteer
 
 # 禁用一个
-bash sync/scripts/optional_mcps.sh disable playwright
+bash sync/scripts/optional_mcps.sh disable puppeteer
 
 # 启用后照常同步
 bash sync.sh
 ```
 
 ## 新增一个可选服务器
 
-1. 在 `env/optional-mcps/` 放 `<name>.json`（格式同 `env/mcp/*.json`，敏感值用 `${...}` 占位）。
+1. 在 `env/optional_mcps/` 放 `<name>.json`（格式同 `env/mcp/*.json`，敏感值用 `${...}` 占位）。
 2. 若需要 secret，在 `env/secrets.json.example` 增加对应字段说明，并提醒用户填写 `env/secrets.json`。
 3. 运行 `bash sync/scripts/optional_mcps.sh enable <name>`。
 

env/optional-mcps/README.md env/optional_mcps/README.mdenv/optional-mcps/README.md renamed to env/optional_mcps/README.md

@@ -194,15 +194,15 @@ python3 sync/cli/main.py sync --target codex  # single platform
 
 ## 可选 MCP 服务器
 
-开箱即用的服务器在 `env/mcp/`。**非默认、社区/高级**服务器放在 `env/optional-mcps/`，用 `sync/scripts/optional_mcps.sh` 按需启用：
+开箱即用的服务器在 `env/mcp/`。**非默认、社区/高级**服务器放在 `env/optional_mcps/`，用 `sync/scripts/optional_mcps.sh` 按需启用：
 
 ```bash
 bash sync/scripts/optional_mcps.sh list                       # 查看可选服务器与启用状态
 bash sync/scripts/optional_mcps.sh enable puppeteer           # 启用 -> 下次 sync.sh 生效
 bash sync/scripts/optional_mcps.sh disable puppeteer          # 停用
 ```
 
-`disable` 带护栏：只移除由本工具启用的服务器，绝不删除仓库默认的 `env/mcp/*.json`。详见 `env/optional-mcps/README.md`。
+`disable` 带护栏：只移除由本工具启用的服务器，绝不删除仓库默认的 `env/mcp/*.json`。详见 `env/optional_mcps/README.md`。
 
 ## Design Principles
 

env/optional-mcps/filesystem-extra.json env/optional_mcps/filesystem-extra.jsonenv/optional-mcps/filesystem-extra.json renamed to env/optional_mcps/filesystem-extra.json

@@ -18,7 +18,7 @@
 REPO_ROOT = Path(__file__).resolve().parents[2]
 ENV_DIR = REPO_ROOT / "env"
 MCP_DIR = ENV_DIR / "mcp"
-OPTIONAL_MCP_DIR = ENV_DIR / "optional-mcps"
+OPTIONAL_MCP_DIR = ENV_DIR / "optional_mcps"
 PLATFORMS_DIR = ENV_DIR / "platforms"
 
 # ── MCP server schema ────────────────────────────────────────────────────────
@@ -206,7 +206,7 @@ def main(argv: list[str] | None = None) -> int:
 
     all_errors: list[str] = []
 
-    # Validate MCP files (env/mcp + env/optional-mcps)
+    # Validate MCP files (env/mcp + env/optional_mcps)
     if not args.platforms_only:
         mcp_dirs = [MCP_DIR]
         if OPTIONAL_MCP_DIR.is_dir():
@@ -221,7 +221,7 @@ def main(argv: list[str] | None = None) -> int:
                     continue  # registry 文件，不是 MCP 定义
                 all_errors.extend(validate_mcp_file(f))
                 total_mcp += 1
-        print(f"Checked {total_mcp} MCP file(s) (incl. optional-mcps).")
+        print(f"Checked {total_mcp} MCP file(s) (incl. optional_mcps).")
 
     # Validate platform files
     if not args.mcp_only and PLATFORMS_DIR.is_dir():