feat: rename skills/skiff to pouch and move ACK state under .pouch

Use ~/.pouch, the pouch CLI, and .pouch.yaml as the SSOT container.
Keep the inner skills/ packages, and store ACK project state in
.pouch/ack instead of docs/ack.

skills/ack/SKILL.md

@@ -2,14 +2,14 @@
 name: ack
 description: >-
   初始化、检查并运行 ACK 三角色协作闭环。仅在用户显式调用 /ack 或 $ack，并要求
-  初始化 ACK、检查 docs/ack 配置、按 ACK 规划需求、指挥 Coordinator/Developer/Test
+  初始化 ACK、检查 .pouch/ack 配置、按 ACK 规划需求、指挥 Coordinator/Developer/Test
   工作，配置测试环境与发版方式，重新部署测试环境，或发布版本时使用。
 ---
 
 # ACK 项目协作入口
 
 本 Skill 是 ACK 的完整能力包：`references/` 保存通用规范，`templates/` 保存项目
-状态模板，`scripts/` 保存校验工具。目标项目只在 `docs/ack/` 保存 `project.md`、
+状态模板，`scripts/` 保存校验工具。目标项目只在 `.pouch/ack/` 保存 `project.md`、
 `tasks.yaml`、`knowledge.yaml` 和默认关闭的 `delivery.yaml`，不要复制或链接 Skill
 内容。
 
@@ -23,7 +23,7 @@ description: >-
 - 用户要求用 ACK 做需求、修复问题或继续任务：执行“工作”。
 - 用户用自然语言说明怎么部署测试环境、怎么发布版本，或要求增加、修改、关闭交付
   流程：执行“交付配置维护”。测试环境和发版必须写进同一份
-  `docs/ack/delivery.yaml`。
+  `.pouch/ack/delivery.yaml`。
 - 用户要求部署、重新部署测试环境，或按已配置方式开始测试：执行“运行测试环境”。
 - 用户要求发布版本：执行“运行版本发布”。
 
@@ -33,48 +33,48 @@ description: >-
 
 ## 初始化
 
-1. 确认 `skiff` 可执行，并检查 `<project>/docs/ack` 是否存在。
+1. 确认 `pouch` 可执行，并检查 `<project>/.pouch/ack` 是否存在。
 2. 不存在时执行：
 
    ```bash
-   skiff init ack --project <project-root>
+   pouch init ack --project <project-root>
    ```
 
    该命令从本 Skill 的 `templates/` 生成项目状态，不会在项目中创建 Skill
    软链接或资源副本。
-3. 如果 `docs/ack` 已存在，不重复初始化、不覆盖文件；转入“检查”。旧项目只有
+3. 如果 `.pouch/ack` 已存在，不重复初始化、不覆盖文件；转入“检查”。旧项目只有
    `project.md` 与 `tasks.yaml` 时，先报告缺少 `knowledge.yaml`。用户授权后，
    从 `templates/knowledge.template.yaml` 生成这个缺失文件并替换项目名和时间；若
    `tasks.yaml` 尚无 `project.knowledgeFile`，同时只补
-   `docs/ack/knowledge.yaml` 这一项。不要重跑 `skiff init`，也不要改写其它已有
+   `.pouch/ack/knowledge.yaml` 这一项。不要重跑 `pouch init`，也不要改写其它已有
    项目状态。
 4. 读取项目的公开配置和文档，例如 README、语言清单、包管理清单、测试配置与
    CI，确定项目名、技术栈、源码/规格/测试路径及真实可执行命令。
-5. 完善 `docs/ack/project.md`：
+5. 完善 `.pouch/ack/project.md`：
    - 用实际项目值替换全部占位符。
    - 无服务地址时把 Base URL 写为 `n/a`，不要虚构端口。
    - 无法从项目证据确定的命令写为 `n/a`，并在结果中列为待配置项。
    - 只写项目差异，不复制 `references/` 中的通用规范。
