Skip to content

qiusuo0226/chrono-pm-skill / governance-shared/baselines/1.10.2

chronopm

Verified

Markdown 驱动的 AI 项目管理技能。当用户需要管理软件研发项目(尤其 To G / To B 政企数字化转型领域)时使用,覆盖需求管理、任务跟踪、进度管控、风险与问题、里程碑、成本与P&L、日报周报、会议纪要、决策记录、复盘、项目集统筹、人员资源协调与流转、初始化向导、迭代管理、信息完整性巡检、历史计划导入与变更追溯、PM 偏好等全链路。触发场景包括:初始化项目、处理日/周报、整理会议纪要、需求评审与变更、风险识别、任务看板更新、项目状态查询、里程碑评审、项目复盘、项目集汇总、跨项目资源调配、完整性巡检、历史计划批量导入、计划变更追踪与延期统计、超期查询、词库管理、PM 偏好管理等。当用户提到"项目管理""日报""周报""风险登记册""任务看板""需求追踪""里程碑""ChronoPM""项目集""资源分配""人员流转""记录一下""更新一下""整理到项目里""归档""入库""评审""验收""会议纪要""接口文档"等关键词时触发。当用户提到"初始化项目""录入项目信息""设置项目基线"时触发初始化向导。当用户提到"迭代""迭代规划""迭代登记"时触发迭代管理。当用户提到"完整性巡检""缺失信息"时触发完整性巡检。当用户提到"导入历史计划""计划变更""延期/超期""变更了几次""延期了几次"时触发 R1-R4 计划同步与变更追溯。当用户上传或粘贴文件并要求处理时也触发。当用户提到"词库""术语""缩写""纠正"时触发词库管理。当用户提到"偏好""习惯设置"时触发 PM 偏好管理。支持 PM 偏好学习与输出适配,以 Markdown 文件为事实源、AI 为辅助、人工确认为最终控制点。

references/17-domain-glossary-rules.md

View on GitHub
---
rule_id: 17
title: 领域术语词库规则
category: 辅助理解
risk_level: 低-中
depends_on: [01, 02, 05, 06, 10]
version: 1.0
---

# 17 领域术语词库规则

## 1. 定位与边界

### 1.1 定位

本规则定义 ChronoPM 的领域术语词库(Domain Glossary)能力,作为 AI 理解用户输入的预处理层。

- 词库是**辅助理解配置数据**,不是事实源
- 词库影响事实源更新前的理解,属于低到中风险配置数据
- 词库不直接产生项目管理决策
- 本次改造**不删除、不弱化现有能力**

### 1.2 边界

- 词库不修改事实源(tasks/board.md 等)
- pending 不静默替换
- pending 不写入确定事实源
- 低置信度不更新事实源
- 原文必须保留
- 纠错不改写事实源
- 用户强制更新也需保留原文与确认记录
- 不新增机器配置字段(自动学习模式以规则策略描述)

### 1.3 "自动无感添加"定义

- "自动无感添加"指 AI 可自动将候选术语写入词库 pending 区,减少用户手动维护成本
- 不等于自动确认:自动发现默认进 pending,需用户确认后升为 confirmed
- "无感"指不需要用户手动打开词库文件添加,不是"完全不提示用户"
- 已确认允许 AI 自动写入 pending

## 2. 文件位置与作用域

### 2.1 路径

项目集共享模式,词库路径为:`ai/portfolio/context/domain-glossary.md`

### 2.2 加载时机

- 按需加载:仅在需要术语归一化时读取
- 不存在时跳过:词库不存在时完全兼容现有流程

## 3. 词库数据结构

### 3.1 术语映射表

| 编号 | 原词 | 标准词 | 类别 | context_hint | 状态 | 来源 | 首次出现 | 最近命中 | 命中次数 | 备注 |
|------|------|--------|------|-------------|------|------|---------|---------|---------|------|

必填字段:编号、原词、标准词、类别、状态、来源、首次出现
可选字段:context_hint、最近命中、命中次数、备注

### 3.2 纠错映射表

| 编号 | 错误写法 | 正确写法 | 类别 | 状态 | 来源 |
|------|---------|---------|------|------|------|

### 3.3 待确认术语表

| 编号 | 术语 | 可能的标准名称 | 上下文 | 首次出现时间 | 状态 |
|------|------|--------------|--------|-------------|------|

