Skip to content

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

chronopm

Verified

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

SKILL_BLUEPRINT.md

View on GitHub
# SKILL_BLUEPRINT.md

> ChronoPM Skill 架构决策与能力审查蓝图。本文件可随时复制给外部 AI 进行审查和补充建议。

---

## Document Boundary

本文件不是 `SKILL.md` 的复制,也不是运行手册。

- `SKILL.md` 负责描述 Skill 如何被调用、如何路由、如何执行(回答"怎么做");
- `SKILL_BLUEPRINT.md` 负责描述 Skill 为什么这样设计、当前能力全景、能力成熟度、已知缺口和演进方向(回答"为什么"和"还差什么")。

本文件只在必要处引用 `SKILL.md` 的章节编号,不复制完整目录树、规则全文或状态枚举。如需操作细节,请阅读 `SKILL.md` 及 `references/` 下的规则文件。

---

## 1. Basic Information

| 属性 | 值 |
|---|---|
| Skill 名称 | ChronoPM — Markdown 驱动的 AI 项目管理技能 |
| 当前版本 | 1.13.0(版本单一事实源为 `scripts/_version.py`) |
| Workspace Schema | 详见 `scripts/_version.py`(WORKSPACE_SCHEMA_VERSION) |
| 创建日期 | 2026-08-09 |
| 最后更新 | 2026-08-12 (v1.13.0 架构精简改造:实体级联嵌入+文件膨胀治理+版本同步收口+Blueprint 瘦身;v1.12.0 工作空间清洁度治理:新增§18白名单/§19交付物控制/§20引用约束,§2流程10→12步;v1.11.0 主动变更+人工确认更新模式:新增 pending-changes 索引 + Change Log 分层归档,权限模型改名 proactive/passive/progressive;v1.10.2 脚本层版本治理;v1.10.1 修复 CR-008 执行遗留;v1.10.0 历史计划全量同步与变更追溯) |
| 维护方式 | 随 Skill 版本同步更新(详见 §13 Update Policy) |
| 入口文件 | `SKILL.md` |
| 元数据 | `skill.json` |
| 核心契约 | `governance/contracts/skill-contract.md` |
| 文件总数 | 约 80 个(22 份规则 + 44 个模板 + 2 个脚本 + 5 个治理文件 + 1 个回归套件 + 版本/蓝图文件) |

---

## 2. Purpose and Design Philosophy

### 2.1 核心目的

为项目经理(尤其 To G / To B 政企数字化转型领域)提供一套以 Markdown 文件为事实源、AI 为辅助、人工确认为控制点的项目管理技能。覆盖需求管理、任务跟踪、进度管控、风险与问题、里程碑、成本与 P&L、日报周报、会议纪要、决策记录、复盘、项目集统筹、人员资源协调与流转等全链路。

### 2.2 设计哲学

ChronoPM 建立在三层信任模型之上:

```
事实源文件(Markdown)  ←  唯一真相,人工确认后才能更新
        ↑
  AI 辅助引擎           ←  分析、建议、生成草稿,不直接修改事实源
        ↑
  人工确认控制点         ←  项目经理审查后决定是否采纳
```

核心信念:

1. **事实源不可绕过**:项目状态以 `ai/` 目录下的事实源文件为唯一真相,日报和会议纪要只是信息输入,不能直接替代事实源。
2. **AI 不决策**:AI 是副手和参谋,不是决策者。涉及资源调配、范围变更、里程碑调整的决策必须由项目经理做出。
3. **过程可追溯**:每条记录必须有 Source 字段,可追溯到来源文档或口述。

---

## 3. Target Users and Operating Context

### 3.1 目标用户

| 用户画像 | 说明 |
|---|---|
| 主要用户 | 项目经理 / 项目集经理,持有 PMP/PRINCE2/CSPM-3 等认证 |
| 行业背景 | To G / To B 政企数字化转型,智慧政务领域 |
| 典型场景 | 省级政务平台建设与交付,多子项目并行管理 |
| 管理规模 | 千万级合同额,多子项目,10-30 人团队 |
| 技术底盘 | Java+Vue 全栈、微服务架构、信创国产化适配 |

### 3.2 运行环境

- AI 平台:灵犀桌面助手(支持 SKILL.md 加载、文件读写、脚本执行)
- 文件系统:本地工作区,`ai/` 目录为事实源载体
- 脚本环境:Python 3.9+

---

## 4. Architectural Decisions

以下每个决策都包含"为什么这样选"和"否决了什么替代方案"。

### AD-01. 使用 Markdown 作为主事实源格式

**决策**:项目状态以 Markdown 文件存储,不使用数据库或在线系统。

**理由**:Markdown 是人类可读、AI 可解析、Git 可追踪的格式。项目经理可以直接打开文件阅读和修改,不依赖任何平台。AI 可以读取和生成 Markdown,无需额外接口。

