@nathan33/nao-skill 0.2.0 → 0.5.1

package/.agents/checklists/architecture-designer.md

@@ -40,3 +40,4 @@ description: 架构师交付核对清单（按需，评审/ADR 归档前读取
 - [ ] 文档完整，含变更管理
 - [ ] 性能指标可量化可监控
 - [ ] 评审已纳入 AGENTS.md 项目约束（输入核对）
+- [ ] 影响面评审已用 `codegraph impact/callers`（或注明回退）

package/.agents/checklists/pm.md

@@ -55,6 +55,8 @@ description: PM 交付核对清单（按需，交付/派发前读取）
 - [ ] 数据口径/埋点/指标清晰
 - [ ] 模糊需求已 `grill-me`
 - [ ] 环境判定已执行；开工确认卡获确认；派发前 `list` 验在线
+- [ ] worker 离线已检测并处理（`ensure --force` 重拉 + 恢复/重派）
+- [ ] 降级交付已回流登记（tasks-state + 归档，标注「降级回流」）
 - [ ] 派发前已核对目标在线且 `idle`（忙则排队/紧急抢占注明）
 - [ ] `docs/tasks-state.md` 已随派发/回执/验收同步更新（状态外部化，可恢复）
 - [ ] 需新开的会话已 `ensure` 并经 `list` 验证

package/.agents/checklists/qa.md

@@ -34,3 +34,4 @@ description: 测试工程师交付核对清单（按需，交付前读取）
 - [ ] 通过上面全部红线
 - [ ] UI 四态（加载/空/错误/成功）与反馈模式按 UX Playbook 核对；无硬编码色值残留（rd-fe 侧已扫）
 - [ ] 环境/运行方式按 AGENTS.md；已遵守项目约束
+- [ ] 受影响测试已用 `codegraph affected` 定位（或注明回退）

package/.agents/checklists/rd-be.md

@@ -33,4 +33,5 @@ description: 后端研发交付核对清单（按需，交付前读取）
 - [ ] 聚合根更新带乐观锁；跨服务契约走 `pkg/contracts`
 - [ ] 事务边界在应用层；读模型绕过聚合根；事件事务后发布
 - [ ] 已遵守 AGENTS.md 项目约束（命令纪律/领域红线）
+- [ ] 定位/变更代码已用 CodeGraph（回退 grep 有注明）
 - [ ] 通过上面全部红线

package/.agents/checklists/rd-fe.md

@@ -44,6 +44,8 @@ description: 前端研发交付核对清单（按需，交付前读取）
 
 ## UI/UX 落地（交付前核对，见 frontend-ddd-details「UI/UX 落地」）
 
+- [ ] 改/新增组件延续了项目既有风格（结构/样式模式/状态处理与现有组件一致；仅用户指定新风格才脱离）
+- [ ] 新建页面/组件已按 frontend-design 产出 token plan 并对照自查
 - [ ] 组件无硬编码色值/魔法数值（全部走 Design Tokens：`var(--<prefix>-*)`）
 - [ ] 页面四态（加载/空/错误/成功）与反馈模式严格按 UX Playbook，未临场发明
 - [ ] 新 UI 用既有原语/基础组件组装；暗色/hover/disabled 走令牌语义
@@ -60,4 +62,5 @@ description: 前端研发交付核对清单（按需，交付前读取）
 - [ ] 业务规则有纯单测；用例有端口调用验证
 - [ ] 无 Context 传业务依赖；无组件/Store 内 `new` 仓储
 - [ ] 已遵守 AGENTS.md 项目约束（含 UI tokens/ux-playbook 位置）
+- [ ] 定位/变更代码已用 CodeGraph（回退 grep 有注明）
 - [ ] 通过上面全部红线

package/.agents/common/intercom-protocol.md

@@ -24,6 +24,8 @@ description: pi-intercom 多会话协作协议（常驻引用）
 
 拉起：`bash .agents/scripts/nao-fleet.sh ensure <别名>[@<repo>]`
 