"待确认术语表"与 pending 状态的关系:
- pending 条目(在术语映射表):AI 已推断出候选标准词但未经用户确认
- 待确认术语表:无明确标准词或存在多个候选,等待用户选择
- 用户确认后,从待确认区迁移到术语映射表 confirmed

### 3.4 索引

- 按类别索引
- 按原词索引
- 索引项含文件路径(拆分后)

### 3.5 Change Log

| Date | Change Type | Description | Source |
|------|------------|-------------|--------|

### 3.6 编号规则

- G + 三位数字(G001、G002...),全局唯一
- 递增:新增 = 当前最大编号 + 1
- 拆分后仍全局唯一
- 重复时提示冲突,不自动覆盖
- E + 三位数字(纠错映射表,独立编号)
- P + 三位数字(待确认术语,确认后转 G 编号)

## 4. 状态机

### 4.1 五状态定义

| 状态 | 含义 | 是否允许静默替换 |
|------|------|----------------|
| confirmed | 已确认术语 | 是 |
| pending | 自动候选,待确认 | 否 |
| rejected | 用户否定 | 否 |
| conflict | 存在多映射冲突 | 否 |
| deprecated | 已废弃/不再使用 | 否 |

### 4.2 状态流转

- pending → confirmed(用户确认)
- pending → rejected(用户否定)
- rejected → pending(用户恢复)
- confirmed → deprecated(用户废弃)
- deprecated → pending(用户恢复)
- 同一原词多映射 → conflict → 用户选择 → confirmed(选中) + deprecated(其余)

### 4.3 pending 使用规则(三层模型)

| 层面 | confirmed | pending | 低置信度/conflict |
|------|-----------|---------|------------------|
| 静默替换 | 允许 | 不允许 | 不允许 |
| 本轮候选理解 | 作为确定术语 | 可作为"候选理解"附带原文参与本轮分析,必须显式标注"按候选理解,待确认" | 只保留原文,不作为候选标准词 |
| 事实源更新 | 可正常更新 | 必须标注不确定,只写草稿,不进入正式事实源 | 不更新为确定事实,只进入待确认区 |
| 主体任务阻塞 | 不阻塞 | 不阻塞 | 不阻塞 |

> 草稿输出应体现在本轮回复或待确认更新清单中,不直接写入 `tasks/board.md`、风险登记册等正式事实源文件。

## 5. 加载时机

### 5.1 触发场景

- 日报处理(01 规则前置)
- 评审记录处理(02 规则前置)
- 查询路由(05 规则前置)
- 更新触发(10 规则前置)
- 词库管理(用户主动触发)

### 5.2 降级规则

- **词库不存在**:
  - 普通业务流程中**不自动创建**词库文件
  - 跳过全部归一化步骤,按现有逻辑处理
  - 提示用户可执行迁移/初始化命令创建词库
  - 用户明确要求"初始化词库",或执行 init/migrate 脚本时,允许创建
- **词库格式损坏**:提示异常,按现有逻辑处理

## 6. 术语归一化流程

### 6.1 九步流程

1. 读取 domain-glossary.md(如不存在,跳过全部步骤)
2. 先处理 confirmed 映射(静默替换,记录命中)
3. 再处理已确认纠错映射(自动纠正,保留原文记录)
4. 检测词库中未命中的新术语候选
5. 判断候选置信度
6. 按置信度处理:
   - 自动推断高 → 写入 pending,本轮按候选理解处理,显式标注
   - 自动推断中 → 写入 pending,不替换,在输出中提示候选
   - 低/多候选冲突 → 不写入正式映射,进入待确认区
7. 生成标准化输入(保留原文映射记录)
8. 将标准化输入送入原 Skill 流程
9. 输出保留原文片段 + 归一化结果 + 状态

### 6.2 归一化优先级

- confirmed 映射 > pending 映射
- 主体名称 > 业务线 > 工作子项 > 人员角色
- 多义冲突时不自动替换,一律进入 conflict 并追问

### 6.3 置信度判定条件

