@nathan33/nao-skill 0.20.1 → 0.20.3

package/.agents/checklists/pm.md

@@ -63,7 +63,7 @@ description: PM 交付核对清单（按需，交付/派发前读取）
 - [ ] 输出里有 `warn`/`error`/`pending approval`/`N vulnerabilities` 却判完成，或遗留项未走三出口（「先放着」不算出口）？（见 @.agents/skills/task-completion.md）
 - [ ] 降级（无 `gh` / 无远端）未在 `tasks-state` 与回执中标注？
 
-## 交付检查清单（完整 42 项）
+## 交付检查清单（完整 43 项）
 
 - [ ] 目标/边界/验收三件事齐备
 - [ ] 证据 + 5 Whys 已产出
@@ -102,8 +102,9 @@ description: PM 交付核对清单（按需，交付/派发前读取）
 - [ ] Issue 已建（或降级已标注）：body 为摘要 + 指针，正文在 `docs/prds/`；同步仅 5 个节点
 - [ ] 验收在 PR 上完成：AC 逐条评论核对 + QA 门禁数字；**UI 呈现类已交用户验收清单并获回填**（QA 产出 → PM 审 → 用户执行）；**验收通过后才授权合并**
 - [ ] 合并由 RD 执行（`--squash`）；main 上本需求恰好 1 条提交且无 `wip()`；需求分支已删除
+- [ ] 合并前已核「分支无未推送提交」（适用：在分支上提交过的**任何角色**，含 PM 落的文档/台账）：`git rev-list --count origin/<branch>..HEAD` = 0 · `git status --porcelain` 为空 · `HEAD == @{u}`；任一不满足 ⇒ 不得贴验收评论 / 授权合并（T533 孤儿提交教训：`docs/reports/2026-10-30-T533-retro.md`）
 - [ ] 发布（若有）：版本号符合 SemVer/项目约定；tag 指向 main 合并提交；release notes 用户可读且落盘 `docs/releases/`（核 @.agents/common/release-notes.md）
-- [ ] `gh` 可用则已用 `gh`，降级已注明；发布后 `tasks-state` 版本/Tag 行已更新
+- [ ] `gh` 可用则已用 `gh`，降级已注明；发布后事实（含 `tasks-state` 版本/Tag 行）的**落地时机与工作区纪律见 `github-flow.md` BR5**（单源指针，本清单不复写命令细节）
 - [ ] 任务 DoD 四类已随**开工确认卡**逐任务实例化（产物路径 / 可执行验证判据 / 遗留项 / 交接），验收按同一份核
 - [ ] 回执含 `遗留：` 字段且遗留项已**三出口**收口（关闭 / 接受含到期日 / 转办；零遗留显式「无」，可执行项已进 `tasks-state` 待派发队列）
 - [ ] 通过上面全部红线
@@ -111,6 +112,7 @@ description: PM 交付核对清单（按需，交付/派发前读取）
 ## 会话回收 / 收窗核对（验收通过后 / 手工关窗前）
 
 - [ ] 派生会话：`tasks-state` 已把任务推进到「已验收 / 已归档」→ `nao-fleet.sh close --task <编号> <别名>`（否则会被状态闸门拦下）
+- [ ] `status` 残留节按**仓归属**读：本仓行才可 `close`；他仓 / 归属不可判定行的处置见 @.agents/skills/pm-operations.md「残留自检」（单源，本清单不重复文案）
 - [ ] 常驻会话**不回收**（保留复用）；上下文变长时 `ensure --force` 重开
 - [ ] 手工关窗（tmux `kill-pane`）前：该会话已回**终态回执**（**未回执不得关**）+ `tmux capture-pane -p -t <pane>` 末 5 行无 `Working`/spinner + 产物已落盘（`git log` 有提交且**落在需求分支**、工作区干净、无 WIP 提交泄漏到 main、dev server/探针已停）
-- [ ] 残留已核对：`nao-fleet.sh status` 无 `! 残留` 提示（有则 `close --task` 或补登 tasks-state）
+- [ ] 残留已核对：`nao-fleet.sh status` **本仓**无 `! 残留` 提示（有则 `close --task` 或补登 tasks-state）；`~`（他仓）/ `?`（归属不可判定）行按上一条指针处置，**不得**在本仓 `close`

package/.agents/prompts/product-manager.md

@@ -1,8 +1,8 @@
 ---
 description: 产品经理角色 Prompt（短常驻）——需求分析/PRD/优先级/验收/多会话调度
 role: pm
-version: 29
-updated: 2026-10-30
+version: 30
+updated: 2026-10-31
 ---
 
 # 产品经理（PM）