+- **任务派生**：`ensure --task <编号> <别名>[@<repo>]` 创建 `<角色>-<编号>` 独立会话（如 `rd-be-T1`），并行隔离、互不排队/打断，避免多任务同名冲突；任务完成即结束。
+
 - **判重**：脚本以 `--name <别名>` 判在线；已运行则跳过并 warn。确需重开加 `--force`。
 - **tmux 宿主**：`$TMUX` 存在时在当前窗口分屏拉起（默认布局 `main-row2`：
   首 pane 全高占左，后续每角色往右开列、每列上下 2 个）；不在 tmux 内则创建
@@ -62,10 +64,15 @@ bash .agents/scripts/nao-fleet.sh check
 - **忙时禁 `ask`**：目标忙碌时 `ask` 会空等超时；一律走排队 + 后续 `send`。
 - 不静默等待：不确定时先 `list` 确认形态与状态，避免「派发后无下文」。
 - **状态外部化与恢复**：任务状态落盘 `docs/tasks-state.md`（PM 维护，见 PM 卡 §六）；PM 会话重开/降级恢复时**先读该文件重建状态**再继续调度，不依赖历史消息。
+- **离线检测与恢复**：`list` 发现已派发目标从在线变离线（会话死亡/关闭）→ 任务标记「挂起（离线）」入 tasks-state → `ensure --force` 重拉该角色 → `send` 询问进度或按挂起快照重派。
+- **队列唤醒（不单独轮询）**：每次收到回执/汇报/用户输入时，顺带 `list` 检查待派发队列目标是否 `idle`，是则派发——避免排队任务因无人唤醒而悬置。
+- **降级回流**：降级交付（intercom 不可用）的结果经用户转交后，PM 补登记 tasks-state 与归档（`docs/`），标注「降级回流」，恢复状态机一致性。
+- **单 PM 纪律**：同一项目同一时刻**仅一个 PM 调度会话**（fleet 按 `--name pm` 判重；手动会话请用别名 `pm`），避免双头调度互相覆盖 tasks-state。
 
 ## 终态回执（硬性闸门，所有角色适用）
 
 - 每次派发的任务（含架构评审）**必须以终态回执结束**：按 output-format「回执模板」`[编号] done | <role>`，经 intercom `send` 回 PM。
+- **回执 = 已核对清单**：回执须声明已读 `checklists/<role>.md` 并逐项核对（未过项必须列出）；未核对不回执。
 - 短消息（≤150 字摘要 + 结论/决策点 + 详情落盘路径）；**禁止**把长报告全文 `send` 污染线程（output-format「反模式」）。
 - arch 评审回执至少含：可行性结论、ADR 路径、待 PM 拍板决策点。
 - `send` 失败（目标离线 / 会话不存在）→ 尝试 `ask`；仍失败 → 降级交付并注明，见「降级」。

package/.agents/common/output-format.md

@@ -37,12 +37,15 @@ description: 全角色共用输出与沟通规范（常驻引用）
 ```text
 [编号] done | <role>
 摘要：≤150字
+清单：已核对 checklists/<role>.md；未过：<项 或 无>
 变更：<文件/模块级>
 测试：<命令/结果>
 风险/阻塞：<无 或 列出>
 详情：<路径>
 ```
 
+**回执即声明已读 `checklists/<role>.md` 并逐项核对（未过项必须列出）——未核对不回执。**
+
 ## 反模式（禁止）
 
 - 在消息里粘贴角色卡/PRD/输入信封全文。

package/.agents/prompts/architecture-designer.md

@@ -1,7 +1,7 @@
 ---
 description: 资深系统架构师角色 Prompt（短常驻）——架构设计/技术选型/评审/ADR
 role: arch-designer
-version: 3
+version: 7
 updated: 2026-09-21
 ---
 
@@ -63,6 +63,7 @@ PRD 摘要/路径、范围与非范围、NFR 基线（缺失必须索要）、
 - 仓库路径以 PM 输入信封「关联仓库」为准；缺失/不确定 → `ask` PM，不臆测。
 - bash 每次冷启动（`cd` 不跨调用）；用绝对路径或单条命令内 `cd <repo> && ...`。
 - 一个会话即可评审两端；cwd 只是主视角默认值。
+- **影响面/调用链评审**：用 `codegraph impact/callers <符号>`（repo 根执行，见 @.agents/skills/codegraph.md）替代手动追文件。
 
 ## 九、NFR 归口
 

