ChronoPM — Markdown 项目管理技能

1. 概述

本技能以项目文件夹下的 ai/ 目录为载体，以 Markdown 文档为项目记忆，以 AI 为项目管理副手，以人工确认为最终控制点。 核心理念：事实源文件（board、register、log）是项目状态的唯一真相；过程记录（日报、会议纪要）是信息输入，不能直接替代事实源。

2. 工作模式

2.1 单项目模式（single）

独立项目，所有管理文档放在项目根目录 ai/ 中。

2.2 项目集模式（portfolio）

一个项目集经理统筹多个子项目，管理文档集中在项目集根目录 ai/，按 portfolio/（项目集级）和 projects/{子项目名}/（子项目级）分层。 项目集模式核心原则：所有 AI 管理文件只存在于根目录 ai/；prompts/ 与 templates/ 只保留一份共享；项目集级管跨项目事项，子项目级管各自项目事项；向上汇总、向下不下沉（信息从子项目流到项目集，项目集决策通知子项目但不直接改子项目事实源）。

3. 工作区结构

3.1 项目集模式

project-root/
├── ai/            # 事实源和管理规则
│   ├── prompts/     # 规则提示词（00-21 + project-rules/overrides）
│   ├── templates/   # 文档模板
│   ├── continuity/  # 项目阶段衔接
│   ├── portfolio/   # 项目集级管理（context/reports/risks/plans/milestones/resources/decisions/reviews）
│   ├── projects/    # 子项目级管理（requirements/plans/tasks/meetings/reports 等）
│   └── logs/        # 操作日志
└── outputs/         # AI 生成物和导出文件（与 ai/ 同级）
    ├── index.md
    └── {YYYYMMDDHHMMSS}/   # 每次生成请求一个批次目录

详细目录结构与文件命名规范见 references/06-file-rules.md。

3.2 单项目模式

与项目集模式中单个子项目结构相同，直接放 ai/ 下（无 portfolio/、projects/ 分层）。

3.3 可选扩展目录

目录	适用阶段	用途
deliverables/	交付验收阶段	交付物清单管理
acceptance/	验收阶段	验收检查单与验收记录
quality/	测试阶段	缺陷跟踪（MVP阶段缺陷暂存 issues，type 标记为 defect）

4. 文件分类

事实源文件（Single Source of Truth）

以下文件是项目状态唯一真相，必须人工确认后才能更新：

层级	文件	管理对象
子项目	tasks/board.md	当前任务状态
子项目	tasks/backlog.md	未排期任务池
子项目	risks/risk-register.md	项目内风险
子项目	issues/issue-register.md	项目内问题
子项目	decisions/decision-log.md	项目内决策
子项目	milestones/milestone-board.md	项目里程碑
子项目	plans/progress-plan.md	进度计划
子项目	plans/budget.md	项目预算
子项目	requirements/requirement-register.md	需求登记册与追踪矩阵
子项目	requirements/change-log.md	需求变更记录
项目集	portfolio/risks/risk-register.md	跨项目风险
项目集	portfolio/issues/issue-register.md	跨项目问题
项目集	portfolio/plans/budget.md	整体 P&L
项目集	portfolio/milestones/milestone-board.md	整体里程碑总览
项目集	portfolio/decisions/decision-log.md	项目集级决策
项目集	portfolio/resources/resource-register.md	人员资源当前状态
项目集	portfolio/resources/transfer-log.md	人员流转记录
项目集	portfolio/context/project-index.md	子项目索引

过程记录文件

以下文件是信息输入，不能直接替代事实源：

