xuanzhu 0.8.6 → 0.8.8

package/README.md

@@ -175,7 +175,6 @@ xzh
 | `xzh init` | 扫描项目并生成 / 补全 `AGENTS.md` 与 `docs/`（已有内容只补缺失小节） |
 | `xzh init --dry-run` | 只预览将生成的内容，不写文件 |
 | `xzh init --force` | 整体覆盖已有规范文件（覆盖前自动备份） |
-| `xzh agents.md` | 让当前模型根据项目实际内容重写 / 整合 `AGENTS.md`（支持 `--dry-run`、`--yes`） |
 | `xzh skill` | 交互式管理技能：启用 / 禁用 / 删除（禁用的技能对模型不可见） |
 | `xzh skill list` | 列出全部技能（来源与状态，含已禁用项） |
 | `xzh skill enable/disable <名称>` | 启用 / 禁用技能 |
@@ -901,25 +900,24 @@ v2ray / Clash / mihomo / sing-box **本地 SOCKS/HTTP 入站端口**，验证后
 | `xzh init --dry-run` | 只打印变更计划与预览，不写任何文件 |
 | `xzh init --force` | 整体覆盖已有规范文件（覆盖前写 `.bak-<时间戳>` 备份） |
 | `xzh init --yes` | 跳过确认（脚本 / CI） |
-| `/init` | 对话内执行（写入前弹确认框；支持 `/init --dry-run`、`/init --force`） |
-| `/agents.md` | 对话内让模型重写 / 整合 `AGENTS.md`（支持 `/agents.md --dry-run`） |
+| `/init` | 对话内执行：先搭建框架，再调用模型完善 AGENTS.md/docs（支持 `/init --dry-run`、`/init --force`） |
 
 - **幂等**：再次运行内容无变化时不写盘，只报「已是最新」；
 - **不自动「修正」**：已有同名小节一律保留（不改写团队手写约定），只补缺失部分；
 - **不在进入项目时自动扫描/生成**：`xzh init` 需要手动运行；启动不会创建 `AGENTS.md`，也不会扫描仓库。
 - 项目根 `AGENTS.md` 会**直接注入系统提示词**；启动不会创建它，只有 `xzh init` 在文件不存在时生成入口模板。请像维护代码一样维护它。
 
-## 用模型整理 AGENTS.md（`xzh agents.md` / `/agents.md`）
+## 对话内 `/init` 的模型完善
 
-`xzh init` 是确定性的扫描与增量补充；`xzh agents.md` 会调用当前模型，根据项目扫描结果
-和现有 `AGENTS.md` 做一次重写：
-
-- 不存在 `AGENTS.md`：直接根据项目事实编写，不做整合；
-- 已存在：保留仍然有效的用户约定，合并重复内容，删除空模板/过时内容；
-- 写入前展示预览并确认，覆盖旧文件时自动备份为 `AGENTS.md.bak-<时间戳>`；
-- 模型只使用扫描事实、现有 AGENTS、README/docs 摘要，不读取依赖或构建产物；
-- 仍不编造命令和路径；失败时不会写入半成品；
-- 强制保留「文档同步」小节：代码改动同步到 AGENTS/docs，md 设计变化需额外告知用户。
+- **`xzh init`（命令行）**：只做确定性框架搭建——扫描项目，创建 AGENTS.md 与 `docs/`，
+  不调用模型；已有文件只补缺失小节。
+- **`/init`（对话内）**：先执行同样的确定性框架，再调用当前模型，根据扫描事实与现有
+  AGENTS/docs 整理入口大纲和详细文档：
+  - AGENTS.md 仍只保留入口大纲，尽量简短；
+  - 缺失的 `docs/` 文件会补齐，模型可同步更新对应 docs；
+  - 写入前展示预览并确认，覆盖文件前自动备份；
+  - 模型失败不会破坏已写入的初始框架，可稍后再次 `/init`；
+  - 强制保留「文档同步」小节：代码改动同步到 AGENTS/docs，md 设计变化需额外告知用户。
 
 ## 内置技能
 
@@ -1049,7 +1047,7 @@ description: 一句话说明该技能的用途与适用场景
 kitty / Ghostty 会把该 xterm 兼容序列映射成「所有按键都用转义码上报」而破坏普通输入，
 故玄猪对这两类终端不发送请求，请改用 `Alt+Enter` 或在终端侧自行配置。
 
-界面内命令：`/help`、`/clear`、`/tools`、`/context`、`/compact`、`/focus [文件]`、`/device`、`/image`（`/paste`）、`/copy [N|A-B|last|all]`、`/mouse`、`/reset`、`/resume [编号]`、`/cwd`、`/switch <目录>`、`/term`、`/model [编号|id|模型名]`、`/goal <目标>`（`/goal [status|continue|off]`）、`/memory [global|show [global]|clear [global]]`、`/usage`、`/undo [N]`、`/init [--dry-run|--force]`、`/agents.md [--dry-run]`、`/auto [on|off]`、`/intent [on|off]`、`/exit`。
+界面内命令：`/help`、`/clear`、`/tools`、`/context`、`/compact`、`/focus [文件]`、`/device`、`/image`（`/paste`）、`/copy [N|A-B|last|all]`、`/mouse`、`/reset`、`/resume [编号]`、`/cwd`、`/switch <目录>`、`/term`、`/model [编号|id|模型名]`、`/goal <目标>`（`/goal [status|continue|off]`）、`/memory [global|show [global]|clear [global]]`、`/usage`、`/undo [N]`、`/init [--dry-run|--force]`、`/auto [on|off]`、`/intent [on|off]`、`/exit`。
 
 ### 选中与复制