Skip to content

WP specs v2 草案(拟 rev9):工作项级标准/非标颗粒度 + 快速导航总表 + 统计员数据来源清单 - #93

Merged
hmisty merged 4 commits into
Jouleverse:mainfrom
xiaoxin2140:wp-spec-v2-draft
Sep 18, 2026
Merged

hmisty merged 4 commits into
Jouleverse:mainfrom
xiaoxin2140:wp-spec-v2-draft

Conversation

@xiaoxin2140

@xiaoxin2140 xiaoxin2140 commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

摘要

新增 work-package-specs-v2-draft.mediawiki,为现行 work-package-specs 的整体重构(rev9)。发起:教链(J-25)|起草:小新|2026-08-25

决议情况(CGC 会议 2026-08-30):经会议讨论决议——先行合并试运行。本规范以 试行版(rev9) 合并入仓库,于下一次 PoWh 统计中实际运行,在使用中持续打磨优化,避免过度讨论。
会议记录:https://github.com/Jouleverse/open-meetings/blob/main/core/CGC20260830.md

核心变更

  1. 废除「标准工作包 / 非标工作包 / 混合工作包」的 WP 级分类——颗粒度细化到工作项,每个 WP 内部分「A. 标准化工作项」(统计员直接按标准拉取数据统计)与「B. 非标工作项」(贡献者先自行上报,统计员汇总核验)两张子表
  2. 新增快速导航总表(贡献者按工作类型一查即知归属/报法)与统计员 SOP 数据来源清单(链上 / GitHub 双客观源)
  3. WP-13 知识库内容贡献一律归 WP-13(消除 spec 与社区实践的矛盾);WP-15 明确纳入 JIP/JEEP 提案与治理机制研究
  4. 非标上报强制附产出物链接(无链接不计数),截止时间明确为次月 5 日 24:00
  5. WP-4 / WP-5 标注暂停;WP-2 节点清单以审计员月度报告为准
  6. 改进建议以注释形式随文列出(附录汇总),另行讨论、不阻塞 rev9 批准

完整变更摘要

见文档附录「本版主要变更摘要」表(共 12 条,含采纳 J-67 审阅意见新增 3 条:唯一权威上报格式 / AI 统计边界与责任 / 数据源脚本化清单)。


本次更新(2026-09-18):将版本标注由「草案(拟 rev9)」改为 试行版(rev9),并注明 CGC 会议 2026-08-30 的决议情况。请 review 后合并试运行。

…nularity, quick-nav table, statistician SOP & data sources

- 废除 WP 级标准/非标/混合分类,细化到工作项粒度(每 WP 内分 A 标准化 / B 非标两张子表)
- 新增快速导航总表、统计员数据来源清单与 SOP
- WP-13 知识库内容贡献一律归 WP-13;WP-15 明确纳入 JIP/JEEP 提案
- 非标上报强制附产出物链接,截止时间明确为次月 5 日 24:00
- WP-4/WP-5 标注暂停;WP-2 节点清单以审计员月度报告为准
- 改进建议以注释形式随文列出,不阻塞批准

发起: 教链(J-25) | 起草: 小新 | 2026-08-25
@xiaoxin2140

Copy link
Copy Markdown
Contributor Author

@hmisty 请 review 🙏 这是 WP specs v2 重构草案(拟 rev9),发起人教链(J-25)。核心变化:废除 WP 级标准/非标分类、细化到工作项粒度,新增快速导航总表与统计员数据来源清单。完整变更摘要见文档附录。

@fangsheng-sudo

Copy link
Copy Markdown
Collaborator

基本可行!建议:既然规范了非标上报截止时间,那么节点审计报告截止时间、统计数据合并时间、执行发放时间何不一并规范?

1 similar comment
@fangsheng-sudo

Copy link
Copy Markdown
Collaborator

基本可行!建议:既然规范了非标上报截止时间,那么节点审计报告截止时间、统计数据合并时间、执行发放时间何不一并规范?

@xiaoxin2140

Copy link
Copy Markdown
Contributor Author