**否决方案**:
- SQLite 数据库:需要额外工具查看,非技术用户不友好,Git diff 不可读
- 在线 PMS(Jira/禅道):引入外部依赖,无法离线使用,且项目集跨系统汇总困难

### AD-02. ai/ 与业务目录分离

**决策**:所有 AI 管理文件只存在于根目录 `ai/` 下,不侵入业务子项目目录。

**理由**:业务目录是交付团队的工作空间,AI 管理文件混入其中会造成干扰、增加 Git 冲突风险、模糊管理边界。

**否决方案**:每个子项目下生成 `ai/` 文件夹 — 侵占业务空间,项目集汇总需要跨目录读取

### AD-03. outputs/ 与 ai/ 分离

**决策**:AI 生成物(周报、Excel、报告等)放在 `outputs/` 目录,与 `ai/` 事实源同级但分离。

**理由**:生成物是"输出",事实源是"输入"。混在一起会导致 AI 难以区分哪些文件可以覆盖(生成物)哪些不能(事实源)。

**否决方案**:生成物直接写入 ai/ — 违反事实源不可污染原则

### AD-04. 项目集模式采用集中式 ai/portfolio + ai/projects

**决策**:项目集模式下,所有管理文档集中在根目录 `ai/` 中,按 `portfolio/`(项目集级)和 `projects/{子项目名}/`(子项目级)分层。

**理由**:项目集经理需要全局视角,集中式管理便于跨项目汇总(周报、风险、资源)。向上汇总、向下不下沉。

**否决方案**:分散式管理(每个子项目独立 ai/)— 汇总时需要跨目录扫描,效率低且易遗漏

### AD-05. 查询采用索引优先,不默认全量扫描

**决策**:查询类请求必须先读索引文件(todo-index、history-index),不默认创建临时脚本全量扫描文件。

**理由**:项目文件数量增长后,全量扫描耗时且不可控。索引预建确保查询性能稳定。

**否决方案**:每次查询临时扫描 — 性能差,且可能遗漏或重复

### AD-06. 历史导入采用 continuity/carryover,不直接覆盖

**决策**:历史项目内容通过 `continuity/` 目录的衔接流程导入,先登记、再结转、最后确认,不直接覆盖当前事实源。

**理由**:历史数据可能包含已过时的信息,直接覆盖会导致当前项目状态丢失。

**否决方案**:直接复制历史 ai/ 目录 — 无法处理冲突,无法选择性继承

### AD-07. Skill 变更采用治理流程和回归保护

**决策**:任何 Skill 修改必须先生成变更工单(CR)、升级方案审查文档(AP)、影响分析(IA),经用户确认后才能执行。变更后必须运行回归测试。

**理由**:Skill 已有 64+ 个文件,随意修改会导致已有能力失效且难以回溯。

**否决方案**:直接修改文件 — 无法追踪变更影响,无法回滚

### AD-08. 工作区升级需用户确认,不静默迁移

**决策**:Skill 版本升级后,旧工作区不自动迁移。AI 检测到版本差异时提示用户,用户确认后才执行迁移脚本。

**理由**:静默迁移可能破坏已有项目数据,用户需要知道发生了什么变更。

**否决方案**:自动迁移 — 用户不知情,迁移失败时无法回溯

### AD-09. SKILL.md 采用"入口路由器"架构

**决策**:`SKILL.md` 主入口只保留定位、工作模式、工作区结构概要、核心工作流路由、提示词路由表、安全底线、ID 编码、规则索引;状态枚举、输出规范、里程碑体系、例外容忍度等规则详情下沉到 `references/00-pm-main-rules.md`(§5a/§5.4/§5.5/§5b/§5c),主入口以引用指针指向它们。

**理由**:主入口作为 AI 每次必读的文件,若承载过多规则正文会显著增加上下文负担、降低导航效率。将详情下沉到单一事实源 references,可避免同一条规则在多处重复维护(单一来源),并使主入口保持精简(v1.8.0 由 478 行降至 297 行)。

**否决方案**:
- 主入口保留全部规则正文 — 上下文过重、跨文件维护时易出现不一致
- 将详情分散下沉到多个 references — 增加路由复杂度、追查困难

### Design Decisions Not To Change Lightly

以下是当前 Skill 的核心设计决策,外部审查者可以挑战,但必须给出充分理由和迁移成本评估:

1. 使用 Markdown 作为主事实源格式(而非数据库)
2. `ai/` 与业务目录分离(不侵入业务空间)
3. `outputs/` 与 `ai/` 分离(生成物不污染事实源)
4. 项目集模式采用集中式 `ai/portfolio + ai/projects`
5. 查询采用索引优先,不默认全量扫描
6. 历史导入采用 continuity/carryover,不直接覆盖当前事实源
7. Skill 变更采用治理流程和回归保护
8. 工作区升级必须用户确认,不静默迁移
9. 同一人同一天只允许一份日报文件,多次提交合并追加不覆盖
10. 快照冻结后不可静默覆盖,修改需追加 Revision Log
11. `SKILL.md` 作为入口路由器,规则详情下沉至 references(见 AD-09)

---

## 5. Capability Map and Maturity Matrix

### 5.1 成熟度模型

| 等级 | 含义 |
|---|---|
| L0 | 仅想法,未实现 |
| L1 | 有规则文件,无完整模板或脚本支撑 |
| L2 | 有规则和模板,但部分流程依赖人工操作 |
| L3 | 规则、模板、流程完整,可稳定使用 |
| L4 | 有自动化脚本和回归测试覆盖 |
| L5 | 长期验证稳定,有迁移和回滚机制 |

### 5.2 能力矩阵

| Capability ID | Capability | Status | Maturity | Rule Files | Templates | Notes |
|---|---|---|---|---|---|---|
| CAP-001 | Workspace Initialization | stable | L4 | `06-file-rules.md` | project-context, project-index, workspace-health 等 | init_workspace.py 支持 single/portfolio 模式 |
| CAP-002 | Daily Report Management | stable | L4 | `01-daily-report-rules.md`, `00-pm-main-rules.md` | personal-daily, project-daily, personal-progress | 含合并幂等性 + 个人进度联动 |
| CAP-003 | Weekly Report & Portfolio Rollup | stable | L3 | `01-daily-report-rules.md`, `09-portfolio-rules.md` | weekly-report, portfolio-weekly | 子项目周报 + 项目集汇总 |
| CAP-004 | PM Daily Todo (9-section Panorama) | stable | L3 | `05-query-rules.md` | pm-daily-todo, todo-index 系列 | 全团队聚合视图,禁止只列 PM 个人任务 |
| CAP-005 | Quick Query (Index-First) | stable | L3 | `05-query-rules.md`, `14-self-check-rules.md` | todo-index 系列, history-index | 索引优先,禁止默认全量扫描 |
| CAP-006 | Output Artifact Management | stable | L3 | `11-output-artifact-rules.md` | outputs-index, output-manifest | 批次目录 + 草稿/确认/导出流程 |
| CAP-007 | Risk & Issue Management | stable | L4 | `04-risk-issue-rules.md` | risk-register, issue-register | 含多源交叉校验 |
| CAP-008 | Requirement Management | stable | L3 | `07-requirement-rules.md` | requirement-register, change-log | 需求追踪矩阵 |
| CAP-009 | Change Control | stable | L3 | `08-change-control-rules.md` | change-log | 变更流程 + 影响分析 |
| CAP-010 | Resource Management | stable | L3 | `09-portfolio-rules.md` | resource-register, transfer-log | 状态与历史分离 |
| CAP-011 | Historical Continuity | partial | L2 | `13-continuity-rules.md` | carryover-register, legacy-sources, project-lineage, import-log | 规则完整但导入仍依赖人工操作 |
| CAP-012 | Todo Snapshot & Actuals | stable | L3 | `15-snapshot-rules.md` | snapshot, actuals, history-index 系列 | 快照冻结 + 计划vs实际对比 |
| CAP-013 | Self-Check & Completeness | stable | L3 | `14-self-check-rules.md` | — | D1-D10/M1-M7/R1-R6/T1-T7 自查清单 |
| CAP-014 | Excel Generation | stable | L3 | `12-excel-generation-rules.md` | — | 8 种文档 sheet 结构/列头/验证/公式/条件格式 |
| CAP-015 | Version & Compatibility | stable | L4 | `20-workspace-version-rules.md` | workspace-health, .skill-version.json | 健康检查 + 兼容模式 + 迁移脚本 |
| CAP-016 | Update Trigger & Intent Detection | stable | L3 | `10-update-trigger-rules.md` | — | 四级触发 + 权限分级 |
| CAP-017 | Skill Governance | stable | L3 | `16-skill-governance-rules.md` | CR-template, IA-template, RR-template, release-checklist | 变更工单 + AP 审查 + 回归保护 |
| CAP-018 | Blueprint & External Review | stable | L3 | `16-skill-governance-rules.md §17` | SKILL_BLUEPRINT.md (本文件) | 架构决策 + 能力矩阵 + 外部审查入口 |
| CAP-019 | Domain Glossary | stable | L3 | `17-domain-glossary-rules.md` | domain-glossary | 术语归一化 + 置信度 + 纠错 + 确认式学习 |
| CAP-020 | Project Initialization Wizard | stable | L3 | `18-init-wizard-rules.md` | iteration-register | 六步引导建档(合同→项目→迭代→需求→资源→里程碑),含进度记忆、断点续接、确认写入 |
| CAP-021 | Information Completeness Inspection | stable | L3 | `19-info-completeness-rules.md` | — | 7层检查维度(合同/项目/迭代/需求/任务/资源/里程碑),P0-P3分级提醒,静默策略,巡检报告 |
| CAP-022 | Entry Router & Knowledge Navigation | stable | L4 | `SKILL.md`, `00-pm-main-rules.md` | — | v1.8.0:SKILL.md 主入口改为路由器,规则详情下沉至 references(AD-09),由 SK-1A~1G 回归护航 |
| CAP-023 | PM Profile & Preference Learning | stable | L3 | `21-pm-profile-rules.md` | pm-profile-template | v1.9.0:用户习惯学习与偏好适配,复用 domain-glossary 状态机,被动观察→pending→confirmed |
| CAP-024 | Historical Plan Import & Change/Delay Tracking | stable | L3 | `03,05,08,13,15,00` | plan-import, delay-stats, task-board, change-log, todo-history-index | v1.10.0:R1 批量导入存量计划(→external_import 冻结快照)、R2 计划变更追踪(计数+plan_change)、R3 延期计数、R4 聚合查询只读 board 单文件;B 类超期实时计算+索引优先 |
| CAP-025 | Proactive Change & Pending Window | stable | L3 | `00,01,03,05,06,10,14,19`, `skill-contract` | pending-changes-index, change-log, change-log-index, change-log-archive | v1.11.0:主动变更+人工确认更新模式;待确认记录不参与延期/超期判定(确认窗口期);权限模型 proactive/passive/progressive;skill-contract #5 与 SKILL.md §7 安全底线 #2 修改(三防线:审计/超时/回滚) |
| CAP-026 | Change Log Tiered Archive | stable | L2 | `06-file-rules.md` | change-log-index, change-log-archive | v1.11.0:活跃区 50 行/30 天触发按月归档至 change-log/archive/,维护 change-log/index.md 月份导航 |

### 5.3 成熟度分布

详见 `tests/regression-suite.md` 各模块成熟度标注。§5.2 矩阵按实际行数统计 per level。

---

## 6. Workspace Schema Evolution

### 6.1 演进路径

| Schema | Skill Version | 关键变更 | 迁移方式 |
|---|---|---|---|
| 0.1.0 | 0.1.0 - 0.2.0 | 初始结构:ai/ 基础目录 + 9 份规则 + 11 个模板 | 无需迁移(初始) |
| 0.2.0 | 0.3.0 - 0.4.0 | 项目集模式 + 资源管理 + 业务目录不侵入 + project-brief | migrate_workspace.py |
| 0.3.0 | 0.5.0 - 0.8.1 | outputs/ 目录 + continuity/ 目录 | migrate_workspace.py |
| 0.4.0 | 0.9.0 - 1.0.1 | todos/ 目录 + snapshots/ + actuals/ + 索引体系 | migrate_workspace.py --index-mode |
| 0.5.0 | 1.1.0 - 1.10.2 | 快照冻结规则 + actuals 可追加 + 历史索引 | 无需迁移(规则增强) |
| 0.6.0 | 1.11.0 - 1.12.0 | 待确认变更索引 pending-changes.md + change-log 分层归档(archive/ 目录) | migrate_workspace.py (SCHEMA_060) |

### 6.2 兼容性策略

- `skill.json` 中 `supportedWorkspaceSchema.min` 标记最低兼容版本
- AI 进入工作区时读取 `.skill-version.json` 检查版本差异
- 版本差异时输出迁移建议,不自行迁移
- `migrate_workspace.py` 支持 `--dry-run` 预览和 `--index-mode` 控制索引重建范围

---

## 7. Rule Module Dependency Map

### 7.1 规则文件清单

| 编号 | 文件 | 定位 |
|---|---|---|
| 00 | `00-pm-main-rules.md` | 总纲:角色、原则、行为边界、意图检测 |
| 01 | `01-daily-report-rules.md` | 日报:生成、合并、联动、快照 |
| 02 | `02-meeting-rules.md` | 会议:纪要、行动项提取、§6 级联传播规则 |
| 03 | `03-task-board-rules.md` | 任务:看板字段、状态流转、§8 级联传播规则 |
| 04 | `04-risk-issue-rules.md` | 风险/问题:识别、评估、升级、§9 级联传播规则 |
| 05 | `05-query-rules.md` | 查询:路由、索引优先、PM 待办输出 |
| 06 | `06-file-rules.md` | 文件:命名、目录边界、创建/更新/瘦身/归档、索引、安全 |
| 07 | `07-requirement-rules.md` | 需求:分类、评审、追踪矩阵、§7 级联传播规则 |
| 08 | `08-change-control-rules.md` | 变更:流程、影响分析、审批、§9 级联传播规则 |
| 09 | `09-portfolio-rules.md` | 项目集:汇总、跨项目风险、资源管理、§8 级联传播规则 |
| 10 | `10-update-trigger-rules.md` | 触发:四级触发、语义信号、权限分级 |
| 11 | `11-output-artifact-rules.md` | 输出物:批次目录、草稿确认导出 |
| 12 | `12-excel-generation-rules.md` | Excel:8 种文档生成规范 |
| 13 | `13-continuity-rules.md` | 衔接:历史导入、结转、冲突检测 |
| 14 | `14-self-check-rules.md` | 自查:索引预建、D1-D10/M1-M7/R1-R6/T1-T7 |
| 15 | `15-snapshot-rules.md` | 快照:冻结、actuals、历史索引、偏差对比 |
| 16 | `16-skill-governance-rules.md` | 治理:变更工单、AP 审查、回归、Blueprint 更新 |
| 17 | `17-domain-glossary-rules.md` | 词库:术语归一化、置信度、纠错、自动学习 |
| 18 | `18-init-wizard-rules.md` | 初始化向导:六步引导建档、进度记忆、断点续接 |
| 19 | `19-info-completeness-rules.md` | 完整性巡检:7层检查维度、P0-P3分级提醒、静默策略 |
| 20 | `20-workspace-version-rules.md` | 工作区版本:版本检查、健康检查、兼容模式、迁移 |
| 21 | `21-pm-profile-rules.md` | PM 偏好:用户习惯学习、5 类偏好分类、pending→confirmed 状态机 |

