chrono-pm-project

项目管理:记日报、出周报、跟待办、做风险登记、写会议纪要。工作包、计划、倒排、里程碑、合同和需求写进你自己的 Markdown 文件夹;要紧的变更先问过你。跨项目只读归集在本包的 portfolio-skill/,不是单独安装的技能。Project management for daily reports, weekly reports, todos, risk registers, and me

SKILL.md

GitHub

ChronoPM-Project — 项目管理(日报/待办/计划/风险/周报)

1. 概述

本技能以项目文件夹下的 ai/ 目录为载体,以 Markdown 为项目记忆,以 AI 为副手,以人工确认为最终控制点。 核心理念:事实源文件是唯一真相;日报/纪要是输入,不能替代事实源。 待办单一数据源:执行状态 = todos/{date}/{owner}.md(一人一天一份;写入经 inbox 再合并)。PLAN = 唯一计划编排事实源(只引用 WP,不列待办)。WP 独立文件 = wps/WP-*.md(须有需求编号;待确认不拆待办)。需求只绑工作包,待办只绑工作包。 v4.0.0:跨项目归集在 portfolio-skill/。集层投喂可调用本包写过程(P-HANDOFF-ACCEPT),root 仍是本成员。

2. 工作模式

仅 single:全部管理文档在本项目 ai/。无 portfolio 模式。 工作区三态只看当前工作区根或 --project-root,禁止向上翻父目录。 (1)集根:当前根同时有 ai/portfolio/ 与 ai/projects/ 一级 → 本包禁止单项目写入,禁止把某个 projects/{名} 当作本项目落盘。材料投喂、日报、入库、混报、进度表、xlsx/csv 文件(不论有无表头)加载 portfolio-skill 的只读边界规则(文件名以 01-readonly 开头;§2.1 后 §2.2 CALL 本包,CALL 的 root 必须是成员根)。跨项目查询加载 portfolio-skill 的归集规则(文件名以 02-aggregation 开头)。目录里没有这些文件就报规则缺失,不提示另装技能。禁止本包在集根上代做成员聚合正文。 (2)成员根 / 纯单项目:当前根直接有 ai/todos/ 或 ai/wps/ 且非集根 → 本包按单项目只写该根,禁止写兄弟项目,禁止写 portfolio/。允许被集层 P-HANDOFF-WRITE 调用(root=本成员)。 (3)在(2)出现跨项目意图 → 加载 portfolio-skill 的归集规则(02-aggregation)。不提示另装技能。

3. 工作区结构

project-root/
└── ai/
    ├── context/          # project-context、pm-profile、project-rules、词库等
    ├── templates/
    ├── todos/{date}/{owner}.md
    ├── requirements/     # 登记册 + sources/{编号}/ 拆解产物(本项目一套)
    ├── plans/  project-info/  wps/  registers/  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-skill/ 使用,init 不创建):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 文件 + 查找加速器(存在性以文件为准)
registers/scope-register.md registers/_index.md 范围矩阵(功能点×对象类型×批次;存在性以表文件为准)
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。结转:先快扫三问(00 §4c / 22 §2.1;只读当天 _index 与文件名)。未过才跑本 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。会话钩子会自己运行 scripts/enforce_workspace_upgrade.py:技能更新时由程序处理。已拆源对不上恰好一条已有需求时保持独立并写参见,不挡住版本戳。已声明 doc_kind: reference 的切片也不计入未完成。切片没有章节或页码、doc_kind 无法识别、恰好一条需求但补完仍没有在用工作包时,不改 skillVersion。模型禁止自己改这个字段,禁止把没做完说成升级完成。钩子没跑成时,版本号保持原样。 P-VIEWS 不在查询时跑。写入完成之后,或用户要求重建视图时,有 Python 则跑 scripts/refresh_views.py --project-root <根> --all(指纹未变不写盘)。<根> = 单项目根(其下直接有 ai/wps/)。联邦集工作区须指向成员项目根,禁止对集根跑 --all。无 Python / 失败 → 不阻断。缺 context/brain.md 不致命。