感谢 @fangsheng-sudo 的建议!已采纳,rev9 将一并明确各环节时间节点:

  • 非标工作项上报截止:次月 15 日 24:00
  • 节点审计报告发布截止:次月 15 日 24:00
  • 统计数据合并完成:次月 20 日 左右
  • 执行发放:发放需经 timelock 延时(core 合约最低延时为链上固定的 2 天/次,共两次)+ 多签人执行协调,在去中心化协作下按现实节奏估计次月底前完成

具体数值欢迎再提意见,定稿后随 rev9 一并提交 CGC。

@xiaoroc-bot-bataroc

Copy link
Copy Markdown
Contributor

本条评论由 J-67 Bataroc 的 bot「小Roc」以自己的账号(xiaoroc-bot-bataroc)发布,内容已经 J-67 审核。

结合 2026 年 7 月 PoWh 统计实操(通过飞书 API 取数、用 6 月数据反算验证公式 100% 一致、生成月度表),针对 v2 草案补充三条改进建议,供 rev9 参考:

1. 非标上报模板给出"唯一权威格式"(含标点规范)

草案 §4 示例中 (总计: 4h)总计:4h 存在半角/全角冒号混用。这类细节正是 AI 解析时最容易踩的坑(与统计表列名漂移同类问题;7 月实操中曾因按 6 月表头对齐 7 月新列,导致凑整行放错列)。建议:

  • 附录给出唯一权威模板,明确全角/半角、冒号、括号、换行等全部细节;
  • 声明解析器(人工或 AI)按此格式解析,不符合格式的上报由项目经理/统计员要求重报。

2. 数据源脚本化清单(建议补充"多签快照")

SOP 中 CheckIn 已有现成脚本 fetch_checkin.py,方向正确。建议将以下取数全部脚本化,每月固定跑一次输出 JSON,统计员/AI 直接消费:

  • WP-1:每月对三个多签钱包跑 getOwners() 快照存档到 repo(草案 WP-1 注释已有此建议,建议升格为正式规则,作为"当月在册签名人"的唯一依据);
  • WP-6:fetch_checkin.py(已有);
  • WP-2/WP-4(恢复后):JTI 合约认证事件扫描、节点清单 nodes.yaml 结构化(草案附录已有);
  • WP-6 纪要:open-meetings 纪要 merge 记录(GitHub API 可脚本化)。

3. AI 辅助统计的边界与责任

草案 SOP 提到"按模板解析,AI Agent 辅助",建议条款明确:

  • AI 可承担:解析 issue 评论提取工时、对照 GitHub 活动核验产出物链接有效性、按公式计算激励并生成月度 mediawiki 表、输出差异报告供人工复核;
  • 责任边界:AI 输出必须附数据源引用(哪条评论/哪个 PR/哪笔 tx);统计主管对最终数字负责;AI 结果与人工复核不一致时以人工为准并记录原因;
  • 这也为草案附录"上报↔GitHub 活动 AI 交叉核验"的改进提案打好基础。

以上为个人建议,供社区讨论,不阻塞 rev9 批准。

@xiaoxin2140

Copy link
Copy Markdown
Contributor Author

感谢 J-67 的三条建议,结合 7 月实操经验非常有价值。逐条回应:

1. 非标上报模板唯一权威格式

同意。rev9 会在附录中给出唯一权威模板,明确全角/半角、冒号、括号、换行等全部细节,并声明不符合格式的上报由项目经理/统计员要求重报。这跟 7 月实操中遇到的表头列名漂移是同类问题,统一格式从源头解决最有效。

2. 数据源脚本化清单 + 多签快照升格

同意。rev9 将:

  • WP-1 多签钱包 getOwners() 快照从注释建议升格为正式规则,每月存档到 repo 作为「当月在册签名人」唯一依据;
  • WP-6 fetch_checkin.py(已有)方向确认;
  • WP-2/WP-4 恢复后的 JTI 合约事件扫描、nodes.yaml 结构化、open-meetings 纪要 merge 记录,在附录脚本化清单中列出,逐步落地。

3. AI 辅助统计的边界与责任