-6. 完善 `docs/ack/tasks.yaml` 的项目信息。纯初始化且用户没有提供真实任务时，
+6. 完善 `.pouch/ack/tasks.yaml` 的项目信息。纯初始化且用户没有提供真实任务时，
    删除模板示例任务并保留 `tasks: []`；不要虚构需求或缺陷。
-   项目状态固定从当前项目根的 `docs/ack/` 推导，不写入 `repoPath` 或 `devWorktree`；
+   项目状态固定从当前项目根的 `.pouch/ack/` 推导，不写入 `repoPath` 或 `devWorktree`；
    worker 默认在 `--project-root`（权威状态目录）工作，不再配置
    `allowedWorktrees` 白名单（v0.19 起废弃）；需要隔离 worktree 时由 Coordinator 在
    派发时显式指定。旧任务板中的 `repoPath`、`devWorktree` 仅兼容读取。
-7. 检查 `docs/ack/knowledge.yaml`。新项目没有已验证的项目经验时保留
+7. 检查 `.pouch/ack/knowledge.yaml`。新项目没有已验证的项目经验时保留
    `verificationRegistry: {}` 与 `entries: []`，不从聊天、README 或单次失败中
    猜测并激活知识。
-8. 检查 `docs/ack/delivery.yaml`。新项目保留 `enabled: false`、空能力表和空 profile；
+8. 检查 `.pouch/ack/delivery.yaml`。新项目保留 `enabled: false`、空能力表和空 profile；
    不从 README 或 CI 猜测、启用交付。旧项目没有该文件时仍可继续使用原 ACK
    闭环；只有用户明确要求配置交付时，才按“交付配置维护”补齐。
 9. 更新 `updatedAt`，并运行：
 
    ```bash
-   python3 <ack-skill-dir>/scripts/validate_tasks.py docs/ack/tasks.yaml
-   python3 <ack-skill-dir>/scripts/validate_knowledge.py docs/ack/knowledge.yaml \
-     --tasks docs/ack/tasks.yaml
-   python3 <ack-skill-dir>/scripts/validate_delivery.py docs/ack/delivery.yaml \
-     --tasks docs/ack/tasks.yaml --project-root <project-root>
+   python3 <ack-skill-dir>/scripts/validate_tasks.py .pouch/ack/tasks.yaml
+   python3 <ack-skill-dir>/scripts/validate_knowledge.py .pouch/ack/knowledge.yaml \
+     --tasks .pouch/ack/tasks.yaml
+   python3 <ack-skill-dir>/scripts/validate_delivery.py .pouch/ack/delivery.yaml \
+     --tasks .pouch/ack/tasks.yaml --project-root <project-root>
    ```
 
 10. 检查 `project.md`、`tasks.yaml`、`knowledge.yaml` 与 `delivery.yaml` 是否仍有
@@ -87,10 +87,10 @@ description: >-
 ## 检查
 
 1. 检查以下路径：
-   - `docs/ack/project.md`
-   - `docs/ack/tasks.yaml`
-   - `docs/ack/knowledge.yaml`
-   - `docs/ack/delivery.yaml`（旧项目可无；存在或被任务板引用时必须校验）
+   - `.pouch/ack/project.md`
+   - `.pouch/ack/tasks.yaml`
+   - `.pouch/ack/knowledge.yaml`
+   - `.pouch/ack/delivery.yaml`（旧项目可无；存在或被任务板引用时必须校验）
    需要查看任务内容时，使用 `<ack-skill-dir>/scripts/select_tasks.py` 解析完整任务板并
    只输出项目配置、摘要和可工作任务；不要用 `cat`、整文件 `sed` 或等价方式把完整
    `tasks.yaml` 注入上下文。完整性仍由校验器检查。
@@ -101,14 +101,14 @@ description: >-
 3. 查找未替换占位符，并核对项目根、覆盖层路径、Developer 白盒命令、Test
    黑盒命令和 Base URL。
 4. 使用 `<ack-skill-dir>/scripts/validate_tasks.py` 校验任务板，使用