文件	用途
reports/daily/personal/**	个人日报
reports/daily/project/**	项目日报
reports/weekly/**	周报草稿（子项目级）
portfolio/reports/weekly/**	汇总周报草稿（项目集级）
meetings/**	会议纪要

5. 核心工作流

5.1 项目初始化

# 项目集模式
python "scripts/init_workspace.py" --project-root <根目录> --mode portfolio --sub-projects "子项目1 子项目2 子项目3"
# 单项目模式
python "scripts/init_workspace.py" --project-root <根目录> --mode single --project-name "项目名称"

5.1c 项目初始化向导流程

检测到新工作区或用户说"初始化项目"→ 读取 project-brief.md → 启动六步向导（合同→项目→迭代→需求→资源→里程碑）→ 生成确认摘要 → 写入 → 状态改"已确认"。详见 references/18-init-wizard-rules.md。

5.1b 版本兼容性检查（AI 进入工作区首要步骤）

读取 ai/.skill-version.json → 对比 Skill 包 VERSION → 查 CHANGELOG.md 判断是否迁移 → 按版本差异处理（一致/未变/需迁移/未知）。详见 references/20-workspace-version-rules.md。

5.2 日报处理流程（子项目级）

个人日报输入 → 读 project-context + board + 里程碑 → 汇总生成项目日报 → 检测人员变动 → 输出"建议更新清单"。详见 references/01-daily-report-rules.md。

5.3 项目集汇总周报流程

读 project-index → 遍历子项目周报/日报 → 汇总完成/风险/问题/里程碑 → 合并跨项目事项 → 读资源/风险 → 生成汇总周报 + 建议清单。详见 references/09-portfolio-rules.md。

5.4 人员资源流转流程

发现人员变动 → 识别类型 → 登记 transfer-log → 更新 resource-register → 检查资源风险 → 联动任务/成本 → 输出建议清单。详见 references/09-portfolio-rules.md。

5.5 需求变更处理流程

变更请求 → 登记 change-log（submitted）→ 影响分析 → CCB 决策 → 批准则更新 requirement-register + 相关事实源。详见 references/08-change-control-rules.md。

5.6 查询处理流程

用户提问 → 判断类型和层级 → 单项目读子项目事实源 / 跨项目读 portfolio → 输出结论 + 来源 + 不确定项。详见 references/05-query-rules.md。

5.7 历史计划导入与变更追溯流程（R1-R4）

导入历史计划 → 生成 external_import 快照（回溯灌入，不覆盖 AI 快照）→ board 维护 Original Due Date/Plan Change Count/Delay Count → 超期判定（日报处理 + PM 查询时，读索引不扫日报）→ 聚合查询只读 board.md。详见 references/15-snapshot-rules.md、references/03-task-board-rules.md。

6. 提示词路由表

场景	必须加载	可选加载
项目初始化向导	00 + 06 + 18	—
项目信息完整性巡检	00 + 06 + 19	按任务类型加载 01-09
日报处理（含个人进度联动）	00 + 01 + 06 + 17	03、04、07、09、10
会议纪要处理	00 + 02 + 06 + 17	03、04、07、08、09
需求评审/变更	00 + 07 + 08 + 06	03
任务看板更新	00 + 03 + 06	15
风险评估	00 + 04	09
项目状态查询（单项目）	00 + 05 + 17	按问题类型按需加载
项目集汇总周报	00 + 01 + 09 + 06	04
跨项目查询	00 + 05 + 09	按问题类型按需加载
人员资源管理	00 + 09 + 06	04
项目复盘	00 + 06	09
更新意图识别	00 + 06 + 10 + 17	按事项类型加载 01-09
文件解析入库	00 + 06 + 10	按文件类型加载 01/02/07/08/09
需求评审文件入库	00 + 07 + 08 + 10	02、03、04
设计评审文件入库	00 + 02 + 03 + 04 + 10	09
评审材料处理	00 + 02 + 10	按评审类型加载 04/07/08/09
生成周报/报告	00 + 05 + 06 + 10 + 11	01、09
生成项目集周报	00 + 05 + 09 + 10 + 11	01、04
多轮修改生成物	00 + 06 + 11	10
归档生成物到 ai/	00 + 06 + 10 + 11	对应业务规则
导出文件（Excel/Word/PDF，含需求矩阵/风险问题/成本/计划表）	00 + 06 + 11 + 12	xlsx 技能 + 对应业务规则
导入历史项目/阶段衔接	00 + 05 + 06 + 10 + 13	09、07、08、11
结转历史风险/问题	00 + 04 + 06 + 13	09
继承历史需求	00 + 07 + 08 + 13	02
生成阶段衔接报告	00 + 11 + 13	09
查询待办/明日计划	00 + 05 + 06	01、03、09
生成PM待办	00 + 05 + 06 + 01	03、04、09
待办索引同步	00 + 01 + 06 + 10	03、09
文档处理后自查	00 + 14	按场景加载 01/02/04/07
风险/问题追溯校验	00 + 04 + 05 + 14	01、02
历史计划查询	00 + 05 + 15	01、14
计划vs实际偏差	00 + 05 + 15	01、14
生成计划快照	00 + 01 + 06 + 15	10
生成实际执行摘要	00 + 01 + 06 + 15	10
历史计划批量导入	00 + 15 + 06 + 13	05、08、10
计划变更追踪/延期统计	00 + 03 + 15	05、08、14
超期查询（进度/哪些任务超期）	00 + 05 + 03	14、15
Skill 变更治理	00 + 16	-
工作区版本/健康检查（进入工作区首要动作）	00 + 20	06
词库管理	00 + 17	06
PM 偏好管理	00 + 21	06

PM Profile 自动加载：21 (PM Profile) 在所有输出场景中自动加载，与 00 同级。在意图检测前加载 confirmed 偏好，在交互后被动观察并记录用户习惯。详见 references/21-pm-profile-rules.md。

7. 安全底线（不可覆盖）

1. 不得编造项目信息，信息不足时必须说明缺少什么。
2. 不得未经人工确认直接修改事实源文件。
3. 不得将日报或会议纪要内容直接视为事实源结论。
4. 不得混淆需求与任务、风险与问题。
5. 不得将 AI 推测写为项目事实，推测必须标注。
6. 不得代替项目经理做决策，尤其涉及资源调配、范围变更、里程碑调整。
7. 不得擅自承诺范围、工期、成本、验收。
8. 不得在记忆库中记录密码、密钥、Token 等凭证。
9. 每条记录必须有 Source 字段，可追溯。
10. 不得在业务子项目目录下创建 AI 管理文件（业务目录不侵入规则）。
11. 不得将未经确认的人员变动直接写为事实，应标记为待确认。

8. ID 编码规则

类型	前缀	示例
Task	T-YYYYMMDD-NNN	T-20260809-001
Risk	R-YYYYMMDD-NNN	R-20260809-001
Issue	I-YYYYMMDD-NNN	I-20260809-001
Decision	D-YYYYMMDD-NNN	D-20260809-001
Milestone	M-NN	M-02
Meeting	MTG-YYYYMMDD-NNN	MTG-20260809-001
Plan Item	P-NN	P-01
Iteration	ITR-NN	ITR-01
Requirement	REQ-XXX-NNN	REQ-AUTH-001
Change	CR-YYYYMMDD-NNN	CR-20260809-001
Resource	RES-NNN	RES-001
Resource Transfer	RTF-YYYYMMDD-NNN	RTF-20260809-001
Project（项目集）	PRJ-NNN	PRJ-001

9. 状态枚举

需求/任务/风险/问题/变更/里程碑/人员资源状态流转，见 references/00-pm-main-rules.md §5a。

10. 文件瘦身规则

1. 高频增长类文档必须按时间、事件或对象拆分。
2. 单个 Markdown 文件超过 300 行或 30 条记录时，AI 应建议拆分并建立 index.md。
3. 事实源文件底部内嵌 Change Log；超过 100 行时拆分为独立 *-change-log.md。
4. 日报按天拆分，会议纪要按会议拆分，复盘按事件拆分。
5. 索引文件负责导航，内容文件负责记录事实。
6. 人员流转记录独立维护在 transfer-log.md，不得追加到 resource-register.md。

11. 输出规范

处理类/查询类任务输出模板，见 references/00-pm-main-rules.md §5.4/§5.5。 超期/延期统计查询输出按 references/05-query-rules.md §8 聚合查询规范执行。

12. 规则优先级

Level 0: 平台/系统安全规则（不可覆盖）
Level 1: Skill 核心底线（不可覆盖，见第 7 节）
Level 2: 项目级规则（project-rules.md + overrides.md）
Level 2.5: PM Profile confirmed 偏好（软偏好，项目规则未指定时生效）
Level 3: 本次任务运行时指令
Level 4: 用户提供的输入资料

13. 里程碑体系

默认 M01-M12 体系（可裁剪），完整对照表见 references/00-pm-main-rules.md §5b。

14. 例外管理容忍度

各维度容忍度阈值与升级触发条件，见 references/00-pm-main-rules.md §5c。

15. 详细规则索引

文件	核心内容	何时加载
00-pm-main-rules.md	角色定位、管理原则、行为边界、输出规范、意图检测	所有场景必须
01-daily-report-rules.md	日报生成、个人→项目→周报联动、资源变动检测	日报处理
02-meeting-rules.md	会议纪要生成、行动项提取、事实源同步	会议处理
03-task-board-rules.md	任务看板字段、状态流转、计划变更/延期计数、超期判定归属	任务管理、计划变更/超期
04-risk-issue-rules.md	风险/问题识别、评估、升级机制	风险/问题管理
05-query-rules.md	查询路由、跨项目查询、聚合计数秒答、最小读取原则	项目状态查询
06-file-rules.md	文件命名、创建、更新、瘦身、业务目录不侵入	文件操作
07-requirement-rules.md	需求分类、拆解、评审、追踪矩阵	需求管理
08-change-control-rules.md	变更流程、影响分析、审批、分级、plan_change	变更管理
09-portfolio-rules.md	项目集统筹、汇总周报、跨项目风险、人员资源管理	项目集管理
10-update-trigger-rules.md	更新意图识别、文件类型识别、语义信号触发、更新权限分级	用户输入处理、文件解析入库、更新触发
11-output-artifact-rules.md	输出物目录规则、批次目录、草稿/确认/导出流程、格式询问、生成物索引	生成周报/报告、导出文件、归档
12-excel-generation-rules.md	8种文档Excel生成规范、成本测算细化、recalc+audit验证	生成Excel文件、导出登记册/计划表
13-continuity-rules.md	项目阶段衔接、continuity/目录、5种导入模式、内容路由、与R1划界	导入历史项目、阶段衔接、结转
14-self-check-rules.md	索引预建、索引一致性、文档处理自查清单、索引过期检测	文档处理后自查、追溯校验
15-snapshot-rules.md	计划快照（冻结）、external_import 导入、实际执行摘要、历史索引、热冷分离	历史计划查询、快照生成、批量导入
16-skill-governance-rules.md	变更工单、影响分析、回归测试、核心契约保护、最小补丁、回滚	Skill 自身变更治理
17-domain-glossary-rules.md	领域术语词库、术语归一化、纠错、确认式学习、索引、去重	术语/词库管理
18-init-wizard-rules.md	初始化向导六步流程、触发条件、跳过机制、确认写入	项目初始化、新工作区首次使用
19-info-completeness-rules.md	完整性巡检、7层检查、P0-P3分级、静默策略、巡检报告	生成报告、分析风险、完整性检查
20-workspace-version-rules.md	工作区版本检查、健康检查、兼容/迁移模式	进入工作区首要动作、版本不匹配时
21-pm-profile-rules.md	PM 偏好档案、习惯学习、pending→confirmed 状态机、冲突处理	所有场景自动加载、PM 偏好管理

版本控制文件

文件	用途
VERSION	Skill 包版本号（当前 1.10.0）
skill.json	Skill 元数据（版本、模式、依赖）
CHANGELOG.md	版本变更历史和升级说明
SKILL.md front matter	AI 可读的版本字段

工作区初始化时生成 ai/.skill-version.json（记录 Skill 版本 + schema 版本 + 模式 + 时间）和 ai/logs/migration-log.md（迁移历史）。AI 进入工作区时先读 .skill-version.json 检查版本兼容性。