qiusuo0226/chrono-pm-skill / governance-shared/baselines/3.1.0
chrono-pm-project
VerifiedMarkdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio(只读)。触发:项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好。支持主动变更+人工确认:写入即标记待确认并登记 pending-changes,确认后生效。
README.md
View on GitHub# ChronoPM v3.1.0 — ChronoPM-Project 单项目 + ChronoPM-Portfolio 只读集
**让 AI 帮你管项目,而不是帮你写文档。**
> **v3.0.0 双包**:日常录入用 **ChronoPM-Project**(仅 single;init 只建单项目工作区)。跨项目进度 / 风险 / 合同 / 周报归集用 **ChronoPM-Portfolio**(viewer 只读,禁止写入成员项目事实源,无 init 脚本)。旧 portfolio 录入口废弃。
## 这是什么?
ChronoPM 是一个给项目经理用的 AI 技能(Skill)。装上之后,AI 就能理解你的项目,帮你处理日常管理工作——写日报、整理会议纪要、跟踪任务和风险、管理需求变更、生成周报。
它不是又一个项目管理软件。它直接在你现有的文件夹里工作,所有项目数据都是 Markdown 文件,不依赖任何数据库或云服务。
**简单来说:它就是一个越用越懂你项目的 AI 助手,把散落的项目信息自动整理成体系化的知识资产。**
## 这些痛点,你遇到过吗?
做项目管理的人,大概对以下场景都不陌生:
**1. 管理标准不统一**
不同项目经理的管理习惯和方法不一致。同一个项目,换一个人来管,成本把控、风险识别、干系人管理的颗粒度完全不一样。这不是能力问题,而是缺乏一套统一的框架来兜底——项目质量过度依赖个人经验。
**2. 日常琐碎导致信息断层**
项目经理即使建立了比较完备的管理机制和文件体系,但因为日常琐碎事务太多,经常出现某项关联文件没有及时同步的情况。看似小事,但信息一旦断链,累积起来就是项目风险。
**3. 项目交接质量不可控**
项目经理是流动的,人员变动时交接往往不到位。以前的做法是甩一份项目文档包,但几十上百个文件,接手的人根本不知道从哪里看起、哪些是关键信息。隐性风险在交接中埋下,等爆发时已经来不及了。
**4. 大量时间花在文档整理上**
周报、日报、会议纪要、风险清单、变更申请……每天花大量时间整理文档,反而挤压了真正应该花在沟通协调上的精力,本末倒置了。
**5. 验收报告缺乏系统性支撑**
最终的项目验收报告,内容来源于日常管理过程中产生的各种材料。但这些材料分散在各个文件、各个系统里,即使想用 AI 来辅助整理,从零开始投喂也耗费大量精力,而且因为没有完整的投喂标准,效果往往不理想。
**6. 通用 AI 工具不理解项目语境**
项目有大量的专属名词、缩写、内部代号。用通用 AI 的话,需要不断重复解释背景,资源消耗巨大还达不到满意效果,最后大家还是觉得不如自己干。
**7. 多项目联动缺乏全局视角**
高级项目管理者同时管多个项目,需要跨项目统筹资源、了解各项目进度之间的关联影响。但目前没有一个工具能把这些分散的信息串联起来,形成全局视图。
## ChronoPM 怎么解决?
ChronoPM 的定位是**项目管理智能知识助手**。靠日常工作中项目经理持续"投喂"项目相关材料——会议纪要、需求文档、风险清单、周报日报、沟通记录等等——它会自动理解项目专属语境,从成本、资源、干系人、风险、问题、进度等多个维度,生成结构化的项目知识索引,最终形成一套**可读取、可传递、可复用的项目知识包**。
## 带来什么价值?
**拉齐管理基线——给每个 PM 配一个"虚拟 PMO"**
不管项目经理经验深浅,工具都从统一的维度框架去补全信息,不会因为个人习惯不同而遗漏关键维度。管理质量有了下限保障。
**交接从"人走茶凉"变成"知识带走"**
项目交接时,只需移交这套结构化索引文件夹。接手人直接让 AI 读取,快速理解项目全貌——成本花了多少、哪些风险还没关闭、干系人诉求是什么、遗留问题清单。不需要再一个个翻文件,交接质量不再依赖个人表达能力。
**日常材料自动沉淀,释放 PM 精力**
周报、日报、会议纪要投喂进去后,工具自动结构化归档。项目经理不用花大量时间整理文档,把精力还给沟通和协调。同时,这些日常沉淀直接为最终验收报告提供系统性支撑——验收不再是"临时拼凑",而是"水到渠成"。
**理解项目专属语境,越用越准**
通过持续投喂建立项目专属的知识索引,项目名词、内部代号、历史上下文都能被准确理解。不需要每次重复解释背景,彻底解决通用 AI"听不懂项目话"的问题。
**多项目联动,形成全局视图**
高级项目管理者可以通过关联多个项目的知识包,跨项目统筹资源、对比进度、识别资源冲突,辅助决策。
**零额外学习成本**
它不是一个新系统、新平台,不需要改变现有工作习惯。项目经理只需要像平时一样把材料丢给它,它自动完成结构化整理。
## 怎么用?
**第一步:安装 Skill**
把本目录复制到你的 AI 工具(如 Qoder)的 Skill 目录下即可。
**第二步:初始化工作区**
告诉 AI:"帮我初始化项目工作区"。AI 会引导你一步步建立项目结构——项目名称、有哪些人、什么阶段、用什么模式。
**第三步:日常使用**
像跟助手说话一样跟 AI 交流:
| 你说 | AI 做 |
|---|---|
| "今天的日报" | 汇总今天所有更新,生成日报,联动更新个人进度 |
| "开个项目启动会,要点如下…" | 整理会议纪要,提取待办事项,分配到责任人 |
| "客户要加一个 XX 需求" | 登记需求,评估影响范围,更新追踪矩阵 |
| "这周进展怎么样" | 从各文件汇总生成本周周报 |
| "跨项目整体状态" | 请到 ChronoPM-Portfolio 对话做只读归集(本包不生成项目集月报) |
| "检查一下项目信息完不完整" | 扫描所有管理文件,列出缺失项并分级提醒 |
| "这个需求在不在合同范围内" | 从合同→招投标→具体需求三层追溯,给出证据链 |
## 待办与任务包:项目执行的核心(v2.0.0 / v2.1.0 增强)
v2.0.0 把整个执行体系收敛成两层:**待办文件**管每一条具体任务,**任务包(WP)**管分组与里程碑。理解这两个概念,就能理解 ChronoPM 的全部数据流转。
### 待办:每人每日一个文件
每个执行人每天一个待办文件:`todos/{日期}/{执行人}.md`。它是任务执行状态的**唯一事实源**——日报、周报、进度、倒排矩阵全部从它实时汇总,不再维护独立的看板或索引。
- **全局唯一编号**:每条待办有 `TD-{人名缩写}-{日期}-{序号}` 编号,跨天、跨项目可追溯。
- **换人不改事**:任务换人执行时新建编号并保留溯源链,谁干过什么一目了然。
- **自带工作日志**:日报内容不再单独成文件,直接写入待办文件的工作日志段(今日完成/进行中/阻塞/风险/工时)。
- **身份快照(v2.1.0)**:每人每日待办文件头部携带 §0 人员信息(岗位/姓名/联系方式/负责模块/进组日期/离组日期),自动 T+1 沿用前一天;与 resource-register 冲突时以 register 为准。
- **进度列(v2.1.0)**:核心执行表新增"进度"列(0%~100%),由日报映射自动更新;与状态双轨仲裁——状态=已完成 ⇒ 进度强制 100%,进度=100% 但状态未完成时不自动提升(终态需 PM 确认)。
- **日报两步流程(v2.1.0)**:日报原文先逐字存档到待办文件 §2 日报存档段(禁止只存摘要),再映射加工进 §3 工作日志段与待办字段,全程可溯源。
- **待办结转(v2.1.0)**:AI 创建/更新待办前强制扫描前一天全员未办结待办并结转到当日(Step 0,硬阻断,未完成禁止写新待办);同人结转编号不变、跨天可追溯。
### 任务包(WP):计划的编排单位
计划文件(`plans/PLAN-xxx.md`)里用任务包(Work Package,编号 `WP-NNN`)组织工作:
- **待办强制归属任务包**:正式待办都带 WP 引用,计划调整时能精准级联到每条待办。
- **里程碑 = 里程碑型任务包**:预演、上线等里程碑不再单独建文件,就是标了"是否里程碑"的任务包。
- **进度不另存**:任务包进度 = 下辖待办完成比例实时聚合,永远与实际执行一致,不存在"进度数字过时"。
### 数据流转全景
```
【输入入口】 日报 / 会议纪要 / 口述安排 / 需求拆解 / 变更批准 / 倒排计划
│
▼ AI 解析提取,统一归属判定
【唯一事实源】 todos/{日期}/{执行人}.md 待办文件
│
┌──────────┼───────────────┐
▼ ▼ ▼
按 WP 引用聚合 按截止日期切片 工作日志段
│ │ │
▼ ▼ ▼
【计划视图】 【时间视图】 【汇报视图】
任务包进度/倒排倒计时 "今天做什么"/"本周计划" 日报 → 周报
```
要点:**写只写待办文件,其他全是它的派生视图**。日报/周报是输出物不是数据源,不会出现"报表和实际不一致"。
### 五个任务创建入口
不管任务从哪个口进来,都走同一套归属判定,保证任务不丢、不重、不乱:
| 入口 | 场景举例 |
|---|---|
| 口述安排 | "给小王加个待办,周五前出接口文档" |
| 日报提取 | 成员日报里的"明日计划"自动转待办 |
| 会议行动项 | 纪要里的行动项提取后落待办 |
| 需求拆解 | 需求确认后拆成任务包与待办 |
| 变更批准 | 变更批准后新增/调整的配套任务 |
每条新任务三选一:**归入任务包**(高置信匹配)/ **独立待办**(有负责人+截止日+交付物)/ **一次性提醒**(不占待办文件,只提示一次)。拿不准时 AI 会追问,绝不自行拍板。
### 状态体系(全中文)
| 实体 | 状态流转 |
|---|---|
| 待办 | 待处理 → 进行中 → 待评审 → 已完成(可 已阻塞 / 已取消 / 已转出) |
| 任务包 | 已规划 → 进行中 → 已完成 |
| 需求 | 已提议 → 已确认 → 进行中 → 已交付 → 已验收(可 已变更 / 已取消) |
| 风险 | 开放 → 监控中 → 已缓解 → 已关闭(可 转为问题) |
| 问题 | 开放 → 处理中 → 已解决 → 已关闭(可 已阻塞) |
| 变更 | 已提交 → 评估中 → 已批准 / 已驳回 → 已实施(可 已取消) |
**状态更新怎么生效**:你说一句"小王的接口文档写完了",AI 会找到对应待办、建议改为已完成,并自动级联检查(任务包进度、关联风险/问题、需求状态)。过程性更新先写为"待确认",终态变更(完成/取消)必须你确认后才真正生效——既不漏更新,也不会自作主张。
**关闭门禁(v2.1.0,DF-002)**:关闭(完成/取消/已转出)需满足"编号 + 佐证 + 关联影响 + PM 确认"四要素;日报/周报流程后 AI 主动批量罗列可关闭候选供你确认。
## 两种工作模式
- **单项目模式**:一个 `ai/` 文件夹管一个项目,适合独立项目。
- **项目集模式**:一个项目集管多个子项目,信息自下而上汇总、决策自上而下通知。适合管一组相关项目的 PM。其中项目集层的**可用性/排期聚合均为动态视图(v2.1.0 硬约束)**——人员可用性、排期冲突、人力配置率、里程碑/门禁达成度一律在查询时从各子项目实时聚合输出,**不落盘**到任何索引文件,杜绝"聚合数据过时"。
## 核心特点
**Markdown 文件就是数据库**
所有项目信息都存在 `.md` 文件里。不依赖任何软件、数据库或云服务。用文本编辑器就能打开看,十年后还能读。
**AI 先读后写,人工确认才生效**
AI 每次操作前先读取现有文件了解上下文。写入重要信息前会先让你确认,不会自作主张改掉你的数据。
**改了什么一目了然**
需求登记、变更控制、影响分析——每一步都有记录。谁提的、什么时候、影响了哪些文件,全部可追溯。
**项目知识不随人员流动**
所有项目知识都在文件里。新人来了,AI 读完文件就能接手;人走了,项目历史不会丢。
**从日报到周报一条龙**
日报、周报、会议纪要、决策记录、复盘总结——全部有标准模板,AI 自动填充和汇总。
**需求范围可追溯**
从合同到招投标文件到具体需求,三层模型帮你搞清楚"这个需求在不在合同范围内"。
**需求双视图:业务⇄实现对应**
同一个需求,甲方看"要做什么"(业务视图),开发看"怎么做"(实现视图)。把开发侧文档(PRD/设计/接口文档/原型)纳入需求库,登记册为每条需求保留"实现视图"和"原型/文档链接",AI 处理开发日报时能对照业务上下文,真正读懂日报在说什么。
**推导基线,状态推导更聪明**
内置生命周期推导链,能从"预演通过""评审通过""验收通过"等里程碑终态事件自动推导模块/任务的实际完成状态,并与待办文件交叉校验;配合实体台账与跨源矛盾处理,周报与查询不再凭单一待办文件状态下结论,漏数、误判更少。
## 能力全景(CAP-001 ~ CAP-031)
| 能力 | 名称 | 说明 |
|---|---|---|
| CAP-001 | 工作区初始化 | 一键建立项目工作区,支持单项目/项目集两种模式 |
| CAP-002 | 日报管理 | 日报处理、合并幂等、个人进度联动 |
| CAP-003 | 本项目周报 | 本项目周报;跨项目汇总周报请用 ChronoPM-Portfolio |
| CAP-004 | PM 每日待办 | 全团队聚合待办视图,9 段全景展示 |
| CAP-005 | 快捷查询 | 索引优先查询,禁止默认全量扫描 |
| CAP-006 | 输出物管理 | 输出物批次目录 + 草稿/确认/导出流程 |
| CAP-007 | 风险与问题 | 风险与问题登记,多源交叉校验 |
| CAP-008 | 需求管理 | 需求登记与追踪矩阵 |
| CAP-009 | 变更控制 | 变更流程 + 影响分析 |
| CAP-010 | 资源管理 | 资源登记,状态与历史分离 |
| CAP-011 | 历史衔接 | 项目阶段衔接,存量导入 |
| CAP-012 | 待办快照 | 快照冻结 + 计划 vs 实际对比 |
| CAP-013 | 自查与完整性 | D/M/R/T 分层自查清单 |
| CAP-014 | Excel 生成 | 8 种文档 sheet 结构/列头/验证/公式 |
| CAP-015 | 版本与兼容 | 工作区健康检查 + 兼容模式 + 迁移脚本 |
| CAP-016 | 更新意图识别 | 四级触发 + 权限分级 |
| CAP-017 | Skill 治理 | 变更工单(CR/IA/RR)+ 回归保护 |
| CAP-018 | 架构蓝图 | 架构决策 + 能力矩阵 + 外部审查 |
| CAP-019 | 领域术语词库 | 术语归一化 + 置信度 + 纠错 + 确认式学习 |
| CAP-020 | 初始化向导 | 六步引导建档,进度记忆、断点续接 |
| CAP-021 | 信息完整性巡检 | 7 层缺失检查,P0-P3 分级提醒 |
| CAP-022 | 入口路由 | SKILL.md 主入口路由器,规则导航 |
| CAP-023 | PM 偏好学习 | 用户习惯学习 + 偏好适配输出 |
| CAP-024 | 历史计划导入 | 存量计划批量导入 + 变更/延期追溯 |
| CAP-025 | 主动变更 | 主动变更 + 人工确认更新模式 |
| CAP-026 | 变更日志归档 | 活跃区/归档区分层,自动月份导航 |
| RI | 需求智能 | 跨源需求归集/范围判定/三级索引;合同作用域多对多映射;业务⇄实现双视图(实现视图/原型链接) |
| CAP-027 | 日报集成审查与主动提问 | 日报处理后对比计划 vs 完成、风险/问题变化、任务进度偏差,并从阻塞/风险/遗漏/可行性四角度主动提问 |
| CAP-028 | 委派跟踪联动 | 任务委派时为委派方生成跟进待办;任务状态变更时校验关联需求状态一致性 |
| CAP-029 | 关闭确认佐证 | 风险/问题关闭建议必须列明编号 + 佐证 + 关联影响,禁止无据关闭 |
| CAP-030 | 沟通质量规则 | 待确认事项编号罗列 + 实读禁缓存,保障输出可追溯与数据准确 |
| CAP-031 | 查询默认过滤 | 任务/待办类查询默认仅输出未完成项,可显式查看全部 |
| —(扩展) | 倒排计划与 WP 工作包管理 | 围绕截止日反向编排计划工作包(WF-7,倒排=计划的编排方式);任务创建五入口统一归属路由(WF-8:归属 WP/独立待办/一次性提醒三分,正式待办强制落待办文件);PLAN 文件 WP 粗规划表 + 倒排元数据;WP 分层查询与倒排倒计时;**倒排每日矩阵**(人员×日期,权威数据源为待办文件,支持 portfolio 多子项目待办文件遍历与存量降级) |
| —(扩展) | 推导基线(Reasoning Baseline) | 生命周期推导链 + 跨源矛盾处理 + 实体台账 + 任务集关联,从里程碑事件自动推导实际完成状态 |
## 包含什么
| 内容 | 数量 | 说明 |
|---|---|---|
| 规则文件 | 22 份 | 定义 AI 在各类场景下该怎么做事 |
| 文档模板 | 33 个 | 日报、周报、会议纪要、风险登记册等全套模板 |
| 自动化脚本 | 5 个 | 工作区初始化、版本迁移、版本同步等 |
| 回归测试 | 302 个用例 | 确保每次更新不破坏已有功能 |
## 目录结构
```
ChronoPM Skill/
├── SKILL.md # AI 入口文件。AI 加载 Skill 时首先读取这个文件,
│ # 从中了解整个 Skill 的能力、路由规则和行为规范。
│ # 相当于 AI 的“岗位说明书”。
├── skill.json # Skill 元数据。版本号、能力声明、升级历史等,
│ # 供 AI 工具平台识别和管理本 Skill。
├── VERSION # 当前版本号(纯文本),便于快速查看。
├── CHANGELOG.md # 变更历史。每个版本的改动内容、发布日期、影响范围。
│
├── references/ # 📖 Project 规则(21 份有效规则 + 09 退役指针;编号 00~22,03 已删)
│ ├── 00-pm-main-rules.md # 主控 + 操作确认分级表
│ ├── 01-daily-report-rules.md # 日报 + 录入归属判定
│ ├── 05-query-rules.md # 查询 + 待办清单输出规范
│ ├── 09-portfolio-rules.md # v3.0.0 退役指针 → ChronoPM-Portfolio
│ └── 10~22 # 其余规则
├── ChronoPM-Portfolio/ # 只读项目集伴生包
│
├── assets/ # 📦 资源文件
│ └── templates/ # 文档模板(33 个)。AI 生成文件时按模板填充,
│ # 确保格式统一。涵盖日报、周报、会议纪要、
│ # 风险登记册、决策记录、复盘报告等全套模板。
│ # 注:工作区 ai/ 目录树由 init 脚本程序化创建,
│ # 不依赖独立的目录模板文件。
│
├── scripts/ # ⚙️ 自动化脚本
│ ├── init_workspace.py # 工作区初始化:仅 single 模式(v3.0.0,portfolio 已拒绝)
│ ├── migrate_workspace.py # 工作区迁移:旧版本工作区自动升级到最新结构
│ ├── sync_version.py # 版本同步:从单一版本源同步到所有触点文件
│ ├── _version.py # 版本单一事实源:SKILL_VERSION + WORKSPACE_SCHEMA_VERSION
│ └── chronopm_init/ # 初始化引擎:配置、模板渲染、校验、目录构建
│
├── governance/ # 🛡️ 治理契约(开发者使用)
│ ├── contracts/ # 核心契约:定义 Skill 变更的保护层级和发布规则
│ ├── baselines/ # 版本基线快照:每个版本的完整文件副本,用于回滚/审计
│ ├── change-requests/ # 变更工单(CR):每次 Skill 自身变更的正式记录
│ ├── migrations/ # 升级文件:版本链权威执行源(upgrade-to-{version}.md)
│ ├── impact-analysis/ # 影响分析(IA):变更前评估影响范围
│ ├── regression-reports/ # 回归报告(RR):每次发布的全量测试结果
│ ├── review-checklists/ # 发布检查清单:确保发布流程不遗漏检查项
│ └── planning/ # 方案设计:重大功能的设计文档
│
└── tests/ # 🧪 回归测试套件(302 个用例)
# 每次 Skill 更新后运行,确保不破坏已有功能。
```
## 版本信息
| 项目 | 值 |
|---|---|
| Skill 版本 | 3.1.0 |
| 工作区 Schema | 0.9.0 |
| 规则文件 | 22 份 |
| 文档模板 | 33 个 |
| 回归用例 | 302 个 |
## 分发包命名规范
发布产物按 `{BrandName}-Skill-v{version}.zip` 命名。v3.0.0 起一次发布打两个包(G-3):
- `ChronoPM-Project-Skill-v3.1.0.zip`(主包,单项目管理)
- `ChronoPM-Portfolio-Skill-v3.1.0.zip`(只读归集伴生包;本版仅版本锁步,规则未改)
- **BrandName**:取自各包 `skill.json` 的 `displayName` 品牌前缀(`—` 或 `(` 之前)
- **version**:语义化版本号,加 `v` 前缀(双包同版本)
本机打包使用 Python 入口 `tools/pack-skill/scripts/pack.py`(PowerShell 执行策略受限时);其排除模型实读 `pack.ps1`,以之为**唯一事实源**,`pack.ps1` 作为跨平台参考实现。在仓库根运行 `pack.py` 时自动感知 `ChronoPM-Portfolio/` 伴生包并依次产出两个 zip;Project 包排除 `ChronoPM-Portfolio/` 目录(排除模型见 `pack.ps1`)。发布前须通过 `governance/scripts/audit_release.py` 审计(含“命名漂移守门”断言,禁止 `{name}-{version}.zip` 类旧格式产物)。
## 升级日志
详见 [CHANGELOG.md](CHANGELOG.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 |