### 7.2 依赖关系

```
00 (总纲) ──被所有规则依赖──
  │
  ├── 01 (日报) ──依赖──→ 03 (任务), 04 (风险), 09 (项目集), 15 (快照)
  ├── 02 (会议) ──依赖──→ 03 (任务), 04 (风险), 08 (变更)
  ├── 05 (查询) ──依赖──→ 01 (日报), 14 (自查), 15 (快照)
  ├── 06 (文件) ──被所有文件操作依赖──
  ├── 07 (需求) ──依赖──→ 08 (变更)
  ├── 09 (项目集) ──依赖──→ 01 (日报), 04 (风险)
  ├── 10 (触发) ──依赖──→ 01-09 (按事项类型路由)
  ├── 11 (输出物) ──依赖──→ 06 (文件)
  ├── 12 (Excel) ──依赖──→ 11 (输出物)
  ├── 13 (衔接) ──依赖──→ 04 (风险), 07 (需求)
  ├── 14 (自查) ──依赖──→ 01 (日报), 02 (会议), 04 (风险)
  ├── 15 (快照) ──依赖──→ 01 (日报), 03 (任务, R1导入联动), 13 (衔接, R1边界判定)
  ├── 17 (词库) ──依赖──→ 01, 02, 05, 06, 10 (术语归一化前置)
  ├── 18 (初始化向导) ──依赖──→ 00, 06 (触发检测+文件写入)
  ├── 19 (完整性巡检) ──依赖──→ 00, 10 (意图检测+更新触发后检查)
  ├── 20 (工作区版本) ──依赖──→ 06 (文件规则), 16 (治理,CHANGELOG 判定)
  ├── 21 (PM 偏好) ──依赖──→ 00 (总纲), 06 (文件规则), 10 (更新触发), 17 (术语归一化), 20 (版本检查)
  └── 16 (治理) ──元规则,约束 Skill 自身变更──
```

> 实体间的**级联/传播依赖**不在本图重复声明,改由各实体规则文件自身的 `§级联传播规则` 声明(见 03 §8、04 §9、07 §7、09 §8、02 §6、08 §9)。本图仅保留模块级引用关系。

### 7.3 关键交互说明

- **00 是总纲**:所有场景必须加载,定义角色定位和行为边界
- **10 是入口路由**:用户输入先经 10 判断意图和路由,再加载对应规则
- **14 是质量守卫**:01/02 处理后必须经 14 自查,确保不遗漏
- **16 是元规则**:不约束项目管理业务,约束 Skill 自身的变更行为

---

## 8. Key Data Flows

### 8.1 日报数据流

```
个人日报输入
  → [01] 生成个人日报文件 (reports/daily/personal/)
  → [01] 合并多个个人日报 → 生成项目日报 (reports/daily/project/)
  → [10] 检测更新信号 → 输出建议更新清单
  → [14] 执行 D1-D10 自查清单
  → [15] 生成计划快照 (snapshots/daily/) + 实际执行摘要 (actuals/daily/)
  → [01] 更新个人进度 (summaries/{name}-progress.md)
  → [01] 更新待办索引 (todos/personal-todo-index.md)
  → [09] 检测资源变动 → 更新 resource-register + transfer-log
  → [04] 检测风险/问题 → 输出风险候选
```

### 8.2 周报数据流

```
[11] 用户说"生成周报" → 进入 outputs/ 批次目录
  → [09] 读取 portfolio/context/project-index.md 获取子项目清单
  → [01] 遍历每个子项目当周日报
  → [01] 读取各子项目本周周报草稿
  → [04] 汇总各子项目风险/问题
  → [09] 汇总跨项目事项(资源冲突、共性问题)
  → 生成汇总周报草稿 (outputs/{timestamp}/draft.md)
  → 用户确认 → 生成 final.md → 导出
  → [15] 生成 actuals/weekly/ 实际执行摘要
```

### 8.3 变更数据流