-   `<ack-skill-dir>/scripts/validate_knowledge.py docs/ack/knowledge.yaml --tasks
-   docs/ack/tasks.yaml` 校验项目知识和跨文件引用。如果存在交付配置或任务板声明了
+   `<ack-skill-dir>/scripts/validate_knowledge.py .pouch/ack/knowledge.yaml --tasks
+   .pouch/ack/tasks.yaml` 校验项目知识和跨文件引用。如果存在交付配置或任务板声明了
    `project.deliveryFile`，再使用 `<ack-skill-dir>/scripts/validate_delivery.py
-   docs/ack/delivery.yaml --tasks docs/ack/tasks.yaml --project-root <project-root>`
+   .pouch/ack/delivery.yaml --tasks .pouch/ack/tasks.yaml --project-root <project-root>`
    校验交付能力、顺序、安全边界和跨文件引用。只报告证据明确的问题，不因旧项目
    缺少可选交付配置而宣称失败。
 5. 若存在 `project.bugIntake`，运行
-   `python3 <ack-skill-dir>/scripts/feishu_bug_intake.py check docs/ack/tasks.yaml`。
+   `python3 <ack-skill-dir>/scripts/feishu_bug_intake.py check .pouch/ack/tasks.yaml`。
    它只接受 `feishu-base` 和显式 profile；详细的飞书配置、凭据初始化和读取方式见
    `references/feishu-bug-intake.md`。
 6. 检查知识引用能解析到固定 revision，candidate 仍留在任务证据中，且
@@ -122,16 +122,16 @@ description: >-
 
 ## 工作
 
-1. 若 `docs/ack` 不存在，停止并建议先用 `/ack` 初始化；不要静默初始化。
+1. 若 `.pouch/ack` 不存在，停止并建议先用 `/ack` 初始化；不要静默初始化。
 2. 依次读取：
-   - `docs/ack/project.md`
-   - 运行 `python3 <ack-skill-dir>/scripts/select_tasks.py docs/ack/tasks.yaml`，只读取
+   - `.pouch/ack/project.md`
+   - 运行 `python3 <ack-skill-dir>/scripts/select_tasks.py .pouch/ack/tasks.yaml`，只读取
      `project`、`summary` 和默认可工作状态的任务；已知当前任务时传
      `--task-id <ack-task-id>`。选择器会解析并校验完整任务板，并只附带选中任务引用的
      receipt 与 delivery run。命中超过默认预算时用 `--task-id` / `--status` 缩小，
      不直接回退为输出完整 `tasks.yaml`。
    - 通过 `<ack-skill-dir>/scripts/select_knowledge.py` 从
-     `docs/ack/knowledge.yaml` 选择的当前任务相关 `active` 条目
+     `.pouch/ack/knowledge.yaml` 选择的当前任务相关 `active` 条目
    - `<ack-skill-dir>/references/kickoff.md`
    - kickoff 指定且与当前任务相关的 references 文件
    - 若 `tasks.yaml.project.deliveryFile` 存在，再读取该 `delivery.yaml` 和
@@ -183,7 +183,7 @@ description: >-
    `knowledgeCandidates`，Test 回报 `knowledgeChecks`；`candidate` 只有在独立验证和
    gate 后才能由 Coordinator 写入或激活。
 7. 执行知识项的 `verification.ref` 时，只调用
-   `<ack-skill-dir>/scripts/run_verification.py docs/ack/knowledge.yaml
+   `<ack-skill-dir>/scripts/run_verification.py .pouch/ack/knowledge.yaml
    <verification-ref> --project-root <project-root>`。不要直接执行选择器返回的 path/args，
    也不要给 runner 注入额外命令或参数。
 8. 不把 `worker_done` 或 Test 自报成功直接当作完成。三轮预算只计算 Test 已对齐正确