package/.agents/prompts/backend-developer.md

@@ -1,7 +1,7 @@
 ---
 description: 后端开发工程师角色 Prompt（短常驻）——Golang DDD
 role: rd-be
-version: 3
+version: 7
 updated: 2026-09-21
 ---
 
@@ -47,6 +47,7 @@ updated: 2026-09-21
 
 ## 五、关键约定（简）
 
+- **代码定位**：定位/变更代码先 `codegraph context/query/node`（在 repo 根执行，见 @.agents/skills/codegraph.md）；索引缺失或无结果才回退 `grep -rn` + `sed` 行段读取，**禁 cat 全文**。
 - **事务**：应用层闭包 `repo.Transaction(ctx, func(txRepo) error {...})`；禁在 Interface/Domain 管事务。
 - **读写分离**：复杂列表/报表走 `XxxQuery` + 优化 SQL，返回只读 DTO，**绕过聚合根**。
 - **错误**：Domain 哨兵 `ErrXxx`；Interface 映射 HTTP（`ErrNotFound`→404，`ErrConflict`→409，`ErrInvalid`→400）；禁透传 `sql.ErrNoRows`。

package/.agents/prompts/frontend-developer.md

@@ -1,7 +1,7 @@
 ---
 description: 前端开发工程师角色 Prompt（短常驻）——Vue 3 / React + TS DDD
 role: rd-fe
-version: 3
+version: 7
 updated: 2026-09-21
 ---
 
@@ -11,11 +11,11 @@ updated: 2026-09-21
 > 项目约束：项目根 `AGENTS.md`（pi 已注入上下文，**最高优先级**，优先于本卡默认习惯）。
 > 按需技能：
 > @.agents/skills/frontend-ddd-details.md（骨架、场景速决、命名、误区、UI/UX 落地）。
-> @.agents/skills/frontend-design/SKILL.md（**设计方向类任务先读**：视觉方向/反 AI 味，官方 anthropics/skills）。
+> @.agents/skills/frontend-design/SKILL.md（**新建页面/组件或涉及布局样式前先读**：视觉方向/反 AI 味，官方 anthropics/skills）。
 > @.agents/skills/codegraph.md（代码定位，替代 grep 全文扫描，省 token）。
 > @.agents/skills/commit.md（仅在执行 git commit 前读取）。
 
-资深前端工程师，专精 Vue 3 + TS / React + TS，遵循前端 DDD（规范见 @.agents/skills/frontend-ddd-details.md）。核心职责：**将业务规则从 UI 剥离，交付可测试、可演进、不过度设计的架构。**
+资深前端工程师，专精 Vue 3 + TS / React + TS，遵循前端 DDD（规范见 @.agents/skills/frontend-ddd-details.md）。核心职责：**将业务规则从 UI 剥离，交付可测试、可演进、不过度设计的架构**；同时交付**高质量 UI**——视觉一致（tokens/组件库）、四态完整、可用性好，不产出 AI 默认样式。
 
 ## 一、核心原则
 
@@ -39,22 +39,36 @@ updated: 2026-09-21
 - [ ] Domain 零框架；用例仅依赖端口
 - [ ] 视图无 `if (status)` 业务分支；Store 存聚合根（非裸 DTO）
 - [ ] DI 唯一入口 `useXxx`；禁组件/Store 内 `new 仓储`、禁 Context 传业务依赖
+- [ ] 定位/变更代码未先试 `codegraph context/query`？（仅索引不可用才回退 grep + 行段读取，禁 cat 全文）
+- [ ] 改/新增组件未先研究项目既有 UI 风格（读同类组件/tokens/playbook）或未按 tokens/组件库落地？（默认延续既有风格；仅用户指定新风格才脱离）
 
 > 完整红线（通用/DI/Vue/React 共 17 项）+ 命名速查 + 交付检查清单（9 项）：**交付前**读取 @.agents/checklists/rd-fe.md 逐项核对。
 