| 置信度 | 判定条件 | 动作 |
|--------|---------|------|
| confirmed 命中 | 原词在词库中存在,且状态为 confirmed | 静默替换,更新命中次数 |
| 用户明确声明 | 用户在当前轮明确表达"X 就是 Y 的简称"或显式要求添加 | 直接写入 confirmed,本轮替换 |
| 自动推断高 | 原词不在词库,但基于上下文可明确推断标准名 | 写入 pending,本轮按候选理解处理,显式标注"按候选理解,待确认" |
| 自动推断中 | 原词不在词库,存在合理候选但不确定 | 写入 pending,不替换,在输出中提示候选 |
| 低/多候选冲突 | 原词不在词库,无法判断标准名;或同一原词存在多个 confirmed 映射 | 不写入正式映射,进入待确认区,不阻塞主体任务 |

## 7. 纠错流程

### 7.1 三级策略

| 级别 | 条件 | 动作 |
|------|------|------|
| 已确认纠错 | 错误写法在词库纠错映射表中,状态为 confirmed | 自动纠正,保留原文记录 |
| 疑似错别字 | 不在词库,但基于上下文疑似错别字 | 仅输出纠正建议,不直接改写 |
| 影响业务含义 | 纠错可能改变任务名称/风险描述/需求含义 | 必须用户确认后才写入词库 |

## 8. 自动学习规则

### 8.1 自动发现

- AI 在处理用户输入时自动检测未命中的新术语
- 基于上下文推断标准名称
- 自动写入 pending 状态

### 8.2 学习模式(规则策略,非机器配置)

允许自动写入 pending 模式:AI 自动推断的新术语直接写入词库 pending 区,本轮按候选理解处理。

> 注:以上为规则策略描述,不新增 skill.json 配置字段。如需配置化,列为可选增强。

### 8.3 不自动写入的情况

- 低置信度/多候选冲突——进入待确认区

## 9. 确认式学习规则

### 9.1 用户确认交互

| 指令 | 处理 |
|------|------|
| "确认 G003" | pending → confirmed,更新 Change Log 和索引 |
| "修正 G003:XXX" | 更新标准词,状态改为 confirmed,更新 Change Log 和索引 |
| "否定 G003" | pending → rejected,不再自动建议,更新 Change Log |
| "恢复 G003" | rejected → pending,更新 Change Log |

### 9.2 待确认区选择

- 用户从候选列表中选择后创建 confirmed 条目(编号 = 当前最大 G 编号 + 1)
- 更新 Change Log 和索引

### 9.3 模糊回复处理

| 用户回复 | 当前轮待确认项数量 | AI 处理方式 |
|---------|-----------------|------------|
| "确认" | 仅 1 个待确认项 | 默认确认该项 |
| "确认" | 多个待确认项 | 追问"请确认哪一项?如 G003 或 P001" |
| "就按第一个" | 有候选列表 | 对应当前最近候选列表的 A 选项 |
| "不是这个" | — | 不直接 rejected,追问"请说明正确的标准词或选择" |
| "改一下" | — | 追问"请提供修正后的标准词" |
| 无法理解 | — | 追问"请回复:确认 G编号 / 修正 G编号:标准词 / 否定 G编号" |

## 10. 去重规则

| 层级 | 判断方式 | 动作 |
|------|---------|------|
| 第一层 | 原词完全相同 | 阻止重复添加 |
| 第二层 | 标准名完全相同 | 提示已存在相同标准名映射 |
| 第三层 | 同一原词不同标准名 | 标记 conflict 状态,提示用户选择 |
| 第四层 | 疑似相似(同音/形近/编辑距离小) | 仅提示候选,不自动合并 |

## 11. 索引维护规则

### 11.1 权威性声明

- 词条表是权威数据
- 索引是派生数据

### 11.2 更新时机

新增、修改、确认、拒绝、拆分后同步更新索引。

### 11.3 更新责任

| 责任方 | 职责 |
|--------|------|
| AI 修改词库时 | 必须同步维护索引 |
| 用户手工修改词库后 | AI 检测不一致并提示重建 |
| 无法可靠维护时 | 优先维护词条表,标记索引为"过期" |

### 11.4 索引降级策略

| 词库规模/状态 | 处理方式 |
|-------------|---------|
| 未拆分且低于阈值(200条/300行) | 索引缺失时回退扫描词条表,提示重建索引 |
| 未拆分但超过阈值 | 提示性能影响,建议先重建索引,可执行降级扫描但需提示 |
| 已拆分且主索引缺失 | 若无法定位子文件,提示修复索引;可按文件规则尝试扫描已知子文件 |
| 索引与词条冲突 | 以词条表为准,提示重建索引 |