```
变更请求输入
  → [08] 登记到 change-log.md (submitted)
  → [08] 影响分析(范围/进度/成本/质量/风险/里程碑)
  → [00] 项目经理决策 → 记录决策
  → 若批准:[07] 更新 requirement-register.md + [03] 更新 board.md + [04] 更新风险
```

### 8.4 历史导入数据流

```
历史项目内容输入(ai 目录/文件/口述)
  → [13] 识别导入模式(ai目录/文件/地址/口述)
  → [13] 登记到 legacy-sources.md
  → [13] 内容路由(风险/问题/需求/任务/里程碑/决策)
  → [13] 冲突检测(与当前事实源对比)
  → [13] 进入 carryover-register.md 等待确认
  → 用户确认后 → 更新对应事实源文件
  → [13] 记录到 import-log.md
```

### 8.5 查询数据流

```
用户提问
  → [05] 判断问题类型和层级
  → [05] 查找索引(todo-index/history-index/snapshots/actuals)
  → 索引命中 → 读取对应事实源文件
  → 索引未命中 → 提示用户重建索引,不自行全量扫描
  → 输出结论 + 信息来源 + 不确定项
```

### 8.6 初始化向导数据流

```
新工作区检测 / 用户说"初始化项目"
  → [18] 检测 project-brief.md status=草稿
  → [18] 启动六步向导
  → Step 1: 合同层 → 录入合同/立项/启动/完工时间 → 写入 project-context + project-brief
  → Step 2: 项目层 → 确认子项目清单 → 写入 project-index
  → Step 3: 迭代层 → 录入迭代名称/时间 → 写入 iteration-register
  → Step 4: 需求层 → 录入迭代需求数量 → 写入 iteration-register
  → Step 5: 资源层 → 录入迭代资源 → 写入 iteration-register + resource-register
  → Step 6: 里程碑层 → 补充里程碑时间 → 写入 milestone-board
  → [18] 生成确认摘要 → 用户确认 → 写入所有文件
  → project-brief.md status 改为"已确认"
```

### 8.7 信息完整性巡检数据流

```
用户发起日常操作(查询/生成报告/分析风险/推导计划)
  → [19] 判断操作涉及的管理域
  → [19] 读取相关事实源文件
  → [19] 按检查维度表逐字段检查
  → [19] 判断缺失项严重程度(P0-P3,含动态升降级)
  → P0 → 必须提醒,可能阻塞当前任务
  → P1 → 主动提醒,标注结论限制
  → P2 → 回答后简短提示
  → P3 → 不提醒
  → 用户选择补充/稍后/忽略
  → 如补充 → 更新对应事实源文件
```

### 8.8 Skill 变更数据流

```
用户提出 Skill 变更请求
  → [16] 生成变更工单 (CR)
  → [16] 生成升级方案审查文档 (AP, 7 章节)
  → [16] 生成影响分析 (IA)
  → 用户确认
  → [16] 执行最小变更
  → [tests] 运行回归测试
  → [16] 生成回归报告 (RR)
  → [16] 更新 VERSION / skill.json / CHANGELOG.md
  → [16] 更新 SKILL_BLUEPRINT.md (按 §13 Update Policy)
  → [16] 生成基线快照
```

---

## 9. Current Version Assessment

### 9.1 稳定能力(L3+)

详见 `tests/regression-suite.md` Module 成熟度标注中 L3 及以上的能力。

### 9.2 实验性/部分实现能力(L2)

- 历史阶段衔接(L2):规则完整,5 种导入模式和冲突检测已实现,但导入过程仍依赖人工操作,缺少自动化导入脚本
- Change Log 分层归档(L2,CAP-026,本次新增):框架与规则已落地,归档触发依赖规则执行,尚未脚本化自动触发

### 9.3 版本成熟度总结

当前 v1.13.0 是正式版(v1.0.0 起的第 23 个版本),核心能力均达到 L3 以上成熟度。整体处于"功能完备、持续优化"阶段。§5.2 矩阵共 26 个 CAP:L2 = 2(CAP-011、CAP-026),L3 = 19,L4 = 5(CAP-001、CAP-002、CAP-007、CAP-015、CAP-022)。最近的 1.7.x 聚焦脚本与规则体量精简,1.8.x 聚焦 SKILL.md 路由化与规则职责收敛(如 06 文件规则瘦身、工作区版本规则外移至 20 号、01 日报规则瘦身与模板指针化、05/11/07 规则表格化)。v1.8.4 为升级路线收尾。v1.9.0 新增 PM Profile 用户习惯学习(CAP-023),复用 domain-glossary 的 pending→confirmed 状态机,实现 AI 输出的个性化适配。v1.10.0 新增历史计划全量同步与变更追溯(CAP-024),覆盖 R1 批量导入、R2 计划变更追踪、R3 延期计数、R4 聚合查询路由。v1.10.1 为 CR-008 遗留计数 bugfix:修正 §5.3 成熟度分布统计,与 §5.2 能力矩阵对齐。v1.11.0 引入主动变更+人工确认更新模式(CAP-025/026),新增 pending-changes 索引与 Change Log 分层归档。v1.12.0 完成工作空间清洁度治理(新增§18白名单/§19交付物控制/§20引用约束)。v1.13.0 完成架构精简改造:实体级联嵌入、文件膨胀治理、索引派生分级、版本同步收口、Blueprint 瘦身。

