feat: modify ack

kits/ack/README.md

@@ -23,6 +23,7 @@ ack/
   README.md
   adoption-checklist.md
   core/                         # 稳定核心：跨项目通用，随 kit 升级，尽量别改
+    kickoff.md                  #   如何开始一个需求（启动手册 + 开场指令模板）
     roles-and-permissions.md    #   角色/权限/状态机/完成定义（SSOT）
     model-routing.md            #   三角色默认模型档位 + 升级规则（SSOT）
     closed-loop.md              #   编排无关闭环 + 手动模式 + worktree 对齐
@@ -94,6 +95,65 @@ ln -s <此框架绝对路径> <project>/docs/ack/kit
 
 ---
 
+## 常用使用方法
+
+### 开一个新需求（最常用）
+
+你（强模型会话）就是 Coordinator(PM)。完整手册见 `core/kickoff.md`，开场指令：
+
+```text
+我要做一个新需求：<一句话需求>。你作为 ack 的 Coordinator(PM)，按 docs/ack/kit/core 规范：
+先读 project.md 与 core/*；写产品文档到 docs/ 并把需求拆成带可观测验收信号的任务写进 docs/ack/tasks.yaml；
+先给我确认产品文档+任务拆分，再按闭环起 DEV/TEST worker（cursor-agent --model auto）循环派发/复测/终检；
+每个任务最多三轮，三轮不过记 leftover。
+```
+
+### 起 worker（模型固定为 auto）
+
+```bash
+orca terminal create --worktree active --command "cursor-agent --model auto" --title "DEV"  --json
+orca terminal create --worktree active --command "cursor-agent --model auto" --title "TEST" --json
+```
+
+需要隔离/并行时先建 worktree：`orca worktree create --name <feature> --base-branch <base> --json`（选择依据见 `core/closed-loop.md`）。
+
+### 派发与等待（Orca）
+
+```bash
+orca orchestration task-create --spec "<任务与验收>" --json
+orca orchestration dispatch --task <task_id> --to <dev_handle> --json
+orca orchestration check --terminal <coordinator_handle> --wait \
+  --types worker_done,retest_result,escalation,decision_gate --timeout-ms 900000 --json
+```
+
+不能 `--inject` 时手动投递 `core/prompt-templates.md` 的模板；命令细节见 `core/orca-adapter.md`。
+
+### 校验任务板结构
+
+```bash
+python3 docs/ack/kit/scripts/validate_tasks.py docs/ack/tasks.yaml
+```
+
+### 只处理已有未通过项
+
+用「默认口令」（见下）让 Coordinator 直接扫 `tasks.yaml` 里的 `open` / `failed_retest` 继续闭环。
+
+### 速查：想做什么 → 看哪个文件
+
+| 想做的事 | 文件 |
+|----------|------|
+| 开一个新需求怎么起步 | `core/kickoff.md` |
+| 角色/权限/状态机/完成定义 | `core/roles-and-permissions.md` |
+| 三角色各自该怎么做（规划/写测试/复测能力清单） | `core/roles-and-permissions.md` §三角色能力清单 |
+| 用哪个模型、怎么固定、何时升级 | `core/model-routing.md` |
+| 闭环步骤、手动模式、worktree 决策与对齐 | `core/closed-loop.md` |
+| 验收信号写法、三轮失败策略 | `core/optimization-method.md` |
+| 派发/复测/回报的 prompt 文案 | `core/prompt-templates.md` |
+| Orca 具体命令 | `core/orca-adapter.md` |
+| 新项目接入步骤 | `adoption-checklist.md` |
+
+---
+
 ## 默认口令
 
 ```text