## 12. 扩容与拆分规则

### 12.1 阈值

- 默认 200 条记录或 300 行
- 可在本规则文件中调整

### 12.2 拆分规则

- 超过阈值时仅建议拆分
- 拆分需用户确认或由维护脚本执行
- 拆分后主文件保留索引
- 子文件命名:`domain-glossary-{category}.md`
- 拆分后索引项包含文件路径
- 拆分后编号仍全局唯一

## 13. 输出格式

### 13.1 归一化记录

- 仅当发生 confirmed 命中替换、pending 自动添加、待确认问题、纠错命中时输出
- **无变化时不输出**(硬规则)
- 必须保留原文片段

### 13.2 词库更新提示

- pending 自动添加时提示用户确认/修正/否定
- 待确认术语提供候选选项

## 14. 异常处理

| 异常场景 | 处理方式 |
|---------|---------|
| 词库文件不存在(普通业务流程) | 不自动创建;跳过归一化,按现有逻辑处理;提示用户可执行迁移/初始化命令 |
| 词库文件为空 | 同上 |
| 词库格式损坏 | 提示"词库格式异常,建议检查",按现有逻辑处理 |
| 同一原词多映射(conflict) | 标记冲突,提示用户选择,不自动替换 |
| 自动添加被否定 | 状态改为 rejected,不再自动建议,除非用户恢复 |
| 词库超过 200 条 | 建议拆分,不自动拆分 |
| 索引与词条表不一致 | 以词条表为准,提示重建索引 |
| 编号重复 | 提示编号冲突,建议修正,不自动覆盖 |
| 索引缺失(小词库,未超阈值) | 回退扫描词条表,提示重建索引 |
| 索引缺失(大词库,超阈值) | 提示性能影响,建议先重建,可执行降级扫描但需提示 |
| 拆分文件缺失 | 按可定位文件降级处理,无法定位时提示修复索引 |
| 用户确认结果与已有条目冲突 | 标记 conflict,提示用户选择 |
| 新术语无法推断 | 不自动添加,在输出中标注"未识别术语:XX" |
| 旧项目无词库模板 | `migrate_workspace.py --create-glossary` 创建;检测旧术语文件并提示是否导入(不自动导入) |

## 15. 风险提示(非强保障)

- 词库文件并发修改/多人同时编辑冲突:通过 Change Log 时间戳检测提示,但不作为强保障能力
- 自动写入 pending 的授权风险:已确认允许写入,pending 不会静默替换

## 16. 禁止事项

- pending 条目不得静默替换
- 低置信度不得阻塞主体任务
- pending/低置信度不得写入确定事实源
- 不得只输出归一化结果而不保留原文
- 不得自动拆分词库文件
- 不得将待确认问题的推荐默认值视为已确认事实
- 不得删除或弱化现有 Skill 能力
- 不得新增机器配置字段
- 无变化时不得输出归一化记录
- 多义词不得自动替换,必须进入 conflict 追问

## 17. 词库文件规范

### 17.1 文件规格

- 文件类型:领域术语词库,doc_type: domain-glossary
- 存储路径:`ai/portfolio/context/domain-glossary.md`(项目集共享)
- 文件格式:Markdown,含 YAML front matter
- 依赖规则:本文件(17-domain-glossary-rules.md)+ 06-file-rules.md
- 不存在时:降级运行,不影响现有流程

### 17.2 词库文件创建边界

- 普通业务处理(日报/评审/查询/更新触发)中**不得静默创建** `domain-glossary.md`
- 以下场景允许创建:
  - `init_workspace.py --glossary`(新工作区初始化)
  - `migrate_workspace.py --create-glossary` 或常规迁移流程(老工作区升级)
  - 用户明确要求"初始化词库"时
- 创建前必须检查目标路径是否存在
- 已存在时**不得覆盖**
- 创建后记录 Change Log 或迁移日志

### 17.3 拆分规则(衔接 06)

- 超过 200 条记录或 300 行时:建议拆分,不自动拆分
- 拆分后子文件命名:`domain-glossary-{category}.md`
- 拆分后主文件保留索引,子文件索引项含文件路径

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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall