qiusuo0226/chrono-pm-skill / governance-shared/baselines/3.14.0/ChronoPM-Project
chrono-pm-project
VerifiedMarkdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio(只读)。触发:项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/整理记录/补全/回填/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好。支持主动变更+人工确认:写入即标记待确认并登记 pm-decisions,确认后生效。需求只绑工作包,计划只绑工作包。
references/08-change-control-rules.md
View on GitHub# 变更管理约束规则
本规则适用于需求变更、范围变更、进度变更、成本变更的识别、影响分析、审批和执行。需求管理基础规则见 `07-requirement-rules.md`。
---
## 1. 变更范围
本规则覆盖以下变更类型:
| 变更类型 | 说明 | 常见触发场景 |
|----------|------|--------------|
| 需求变更 | 新增、修改、删除需求 | 客户提出新需求、需求理解偏差 |
| 范围变更 | 项目交付范围调整 | 模块裁剪、交付物增减 |
| 进度变更 | 里程碑或交付时间调整 | 工期压缩、延期、提前交付 |
| 成本变更 | 预算调整 | 人力增减、外采变更 |
| 资源变更 | 人员或设备调整 | 人员变动、资源冲突 |
| 计划变更 | 单任务 Due Date / 负责人调整 | 任务延期、提前、换人(见 R2) |
### 1.1 概念域说明(重要)
本文件中的"变更类型"属于**概念域 B(变更影响分类)**,描述"变更影响了什么"。
它与**概念域 A(记录操作)**是不同维度,不可合并:
| 概念域 | 枚举 | 载体 | 语义 |
|---|---|---|---|
| A:记录操作 | `add / update / remove / status / archive` | 各事实源 Change Log、`04-risk-issue` 等 | 做了哪种写操作 |
| B:变更影响分类 | `requirement / scope / schedule / cost / resource / plan_change` | change-log.md(本文件) | 变更影响了哪类内容 |
- `plan_change` 只存在于**概念域 B**,表示"针对单任务进度/负责人的计划变更",以区别于"进度变更(schedule)"针对里程碑/整体进度。
- 各事实源(待办文件等)的 Change Log 继续使用概念域 A,**不引入** `plan_change` 操作符——计划变更通过 `update` + 描述体现。
- 追加 `plan_change` 不改变概念域 A 的任何枚举。
- **主动变更(proactive)不构成新概念域**:主动变更描述的是"写入确认时机"(先写后确认 vs 先确认后写),而非"变更影响了哪类内容",故概念域 B 枚举**不新增** `proactive_change`,本枚举维持 `requirement / scope / schedule / cost / resource / plan_change` 不变。(提示性说明,见方案 3.5.6、B-10)
---
## 2. 变更流程
所有变更必须走以下流程,不可跳过任何环节:
```
变更请求提出 → 登记到 change-log.md(已提交)
→ 影响分析(评估中)
→ CCB/项目经理评审
→ 决策:批准 / 拒绝 / 延期
→ 若批准:执行变更 → 更新事实源
→ 若拒绝:记录原因,关闭变更
→ 通知相关干系人
```
### 2.1 关键规则
1. 任何疑似变更,不得直接更新事实源文件。
2. 必须先进入 `requirements/change-log.md`,状态为 `已提交`。
3. 变更未经审批前,相关事实源文件保持不变。
4. 客户口头需求不得直接进入需求登记册,只能进入 change-log 的已提交状态。
5. **变更批准后走需求清单 / 工作包**,禁止跳过 WP 直接灌待办。已规划 WP 上的增量任务才允许拆待办。
## 3. 变更登记
### 3.1 change-log.md 字段
| 字段 | 说明 | 必填 |
|------|------|------|
| Change ID | CR-YYYYMMDD-NNN | 是 |
| 变更类型 | requirement / scope / schedule / cost / resource / plan_change | 是 |
| 描述 | 变更内容描述 | 是 |
| 变更前内容 | 原始状态 | 是 |
| 变更后内容 | 目标状态 | 是 |
| 提出人 | 提出者 | 是 |
| 提出日期 | YYYY-MM-DD | 是 |
| 变更原因 | 为什么变更 | 是 |
| 影响分析 | 见第 4 节 | 是(评估中阶段) |
| 变更级别 | micro / normal / major | 是 |
| 审批结果 | 批准 / 驳回 / 暂缓 | 否(审批后填) |
| 审批人 | 决策者 | 否 |
| 审批日期 | YYYY-MM-DD | 否 |
| 执行状态 | 待实施 / 已实施 / 已取消 | 否 |
| 关联需求 | REQ-XXX-NNN | 否 |
| 关联 WP | WP-NNN(可多个) | 否 |
| 关联决策 | D-{YYYYMMDD}-{HHmmss}(旧号 D-YYYYMMDD-NNN 双格式兼容;工作区 Change ID 仍为 CR-YYYYMMDD-NNN,不改) | 否 |
| Source | 来源 | 是 |
> `plan_change` 类型建议通过「关联 WP」字段指向工作包 WP-NNN,并在「变更后内容」中记录新的时间盒 / 负责人。禁止只改待办而绕过工作包。存量「关联任务」列停用;触碰该条时改写「关联 WP」。
### 3.2 变更状态流转
```
已提交 → 评估中 → 已批准 → 已实施
→ 已驳回(关闭)
→ 暂缓(后续可重新评估)
任何状态 → 已取消
```
## 4. 影响分析
每次变更必须进行以下维度的影响分析:
| 维度 | 分析内容 | 输出 |
|------|----------|------|
| 范围影响 | 涉及哪些模块、哪些需求 | 受影响需求清单 |
| 进度影响 | 对里程碑和交付时间的影响 | 天数偏差、里程碑风险 |
| 成本影响 | 增加的工作量和人力成本 | 人天增量、成本增量 |
| 质量影响 | 对测试范围和质量风险的影响 | 测试范围变化、质量风险 |
| 风险影响 | 引入的新风险 | 新增风险项 |
| 依赖影响 | 对上下游模块的影响 | 依赖关系变化 |
| 验收影响 | 对验收标准和验收进度的影响 | 验收范围变化 |
### 4.1 影响分析输出模板
```markdown
## 变更影响分析
### 变更概述
- Change ID: CR-YYYYMMDD-NNN
- 变更类型: [类型]
- 描述: [描述]
### 范围影响
- 受影响需求: [REQ-XXX-NNN 列表]
- 受影响模块: [模块列表]
### 进度影响
- 工作量增量: [X] 人天
- 里程碑影响: [里程碑型 WP(WP-NNN)是否延期]
- 预计进度偏差: [X]%
### 成本影响
- 人力成本增量: [X] 人天
- 预算偏差: [X]%
### 质量影响
- 测试范围变化: [说明]
- 质量风险: [说明]
### 风险影响
- 新增风险: [R-NNN 或描述;存量时间戳号三格式兼容]
### 依赖影响
- 上下游影响: [说明]
### 验收影响
- 验收标准变化: [说明]
- 验收进度影响: [说明]
```
## 5. 变更分级
| 变更级别 | 判定标准 | 审批权限 |
|----------|----------|----------|
| 微变更(micro) | 工作量增量 ≤ 2人天,无里程碑影响,无成本基线影响 | 项目经理审批 |
| 一般变更(normal) | 工作量增量 2-10人天,可能有进度偏差,不涉及成本基线 | CCB 评审 |
| 重大变更(major) | 工作量增量 > 10人天,或影响里程碑,或影响成本基线,或影响合同范围 | CCB 评审 + 发起方确认 |
CCB(变更控制委员会)组成:项目经理、技术负责人、客户代表(如需)、发起方代表(重大变更时)。
## 6. 变更执行
### 6.1 批准后执行步骤
1. 更新 `requirements/change-log.md`:状态改为 `已实施`。
2. 更新需求清单(`requirements/_index.md` + 登记册/分片):新增/修改/标记对应需求;生命周期改为 `已变更`(如适用)。
3. 绑定或调整受影响工作包(`wps/WP-NNN.md`)。无对应需求则先补需求再绑,**禁止无需求建 WP**。
4. **仅当 WP 状态为「已规划」时**,才允许拆增量待办。禁止变更单跳过 WP 直接灌待办。
5. 更新 `project-info/progress-plan.md`:调整进度计划 / 工作包时间盒(如需)。计划只引用工作包,不按人员×日期灌待办。
6. 更新 `project-info/budget.md`:调整预算(如需)。
7. 更新 `risks/risk-register.md`:新增变更引入的风险(如有)。
8. 更新 `decisions/decision-log.md`:记录审批决策。
9. 通知相关干系人。
> 计划变更(`plan_change`)批准后,同步 WP 时间盒;下辖待办的 `Due Date` / `Owner` 从所属 WP 继承,禁止只改待办行而绕过工作包。
### 6.1a 禁止跳过工作包
- 批准后的路径:变更单 → 需求清单 → 工作包 →(已规划 WP)待办。
- 禁止:变更单 → 待办。
- 未确认需求不得组已规划工作包、不得拆待办。
### 6.2 执行输出
```markdown
## 变更执行清单
| Target File | Update Type | Suggested Change | Confirmed |
|---|---|---|---|
| requirements/_index.md 与需求清单分片 | update | REQ-XXX-001 生命周期改为已变更 | 待确认 |
| wps/WP-NNN.md | update | 绑定/调整工作包(只存需求编号) | 待确认 |
| ... | | | |
```
所有更新必须通过"建议更新清单"输出,人工确认后执行。
## 7. 变更记录独立性
1. `requirements/change-log.md` 是独立文件,不可将变更记录长期追加到 `requirement-register.md` 中。
2. 变更记录按时间顺序排列,最新的在最上面。
3. 已关闭的变更(已驳回、已取消、已实施)保留记录,不可删除。
4. 变更记录超过 100 条时,触发归档(纯条数触发,取消季度粒度)。归档目标 `requirements/archive/YYYY-change-log-archive.md`,归档后维护 `requirements/archive/index.md`。
## 8. Change Log
change-log.md 本身不需要底部 Change Log(它本身就是变更记录)。但 requirement-register.md 底部需维护 Change Log,记录因变更导致的需求状态变化。
## 9. 级联传播规则
本实体(变更)状态变更时,按以下规则触发下游动作。动作分三类:
- [AUTO] 写派生视图(索引),低风险,直接执行
- [CHECK] 只读校验,检查关联是否存在/一致
- [SUGGEST] 写事实源或影响其他实体,加入建议更新清单待 PM 确认
> **AUTO 作用域声明**:AUTO 仅作用于非事实源的派生视图,不触碰任何事实源文件。事实源写入(含 `ai/pm-decisions.md` 登记)一律受 `skill-contract.md` 第 5 条约束。
执行顺序:先 AUTO → 再 CHECK → 最后 SUGGEST。
同一处理流程内,级联动作只执行一次;多个 SUGGEST 汇总为同一批建议清单,流程末尾统一输出。
执行完毕后,14 号自查清单验证完整性。
> **强制执行要求**(见 `00-pm-main-rules.md` §8a):以上 AUTO/CHECK/SUGGEST 动作不得静默跳过。SUGGEST 必须呈现给 PM 确认,不得以"用户未要求"为由省略。流程末尾必须输出"级联完整性"结论。
变更批准 →
[SUGGEST] 更新所有受影响的事实源文件(影响范围见变更影响分析;路径=需求清单→工作包,禁止跳过 WP 灌待办)
[AUTO] 更新 change-log 衍生索引
[AUTO] 更新 `ai/pm-decisions.md`(从开放块移除已确认条目,追加决策记录)
变更拒绝 →
[AUTO] 更新 `ai/pm-decisions.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 |