---

## 10. Known Limitations and Design Debt

### 10.1 Known Boundaries

以下是有意为之的设计边界,不是缺陷:

| 边界 | 说明 | 设计理由 |
|---|---|---|
| 不直接连接真实项目管理系统 | 不对接 Jira/禅道/OA 等 | Markdown 事实源是核心设计决策,外部系统对接属于扩展而非核心 |
| 不替代正式 OA/ERP/PMS | AI 是辅助而非替代 | 项目经理是决策者,AI 是副手 |
| 默认不全量扫描历史文件 | 查询走索引优先 | 全量扫描性能不可控,索引预建确保稳定性 |
| 默认不静默迁移旧工作区 | 升级需用户确认 | 静默迁移可能破坏已有数据 |
| 不自动执行人员调配决策 | 人员变动需人工确认 | 资源调配是项目经理的决策权 |
| 不自动审批变更 | 变更必须人工审批 | 变更影响范围大,AI 不替代决策 |
| Blueprint 不参与运行时路由 | Blueprint 是被动文档 | Blueprint 供外部审查,不影响 AI 执行行为 |
| Qoder 环境需轻量入口 | SKILL.md 22KB 在 Qoder 中每轮注入上下文导致屏闪(已由 QoderWork 确认) | 提供 QODER_RULES.md 轻量入口(~4KB),含快捷路由和最小读取原则 |
| PM Profile 不影响事实源 | PM Profile 仅影响 AI 输出方式和交互风格,不影响事实源内容 | 事实源准确性是核心设计决策,偏好学习仅优化输出体验 |

### 10.2 Design Debt / Gaps

以下是已知待修缺陷,后续要补:

| 编号 | 缺陷 | 影响 | 建议优先级 |
|---|---|---|---|
| DEBT-01 | 历史导入缺少自动化脚本 | 导入效率低,依赖人工操作 | P1 |
| DEBT-02 | 回归测试尚未完全自动化 | 每次变更需人工执行测试用例 | P2 |
| DEBT-03 | 历史索引重建依赖人工确认 | 索引过期时需用户手动触发 | P2 |
| DEBT-04 | 跨项目人员身份映射可能不完整 | 同一人在不同子项目可能用不同名 | P2 |
| DEBT-05 | 模板数量(38个)增加后缺少模板索引 | 查找模板需要遍历目录 | P1 |
| DEBT-06 | 成本测算表尚无自动汇总公式 | 需人工填写汇总 | P2 |
| DEBT-07 | Blueprint 更新依赖人工记忆 | 发布检查清单可捕获,但非自动 | P2 |

---

## 11. Roadmap and Backlog

### 11.1 已规划能力

| 编号 | 能能 | 描述 | 优先级 | 依赖 |
|---|---|---|---|---|
| TODO-01 | 模板索引 | 自动生成模板目录索引,支持按场景查找模板 | P1 | 无 |
| TODO-02 | 历史导入自动化脚本 | 脚本化导入流程,减少人工操作 | P1 | DEBT-01 |
| TODO-03 | 验收管理 | deliverables/ 和 acceptance/ 目录的完整规则和模板 | P2 | 无 |
| TODO-04 | 缺陷跟踪 | quality/ 目录规则,或 issues 中 type=defect 的细化规则 | P2 | 无 |
| TODO-05 | 回归测试自动化 | 将 163 个回归用例脚本化执行 | P2 | DEBT-02 |

### 11.2 评估中能力

| 编号 | 能力 | 描述 | 评估状态 |
|---|---|---|---|
| EVAL-01 | 多项目集管理 | 支持多个独立项目集的跨集查询和汇总 | 待评估需求场景 |
| EVAL-02 | Blueprint 自动生成 | 根据规则文件和模板自动生成能力矩阵 | 当前人工维护足够 |
| EVAL-03 | 成本预警自动化 | 当 CPI/SPI 超阈值时自动生成预警 | 待评估触发机制 |

### 11.3 已落地结构变更

详见 `governance/change-requests/` 各 CR 工单的 Scope 和 Blueprint Impact 段。

| Version | Change | CR ID |
|---------|--------|-------|
| 1.13.0 | 实体级联传播 + 归档治理 + 索引分级 + 版本同步 + Blueprint 瘦身 | CR-20260812-001 |

---

## 12. External AI Review Guide

### 12.1 审查目标

外部 AI 阅读本文件后,应能够:

1. 理解 ChronoPM Skill 的设计目的、架构决策和当前能力
2. 识别能力矩阵中的薄弱环节(L2 及以下)
3. 评估已知局限中哪些是可改进的设计债务
4. 对 Roadmap 中的规划能力提出建议
5. 发现 Blueprint 中遗漏的能力或风险

