qiusuo0226/chrono-pm-skill / governance-shared/baselines/3.1.0
chrono-pm-project
VerifiedMarkdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio(只读)。触发:项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好。支持主动变更+人工确认:写入即标记待确认并登记 pending-changes,确认后生效。
references/14-self-check-rules.md
View on GitHub# 自查与完整性校验规则
本规则用于确保 AI 在处理项目文档时不遗漏关键事项。项目管理必须严谨,AI 必须对每次处理结果进行自查校验,发现遗漏时主动补充。
---
## 1. 核心原则
1. **索引预建,不是边查边建。** 索引在日常更新时自动维护,查询时直接读取,不在查询时临时构建。
2. **处理即校验。** 每次处理日报、会议纪要、评审材料、文件导入后,必须执行自查清单。
3. **遗漏即补充。** 自查发现遗漏时,立即补充,不等用户发现。
4. **不确定即标注。** 无法确认是否遗漏时,明确标注不确定项,不隐瞒。
5. **可追溯。** 每次自查结果记录在 AI 操作日志中。
---
## 2. 索引预建规则
### 2.1 禁止边查边建
AI 查询时**不得**:
- 临时创建脚本扫描目录
- 逐个读取日报文件搜索关键词
- 临时读取 Excel 文件提取信息
- 在查询过程中构建索引
AI 查询时**必须**:
- 先读取对应索引文件
- 索引存在且未过期 → 直接返回结果
- 索引不存在 → 提示用户重建(不自行全量扫描)
- 索引过期(>24h)→ 提示用户「索引可能过期,上次更新 X 小时前,建议重建」
### 2.2 索引自动维护时机
索引在以下场景**自动更新**,不需要用户专门要求:
| 触发场景 | 自动更新内容 |
|---|---|
| 日报处理完成后 | 从"明日计划"提取 TODO → 落待办文件 `todos/{date}/{owner}.md` + 绑定文件 `_index.md` |
| 会议纪要处理后 | 从行动项提取 TODO → 落待办文件 + 绑定文件 `_index.md` |
| 待办状态变更后 | 同步状态到待办文件 + 绑定文件 `todos/{date}/_index.md` |
| 日报索引维护时 | 更新 `YYYYMM/index.md` 月度索引 |
| 待确认变更新增时(主动写事实源/高风险建请求) | **写入前查重**:按 Change Log 指针(目标文件+字段/实体 ID)+事项描述匹配;已存在相同待确认项则**合并**(更新说明/时间,不追加新行、`total_pending` 不加)。无重复才写入 `pending-changes.md` 新条目,`total_pending` 加 1,保持与 Change Log `Confirmed By: 待确认` 条目一一对应 |
| 待确认变更确认后 | 更新 Change Log `Confirmed By` 为 PM 姓名,从 `pending-changes.md` 移除对应条目,`total_pending` 减 1 |
| 待确认变更驳回后 | Change Log 追加 `修改原因: 驳回-恢复原值`(保留驳回轨迹),AI 恢复事实源原值,从 `pending-changes.md` 移除对应条目,`total_pending` 减 1 |
| 实体级联完成后 | 确认对应实体规则文件 §级联传播规则 中所有 AUTO 动作已执行、CHECK 结果已输出、SUGGEST 动作已加入建议更新清单 |
### 2.3 索引一致性检查
AI 在每次更新索引后,必须执行一致性检查:
| 检查项 | 规则 |
|---|---|
| 绑定文件 vs 待办文件 | `todos/{date}/_index.md` 中的待办概览状态必须与各人 `todos/{date}/{owner}.md` 待办清单状态一致 |
| 待办 vs 来源 | 每条正式待办的来源(日报"明日计划"/纪要行动项/变更批准等)可追溯 |
| 月度索引 vs 文件 | `YYYYMM/index.md` 中的记录数必须与 `YYYYMM/` 目录下的日报文件数一致 |
| RI 登记册 vs 检索路由 | RI 范围判定查询前检查本项目 `requirements/contract-register.md` 非空且格式完整(字段齐全);登记册中的 active 合同须能在本项目 canonical 索引找到。空登记册 → 触发补录引导,不臆造结论(CR-20260813-002)。跨项目检索请用 ChronoPM-Portfolio |
| 本项目禁写集层 | 本项目 `ai/` 内不得把 `portfolio/` 当事实源落点;发现 `portfolio/` 存储路径 → 不读写,提示跨项目归集请用 ChronoPM-Portfolio |
一致性检查补充(D11,pending 一致性):
- **写入前查重(强制)**:写入 `pending-changes.md` 前,按 Change Log 指针(目标文件+字段/实体 ID)+事项描述查重;重复则**合并不追加**(更新已有待确认项的说明/时间,不新增行)。
- `pending-changes.md` 中的条目必须与 Change Log 中 `Confirmed By: 待确认` 条目**一一对应**,且 `total_pending` 与待确认条目数一致;发现不一致时,**以 Change Log 为准重建 `pending-changes.md`** 并输出差异清单。
> 注:待确认项为临时"质保"状态,`Confirmed By: 待确认` 记录不计入延期判定与已完成统计(见 `05-query-rules.md` §6.5/§6.6)。
发现不一致时:
1. 以事实源为准。
2. 输出差异清单。
3. 建议修正索引。
### 2.4 索引派生分级
索引按其能否从事实源重建,分三类管理:
**完全派生索引**(可从事实源全量重建,实体变更时经级联规则 AUTO 触发重建):
| 索引 | 来源 |
|---|---|
| `todos/{date}/_index.md`(绑定文件) | 当日各人待办文件聚合 |
| `YYYYMM/index.md` | reports/daily/ 目录扫描 |
**增量维护索引**(变更时增量更新,非全量重建):
| 索引 | 维护方式 |
|---|---|
| `change-log/index.md` | 归档时增量追加月份导航条目 |
**独立累积索引**(不可从单一事实源重建,维持现有"过期检测→提示"机制):
| 索引 | 说明 |
|---|---|
| `outputs/index.md` | 追加式 |
| `pending-changes.md` | 变更候选累积 |
规则:
- 完全派生索引在事实源变更时通过级联规则 AUTO 触发重建。
- 增量维护索引不做全量重建,走增量 + 过期检测(§2.3 一致性检查衔接)。
- 独立累积索引不适用自动重建,维持"过期检测 → 提示"机制(§7)。
- 索引级联完整性由各实体规则文件 §级联传播规则 + 本文件 §2.2 末尾"实体级联完成后"行共同保障。
### 2.5 输出前级联验证(强制,仅限写入场景)
当工作流涉及事实源或派生视图的写入/更新动作时,AI 必须在输出前执行级联完成验证,流程见 `00-pm-main-rules.md` §8a.2(唯一权威定义,本文件不重复展开)。
纯查询场景(`10-update-trigger-rules.md` Level 4)不产生写入,不触发此验证。
---
## 3. 文档处理自查清单
### 3.1 日报处理自查清单
日报处理完成后,AI 必须逐项检查:
| 序号 | 检查项 | 漏了会怎样 | 检查方法 |
|---|---|---|---|
| D1 | 今日完成事项是否全部提取为任务进展 | 任务进度不更新,待办文件滞后 | 逐条核对"今日完成"区块 |
| D2 | 进行中事项是否更新到待办文件进度 | 待办进度不反映实际情况 | 逐条核对"进行中"区块 |
| D3 | 明日计划是否全部提取为待办 | 待办遗漏 | 逐条核对"明日计划"区块 |
| D4 | 阻塞事项是否全部识别为问题候选 | 问题遗漏,风险扩大 | 逐条核对"阻塞/问题"区块 |
| D5 | 潜在风险表述是否全部识别为风险候选 | 风险遗漏 | 扫描"可能""担心""如果""担心"等关键词 |
| D6 | 资源变动关键词是否触发资源联动 | 人员变动遗漏 | 扫描"请假""抽调""借调"等关键词 |
| D7 | 投入工时是否更新到待办文件工时列 | 工时统计不准 | 核对"投入工时"区块 |
| D8 | 日报是否更新月度索引 | 索引不完整 | 确认 `YYYYMM/index.md` 已追加记录 |
| D9 | 绑定文件是否同步更新 | 团队待办概览过期 | 确认 `todos/{date}/_index.md` 待办概览已更新 |
| D10 | 同人同天多次汇报是否检查了合并追加 | 工作日志内容丢失 | 确认同人同天汇报合并追加到同一待办文件工作日志段,未覆盖 |
| D11 | 待确认变更:写入前按 Change Log 指针+事项查重(重复则合并不追加);`pending-changes.md` 与 Change Log `Confirmed By: 待确认` 一一对应、`total_pending` 一致 | pending 重复粘贴或索引与实际不一致 | 写入前查重;核对本次新增/确认/驳回是否已同步;不一致则以 Change Log 为准重建 |
| D12 | Change Log 活跃区是否超 50 行或超 30 天未归档 | 活跃区膨胀、追溯困难 | 活跃区超 50 行或超 30 天触发按月归档到 `change-log/archive/YYYYMM-change-log.md` 并更新 `change-log/index.md` |
| D13 | 级联传播是否完整执行 | 下游同步遗漏 | 确认对应实体规则文件 §级联传播规则 中所有 AUTO 动作已执行、CHECK 结果已输出、SUGGEST 动作已加入建议更新清单 |
| D14 | 推导基线 entity-registry 完整性 | 实体枚举遗漏、推导状态与事实源不一致 | 检查 `context/entity-registry.md` 是否存在;存在时检查实体数量 vs 待办文件任务中提及的实体数量是否一致;不一致则提示同步 |
| D15 | 每条正式待办(有 Owner + Deadline + 交付物)是否 WP Ref 完整、状态非孤儿 | 待办孤儿、数据不一致 | 扫描待办文件待办清单,核对 WP Ref/Owner/结束时间字段;缺失则走 WF-8 归属判定补填(存量工作区升级后首次自查时批量对齐,避免零散噪音) |
| D16 | 是否存在“只在日报/纪要中呈现而未落待办文件”的半写状态 | 半更新残留 | 检查最近日报/纪要的正式行动项是否按 WF-8 落待办文件(一次性提醒除外);发现半写 → 补全待办文件并输出差异清单 |
| D17 | 本项目内是否出现集层存储路径 `portfolio/` | 把 `portfolio/` 当本包事实源 | 扫描本项目 `ai/`;发现 `portfolio/` 存储路径 → 不读写,提示跨项目归集请用 ChronoPM-Portfolio |
| D18 | DF 行完整性 | 内置习惯基线丢失、不可审计 | 检查 `context/pm-profile.md` §1:DF-NNN 相对 21 号 §5.1a 基线表编号连续、无缺失、无任何 DF 行被移入 §3 已否决/已废弃段;缺失 → 从模板恢复该行(状态 `disabled` + 备注「检测到缺失已自动恢复」)并提示 PM |
| D19 | 操作类型×已加载规则匹配 | 规则未加载导致漏流程 | 对照 SKILL.md §6 最小规则集:当前操作类型必须已加载对应规则文件;缺失则先加载再继续,不得跳过流程 |
### 3.2 会议纪要处理自查清单
| 序号 | 检查项 | 漏了会怎样 | 检查方法 |
|---|---|---|---|
| M1 | 所有行动项是否提取为 TODO | 待办遗漏 | 逐条核对会议中的"行动项/安排/负责/跟进" |
| M2 | 所有决策是否记录到 decision-log | 决策遗漏 | 逐条核对"决定/确认/同意/不做/暂缓" |
| M3 | 提到的风险是否识别为风险候选 | 风险遗漏 | 扫描风险关键词 |
| M4 | 提到的问题是否识别为问题候选 | 问题遗漏 | 扫描问题关键词 |
| M5 | 提到的需求变更是否触发变更流程 | 变更遗漏 | 扫描"变更/调整/新增/取消" |
| M6 | 资源变动是否触发资源联动 | 人员变动遗漏 | 扫描资源关键词 |
| M7 | 待办索引是否同步更新 | 索引不完整 | 确认 todos/ 已更新 |
| M8 | 级联传播是否完整执行 | 下游同步遗漏 | 确认 Decision 级联传播规则中所有 AUTO/CHECK/SUGGEST 动作已处理或已加入建议清单 |
### 3.3 评审材料处理自查清单
| 序号 | 检查项 | 漏了会怎样 | 检查方法 |
|---|---|---|---|
| R1 | 评审结论是否提取为决策 | 决策遗漏 | 核对"通过/不通过/有条件通过/待确认" |
| R2 | 评审中的待确认事项是否提取为问题 | 问题遗漏 | 核对"待确认/待讨论/待补充" |
| R3 | 评审中发现的风险是否识别 | 风险遗漏 | 扫描风险关键词 |
| R4 | 评审中的行动项是否提取为 TODO | 待办遗漏 | 核对"需要/应该/后续/跟进" |
| R5 | 需求变更是否触发变更流程 | 变更遗漏 | 核对需求状态变化 |
| R6 | 评审纪要是否归档 | 过程记录丢失 | 确认 meetings/ 或 reviews/ 已保存 |
| R7 | 级联传播是否完整执行 | 下游同步遗漏 | 确认评审触发的实体级联传播动作已处理或已加入建议清单 |
### 3.4 风险/问题追溯自查清单
当用户要求"追溯项目风险/问题"时,AI 必须执行多源交叉校验:
| 序号 | 检查项 | 方法 |
|---|---|---|
| T1 | 风险登记册是否覆盖所有来源 | 对比 risks/risk-register.md 与以下来源的差异 |
| T2 | 来源A:日报中的风险关键词 | 扫描所有日报索引,搜索"风险/可能/担心/如果" |
| T3 | 来源B:会议纪要中的风险讨论 | 扫描会议索引,搜索"风险/可能/担心/如果" |
| T4 | 来源C:周报中的风险章节 | 扫描最近周报的风险部分 |
| T5 | 来源D:问题登记册中的关联风险 | 检查 issues/ 中有关联风险编号的记录 |
| T6 | 来源E:待办文件中的延期/阻塞 | 检查待办文件中状态为已阻塞/已超期的任务 |
| T7 | 差异报告 | 输出"登记册有但来源无"和"来源有但登记册无"两个方向差异 |
**追溯输出格式:**
```markdown
## 风险追溯校验报告
### 校验范围
- 风险登记册:X 条
- 日报扫描范围:YYYY-MM-DD ~ YYYY-MM-DD,共 X 份
- 会议纪要扫描范围:最近 X 次会议
- 周报扫描范围:最近 X 周
### 交叉校验结果
| 风险编号 | 登记册 | 日报 | 会议 | 周报 | 问题关联 | 一致性 |
|---|---|---|---|---|---|---|
| R-001 | ✅ | ✅ | ✅ | ✅ | ✅ | 一致 |
| R-002 | ✅ | ❌ | ✅ | ✅ | - | 日报未提及(正常) |
| - | ❌ | ✅ | ❌ | ❌ | - | ⚠️ 日报提及但未登记,建议补充 |
### 遗漏项
| 来源 | 关键词 | 上下文 | 建议动作 |
|---|---|---|---|
| 日报 2026-08-05 仇索 | "担心接口联调延期" | "...接口还没通,担心下周联调会延期" | 建议新增风险候选 |
### 结论
- 登记册已有风险:X 条
- 发现遗漏候选:Y 条
- 建议确认后补充
```
---
## 4. 处理后自查输出格式
**输出分级(审计不弱化)**:
- **全部通过**:只输出一行摘要;全量自查表落盘文件变更日志 / AI 操作日志,不在对话展开。
- **任一项失败/遗漏/不确定**:对话输出完整自查表 + 发现项(不得省略)。
### 成功(一行摘要)
```markdown
自查通过:日报处理 D1–D19 全部通过。
```
### 失败(全量输出)
```markdown
## 自查清单
| 序号 | 检查项 | 结果 | 说明 |
|---|---|---|---|
| D1 | 今日完成事项提取 | ✅ 3/3 | 全部提取 |
| D5 | 风险关键词扫描 | ⚠️ 1 项遗漏 | "担心接口延期"未识别为风险候选,已补充 |
| D11 | pending 查重/一致性 | ✅ | 无重复,total_pending 一致 |
| D18 | DF 行完整性 | ✅ | DF 编号连续、无缺失、未移入废弃段 |
| D19 | 操作类型×已加载规则 | ✅ | 日报=00+01+06+17 已加载 |
### 自查发现
- [发现1]:风险关键词"担心接口延期"在初次处理时未识别为风险候选,已补充为 R-{YYYYMMDD}-{HHmmss} 候选
```
---
## 5. 多轮自查规则
### 5.1 首次处理后的自查
首次处理文档后执行完整自查清单。
### 5.2 用户追问时的自查
当用户追问"有没有漏的""是不是全了""再检查一下"时,AI 必须:
1. **重新执行完整自查清单**,不是简单回答"已经检查过了"。
2. **扩大扫描范围**:首次只查了日报,追问时增加会议纪要和周报交叉校验。
3. **输出差异报告**:与首次处理结果的差异。
### 5.3 批量处理时的自查
当一次性处理多份文档时(如全团队日报):
1. 每份文档单独执行自查。
2. 全部处理完后执行汇总自查(合并去重、交叉校验)。
3. 输出汇总自查清单。
---
## 6. 遗漏补救规则
### 6.1 发现遗漏时
1. **立即补充**,不等用户确认(低风险项)或立即建议补充(高风险项)。
2. 在自查清单中标注"⚠️ 首次遗漏,已补充"。
3. 在 AI 操作日志中记录遗漏原因和补救动作。
### 6.2 遗漏原因分析
AI 在发现遗漏后,应分析遗漏原因:
| 原因类型 | 说明 | 改进措施 |
|---|---|---|
| 关键词未覆盖 | 用户的表述不在信号词列表中 | 补充信号词 |
| 语义理解偏差 | AI 理解了字面意思但未识别为管理信号 | 标注为经验教训 |
| 处理中断 | 文档过长导致后半部分被忽略 | 分段处理,每段后自查 |
| 格式异常 | 文档格式不规范导致提取失败 | 标注为不确定项,请求用户确认 |
### 6.3 遗漏统计
AI 操作日志中应记录每次处理的遗漏率:
```markdown
## 自查统计
- 处理文档数:5
- 自查项总数:50
- 首次通过:47
- 首次遗漏:3(已全部补充)
- 遗漏率:6%
```
---
## 7. 索引过期检测
### 7.1 过期判断规则
| 索引文件 | 过期阈值 | 过期处理 |
|---|---|---|
| `todos/{date}/_index.md`(绑定文件) | 24 小时 | 提示「绑定文件上次更新 X 小时前,建议刷新」 |
| `YYYYMM/index.md` | 实时 | 每次日报处理时同步更新 |
| `pending-changes.md` 待确认项 | 7 天 | 超 7 天未确认进入**日常提醒**(每日催办,合入 `19-info-completeness-rules.md` P0-P3);超 14 天未确认升级为 **critical**(P0/P1 优先级) |
### 7.2 过期提示格式
```markdown
## 索引状态检测
| 索引文件 | 上次更新 | 状态 | 建议 |
|---|---|---|---|
| todos/2026-08-08/_index.md | 2026-08-08 10:00 | ⚠️ 过期(25h) | 建议刷新 |
| todos/2026-08-09/_index.md | 2026-08-09 09:00 | ✅ 正常 | - |
是否现在刷新过期索引?
```
---
## 8. 与其他规则的关系
| 规则 | 自查时的职责 |
|---|---|
| `01-daily-report-rules.md` | 日报自查清单 D1-D19 |
| `02-meeting-rules.md` | 会议自查清单 M1-M7 |
| `05-query-rules.md` | 索引优先、禁止边查边建 |
| `10-update-trigger-rules.md` | 触发完整性(信号词全覆盖) |
| `11-output-artifact-rules.md` | 输出物生成后自查 |
| `13-continuity-rules.md` | 历史导入完整性校验 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |