refactor(skills): 拆分安装器私有模块

Author: mudssky

.trellis/tasks/05-20-skills-installer-private-module-split/design.md

@@ -0,0 +1,52 @@
+# design: skills installer private module split
+
+## Scope
+
+本任务只拆分 `ai/skills/Install-Skills.ps1` 内部的 skills 安装器领域逻辑。拆出的文件放在 `ai/skills/private/`，通过入口脚本 dot-source 加载，不进入 `psutils`，也不改变配置字段、安装语义或外部命令参数。
+
+入口脚本继续作为唯一 CLI 入口，负责：
+
+* 声明参数与脚本级帮助。
+* 初始化 `Set-StrictMode`、`$ErrorActionPreference`、`$script:SkillsInstallerRoot`、`$script:SkillsRepoRoot`。
+* 导入 `psutils/modules/process.psm1` 与 `psutils/modules/config.psm1`。
+* 按顺序加载私有脚本。
+* 保留 `Invoke-SkillsInstallMain` 与最终 `exit` 调用。
+
+## File Layout
+
+新增 `ai/skills/private/`：
+
+* `bootstrap.ps1`
+  * 字符串数组转换、默认路径、用户目录、agent skill 目录、已安装目录检查。
+* `plan.ps1`
+  * 配置读取、agent/scope/source 解析、命令计划、完整安装计划生成。
+* `presentation.ps1`
+  * 安装计划展示与脚本级确认。
+* `execution.ps1`
+  * tool check、pending plan 过滤、单步执行和计划执行。
+
+## Load Order
+
+`Install-Skills.ps1` 先导入共享 `psutils` 模块，再按以下顺序 dot-source 私有脚本：
+
+1. `bootstrap.ps1`
+2. `plan.ps1`
+3. `presentation.ps1`
+4. `execution.ps1`
+
+这个顺序保证私有脚本可以直接复用共享配置/进程 helper，以及前置私有 helper。
+
+## Compatibility
+
+* 保留现有函数名，测试继续通过 dot-source `Install-Skills.ps1` 访问这些函数。
+* 保留 `SKILLS_INSTALLER_SKIP_MAIN=1` 测试入口语义。
+* 保留 `WhatIf`、`DryRun`、`Yes`、`Force` 行为。
+* 保留日志文件创建与命令执行器注入方式。
+
+## Tradeoffs
+
+本轮不引入 `.psm1` 模块导出或构建型单文件 bundle。当前优先目标是降低入口脚本体积和提高领域边界可读性；如果后续需要发布单文件脚本，可再增加构建脚本把 `private/*.ps1` inline 到 bundle。
+
+## Rollback
+
+如拆分后出现加载或作用域问题，可把 `private/*.ps1` 的函数按原顺序合并回 `Install-Skills.ps1`，删除 dot-source 加载块即可恢复单文件结构。

.trellis/tasks/05-20-skills-installer-private-module-split/implement.md

@@ -0,0 +1,30 @@
+# implement: skills installer private module split
+
+## Checklist
+
+1. 准备任务状态
+   * 补齐 `design.md` 与 `implement.md`。
+   * 执行 `task.py start` 将任务状态切到 `in_progress`。
+2. 新建私有脚本目录
+   * 创建 `ai/skills/private/bootstrap.ps1`。
+   * 创建 `ai/skills/private/plan.ps1`。
+   * 创建 `ai/skills/private/presentation.ps1`。
+   * 创建 `ai/skills/private/execution.ps1`。
+3. 迁移函数
+   * 将无 CLI 参数依赖的 helper 按边界移动到私有脚本。
+   * 入口脚本保留参数、共享模块导入、私有脚本加载、`Invoke-SkillsInstallMain` 与最终执行块。
+   * 保留原有 comment-based help，不改变函数名和参数。
+4. 验证兼容性
+   * `pnpm exec pwsh -NoProfile -File ./scripts/pwsh/devops/Invoke-PesterMode.ps1 -Mode serial -Path ./tests/SkillsInstaller.Tests.ps1`
+   * `pnpm qa`
+   * `pnpm test:pwsh:all`
+5. Review gate
+   * 确认 `Install-Skills.ps1` 行数明显下降。
+   * 确认没有新增 `psutils` 领域外逻辑。
+   * 确认工作区只包含本任务相关文件。
+
+## Rollback Points
+
+* 私有脚本加载失败：先检查 dot-source 路径和加载顺序。
+* 函数不可见：确认测试仍 dot-source 入口脚本，而不是直接调用私有脚本。
+* 行为回归：通过 `git diff` 比对迁移块，优先恢复对应函数原文再缩小拆分范围。

.trellis/tasks/05-20-skills-installer-private-module-split/task.json

@@ -3,7 +3,7 @@
   "name": "skills-installer-private-module-split",
   "title": "skills installer private module split",
   "description": "",
-  "status": "planning",
+  "status": "in_progress",
   "dev_type": null,
   "scope": null,
   "package": null,