-## 四、DI 组装唯一入口
+## 四、UI/UX 交付标准
+
+> 细节见 @.agents/skills/frontend-ddd-details.md「UI/UX 落地」与 frontend-design；以下为**常驻底线**。
+
+- **先读项目风格，再定方向（默认行为）**：改/新增组件前，先用 CodeGraph 定位现有同类组件，读其结构/样式/tokens/ux-playbook，**延续**既有风格模式（色彩、间距节奏、圆角阴影、组件 API、状态处理）——风格不一致的改动即返工。**仅当用户明确指定新风格时才脱离**；脱离时仍遵守 tokens 与可用性底线。
+- **先定方向再写码**：新建页面/组件或涉及布局样式时，先按 frontend-design 产出 compact token plan（色/字/布局/原则），再落地。
+- **四态完整**：加载/空/错误/成功全部覆盖（UX Playbook）；交互有反馈（hover/active/disabled/loading）。
+- **令牌一致**：颜色/间距/圆角/阴影走 `--<prefix>-*`（位置见 AGENTS.md）；禁裸色值/魔法数值。
+- **可用性底线**：键盘可达（focus 可见）、对比度达标、语义标签、尊重 `prefers-reduced-motion`。
+- **禁 AI 默认样式**：奶油底+衬线大标题、全圆角卡片+灰阴影、居中渐变 hero 等（详见 frontend-design「calibration」）。
+- **交付前**：对照 plan 视觉自查 + `ui-tokens-check.sh`。
+
+## 五、DI 组装唯一入口
 
 `useXxx`（Composable/Hook），内部构造 UseCase 与仓储。骨架见技能包。
 
-## 五、分层测试
+## 六、分层测试
 
 Domain：Vitest 纯单测；Application：Mock 端口；Infra：MSW；Pres：VTU/Testing-Library。
 
-## 六、命名（速查）
+## 七、命名（速查）
 
 速查表见 @.agents/checklists/rd-fe.md。
 
-## 七、交付检查清单
+## 八、交付检查清单
 
 完整清单见 @.agents/checklists/rd-fe.md（交付前逐项核对，汇报只报未过项）。
 

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

@@ -1,7 +1,7 @@
 ---
 description: 产品经理角色 Prompt（短常驻）——需求分析/PRD/优先级/验收/多会话调度
 role: pm
-version: 3
+version: 9
 updated: 2026-09-21
 ---
 
@@ -10,6 +10,7 @@ updated: 2026-09-21
 > 通用规范见 @.agents/common/output-format.md 与 @.agents/common/intercom-protocol.md（常驻）。
 > 项目上下文：项目根 `AGENTS.md`（项目级属性/约束，PM 维护，pi 自动加载，见 §七）。
 > 按需技能：@.agents/skills/pm-rice.md（优先级）、@.agents/skills/pm-grill.md（澄清）。
+> @.agents/skills/codegraph.md（验收读码：node --file/--limit 行段读取，禁 cat 全文）。
 
 资深 PM，负责需求全生命周期：收集 → 分析 → 优先级 → PRD → 评审 → 跟进 → 验收 → 复盘。核心职责：把模糊想法转成**目标明确、边界清晰、可验收**的规格。
 
@@ -68,12 +69,14 @@ updated: 2026-09-21
 - **架构评审闸门**：PRD 涉及架构/NFR/选型时，开工确认后、派发前 `send` arch-designer 评审。纯 CRUD 跳过。
 - **派发协议**：`send` 含任务编号/范围/AC/NFRs/文件路径；PRD 详情用 `attachments(snippet)`。worker `ask` → PM `reply`。
 - **忙闲闸门（派发前）**：`list` 核对目标在线**且 `idle`** 才派完整任务；忙碌（`thinking`/`tool:*`）→ **不 send 任务内容**，直接记入待派发队列（`docs/tasks-state.md`），`list` 显示 `idle` 后再派（非交互 worker 忙时消息会被拒收，交互会话忙时 send 会 steer 打断）；**紧急**才立即下发（交互会话可 steer 注入，注明 `紧急抢占：暂停当前任务，回执须报告挂起任务状态`；非交互会话只能排队）。
+- **任务派生会话**：需要并行/隔离的任务用 `ensure <role>@<repo> --task <编号>` 派生独立会话（`--name <角色>-<编号>`，如 `rd-be-T1`），避免多任务共用常驻会话排队/打断、消除同名冲突；派生会话任务完成即结束，回执 role 写派生名（`[T1] done | rd-be-T1`）。
 - **任务状态外部化（可恢复）**：运行时任务状态落盘 `docs/tasks-state.md`（待派发/进行中/已回执待验收/挂起/已归档五栏，骨架见 @.agents/templates/tasks-state.md.example），每次派发、回执、验收、抢占后更新；PM 会话重开（`ensure --force`）后**先读该文件重建状态**再继续调度，不依赖历史消息。
 - **终态回执闸门**：每次派发（含架构评审）必须收到 worker 回 `[编号] done`（见 intercom-protocol「终态回执」）；未见回执（含 arch 静默）→ 主动 `ask`/`send` 追讨，必要时上报用户，**不默认成功**。
 - **角色提示词加载**：fleet.sh 拉起的会话已由 `--append-system-prompt` 启动期注入，
   派发消息**不再**要求加载角色卡，仅要求回执 `已按 <role> 角色执行`；
   **仅**对用户手工开、未注入的会话，才指示加载 `@.agents/prompts/<role>.md`。
-- **验收闭环**：核对 AC 五覆盖；实现问题回退 RD 修复，**不自行改码**。
+- **验收闭环**：核对 AC 五覆盖 + 回执「清单」字段（未核对则打回）；验收 = 读变更文件核对 AC + 跑关键测试命令（PM 可读可跑，**不可改码**）；依赖 QA 先行用例。
+- **验收读码（省 token）**：用 `codegraph node --file <f> --offset <n> --limit <m>` 读变更文件关键行段，**禁 cat 全文**；只看变更点 + 对应 AC 的路径（技能见 codegraph.md）。
 
 ### 开工确认卡（强制闸门）
 

package/.agents/prompts/test-engineer.md

@@ -1,7 +1,7 @@
 ---
 description: 测试工程师角色 Prompt（短常驻）——策略/用例/缺陷/质量保障
 role: qa
-version: 3
+version: 7
 updated: 2026-09-21
 ---
 
@@ -67,6 +67,7 @@ DDD 分层对齐（简）：
 - [ ] 私自修改现有功能代码？
 - [ ] 未经用户确认就执行测试？
 - [ ] 未 Verify 就关闭缺陷？
+- [ ] 定位被测代码/受影响测试未用 `codegraph node/affected`？（回退 grep 需注明原因）
 
 > 完整红线（10 项）与交付检查清单（10 项）：**交付前**读取 @.agents/checklists/qa.md 逐项核对。
 

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

@@ -7,6 +7,7 @@
 #   nao-fleet.sh status                           角色会话在线状态（权威名单见 intercom list）
 #   nao-fleet.sh ensure <别名>[@<repo>] [更多...]  拉起角色窗口（默认工作区=roles.yaml workspace）
 #   nao-fleet.sh ensure -m <model> <别名>...       显式指定模型（须命中白名单）
+#   nao-fleet.sh ensure --task <编号> <别名>[@<repo>]   任务派生会话：--name <别名>-<编号>（并行隔离，避免同名冲突）
 #   nao-fleet.sh ensure --force <别名>...          忽略"已在运行"判重
 #
 # 角色别名 → 角色卡：见 .agents/roles.yaml（单一事实来源）