同意。rev9 SOP 条款将明确:

  • AI 可承担:解析 issue 评论提取工时、核验产出物链接有效性、按公式计算激励、生成月度 mediawiki 表、输出差异报告供人工复核;
  • 责任边界:AI 输出必须附数据源引用(评论/PR/tx);统计主管对最终数字负责;AI 结果与人工复核不一致时以人工为准并记录原因。

三条建议均纳入 rev9 修订,感谢 J-67 和小Roc 的实操验证 🙏

- §4 上报模板改为唯一权威格式, 明确全角/半角标点规范
- WP-1 多签 getOwners() 快照从注释建议升格为正式规则, 作为当月在册签名人唯一依据
- 统计员 SOP 新增 AI 辅助统计的边界与责任条款
- 附录新增数据源脚本化清单表
- 随文改进提案同步更新(快照项已升格)

回应 J-67 审阅意见 | 起草: 小新 | 2026-08-27
@xiaoroc-bot-bataroc

Copy link
Copy Markdown
Contributor

本条评论经 J-67 审核后由其助理小Roc 发布

针对第 3 条「AI 辅助统计的边界与责任」,结合社区质询(微尘 J-53)修订如下,供 rev9 参考:

一、为什么修订

原条款将"人工复核"设为默认环节(AI 结果与人工复核不一致时以人工为准)。社区质询指出:若自动化统计后仍需逐条人工复核,自动化就失去了规模化意义——链生态扩大后(节点数万级、上报量线性增长),人力复核必然成为瓶颈。历次会议上对"双 agent 独立统计与复核"的质询,答复均未被反对。核心诉求是:把 agent 固定在统计规范的轨道上(规范须机器可执行),让统计与复核都在 agent 层完成,人只做审阅与裁决,而非逐条复核

二、修订版第 3 条:AI 辅助统计的边界与责任

AI 可承担:解析 issue 评论提取工时、对照 GitHub 活动核验产出物链接有效性、按公式计算激励并生成月度 mediawiki 表、输出差异报告。

统计与复核均由 agent 执行,人不再逐条复核:

  • 统计 bot:按统计规范(SOP 须机器可执行化:模板、公式、判定规则固化)独立完成统计,输出报告并附数据源引用(哪条评论 / 哪个 PR / 哪笔 tx);
  • 复核 bot:与统计 bot 独立运行、不共享其中间结果,对统计输出做交叉核验,输出差异报告;
  • 多 bot 交叉确认:统计组增多后,可由多个独立 bot(B/C/D…)对统计 bot 的结果核对确认,任一差异均须记录原因;
  • 人的职责:统计人(统计主管)审阅 bot 输出与差异报告、确认统计规范版本,对最终数字负责——是审阅,不是逐条复核

责任边界:bot 输出必须附数据源引用;差异无法由规范自动裁决时,以人工判断为准并记录原因。

三、开放性思考:统计核对 Skill 社区共享(最低成本的最大公开)

可否由统计组牵头,将 SOP 的解析、核验、计算、差异报告流程封装为可安装的「统计核对 Skill」,分享给社区——任何人(即使不在统计组)都可安装此 Skill,一键复核月度统计结果。这样等于用最低成本实现最大程度的过程公开:统计的每一步(数据源、公式、归并)都可被任何社区成员独立复跑验证,形成"人人可审阅、人人可监督"的开放统计。

此 Skill 亦可作为随文改进提案 #7「上报↔GitHub 活动 AI 交叉核验」的基础实现——该提案依赖变更 5(非标上报强制附产出物链接)落地后启动,两者衔接形成"强制链接 → 脚本化核验 → 人人可复跑"的完整闭环。

以上为个人建议,供社区讨论,不阻塞 rev9 批准。

@xiaoxin2140

Copy link
Copy Markdown
Contributor Author

@hmisty 已按要求更新:版本由「草案(拟 rev9)」改为试行版(rev9),并注明 CGC 会议 2026-08-30 的决议情况(先行合并试运行、于下一次统计中实际运行)。请 review 后合并试运行,谢谢。

@hmisty
hmisty merged commit b94140b into Jouleverse:main Sep 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants