Skip to content

docs(pm-dispatch,os-dev): 发现类 issue 纪律——查重、归挂、finding 分级与分诊出水口 (#4949) - #4955

Open
xuyushun441-sys wants to merge 2 commits into
mainfrom
claude/issue-4949-findings-discipline
Open

docs(pm-dispatch,os-dev): 发现类 issue 纪律——查重、归挂、finding 分级与分诊出水口 (#4949)#4955
xuyushun441-sys wants to merge 2 commits into
mainfrom
claude/issue-4949-findings-discipline

Conversation

@xuyushun441-sys

Copy link
Copy Markdown
Contributor

Fixes #4949

维护者观察「issue 越开发越多」后与 PM 复盘的产物。cloud 分片一日数据:关 14 开 19。定位:病根不在 Prime Directive #10——本会话所有返工都来自大而含糊/过时的 issue,小而精确的单派发成功率近 100%,P0 过滤器旁路(cloud#1004 顺手发现的 $contains 不转义)正是立单纪律抓到的——而在循环只有生产者、没有出水口:issue 离开系统仅有「修掉」与「关重复」两条路。

改动(两文件,+63/−3)

.claude/agents/os-dev.md —— 立单纪律三条,挂在既有 rule 3 之下:

  1. 立单前查重:关键词 + 文件路径搜 open issues,命中则评论补充(cloud#1054 与 cloud#1031 同日重复,并行 dev 互相不可见);
  2. 归挂 vs 独立:属已排队 issue 完成范围 ⇒ sub-issue;仅依赖 ⇒ 独立 + Blocked-by:(cloud#1045/Fix all CI build and test errors #1046 之于 cloud#1050);
  3. 观察类打 finding,不自行判级压单——立单时判级最不准(cloud#1004、cloud#897 的影响面自评都错了),照实立单、分级归 PM 分诊轮。

.claude/skills/pm-dispatch/SKILL.md —— 四处:

  1. 一次性 setup 增 finding 标签(三仓);
  2. step 0 分类增 Hold (finding) 类——刻意不用「评论记录/台账 issue」方案:评论在状态机之外是 ADR-0049 的 silent fourth state,台账是 rule 5 禁止的 second tracker;
  3. 新增发现分诊轮:每 ~5 轮(或 finding 存量 >15)批量过一遍,先做过时前提检查(main 一天 ~18 合并,发现的准确性半衰期以天计——囤积是负利息存款),后三选一:晋级 / 关闭 not planned(附理由,列入轮次报告,维护者可否决重开但 PM 不等批准) / 持有。含归挂限定:已排队父单的 sub-issue 自动入派发池,仅依赖的发现不得挂入;
  4. 轮次报告增三个有界健康度指标:可派发库存趋势、needs-user-decision 收件箱、finding 中位年龄——总 open 数刻意不设为指标(债务密集区发现率天然高,涨是系统在工作)。报告契约尾注同步:PM 需交叉核对同轮并行报告的重复立单。

验证

文档-only 改动。基于最新 main(bf973ae)编写,已核对与近期三次 skill 更新(#4824 domain 车道、#4885#4893)无条款重叠;finding 标签与 pm:* / needs-user-decision 状态机的交互在 step 0 与分诊轮两处显式声明。

备注

PM tooling 类 PR,按 SKILL.md guardrails 不自合,交维护者审定——本 PR 改的正是那份 guardrails 所在的文件,更该如此。


Generated by Claude Code

cloud 分片一日运行数据:关闭 14 条、新开约 19 条。复盘定位:病根不在
Prime Directive #10(发现即立单)—— 本会话所有返工都来自大而含糊/过时
的 issue,小而精确的单派发成功率接近 100%,P0 过滤器旁路正是顺手立单
抓到的 —— 而在循环只有生产者、没有合法出水口:issue 离开系统仅有
「修掉」与「关重复」两条路,总量单调增长。

os-dev 立单纪律三条:立单前按关键词+文件路径查重(cloud#1054 与
cloud#1031 同日重复);属已排队 issue 完成范围的开 sub-issue、仅依赖
的独立立单 + Blocked-by;观察类打 finding 标签,不自行判级压单
(立单时判级最不准:cloud#1004 的「转义细节」实为 P0)。

SKILL.md 四处:setup 增 finding 标签;step 0 分类增 Hold 类
(评论/台账是 ADR-0049 的 silent state + rule 5 的 second tracker,
故记录必须留在 issue 层);新增发现分诊轮 —— 每 ~5 轮批量过一遍
finding,晋级 / 关闭 not planned(否决窗口)/ 持有,判级责任归此轮;
轮次报告增三个有界健康度指标(可派发库存、决策收件箱、finding 中位
年龄)—— 总 open 数刻意不设为指标,债务密集区发现率天然高。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RnouiyjNYm6KGMuCe3YLWT
@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectstack Ignored Ignored Aug 3, 2026 5:08pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/s labels Aug 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

pm-dispatch / os-dev:发现类 issue 纪律——立单前查重、就近归挂 sub-issue、finding 分级与批量分诊出水口

2 participants