@@ -63,6 +63,7 @@ updated: 2026-10-30
 - **任务完成闸门（交付 + 维护通用）**：任务单元分**交付型**（Issue 号/批次号）与**维护型**（`M<YYYYMMDD>-<slug>`，外部命令/依赖/环境动作）；DoD 四类（产物/验证/遗留项/交接）在**开工确认卡**上逐任务实例化，验收按同一份核；收尾时遗留项必须走**三出口**（关闭 / 接受含到期日 / 转办），零遗留显式写「无」；命中**返工 ≥1 / 漏闸 / 事故 / 同类第二次 / 用户投诉** → L1 完整复盘。协议与判据见 @.agents/skills/task-completion.md。
 - **验收闭环（省 token）**：核对 AC 五覆盖 + 回执「清单」字段（未核对则打回）；验收 = 核对回执**全量门禁精确数字** + 读变更文件核对 AC + **异常才复跑/抽查**（**不可改码**、**不重复跑 worker 已跑的门禁**）；读码走三段阶梯（原生入口 `codegraph_explore`（需插件 + CLI + 索引齐备）→ CLI → `grep -rn` + 行段；详情见 `@.agents/skills/codegraph.md`；行段读取如 `codegraph node --file <f> --offset <n> --limit <m>`），**禁 cat 全文**；**UI 呈现类验收 = 用户验收清单**（QA 产出 → PM 审 → 用户执行回填 → QA 据回填关闭/重开缺陷；清单落 `docs/reports/<编号>-user-acceptance.md`，见 qa 卡）。
 - **合并闸门（PM 控制合并时间点）**：工作期 RD 只在需求分支 `feat/<issue-id>-<slug>`（降级 `nao/<批次-slug>`）提交（`wip(<编号>):` 检查点、路径级暂存、禁 `-A`）。**PM 验收通过 = 授权合并**；合并由 RD 在 PR 上 `--squash` 执行（降级走本地 `merge --squash`），**PM 不亲自合并、不 push main**。验收核对：PR 标题/信息**用户可读** + main 上本需求**恰好 1 条提交且无 `wip()`** + 工作区干净。**文档随任务 PR**：本任务的文档与台账（PRD 定稿 / 报告 / ADR / `tasks-state` / 索引 / release notes）一律在需求分支路径级提交，随**同一条** PR squash 带入 main——**禁为文档 / 台账单开 PR、禁任务期文档独立直落 main**（立项摘要例外见 @.agents/skills/github-flow.md「文档与台账载体」）。特例白名单与流水线见 @.agents/skills/github-flow.md。
+- **合并前 push 核对（指针，单源在清单）**：在分支上提交过的**任何角色**（含 PM 落的文档/台账）在贴验收评论 / 授权合并前，必须核「分支无未推送提交」——三条命令与判据单写在 @.agents/checklists/pm.md「交付检查清单」合并项，本卡不复制（BR5 单源）。
 - **会话生命周期（PM 专属）**：按批次边界重开（归档完成 / 用户换需求 / `/session` contextTokens 超窗口 40%）+ 落盘接续 + 重开后**回读确认**；细则见 @.agents/skills/pm-operations.md §三。
 - **状态外部化**：任务状态落 `docs/tasks-state.md`（含接续快照），每次派发/回执/验收后更新；重开先读它。
 - **回收与残留**：派生会话验收通过即 `close --task <编号> <别名>`；常驻会话不回收，需重开时 `ensure --force`；`status` 残留即核对回收。
@@ -105,7 +106,7 @@ updated: 2026-10-30
 - [ ] 输出里有 `warn`/`error`/`pending approval`/`N vulnerabilities` 却判完成？（`exit 0` ≠ 完成，见 @.agents/skills/task-completion.md §三）
 - [ ] 降级（无 `gh` / 无远端）未在 `tasks-state` 与回执中标注？
 
-> 完整红线（34 项）与交付检查清单（42 项）：**交付/派发前**读取 @.agents/checklists/pm.md 逐项核对。
+> 完整红线（34 项）与交付检查清单（43 项）：**交付/派发前**读取 @.agents/checklists/pm.md 逐项核对。
 
 ## 十一、交付检查清单
 

package/.agents/scripts/nao-fleet.sh

@@ -1324,6 +1324,101 @@ cmd_check() {
   return $rc
 }
 
