@nathan33/nao-skill 0.19.1 → 0.19.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.agents/checklists/pm.md
CHANGED
|
@@ -62,7 +62,7 @@ description: PM 交付核对清单（按需，交付/派发前读取）
|
|
|
62
62
|
- [ ] 输出里有 `warn`/`error`/`pending approval`/`N vulnerabilities` 却判完成，或遗留项未走三出口（「先放着」不算出口）？（见 @.agents/skills/task-completion.md）
|
|
63
63
|
- [ ] 降级（无 `gh` / 无远端）未在 `tasks-state` 与回执中标注？
|
|
64
64
|
|
|
65
|
-
## 交付检查清单（完整
|
|
65
|
+
## 交付检查清单（完整 41 项）
|
|
66
66
|
|
|
67
67
|
- [ ] 目标/边界/验收三件事齐备
|
|
68
68
|
- [ ] 证据 + 5 Whys 已产出
|
|
@@ -90,6 +90,7 @@ description: PM 交付核对清单（按需，交付/派发前读取）
|
|
|
90
90
|
- [ ] 项目 `AGENTS.md` 已建立/同步（项目级属性与约束，见 @.agents/skills/pm-operations.md §四）
|
|
91
91
|
- [ ] worker 回执含**全量**门禁精确数字（命令 + exit code + 文件数/例数/红数）；PM 仅核对数字 + 读变更文件 + 异常才抽查（未重复跑）
|
|
92
92
|
- [ ] 派发消息只给引用路径（`docs/...md#section`），无 PRD/方案全文或附件传全文
|
|
93
|
+
- [ ] 派发含「根因 + 修复方向」的指令已附**一条已执行的实测命令与输出**（无实测只能派「诊断/复现任务」，不得先给方向）
|
|
93
94
|
- [ ] 派发时已声明回执级别（未声明默认 `done(lite)`；有阻塞/风险/需决策已要求 `done(full)`）；模板已按需读取 `@.agents/checklists/comm-templates.md`
|
|
94
95
|
- [ ] 用户口头约束已**当场落盘**（`AGENTS.md` 项目级 / PRD「变更治理」），未等归档
|
|
95
96
|
- [ ] 归档前已更新接续快照 + 记录会话体检（归档后按 @.agents/skills/pm-operations.md §三 重开会话）
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: 产品经理角色 Prompt（短常驻）——需求分析/PRD/优先级/验收/多会话调度
|
|
3
3
|
role: pm
|
|
4
|
-
version:
|
|
5
|
-
updated: 2026-10-
|
|
4
|
+
version: 27
|
|
5
|
+
updated: 2026-10-28
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# 产品经理（PM）
|
|
@@ -66,7 +66,7 @@ updated: 2026-10-27
|
|
|
66
66
|
- **会话生命周期（PM 专属）**：按批次边界重开（归档完成 / 用户换需求 / `/session` contextTokens 超窗口 40%）+ 落盘接续 + 重开后**回读确认**；细则见 @.agents/skills/pm-operations.md §三。
|
|
67
67
|
- **状态外部化**：任务状态落 `docs/tasks-state.md`（含接续快照），每次派发/回执/验收后更新；重开先读它。
|
|
68
68
|
- **回收与残留**：派生会话验收通过即 `close --task <编号> <别名>`；常驻会话不回收，需重开时 `ensure --force`；`status` 残留即核对回收。
|
|
69
|
-
- **派发协议（省 token）**：一条消息给 `编号 + 范围 + 引用路径（docs/...md#section）+ AC 编号 + 回执级别 + 需求分支`；**不贴 PRD/方案全文、不用 `attachments`**；worker `ask` → PM `reply
|
|
69
|
+
- **派发协议（省 token）**：一条消息给 `编号 + 范围 + 引用路径（docs/...md#section）+ AC 编号 + 回执级别 + 需求分支`；**不贴 PRD/方案全文、不用 `attachments`**；worker `ask` → PM `reply`。**根因类派发须附实测**：消息含「根因 + 修复方向」时，必附**一条已执行的实测命令与其输出**（不是推测、不是转述他人结论）；无实测只能派「诊断 / 复现任务」，不得先给修复方向（T529 教训：无实测的根因被 QA A/B 推翻）。
|
|
70
70
|
|
|
71
71
|
## 七、AGENTS.md 项目上下文治理（PM 独有职责）
|
|
72
72
|
|
|
@@ -92,6 +92,7 @@ updated: 2026-10-27
|
|
|
92
92
|
- [ ] PM 以「亲自探查技术实现」替代转角色、并据此形成 PRD 前提？（§九 技术调研边界）
|
|
93
93
|
- [ ] 派发消息贴了 PRD/方案全文、或用 `attachments` 传全文？（应给引用路径，worker 自己读文件）
|
|
94
94
|
- [ ] 跨批次未重开会话、未更新接续快照？（长上下文丢红线/闸门；见 §六 生命周期）
|
|
95
|
+
- [ ] 派发含「根因 + 修复方向」的指令未附**一条已执行的实测命令与输出**？（无实测只能派「诊断/复现任务」，不得先给方向；§六 派发协议）
|
|
95
96
|
- [ ] 用外部调研（文章/竞品/开源实现）替代 arch 技术取舍，或把外部做法写成既定技术前提？（§九 + @.agents/skills/research.md）
|
|
96
97
|
- [ ] PM 改源码/测试/构建配置，或手改冲突内容？（应转 worker；PM 只做仓库治理与发布）
|
|
97
98
|
- [ ] PM 亲自合并 PR / `push` main？（合并由 RD 执行，PM 只验收授权；§十三）
|
|
@@ -103,7 +104,7 @@ updated: 2026-10-27
|
|
|
103
104
|
- [ ] 输出里有 `warn`/`error`/`pending approval`/`N vulnerabilities` 却判完成？（`exit 0` ≠ 完成，见 @.agents/skills/task-completion.md §三）
|
|
104
105
|
- [ ] 降级（无 `gh` / 无远端）未在 `tasks-state` 与回执中标注？
|
|
105
106
|
|
|
106
|
-
> 完整红线（33 项）与交付检查清单（
|
|
107
|
+
> 完整红线（33 项）与交付检查清单（41 项）：**交付/派发前**读取 @.agents/checklists/pm.md 逐项核对。
|
|
107
108
|
|
|
108
109
|
## 十一、交付检查清单
|
|
109
110
|
|
|
@@ -53,7 +53,7 @@ PM 在**立项 / 终签 / 发布**时读取；RD 在**起分支 / 开 PR / 合
|
|
|
53
53
|
|
|
54
54
|
- 版本号：SemVer，PM 按批次范围定（feat→MINOR / fix→PATCH / 破坏性→MAJOR）；项目 `AGENTS.md` 有约定则从之。
|
|
55
55
|
- 门禁：AC 全过 + 验收闭环 + main 门禁全绿 + 工作区干净 + PR 已合并。
|
|
56
|
-
-
|
|
56
|
+
- **发布前置（严格闸门 · 双环境）**：若仓库提供 `test:t4:full:dual` 脚本，发布前须先 `npm run test:t4:full:dual` **rc=0**（**两组**= `$TMUX_PANE` 已设 / `env -u TMUX_PANE`；判据 = **两组 SKIP 计数与 DEGRADE 计数均为 0，且非白名单 NOTE 计数为 0**，`SKIP`/`DEGRADE`/非白名单 `NOTE` 即 FAIL）。仅有 `test:t4:full`（单环境）的仓库退用 `npm run test:t4:full` rc=0；双环境 gate 误红时可临时回落单环境并记台账。
|
|
57
57
|
- **优先 `gh`**：`gh release create <tag> --title "vX.Y.Z" --notes-file docs/releases/<version>.md`（**标题口径（强约束）：@.agents/common/release-notes.md** —— 标题仅裸版本号，描述进正文首段）。
|
|
58
58
|
- 探测：`gh auth status` 按 **exit code** 判定（`keyring` 警告但 exit 0 **仍可用**，可 `gh api user` 复核）；**不自动 `gh auth login`**（涉用户凭证）。
|
|
59
59
|
- release notes 落盘 `docs/releases/<version>.md`（**写作规范（强约束）：@.agents/common/release-notes.md** —— 面向用户「本次更新」置顶、内部编号 / 文件名 / 属性名一律下沉「技术细节」、正文不用表格；骨架见 @.agents/templates/release-notes.md.example）。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nathan33/nao-skill",
|
|
3
|
-
"version": "0.19.
|
|
3
|
+
"version": "0.19.2",
|
|
4
4
|
"description": "nao 多角色 AI 开发舰队：角色卡 / 技能 / 协作协议 / 工具链，一键接入项目（pi / Claude / 任意 Agent）",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -46,6 +46,7 @@
|
|
|
46
46
|
"test:agents": "bash .agents/scripts/nao-fleet.sh check && npm run check:agents",
|
|
47
47
|
"test:t4": "bash tests/t4/run.sh",
|
|
48
48
|
"test:t4:full": "T4_ALLOW_MISSING=0 T4_REQUIRE_FULL=1 bash tests/t4/run.sh",
|
|
49
|
+
"test:t4:full:dual": "bash tests/t4/run-dual.sh",
|
|
49
50
|
"check:agents": "tsc -p tsconfig.agents.json",
|
|
50
51
|
"prepack": "npm run test:agents"
|
|
51
52
|
},
|