### 12.2 审查维度

| 维度 | 关注点 |
|---|---|
| 能力完整性 | 是否有项目管理场景未被覆盖?能力矩阵是否有遗漏? |
| 规则一致性 | 规则之间是否有冲突?依赖关系是否正确? |
| 成熟度合理性 | 成熟度评级是否准确?L2 能力是否有明确的提升路径? |
| 设计债务 | Design Debt 清单是否完整?是否有未识别的债务? |
| 数据流完整性 | 数据流是否有断点?是否有数据进入但无处去的情况? |
| 边界合理性 | Known Boundaries 是否合理?是否有应该突破的边界? |
| Roadmap 合理性 | 规划能力的优先级是否合理?是否遗漏了关键能力? |

### 12.3 不可轻易推翻的设计决策

审查者在挑战以下决策时,必须给出充分理由和迁移成本评估(见 §4 "Design Decisions Not To Change Lighty"):

1. 使用 Markdown 作为主事实源格式
2. ai/ 与业务目录分离
3. outputs/ 与 ai/ 分离
4. 项目集模式采用集中式
5. 查询采用索引优先
6. 历史导入不直接覆盖
7. Skill 变更采用治理流程
8. 工作区升级需用户确认
9. 同人同天日报合并追加不覆盖
10. 快照冻结后不可静默覆盖

### 12.4 反馈格式要求

外部 AI 审查后建议按以下格式输出:

```markdown
## 审查结论

### 总体评价
[一段话概述对 Skill 的整体评价]

### 发现的问题

| 编号 | 类型 | 严重程度 | 描述 | 建议改进 |
|---|---|---|---|---|
| REV-001 | 能力遗漏 / 规则冲突 / 成熟度误评 / 设计债务未识别 / 数据流断点 / 其他 | 高/中/低 | [具体描述] | [具体建议] |

### 对 Roadmap 的建议
[对规划能力的优先级调整或新增建议]

### 对设计决策的挑战(如有)
[仅当认为某设计决策需要调整时填写,必须包含迁移成本评估]
```

### 12.5 审查注意事项

1. **不要试图操作 Skill**:Blueprint 是被动文档,不包含执行指令
2. **不要建议推翻核心设计决策**:除非能证明当前决策导致了不可接受的后果
3. **聚焦薄弱环节**:L2 能力(历史衔接)是最需要建议的部分
4. **关注完整性**:是否有应该有但没有的能力?数据流是否有断点?
5. **区分边界与缺陷**:Known Boundaries 是有意为之的,Design Debt 才是待修的

---

## 13. Update Policy

### 13.1 分级触发

| 触发条件 | 更新级别 | 更新内容 |
|---|---|---|
| Major 版本发布 | 必更 | 全文审查:能力地图、架构决策、Roadmap、Limitations |
| Minor 版本发布 | 必更 | 能力地图、版本状态、Roadmap、Known Limitations、数据流 |
| 新增/删除能力 | 必更 | Capability Map、Rule Dependency |
| workspace schema 变化 | 必更 | Schema Evolution |
| 新增治理机制 | 必更 | Governance Model |
| 新增核心数据流 | 必更 | Data Flow |
| 新增迁移/升级机制 | 必更 | Workspace Upgrade |
| Patch 版本发布 | 应更 | 版本元数据(版本号、日期) |
| 仅新增模板/测试/措辞 | 免更 | CHANGELOG 标注 "Blueprint Impact: none" |

### 13.2 结构性变更需走 CR

以下 Blueprint 变更需走完整 CR 流程(见 `16-skill-governance-rules.md` §2):

- 新增/删除一级章节
- 新增/删除 Capability ID
- 改变能力分类体系
- 将某能力标记为废弃
- 修改核心设计决策解释
- 修改外部审查标准
- 修改 Document Boundary 定义
- 与 SKILL.md / skill.json 出现能力口径不一致

### 13.3 普通更新走轻量流程

以下 Blueprint 变更只需 CHANGELOG 记录:

- 版本号更新
- Roadmap 补充
- Known Limitations 补充
- 状态从 planned 改为 partial / implemented
- 审查指南措辞优化

### 13.4 层级归属

Blueprint 属于**文档层(Documentation Layer)**,不属于核心契约层。

- 普通更新:无需 CR,记录 CHANGELOG
- 结构性变更:需走 CR
- 发布前必检:VERSION / skill.json / CHANGELOG / Blueprint 版本一致性

### 13.5 CHANGELOG 标注要求

每次版本发布时,CHANGELOG 中必须标注 Blueprint 影响:

```markdown
Blueprint Impact: [full / metadata-only / none]
```

- `full`:正文内容有实质性更新(能力矩阵、架构决策、数据流等)
- `metadata-only`:仅更新版本号和日期
- `none`:本次变更不影响 Blueprint 内容
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