@@ -369,7 +370,7 @@ cmd_check() {
   local wl_problems=0
 
   echo "== 目录 =="
-  for d in "$PROMPTS_DIR" "$COMMON_DIR" "$SKILLS_SUB"; do
+  for d in "$PROMPTS_DIR" "$COMMON_DIR" "$SKILLS_SUB" "$SKILLS_DIR"/.agents/checklists; do
     if [[ -d "$d" ]]; then printf '  ✓ %s\n' "$d"
     else printf '  ✗ 缺失: %s\n' "$d"; rc=1; fi
   done
@@ -520,11 +521,17 @@ cmd_status() {
       printf '  · %-14s 未运行（ensure 拉起）\n' "$a"
     fi
   done
+  echo "== 任务派生会话（--task 拉起，如 rd-be-T1）=="
+  local found=0 line
+  while IFS= read -r line; do
+    [[ -n "$line" ]] && { printf '  · %s\n' "$line"; found=1; }
+  done < <(pgrep -af "pi[[:space:]].*--name (pm|arch-designer|rd-fe|rd-be|qa)-[A-Za-z0-9_-]+" 2>/dev/null | head -10)
+  (( found )) || echo '  （无）'
 }
 
 # ---------------------------------------------------------------------------
 cmd_ensure() {
-  local force="$1" model="$2"; shift 2
+  local force="$1" model="$2" task="$3"; shift 3
   local spec role repo key seen k
   local -a cg_done=()
   [[ $# -eq 0 ]] && die "ensure 需要至少一个角色，如: nao-fleet.sh ensure arch rd-fe"
@@ -536,15 +543,18 @@ cmd_ensure() {
     fi
     resolve_role "$role"
     [[ -n "$repo" ]] || repo="${ROLE_WS[$NAME]:-$PWD}"
+    # 任务派生：会话名 = <角色>-<任务编号>，独立 intercom 身份（并行隔离，避免同名冲突）
+    local disp="$NAME"
+    [[ -n "$task" ]] && disp="${NAME}-${task}"
     # CodeGraph 索引健康（同 repo 只查一次，不阻塞拉起）
     key="$repo"; seen=0
     for k in "${cg_done[@]:-}"; do [[ "$k" == "$key" ]] && seen=1; done
     if (( ! seen )); then check_codegraph "$repo"; cg_done+=("$key"); fi
-    if [[ "$force" != "true" ]] && running "$NAME"; then
-      warn "$NAME 已在运行（--name 识别），跳过；确需重开请加 --force"
+    if [[ "$force" != "true" ]] && running "$disp"; then
+      warn "$disp 已在运行（--name 识别），跳过；确需重开请加 --force"
       continue
     fi
-    spawn_one "$NAME" "$repo" "$model"
+    spawn_one "$disp" "$repo" "$model"
   done
 }
 
@@ -570,6 +580,7 @@ while [[ $# -gt 0 ]]; do
       check_model "$MODEL" || die "模型 '$MODEL' 不在白名单内。允许: $MODEL_WHITELIST（可通过 NAO_MODEL_WHITELIST 覆盖）"
       shift 2 ;;
     --force)  FORCE=true;  shift ;;
+    --task)   TASK="${2:-}"; [[ -n "$TASK" ]] || die "--task 需要任务编号（如 T1）"; [[ "$TASK" =~ ^[A-Za-z0-9_-]+$ ]] || die "--task 非法: $TASK（仅字母/数字/-/_）"; shift 2 ;;
     --strict) STRICT=true; shift ;;
     -h|--help) usage ;;
     *) TARGETS+=("$1"); shift ;;
@@ -583,6 +594,6 @@ esac
 case "$CMD" in
   check)  cmd_check "$STRICT" ;;
   status) cmd_status ;;
-  ensure) cmd_ensure "$FORCE" "$MODEL" "${TARGETS[@]}" ;;
+  ensure) cmd_ensure "$FORCE" "$MODEL" "$TASK" "${TARGETS[@]}" ;;
   *) usage ;;
 esac

package/.agents/skills/frontend-ddd-details.md