@@ -216,8 +216,8 @@ description: >-
    destination、environment 与 profile。测试环境部署和版本发布都写进这一份
    `delivery.yaml`，不要拆成第二份文档。配置只引用仓库内脚本或声明式工具 target，
    不保存 shell。
-2. 若旧项目首次启用，生成 `docs/ack/delivery.yaml`，在 `tasks.yaml.project` 增加
-   `deliveryFile: docs/ack/delivery.yaml`，并增加顶层 `deliveryRuns: []`；不改写其它
+2. 若旧项目首次启用，生成 `.pouch/ack/delivery.yaml`，在 `tasks.yaml.project` 增加
+   `deliveryFile: .pouch/ack/delivery.yaml`，并增加顶层 `deliveryRuns: []`；不改写其它
    项目状态。首次生成保持 `enabled: false`，先展示 diff 和解析出的执行顺序。
 3. 运行 delivery、tasks 和跨文件校验；需要的脚本不存在、不可执行、引用不完整或
    涉及凭据正文时 fail closed。凭据只写 secret 名称，值由外部环境提供。
@@ -227,7 +227,7 @@ description: >-
 
 ## 运行测试环境
 
-1. 读取 `docs/ack/delivery.yaml` 与 `references/delivery.md`。
+1. 读取 `.pouch/ack/delivery.yaml` 与 `references/delivery.md`。
 2. `enabled` 不为 true，或 `intents.testEnvironment` 为 null：停止，请用户说明如何
    部署测试环境，转入交付配置维护。不猜测编译或启动命令。
 3. 不要求任务已 `verified`。按该 profile 执行 build → deploy → health-check。
@@ -237,7 +237,7 @@ description: >-
 
 ## 运行版本发布
 
-1. 读取同一份 `docs/ack/delivery.yaml` 与 `references/delivery.md`。
+1. 读取同一份 `.pouch/ack/delivery.yaml` 与 `references/delivery.md`。
 2. `enabled` 不为 true，或 `intents.release` 为 null：停止，请用户说明如何发版，
    写入同一文件后再执行。
 3. 按该 profile 顺序执行。stable 发布和生产部署的 `approval` 不能用口头「发版」
@@ -262,7 +262,7 @@ description: >-
   没有可信空闲状态、配置匹配和历史消息清理证明时不复用既有 worker。
 - launcher 返回 `indeterminate` 或 `reconcile required` 时，不直接重试；先按
   launch ID、外部 record 和 Orca live state 完成人工核对。
-- 不覆盖已有 `docs/ack` 文件；除用户确认的 ACK 任务或 delivery profile 外，不擅自
+- 不覆盖已有 `.pouch/ack` 文件；除用户确认的 ACK 任务或 delivery profile 外，不擅自
   提交、推送、创建终端、新 worktree、发布产物或部署。
 - 只有 Coordinator 写 `tasks.yaml`、`knowledge.yaml` 和 `deliveryRuns`；Developer
   与 Test 只读，只能通过回报提名或验证知识。`delivery.yaml` 只在显式的交付配置
@@ -271,6 +271,6 @@ description: >-
   按 registry ID 执行。不自动修改 `AGENTS.md`、`CLAUDE.md` 或其它 Agent 指令文件。
 - 不把完整 `tasks.yaml` 注入上下文；使用 `select_tasks.py` 获取有预算的项目与任务
   视图，写回前仍运行完整任务板校验。
-- 项目只保存 `docs/ack/project.md`、`docs/ack/tasks.yaml`、
-  `docs/ack/knowledge.yaml` 和可选的 `docs/ack/delivery.yaml`；通用资源始终从当前
+- 项目只保存 `.pouch/ack/project.md`、`.pouch/ack/tasks.yaml`、
+  `.pouch/ack/knowledge.yaml` 和可选的 `.pouch/ack/delivery.yaml`；通用资源始终从当前
   ACK Skill 目录读取。