+# ---------------------------------------------------------------------------
+# T534（A · ADR 2026-10-31-fleet-status-repo-attribution）：派生会话归属加「仓」维度
+#   北极星 = 本仓 status 的残留提示**永不**指向他仓会话（BR2「提示即可执行」）；
+#   close / ensure **零改动**（BR3），本批只收紧 status 的判定与提示。
+# 物理归一：pwd -P → readlink -f → 原串（目录已删/不可读时不猜，交给组件级前缀判否）
+nao_phys_path() {
+  local p="$1" out=""
+  [[ -n "$p" ]] || return 0
+  out="$(cd "$p" 2>/dev/null && pwd -P)" || out=""
+  [[ -n "$out" ]] || out="$(readlink -f -- "$p" 2>/dev/null || true)"
+  [[ -n "$out" ]] || out="$p"
+  printf '%s\n' "$out"
+}
+
+# 单行谓词（AC7⑤，同时是 AC2 的单行变异点）：cwd 是否落在 root 子树内。
+#   组件级前缀：`/a/b` **不**命中 `/a/bc`（裸字符串前缀的经典陷阱 ⇒ AC7②）。
+repo_contains_path() { [[ -n "$1" && -n "$2" && ( "$2" == "$1" || "$2" == "${1%/}"/* ) ]]; }
+
+# 本仓锚集（每 run 一次）：主锚 pwd -P；git toplevel 是 cwd **严格祖先**时并入
+#   （覆盖在 `.agents/` 等子目录跑 status ⇒ AC7③）。不用 roles.yaml workspace（常为 `.`/子目录，且 ensure 支持 @repo）。
+repo_anchor_roots() {
+  local cwd top
+  cwd="$(nao_phys_path "$PWD")"
+  [[ -n "$cwd" ]] && printf '%s\n' "$cwd"
+  command -v git >/dev/null 2>&1 || return 0
+  top="$(git -C "$PWD" rev-parse --show-toplevel 2>/dev/null || true)"
+  [[ -n "$top" ]] || return 0
+  top="$(nao_phys_path "$top")"
+  [[ -n "$top" && "$top" != "$cwd" ]] || return 0
+  repo_contains_path "$top" "$cwd" || return 0
+  printf '%s\n' "$top"
+}
+
+# pane cwd 一次快照（**禁**逐名 find_pane_for：O(N) 次 tmux 调用违 NFR「不引入额外 I/O 循环」）
+#   输出：name<TAB>pane_id<TAB>pane_current_path；标题契约 `π - <会话名> - <任意>`（会话名字符集同 visible_session_names）
+pane_cwd_snapshot() {
+  command -v tmux >/dev/null 2>&1 || return 0
+  tmux list-panes -a -F "#{pane_id}"$'\t'"#{pane_title}"$'\t'"#{pane_current_path}" 2>/dev/null \
+    | awk -F'\t' -v p="$PI_TITLE" '
+        { pre = p " - "
+          if (index($2, pre) != 1) next
+          rest = substr($2, length(pre) + 1)
+          i = index(rest, " - ")
+          if (i <= 1) next
+          name = substr(rest, 1, i - 1)
+          if (name !~ /^[A-Za-z0-9_-]+$/) next
+          print name "\t" $1 "\t" $3
+        }' || true
+}
+
+# 归属三态：local（本仓）/ other（他仓）/ unknown（不可判定 ⇒ fail-closed，只标注不给命令）
+#   $1=本仓锚集（换行分隔）· $2=pane cwd 集（换行分隔；空 = 无 pane）· $3=名册 cwd（可空）
+#   优先级 pane > 名册；同名多 pane：本仓 ≥1 ⇒ local · 本仓 0 且他仓 ≥1 ⇒ other · 两侧皆无 ⇒ unknown
+#   输出：`<verdict><TAB><他仓仓名 basename>`
+session_repo_verdict() {
+  local roots="$1" cwds="$2" rcwd="$3"
+  local c r hit local_n=0 other_n=0 obase="" verdict=""
+  if [[ -n "$cwds" ]]; then
+    while IFS= read -r c; do
+      [[ -n "$c" ]] || continue
+      c="$(nao_phys_path "$c")"
+      hit=0
+      while IFS= read -r r; do
+        [[ -n "$r" ]] || continue
+        if repo_contains_path "$r" "$c"; then hit=1; break; fi
+      done <<< "$roots"
+      if (( hit )); then
+        local_n=$((local_n + 1))
+      else
+        other_n=$((other_n + 1))
+        if [[ -z "$obase" ]]; then obase="${c%/}"; obase="${obase##*/}"; fi
+      fi
+    done <<< "$cwds"
+    if (( local_n > 0 )); then verdict=local
+    elif (( other_n > 0 )); then verdict=other
+    fi
+  fi
+  if [[ -z "$verdict" && -n "$rcwd" ]]; then
+    c="$(nao_phys_path "$rcwd")"
+    hit=0
+    while IFS= read -r r; do
+      [[ -n "$r" ]] || continue
+      if repo_contains_path "$r" "$c"; then hit=1; break; fi
+    done <<< "$roots"
+    if (( hit )); then
+      verdict=local
+    else
+      verdict=other
+      obase="${c%/}"; obase="${obase##*/}"
+    fi
+  fi
+  [[ -n "$verdict" ]] || verdict=unknown
+  printf '%s\t%s\n' "$verdict" "$obase"
+}
+
 # ---------------------------------------------------------------------------
 cmd_status() {
   local a
@@ -1337,12 +1432,35 @@ cmd_status() {
     fi
   done
   echo "== 任务派生会话（--task 拉起，如 rd-be-T1 / rd-infra-T1）=="
-  local found=0 dname role id cls tag
+  # T534：先建归属快照（本仓锚 / pane cwd / 名册 cwd），再逐会话**先定归属、后判本仓台账**
+  #   （他仓不查本仓 tasks-state，杜绝误读；本仓行 cls tag 逐字不变）
+  local roots_blob="" rl
+  while IFS= read -r rl; do [[ -n "$rl" ]] && roots_blob+="$rl"$'\n'; done < <(repo_anchor_roots)
+  local -A pane_cwds=() roster_cwds=()
+  local pn pname pcwd rn rcwd prev
+  while IFS=$'\t' read -r pn pname pcwd; do
+    [[ -n "$pname" ]] || continue
+    prev="${pane_cwds[$pname]:-}"
+    pane_cwds["$pname"]="$prev$pcwd"$'\n'
+  done < <(pane_cwd_snapshot)
+  while IFS=$'\t' read -r rn rcwd; do
+    [[ -n "$rn" ]] || continue
+    [[ -n "${roster_cwds[$rn]:-}" ]] || roster_cwds["$rn"]="$rcwd"
+  done < <(intercom_roster 2>/dev/null || true)
+
+  local found=0 dname role id cls tag verdict obase
   while IFS= read -r dname; do
     [[ -n "$dname" ]] || continue
     id=""
     for role in "${ROLE_ORDER[@]}"; do [[ "$dname" == "$role-"* ]] && { id="${dname#"$role"-}"; break; }; done
     [[ -n "$id" ]] || continue
+    IFS=$'\t' read -r verdict obase <<< "$(session_repo_verdict "$roots_blob" "${pane_cwds[$dname]:-}" "${roster_cwds[$dname]:-}")"
+    case "$verdict" in
+      # D5：他仓会话**列出并标注**（不静默隐藏），整行不含任何可执行 close 命令（BR2）
+      other)   printf '  ~ %s（他仓 @ %s）他仓会话，勿在本仓回收\n' "$dname" "${obase:-?}"; found=1; continue ;;
+      # fail-closed（T530 对偶）：不可判定时不得声称「是本仓残留」，只标注不给命令
+      unknown) printf '  ? %s（归属不可判定）→ 人工核对（勿在本仓回收）\n' "$dname"; found=1; continue ;;
+    esac
     cls="$(task_state_class "$id")"
     tag=""
     case "$cls" in

package/.agents/skills/github-flow.md

@@ -37,7 +37,7 @@ PM 在**立项 / 终签 / 发布**时读取；RD 在**起分支 / 开 PR / 合
 - **BR2 禁令**：① 禁止为文档 / 台账**单开 PR**；② 禁止任务期文档作为**独立提交直落 main**（唯一例外见 BR3）。发布提交（阶段 7）承载批间收尾事实，不计入本禁令。
 - **BR3 立项例外（三条件同时满足才可用）**：① **仅用于**建 Issue / 定分支名所需的最小摘要；② 内容上限 = **最小摘要三要素**（TL;DR + AC 编号 + PRD 路径指针），正文仍留 `docs/`，**禁抄正文**；③ **单条** `docs(<编号>):` 提交、只含该摘要文件、**不与其它改动混提**。**降级批次（无 Issue）无此例外**。
 - **BR4 谁提交**：PM 在需求分支做**路径级**提交（`git add <具体路径>`，`docs(<编号>):` 前缀，**禁 `-A`**、禁 push main）；RD 最终 squash 时一并带入。同 worktree 并行时，提交方**只暂存自己的路径**。
-- **BR5 批间收尾**：合并后产生的事实（npm 核验结果 / Release 标题核验 / 角色卡广播登记 / 会话交接快照）随**发布提交一次带走**；发布提交之后才产生的事实，登记进**下一个任务 PR** 或下一次发布提交，**不得单独提交 main**。
+- **BR5 批间收尾（发布后事实）**：合并后产生的事实（npm 核验结果 / Release 标题核验 / 角色卡广播登记 / 会话交接快照）随**发布提交一次带走**；**发布提交之后**才产生的事实登记进**下一个任务 PR 的首个文档提交**（随该 PR 一并进 main），**不得单独提交 main**。其间**不得留工作区脏改**：需要先保住改动时用**带标签的 `git stash`**（如 `git stash push -m "<编号>: 发布后事实" -- <路径>`），在下一分支的首个文档提交里 `git stash pop` 后一并提交。理由：实测 PM 把 `tasks-state` 改动留在工作区时，用户执行 `git pull --ff-only` 会被未暂存改动拒绝（`pull.rebase=true` 下周期性阻塞协作）。
 - **BR6 可读性不变**：PR 标题与 `gh pr merge --squash --subject` 仍须用户可读（禁纯编号 / 类名 / 路径）；文档改动不降低该要求。
 - **自查三条（可执行）**：main 上本任务提交数（`git log --oneline main | grep -c '(<编号>)'`）· 本 PR diff 是否含 `docs/` 路径（`git diff --name-only main...HEAD | grep '^docs/'`）· 工作区干净（`git status --porcelain` 为空）。
 - **验证接缝**：文本口径由一次性只读探针核（如 `docs/reports/<日期>-*-probe.sh`），不进 `tests/`。

package/.agents/skills/pm-operations.md

@@ -19,7 +19,7 @@ description: 按需技能——PM 运行手册（调度细则 / 开工确认卡
 - **任务派生会话（并行隔离）**：`ensure <role>@<repo> --task <编号>` → `--name <角色>-<编号>`（如 `rd-be-T1`）；**验收通过后回收**：`nao-fleet.sh close --task <编号> <别名>`（工具内置「在跑 turn / tasks-state 未推进」双闸门，后者防验收未过就回收丢返工上下文）；回执 role 写派生名。
 - **状态外部化 + 接续快照（可恢复）**：任务状态落盘 `docs/tasks-state.md`（五栏 + 顶部「PM 接续快照」；骨架见 @.agents/templates/tasks-state.md.example），每次派发/回执/验收/抢占后更新；重开后**先读该文件重建状态**，不依赖历史消息。
 - **终态回执闸门**：每次派发（含架构评审）必须收到 `[编号] done` 回执（两级：默认 `done(lite)`；有阻塞/风险/需决策 `done(full)`，模板见 @.agents/checklists/comm-templates.md）；未见回执（含 arch 静默）→ 主动追讨，必要时上报用户，**不默认成功**。
-- **残留自检**：`nao-fleet.sh status` 标出派生会话残留（tasks-state 已归档 / 无记录）；发现即核对状态并 `close --task <编号> <别名>` 回收。
+- **残留自检**：`nao-fleet.sh status` 标出派生会话残留（tasks-state 已归档 / 无记录）；发现即核对状态并 `close --task <编号> <别名>` 回收。判据按 pane 实际工作目录定归属 ⇒ **他仓会话单列、勿在本仓回收**（`~ <名>（他仓 @ <仓名>）` 行不含可执行命令；归属不可判定 ⇒ 人工核对）。
 - **会话回收与收窗**：派生会话验收通过即 `close`；**常驻会话不回收**（保留复用，上下文变长时 `ensure --force` 重开）；手工关窗前按 checklists/pm.md「会话回收 / 收窗核对」逐项核对（工具不替代回执与产物核对）。
 - **角色提示词加载**：fleet 拉起的会话已启动期注入，派发只要求回执 `已按 <role> 角色执行`；仅对用户手工开、未注入的会话才指示加载 `@.agents/prompts/<role>.md`。
 - **验收闭环（省 token）**：核对 AC 五覆盖 + 回执「清单」字段（未核对则打回）；验收 = 核对回执**全量门禁精确数字** + 读变更文件核对 AC + **异常才复跑/抽查**（**不可改码**、**不重复跑 worker 已跑的门禁**）；读码走三段阶梯（原生入口 `codegraph_explore`（需插件 + CLI + 索引齐备）→ CLI → `grep -rn` + 行段；行段读取如 `codegraph node --file <f> --offset <n> --limit <m>`），**禁 cat 全文**；依赖 QA 先行用例。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nathan33/nao-skill",
-  "version": "0.20.1",
+  "version": "0.20.3",
   "description": "nao 多角色 AI 开发舰队：角色卡 / 技能 / 协作协议 / 工具链，一键接入项目（pi / Claude / 任意 Agent）",
   "type": "module",
   "bin": {