qiusuo0226 ChronoPM-Project — 单项目 Markdown 项目管理技能
1. 概述
本技能以项目文件夹下的 ai/ 目录为载体，以 Markdown 为项目记忆，以 AI 为副手，以人工确认为最终控制点。
核心理念：事实源文件是唯一真相；日报/纪要是输入，不能替代事实源。
待办单一数据源：执行状态 = todos/{date}/{owner}.md（一人一天一份；写入经 inbox 再合并）。PLAN = 唯一计划编排事实源（只引用 WP，不列待办）。WP 独立文件 = wps/WP-*.md（须有需求编号；待确认不拆待办）。需求只绑工作包，待办只绑工作包。
v3.0.0：本包仅单项目。旧 portfolio 录入口废弃。跨项目归集见 ChronoPM-Portfolio。集层投喂可调用本包写过程（P-HANDOFF-ACCEPT），root 仍是本成员。
2. 工作模式
仅 single：全部管理文档在本项目 ai/。无 portfolio 模式。
若工作区是联邦集工作区中的 ai/projects/{项目名}/ai/，本包仍按单项目读写该目录，禁止写兄弟项目，禁止写 portfolio/。允许被集层 P-HANDOFF-WRITE 调用（root=本成员）。
跨项目查询/汇总周报/挂载感知/一份文件要拆进多个成员项目 → 换 ChronoPM-Portfolio 对话。本包禁止当集经理代写兄弟项目。
3. 工作区结构
project-root/
└── ai/
├── context/ # project-context、pm-profile、project-rules、词库等
├── templates/
├── todos/{date}/{owner}.md
├── requirements/ # 登记册 + sources/{编号}/ 拆解产物（本项目一套）
├── plans/ project-info/ wps/ risks/ issues/ decisions/
├── backup/ # 升级垃圾封存（禁读；3.8.0 空目录）
├── resources/ # 退役：register/transfer-log 迁 backup；人员读 todos/_index
├── reports/ # 项目日报按需生成（存根，可能不存在）+ 周报；个人日报在 todos
├── meetings/ reviews/ logs/ops/ logs/journal/ outputs/
├── pm-decisions.md # 等你裁定（分块）；旧 pending-changes 升级迁入
├── context/brain.md # 懒建派生快照（refresh_views.py）
├── context/active-entities.json # 懒建活实体表
└── .skill-version.json # 另：ai/.state.json 懒建指纹
联邦集工作区（Portfolio 使用，本包不创建）：ai/portfolio/ + ai/projects/{名}/ai/（内部即上图）。项目 ai 内禁止再出现 portfolio/ 或 projects/。
4. 事实源（低/中风险写入即生效；高风险确认前不写该笔）
口径见 00-pm-main-rules.md §3.3。低/中风险：Confirmed By: auto，不进 pm-decisions.md 块 8 子节「已经写了等点头」，计入统计。仅 Confirmed By: 待确认 不进完成统计/超期。确认清单不阻断同一轮其他动作。confirmation_level: strict 恢复 3.22 全确认。
| 文件 | 对象 |
|---|---|
todos/{date}/{owner}.md |
待办与人员快照/进出组/能耗（§0 只留联系方式与负责模块） |
todos/{date}/_index.md |
花名册 §1 + 结转 §2 + 当日参与 §3 + TD 缩写 §6 |
pm-decisions.md |
等你裁定的事项（分块 + 决策记录） |
logs/ops/_index.md |
对话过程留痕索引（懒建；不是进度事实源） |
requirements/_index.md |
需求检索 |
risks/ issues/ decisions/ |
风险/问题/决策 |
plans/PLAN-*.md |
计划（§3 = WP 引用简表；§4 = 阶段列表投影） |
project-info/progress-plan.md project-info/budget.md |
进度框架/预算 |
wps/WP-*.md wps/_index.md |
独立 WP 文件 + 查找加速器（存在性以文件为准） |
requirements/requirement-register.md change-log.md contract-register.md source-type-registry.md |
需求与合同（本项目） |
requirements/sources/ _index.md |
源文档级拆解（加速器；存在性以 sources/*/meta.md 为准） |
| （人员） | 权威=最新合法日 _index.md §1；进出组=个人 §0.5；能耗=个人最新文件 §0.6。退役 register/transfer-log 见 backup/ |
context/pm-profile.md |
pm_name=项目经理（1～2 位，基本信息）；current_operator=当前操作人。「我的待办」只认后者；空则 ASK，禁止回退 pm_name |
过程记录：reports/daily/project/**、reports/weekly/**、meetings/** 不能当事实源结论。
5. 核心工作流
5.0 环境检测（首次跑脚本前）
初始化 / 升级迁移 / verify 脚本需要 Python ≥3.9（与 skill.json "python": ">=3.9" 一致；推荐 3.10+）。
python --version
若输出 Python 3.9 及以上 → 继续。若报「不是内部或外部命令」/ command not found：
- Windows：
winget install Python.Python.3.12 --silent或py -3 --version - Mac：
brew install python3 - Linux：
sudo apt update && sudo apt install python3
装完再跑脚本。日常记待办、查进度 可不依赖 Python。结转：有 Python 则优先本 Skill 包 scripts/carryover_step0.py（与 SKILL.md 同级，--root 指向项目根，禁止在业务 cwd/ai/ 找脚本后手搓全员）；无 Python 仍按 22 号全员结转，禁止跳过。
5.1 初始化
python "scripts/init_workspace.py" --project-root <根目录> --mode single --project-name "项目名称"
无 --mode portfolio。向导见 18-init-wizard-rules.md（含成本核算方式必填）。
5.1b 版本检查（进入工作区先做）
读 ai/.skill-version.json → 比 Skill VERSION。Skill < 工作区版本 → 提示升级 Skill + 只读降级。见 20-workspace-version-rules.md。
随后 P-VIEWS：有 Python 则跑本 Skill 包 scripts/refresh_views.py --project-root <根> --all（与 SKILL.md 同级；指纹未变不写盘）。<根> = 单项目根（其下直接有 ai/wps/）。联邦集工作区须指向成员项目根 .../ai/projects/{项目名}，禁止对集根或 .../ai（只有 portfolio/+projects/）跑 --all，否则会写出空视图。无 Python / 无 .state.json / 脚本失败 → 不阻断；查询读事实原文并声明 as-of。缺 context/brain.md 不致命。
5.2 日报
先判定是否本项目 → 原文进 inbox → 合并进当天一人一份个人文件 → 映射待办（够正式的未匹配进展自动建待办）。禁止写入 reports/daily/。明日计划留在当天原文，次日才落待办。疑似他项目：拆分+分流，禁代写。见 01-daily-report-rules.md。
5.3 查询
本项目事实源。跨项目用 Portfolio。简单查询仍只载 05，但 每一次查询须先 P-VIEWS（命令写在 05 文首，不因此加载 00）：有 Python 则跑本 Skill 包 scripts/refresh_views.py --project-root <根> --all；无 Python / 失败 → 不阻断，定向读事实并声明 as-of。有 brain.md 且 facts 指纹一致 → 先读 context/brain.md 别名短表（不得默认打开 active-entities.json）；未中按 05 §2 打开路由文件；写入/对齐/查重（P-RESOLVE）才打开 entities。再最多打开 1～3 个事实文件。全库扫 / 扫 backup/ / 全库语义扫 = 本轮失败。纯查询横幅见 05 §1a（N>0 一行，不铺清单）。待办清单输出见 05（默认未办结；待确认 终态仍可见；auto 按已确认）。日报内容默认先读 todos/{date}/*.md §2+§3，禁止先探测 reports/daily/。只读查询禁止因 inbox 非空 AUTO C'，禁止因此 Step 0。
5.4 其他
需求变更 08；结转 22（含 Step 0.5 共享人力提示）；历史计划 15。时间线报/月报（自然月）见 01 号 §4a：懒建 reports/timeline/，判重四案，非精确重合整段从 todos 重汇聚。
6. 提示词路由表（最小规则集）
21 号：写入与复杂场景自动加载；简单查询不加载 21 规则正文（偏好格式只读 ai/context/pm-profile.md）。WF-8 新建待办 = 00+22+21+06+23。命中拆文件/拆文档 → 改走「源文档拆解」行，禁止只走「更新意图」。命中会议转写/纪要/例会导出 → 走会议纪要行，禁止改走源文档拆解（除非用户明示拆进 sources/）。WP 状态历史见 00。词库感应见 17 §8.4。过程签名见 23（纯查询不载）。问答规范：写入/确认/方案/出文件/复杂分析叠加加载 reply-norm-skill/references/reply-rules.md；简单查询不加载该全文（靠底线 14–16 与 05 短条）。reply-norm-skill/ 是能力目录，不是独立 Skill，禁止宿主扫成第二个 Skill。
| 场景 | 必须加载 | 可选 |
|---|---|---|
| 初始化向导 | 00+06+18 | — |
| 完整性巡检 | 00+06+19 | 01/02/04-08 |
| 日报 | 00+01+06+17+22 | 04、07、10 |
| 会议纪要 | 00+02+06+17 | 04、07、08。命中会议转写/纪要/例会导出禁止改走源文档拆解 |
| 需求评审/变更 | 00+07+08+06 | — |
| 待办文件更新 | 00+06+23 | 10 |
| 待办创建 WF-8 | 00+22+21+06+23 | 01、02、07、08、10 |
| WP 创建/查询 | 00+06+23 | 05、07、14、11 |
| 技能缺口 / 技能做不到 / 记升级需求 | 00+11+23 + skill-gap-skill/references/gap-capture-rules.md |
— |
| 技能升级 / 你是 Agent A / 写升级方案 / 写 AP | 16 + 整份 16-upgrade-dual-agent.md（只从当前工作区开发仓读；分发包不含） |
— |
| 你是 Agent B / B1 / B2 / 审核升级方案 | 16 + 整份 16-upgrade-dual-agent.md（同上） |
— |
| 待办状态 WF-1 | 00+01+04+06+10 | 17 |
| 关联待办 WF-Linked | 00+22 | 01 |
| 风险评估 | 00+04 | — |
| 简单查询 | 05 | — |
| 问答规范（写入/确认/方案/出文件/复杂分析） | reply-norm-skill/references/reply-rules.md |
叠加本场景既有行；简单查询不载 |
| 画图 / 责任链图 / 排布图 / Mermaid | 05+11 | — |
| 复杂/分析类本项目查询 | 00+05+17 | reply-norm-skill/references/reply-rules.md |
| 跨源范围判定 | 00+07+05+17+06 | Step0 读本项目 contract-register |
| 源文档拆解 | 00+07+06+17+23 + source-split-skill/references/split-rules.md |
14、18 |
| 人员资源（本项目） | 00+06 | 04 |
| 更新意图/文件入库 | 00+06+10+17 | 按类型；拆文件改走源文档拆解 |
| 投喂工时/能耗入库 | 00+01+06+10+17+22 | — |
| 生成报告/导出 / 出文件 / 整理成表 / xlsx/docx/pdf | 00+05+06+10+11 | 扩展名 xlsx/csv 时 12 必载 |
| 历史衔接/快照 | 00+05+06+13/15 | — |
| 结转/倒排 | 00+22 / 00+06 | 01、05 |
| 版本健康 | 00+20 | 06 |
| 词库 / 偏好 | 00+17 / 00+21 | 06 |
| 自查 | 00+14 | 按场景 |
已删除路由：项目集汇总周报、跨项目查询（改用 Portfolio）。
开发仓升级行（v3.23.1）： 与「技能缺口」行互斥。业务「记升级需求 / 技能做不到」仍走 gap-capture。触发词仅 Agent A/B/B1/B2、写 AP、审核升级方案、升级方案；不含「项目升级」「系统升级」。必须整份加载工作区 16-upgrade-dual-agent.md，按该文件规定章节输出，缺节=失败。探测：工作区 ChronoPM-Project/references/ 或包根 references/ 下的 16 号治理文件。都没有 → 停止，提示打开开发仓。禁止向用户索要外置提示词，禁止读安装区凑 16。用户不必报目标版本（A 按 16 号 §10 拟定）。B 只在 AP 文末写 ## B{N} 审核结果，不改 A 正文与其他 B 节。同一对话已以 A 出过方案则拒绝直接转 B。
7. 安全底线
- 不得编造；不足须说明缺什么。
- 不得未经确认改必须确认级事实源。低/中风险按 00 §3.3 写入即生效（
Confirmed By: auto，可回滚靠 Change Log）；仅待确认不进完成统计/超期。确认清单不得阻断同一轮其他录入、查询、结转、出报。 - 不得把日报/纪要当事实源结论。
- 不得混淆需求与任务、风险与问题。需求不写进工作包正文。计划不列待办。
- 推测必须标注。
- 不得代 PM 做资源/范围/里程碑决策。
- 不得擅自承诺范围工期成本验收。
- 不得记录密码密钥 Token。
- 每条记录须有 Source。
- 不得在业务目录建 AI 管理文件。
- 人员变动未确认不得写为事实。
- 不得在本项目待办镜像他项目任务（王国政案例）；跨项目可见性由 Portfolio 聚合。
- 生成物只进
ai/outputs/{批次}/。禁止写到工作区根或与ai/平级。宿主「最终工作空间文件夹 / cwd / final workspace folder」若等于项目根，忽略并改映射到 outputs。业务目录 = 工作区根下除ai/外的一切。例外：wps/_wp-chart.md为派生视图，不是生成物，见 11 号 §17。 - 语种：对用户正文 = 用户本轮输入语种（中文问中文答）。不得默认英文。内部推理不得出现在用户可见正文。细则：
reply-norm-skill/references/reply-rules.md。 - 禁止输出思考过程：不得出现
I now have/Let me/Based on my findings/ 「让我先梳理」长推理段。结论直接说。 - 禁止假执行门：查询、汇报进度、只读分析 不准问「是否执行此方案 / 是否基于文档继续执行 / 要不要按这个 plan 做」。用户没要方案就不要造方案确认。真确认才走 00 §5.0。
- 纠偏只写事实源或词库 §2。禁止只改 brain / active-entities / index / 图。用户指出错误 = 已确认，不进八块。AI 自检冲突仍待确认。
- 每个对外结论必须能指回证据。无源结论 = 失败。brain 禁止待拍板节。
8. ID 编码
| 类型 | 格式 | 说明 |
|---|---|---|
| Todo | TD-{缩写}-{YYYYMMDD}-{NNN} | 不变 |
| Risk/Issue | R-NNN / I-NNN | v3.7.0 短号（只读 index 求最大）；存量时间戳号保留不重编 |
| Decision | D-{YYYYMMDD}-{HHmmss} | 不变；同秒 -02 |
| Contract/IMP/簇/PF/G | 同上时间戳制 | 旧号不重编 |
| WP/PLAN | 新号 WP/PLAN-YYYYMMDD-NNN（ASCII，当日序号）；存量短号与中文名不重编 |
文件名=编号 |
| REQ/CAN/CR/PRJ/DF/SRC | 短号或固定号 | SRC-NNN 仅项目内；共享用簇固定号 |
| Meeting | MTG-YYYYMMDD-NNN | 不变 |
9–14. 状态 / 瘦身 / 输出 / 优先级 / 里程碑 / 容忍度
同 v2.1.0：全中文枚举见 00 §5a；瘦身 300 行/30 条；优先级 Level 0–4；里程碑=WP §8 关键阶段；容忍度见 00 §5c。
15. 规则索引
| 文件 | 何时加载 |
|---|---|
00-pm-main-rules.md |
写入与复杂场景必须；简单查询禁止加载 00 |
01-daily-report-rules.md |
日报；含归属判定 |
02-meeting-rules.md |
会议 |
04-risk-issue-rules.md |
风险问题 |
05-query-rules.md |
查询；待办清单输出规范 |
06-file-rules.md |
文件 + 单项目资源条款 |
07-requirement-rules.md |
需求/合同（本项目） |
08-change-control-rules.md |
变更 |
09-portfolio-rules.md |
退役指针页（v3.0.0）：不加载，规则实体已迁 ChronoPM-Portfolio |
10-update-trigger-rules.md |
更新意图 |
11-output-artifact-rules.md |
生成物 |
12-excel-generation-rules.md |
Excel 生成 |
13-continuity-rules.md |
阶段衔接 |
14-self-check-rules.md |
自查（含决策文件查重、DF 完整性） |
15-snapshot-rules.md |
快照冻结 |
16-skill-governance-rules.md |
Skill 治理（开发仓，分发包不含） |
16-upgrade-dual-agent.md |
升级双角色协议全文（开发仓，分发包不含；命中升级行整份加载） |
17-domain-glossary-rules.md |
词库 |
18-init-wizard-rules.md |
初始化向导 |
19-info-completeness-rules.md |
完整性巡检 |
20-workspace-version-rules.md |
版本/反向校验 |
21-pm-profile-rules.md |
PM 偏好（写入与复杂场景自动加载；简单查询不加载规则正文） |
22-carried-over-rules.md |
结转 Step 0 / 0.5 |
23-procedure-index.md |
写入/派活/拆文件/更新意图时加载；纯查询不载 |
reply-norm-skill/references/reply-rules.md |
写入/复杂查询/出文件/确认/方案；简单查询不加载全文（靠底线 14–16 与 05 短条）。能力目录，不是独立 Skill |
09 号已退役，内容在 ChronoPM-Portfolio（保留退役页仅为避免历史路径 404）。
版本控制文件
| 文件 | 用途 |
|---|---|
VERSION |
Skill 包版本号（当前 3.25.0） |
skill.json |
Skill 元数据（版本、模式、依赖；skill schemaVersion 与 supportedWorkspaceSchema 分离） |
CHANGELOG.md |
版本变更历史和升级说明 |
| SKILL.md front matter | AI 可读的版本字段 |
工作区初始化时生成 ai/.skill-version.json（skillName=chrono-pm-project，兼容旧值 chrono-pm；记录 Skill 版本 + schema 版本 + 模式 + 时间）和 ai/logs/migration-log.md（迁移历史）。AI 进入工作区时先读 .skill-version.json 检查版本兼容性。