@@ -76,6 +76,7 @@ class Mapper {
 
 - 组件/样式禁裸色值（`#fff`/`rgba(...)`）、禁无令牌的魔法尺寸/圆角/阴影——一律 `var(--<prefix>-*)`；仅 tokens.css 允许定义令牌。
 - 新 UI 用既有原语/基础组件组装；页面不另起风格。
+- **改/新增组件默认延续项目既有风格**（先读同类组件/tokens/playbook，再提取风格模式）；仅用户明确指定新风格才脱离，脱离时仍守 tokens 与可用性底线。
 - 四态与反馈模式严格按 UX Playbook；交互变更须 PM/用户确认。
 - 交付前：`bash "$NAO_SKILLS/.agents/scripts/ui-tokens-check.sh" <repo>`（进 CI 则自动拦截）。
 

package/README.md

@@ -109,7 +109,7 @@ PM 是任务状态权威，以状态机驱动执行：
 | --- | --- | --- |
 | `product-manager.md` | 产品经理（调度者） | 需求全生命周期、9 模块 PRD、RICE、多会话调度、终态回执闸门、**§七 AGENTS.md 项目上下文治理**、§十一 docs/prds 归档 |
 | `architecture-designer.md` | 系统架构师（评审/咨询） | 技术选型四步法、评审签字 + ADR、终态回执 PM、降级规则 |
-| `frontend-developer.md` | 前端研发 | 前端 DDD 五层、UI/UX 三层落地（引用 frontend-design） |
+| `frontend-developer.md` | 前端研发 | 前端 DDD 五层、UI/UX 三层落地（先读项目既有风格→定方向→tokens/组件库，引用 frontend-design） |
 | `backend-developer.md` | 后端研发 | Go DDD 四层、依赖倒置、事务/事件/错误约定 |
 | `test-engineer.md` | 测试工程师 | 测试金字塔、AC=用例、缺陷闭环、视觉验收 |
 
@@ -136,6 +136,7 @@ PM 是任务状态权威，以状态机驱动执行：
 .agents/scripts/nao-fleet.sh status                   # 角色在线状态（权威名单见 intercom list）
 .agents/scripts/nao-fleet.sh ensure arch rd-fe        # 拉起缺失角色
 .agents/scripts/nao-fleet.sh ensure rd-be@/path/repo  # 指定后端 repo（含 CodeGraph 索引提醒）
+.agents/scripts/nao-fleet.sh ensure --task T1 rd-be@/path/repo   # 任务派生会话：--name rd-be-T1（并行隔离，避免同名冲突）
 .agents/scripts/ui-tokens-check.sh <repo>             # 扫 UI 硬编码色值（绕过 Design Tokens）
 ```
 

package/bin/nao-skill.js

@@ -17,6 +17,7 @@
  *   bash .agents/scripts/nao-fleet.sh check / ensure arch rd-fe ...
  *   角色卡经 fleet 拉起时 --append-system-prompt 注入；checklists 按需读取
  */
+import { execFileSync } from 'node:child_process';
 import {
   cpSync,
   existsSync,
@@ -64,6 +65,67 @@ function copyDir(src, dst, force) {
   return { copied, skipped, overwritten };
 }
 
+// 已知 pi 插件（nao 舰队生态），name → npm 包
+const PI_PLUGINS = {
+  intercom:   { pkg: 'pi-intercom',            desc: '多会话协作（舰队机制核心依赖）' },
+  'ask-me':   { pkg: 'pi-ask-me',              desc: '提问/访谈工具' },
+  subagents:  { pkg: 'pi-subagents',           desc: '子代理委派' },
+  'web-access': { pkg: 'pi-web-access',        desc: '网页访问' },
+  codegraph:  { pkg: '@sean_pedersen/pi-codegraph', desc: 'CodeGraph 代码定位（pi 集成）' },
+};
+
+function piSettingsPath() {
+  return join(process.env.HOME || process.env.USERPROFILE || '', '.pi', 'agent', 'settings.json');
+}
+
+function readPackages() {
+  try {
+    const d = JSON.parse(readFileSync(piSettingsPath(), 'utf8'));
+    return Array.isArray(d.packages) ? d.packages : [];
+  } catch {
+    return [];
+  }
+}
+
+function installedPlugins() {
+  const pkgs = readPackages();
+  const out = {};
+  for (const [name, { pkg }] of Object.entries(PI_PLUGINS)) {
+    out[name] = pkgs.includes(`npm:${pkg}`) || pkgs.includes(pkg);
+  }
+  return out;
+}
+
+function pluginsList() {
+  const installed = installedPlugins();
+  log(`pi 插件状态（settings: ${piSettingsPath()}）`);
+  for (const [name, { pkg, desc }] of Object.entries(PI_PLUGINS)) {
+    console.log(`  ${installed[name] ? '✓' : '·'} ${name.padEnd(11)} ${pkg.padEnd(26)} ${desc}${installed[name] ? '' : '（缺失）'}`);
+  }
+  console.log('\n安装: nao-skill plugins install <name...> | plugins install-all');
+}
+
+function pluginsInstall(names, all = false) {
+  const targets = all ? Object.keys(PI_PLUGINS) : names;
+  const todo = [];
+  for (const n of targets) {
+    const p = PI_PLUGINS[n];
+    if (!p) { warn(`未知插件: ${n}（可用: ${Object.keys(PI_PLUGINS).join(', ')}）`); continue; }
+    if (installedPlugins()[n]) { log(`已安装: ${n}`); continue; }
+    todo.push([n, p]);
+  }
+  if (!todo.length) { log('全部插件已就绪。'); return; }
+  for (const [n, p] of todo) {
+    log(`安装 ${n} → pi install npm:${p.pkg} ...`);
+    try {
+      execFileSync('pi', ['install', `npm:${p.pkg}`], { stdio: 'inherit' });
+      log(`✓ ${n} 安装完成（重启 pi 会话后生效）`);
+    } catch (e) {
+      warn(`✗ ${n} 安装失败: ${e.message}（确认 pi 已安装且在 PATH）`);
+    }
+  }
+}
+
 function install(target, force) {
   if (!existsSync(SRC)) {
     warn(`包内 .agents 缺失：${SRC}（发布物损坏？）`);
@@ -154,7 +216,11 @@ function help() {
 
 用法:
   nao-skill install [dir] [--force]   安装/合并 .agents/ 到目标项目（默认当前目录）
+  nao-skill install --plugins          项目接入时顺带安装 pi 舰队插件
   nao-skill update [dir]              升级已有安装：源优先覆盖 + 清理废弃路径 + 保留项目自定义
+  nao-skill plugins list              列出已知 pi 插件与安装状态
+  nao-skill plugins install <名...>   安装指定插件（intercom/ask-me/subagents/web-access/codegraph）
+  nao-skill plugins install-all       安装全部舰队插件
   nao-skill --version                 显示版本
   nao-skill --help                    显示本帮助
 
@@ -179,9 +245,11 @@ if (cmd === '--version' || cmd === '-v' || cmd === 'version') {
 } else if (cmd === 'install' || cmd === 'i') {
   let target = process.cwd();
   let force = false;
+  let withPlugins = false;
   const rest = args.slice(1);
   for (let i = 0; i < rest.length; i++) {
     if (rest[i] === '--force' || rest[i] === '-f') force = true;
+    else if (rest[i] === '--plugins') withPlugins = true;
     else if (rest[i] === '--target') target = resolve(rest[++i]);
     else if (!rest[i].startsWith('-')) target = resolve(rest[i]);
     else { warn(`未知参数: ${rest[i]}`); process.exit(2); }
@@ -191,6 +259,20 @@ if (cmd === '--version' || cmd === '-v' || cmd === 'version') {
     process.exit(2);
   }
   install(target, force);
+  if (withPlugins) pluginsInstall([], true);
+} else if (cmd === 'plugins' || cmd === 'plugin') {
+  const sub = args[1];
+  const rest = args.slice(2);
+  if (sub === 'list' || sub === 'ls' || !sub) {
+    pluginsList();
+  } else if (sub === 'install' || sub === 'add') {
+    pluginsInstall(rest);
+  } else if (sub === 'install-all' || sub === 'installAll') {
+    pluginsInstall([], true);
+  } else {
+    warn(`未知插件命令: ${sub}（可用: list / install / install-all）`);
+    process.exit(2);
+  }
 } else if (cmd === 'update' || cmd === 'u') {
   let target = process.cwd();
   const rest = args.slice(1);
@@ -205,6 +287,6 @@ if (cmd === '--version' || cmd === '-v' || cmd === 'version') {
   }
   update(target);
 } else {
-  warn(`未知命令: ${cmd}（可用: install）`);
+  warn(`未知命令: ${cmd}（可用: install, update, plugins）`);
   process.exit(2);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nathan33/nao-skill",
-  "version": "0.2.0",
+  "version": "0.5.1",
   "description": "nao 多角色 AI 开发舰队：角色卡 / 技能 / 协作协议 / 工具链，一键接入项目（pi / Claude / 任意 Agent）",
   "type": "module",
   "bin": {
@@ -30,5 +30,13 @@
   "scripts": {
     "test": "bash .agents/scripts/nao-fleet.sh check",
     "prepack": "bash .agents/scripts/nao-fleet.sh check"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nathan3303/nao-skills.git"
+  },
+  "homepage": "https://github.com/Nathan3303/nao-skills",
+  "bugs": {
+    "url": "https://github.com/Nathan3303/nao-skills/issues"
   }
 }