5.2 日报

先判定是否本项目 → 原文进 inbox → 合并进当天一人一份个人文件 → 映射待办(够正式的未匹配进展自动建待办)。禁止写入 reports/daily/。明日计划留在当天原文,次日才落待办。口述或粘贴不建 sources/。甩来的日报文件同轮拆进 sources/,doc_kind: reference,进展仍进各人当天待办。疑似他项目:拆分+分流,禁代写。见 01-daily-report-rules.md。

5.3 查询

本项目事实源。简单查询加载 query-skill/references/query-rules.md,先跑 query-skill/scripts/query_locate.py,不跑 refresh_views.py --all。无 Python / 失败 → 不阻断,定向读事实并声明 as-of。再最多打开路由允许的事实文件。全库扫 / 扫 backup/ / 全库语义扫 = 本轮失败。纯查询横幅见查询规则 §1a(N>0 一行,不铺清单)。待办清单输出见查询规则(默认未办结;待确认 终态仍可见;auto 按已确认)。日报内容默认先读 todos/{date}/*.md §2+§3,禁止先探测 reports/daily/。只读查询禁止因 inbox 非空 AUTO C',禁止因此 Step 0。跨项目查询加载 portfolio-skill 的归集规则(02-aggregation),对成员根调用 query_locate.py。

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/,或甩来了独立的开会文件)。甩来的开会文件同轮拆进 sources/,doc_kind: reference,行动项仍按会议规则提取。无文件的转写不进 sources/。WP 状态历史见 00。词库感应见 17 §8.4。过程签名见 23(纯查询不载)。问答规范:写入/确认/方案/出文件/复杂分析叠加加载 reply-norm-skill/references/reply-rules.md;简单查询不加载该全文(靠底线 14–16 与 19、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。无文件的转写禁止改走源文档拆解。甩来的开会文件同轮拆档,并保留「除非用户明示拆进 sources/」
需求评审/变更 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 —
简单查询 query-skill/references/query-rules.md —
项目集 / 跨项目查询 / 集周报 portfolio-skill 归集规则(02-aggregation) 01、04
问答规范(写入/确认/方案/出文件/复杂分析) reply-norm-skill/references/reply-rules.md 叠加本场景既有行;简单查询不载
画图 / 责任链图 / 排布图 / Mermaid 05+11 —
复杂/分析类本项目查询 00+query-skill/references/query-rules.md+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;编译主题页同轮 digest-schemas.md。总闸泛化文件同样走本行
人员资源(本项目) 00+06 04
更新意图/文件入库 00+06+10+17 按类型;未命中 L2 不得改走分析/反问,走 10 §1.0 兜底;拆文件/泛化材料改走源文档拆解
投喂工时/能耗入库 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-skill/。不再另装技能。

用户要的是升级需求、技能缺口或 skill 需求时,即使句子里有生成、写、出、整理,也走「技能缺口」行,不走「生成报告/导出」行。技能缺口行内部仍按 23 号 CALL P-OUTPUT,主文件名是 需求-{短标题}.md。宿主技能自己的输出目录不得覆盖底线 13。

开发仓升级行(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. 安全底线

  1. 不得编造;不足须说明缺什么。
  2. 不得未经确认改必须确认级事实源。低/中风险按 00 §3.3 写入即生效(Confirmed By: auto,可回滚靠 Change Log);仅 待确认 不进完成统计/超期。确认清单不得阻断同一轮其他录入、查询、结转、出报。
  3. 不得把日报/纪要当事实源结论。
  4. 不得混淆需求与任务、风险与问题。需求不写进工作包正文。计划不列待办。
  5. 推测必须标注。
  6. 不得代 PM 做资源/范围/里程碑决策。
  7. 不得擅自承诺范围工期成本验收。
  8. 不得记录密码密钥 Token。
  9. 每条记录须有 Source。
  10. 不得在业务目录建 AI 管理文件。
  11. 人员变动未确认不得写为事实。
  12. 不得在本项目待办镜像他项目任务(王国政案例);跨项目可见性由 portfolio-skill 聚合。
  13. 生成物只进 ai/outputs/{批次}/。禁止写到工作区根或与 ai/ 平级。宿主「最终工作空间文件夹 / cwd / final workspace folder」若等于项目根,忽略并改映射到 outputs。业务目录 = 工作区根下除 ai/ 外的一切。例外:wps/_wp-chart.md 为派生视图,不是生成物,见 11 号 §17。宿主最终工作空间文件夹约定与底线 13 冲突时底线 13 优先,校验器为最终裁决。出文件前运行 scripts/check_output_path.py。
  14. 语种:对用户正文 = 用户本轮输入语种(中文问中文答)。不得默认英文。内部推理不得出现在用户可见正文。细则:reply-norm-skill/references/reply-rules.md。
  15. 禁止输出思考过程:不得出现 I now have / Let me / Based on my findings / 「让我先梳理」长推理段。结论直接说。
  16. 禁止假执行门:查询、汇报进度、只读分析 不准问「是否执行此方案 / 是否基于文档继续执行 / 要不要按这个 plan 做」。已判定与本项目相关的材料不准问「您希望我怎么做 / 需要我如何处理 / 要不要记住 / 要不要解析」。用户没要方案就不要造方案确认。真确认才走 00 §5.0。
  17. 纠偏只写事实源或词库 §2。禁止只改 brain / active-entities / index / 图 / _digest(主题页)。用户指出错误 = 已确认,不进八块。AI 自检冲突仍待确认。改源文档切片须同轮重编主题页。
  18. 每个对外结论必须能指回证据。无源结论 = 失败。brain 禁止待拍板节。汇报段可出示源文档抽出图或路径;拍板段仍走底线 19。
  19. 对外拍板禁止技能黑话:同一轮「结果汇报」和「请你拍板」必须分段。拍板段禁止内部编号、结构版本、工序名、脚本名、回填状态。发消息前五句自检过不了 = 本轮对外失败,先重写再发:①这段是问人认不认还是报进度;②问人的句子有没有内部编号/结构版本/工序名;③不看上文能不能回 1A;④证据路径等人问「改了哪些」再给(处理类落点回执除外);⑤词典没有的新黑话先用人话解释。禁词只约束提问/拍板段;查询待办清单仍给待办编号。细则:00-pm-main-rules.md §5.0。
  20. 投喂一次做完:混报/进度表/拆文件本轮必须落下原文 + 能确定的待办映射 + 已发生卡住。禁止「下次再对包」。投喂/日报映射:该人该项目进行中且正常的工作包恰好 1 个则绑,否则标待归属、当场不问,不经 Q-7 回落 WF-8 问绑。WF-8「无上下文仍必须问绑哪个」只适用于口述直接创建(以及纪要正式行动项/派活等非投喂入口)。只问关问题/出组/删除/扩范围(外加口述绑包)。细则 01/04/00。

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 不变
SR SR-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 指针。正文在 query-skill/references/query-rules.md
query-skill/references/query-rules.md 查询;待办清单输出规范
portfolio-skill 归集规则(02-aggregation) 跨项目只读归集。不是独立技能
06-file-rules.md 文件 + 单项目资源条款
07-requirement-rules.md 需求/合同(本项目)
08-change-control-rules.md 变更
09-portfolio-rules.md 退役指针页:不加载,规则在 portfolio-skill/references/
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 与 19、05 短条)。能力目录,不是独立 Skill

09 号已退役,内容在 portfolio-skill(保留退役页仅为避免历史路径 404)。

版本控制文件

文件 用途
VERSION Skill 包版本号(当前 4.1.1)
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 检查版本兼容性。