qiusuo0226/chrono-pm-skill / governance-shared/baselines/3.2.0/ChronoPM-Project
chrono-pm-project
VerifiedMarkdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio(只读)。触发:项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好。支持主动变更+人工确认:写入即标记待确认并登记 pending-changes,确认后生效。
references/06-file-rules.md
View on GitHub# 文件管理约束规则
本规则适用于项目记忆库中文件的命名、创建、更新、拆分和归档。
## 1. AI 文件目录边界规则
### 1.1 核心原则:业务目录不侵入
AI 生成的所有管理文件必须统一存放在 `ai/` 目录下,**严禁在业务代码目录或项目交付物目录中创建任何 AI 管理文件**。本包为单项目工作区;集层目录不属于本包结构,跨项目归集见 ChronoPM-Portfolio。
### 1.1a project-brief.md — AI 首读文件
本项目 `context/project-brief.md` 是 AI 的**快速入口文件**(R4 归属判定配套)。
**规则:**
1. AI 在处理任何用户输入(文本、文件、口述)前,**必须先读取 `project-brief.md`**,获取项目基本信息、团队成员、文件路由速查表,并判定输入与本项目的关联度(他项目内容按 01 号 §1.0 分流,禁代写)。
2. AI 通过 `project-brief.md` 判断输入与当前项目的关联度,确定项目归属和作用范围。
3. `project-brief.md` 应保持精炼(建议 ≤ 100 行),只放 AI 快速判断所需关键信息。详细背景见 `project-context.md`。
4. `project-brief.md` 是事实源文件,更新需经用户确认。
5. 项目初始化时由 `init_workspace.py` 自动生成空模板。
6. **团队信息指针化**:`project-brief.md` 中的团队信息不应复制 `resource-register.md` 完整团队列表,而应使用指针。brief 团队部分替换为:
```markdown
## 3. 团队成员
→ 见本项目 `resources/resource-register.md`(人员当前状态主源)
→ 见本项目 `resources/transfer-log.md`(人员流转历史)
```
**迁移规则**:不自动删除 brief 已有团队列表,只新增主源指针并标记冗余待清理。下次 register 更新时提示用户"brief 团队列表已指针化,建议删除冗余信息",确认后删除。
| 目录 | 是否允许创建AI文件 | 说明 |
|---|---|---|
| `ai/` 下本项目目录(todos/risks/issues/plans/requirements/decisions/resources/reports/meetings/context/outputs/logs) | ✅ 允许 | 本项目管理工作区 |
| 业务代码目录 / 需求文档目录 / 交付物目录 | ❌ 禁止 | AI 不得在此创建或修改任何文件 |
| 他项目 `ai/` | ❌ 禁止 | 不得代写;跨项目可见性由 ChronoPM-Portfolio 只读聚合 |
### 1.2 集层目录(本包不使用)
`portfolio/` 集层目录**不是**本包工作区结构。跨项目索引 / 汇总周报 / 共享人力请使用 ChronoPM-Portfolio。本包只维护下方单项目树。
### 1.3 单项目目录结构
直接放 `ai/` 下(无 `portfolio/`、`projects/` 分层):
```
ai/ ├── todos/ ├── risks/ ├── issues/ ├── plans/ ├── requirements/ ├── decisions/
├── resources/ ├── reports/ ├── meetings/ ├── context/ ├── outputs/ └── logs/
```
> v2.1.0:原 `continuity/` 目录合并入 `context/`(4 个文件:carryover-register/import-log/legacy-sources/project-lineage);原工作区根目录 `outputs/` 移入 `ai/outputs/`,工作区根目录只留一个 `ai/` 顶层目录。
完整树见 `SKILL.md` §3.2。
### 1.4 更新权限分级
默认采用 `proactive` 模式(主动变更 + 人工确认)。项目可在 `prompts/project-rules.md` 中修改权限级别。
**低/中风险更新(proactive 模式下直接写入事实源,并标记 `Confirmed By: 待确认`,同步登记 `pending-changes.md`,待 PM 确认后持久化):**
- 日报归档、会议纪要草稿归档、评审纪要归档
- 周报草稿生成
- 资源流转日志候选、AI 操作日志更新
- 未排期待办候选新增(登记 `pending-changes.md`)
- 风险/问题候选新增为开放
- 任务 Due Date / 状态中途 / Owner 等过程性更新(写事实源并标记待确认)
> 低/中风险先在事实源记录新值并标 `Confirmed By: 待确认`,PM 确认后翻转为 PM 姓名,驳回则恢复原值并追加 `已驳回` 记录。若配置 `update_mode: passive` 则回退为"仅输出建议清单,不写事实源"。
**高风险更新(必须确认后才能更新):**
- 需求状态确认/取消、需求变更批准
- 预算/P&L 金额调整、里程碑日期调整
- 任务关闭、风险/问题关闭
- 正式决策记录、验收结论
- 人员正式离场、删除/覆盖/重写历史记录
详细触发机制和路由见 `10-update-trigger-rules.md`。
### 1.5 资源文件状态与历史分离规则
人员资源管理遵循「状态与历史分离」原则,事实源只在本项目 `resources/`:
| 文件 | 定位 | 内容 | 更新方式 |
|---|---|---|---|
| 本项目 `resources/resource-register.md` | 当前状态事实源 | 本项目人员当前状态快照(角色/状态/分配方式/B角等) | 覆盖更新(每次只保留最新状态) |
| 本项目 `resources/transfer-log.md` | 流转历史记录 | 本项目人员进出、调配、角色变更的完整流水 | 追加更新(只增不改不删) |
**规则:**
1. `resource-register.md` 只反映当前状态,不保留历史状态。历史状态通过 `transfer-log.md` 追溯。
2. `transfer-log.md` 是只追加文件,已录入的流转记录不可修改或删除。
3. 两个文件通过「资源 ID(RES-NNN)」和「姓名」关联。
4. AI 检测到资源变动时,必须同时建议更新两个文件:在 `transfer-log.md` 追加流转记录,在 `resource-register.md` 更新状态。
5. 跨项目共享人力索引不在本包维护;查询请使用 ChronoPM-Portfolio。
### 1.6 单项目资源管理(自 09 号 §8.1/§8.2 迁入)
路径一律本项目 `resources/`(及本项目 `logs/` 归档)。
**transfer-log 归档:**
- 拆分触发:>100 条记录 或 文件 >300 行
- 拆分策略:按年度归档到本项目 `logs/archive/YYYY-transfer-log.md`
- 归档后维护本项目 `logs/index.md` 索引
- 归档操作本身记录在 Change Log 中
- transfer-log 为只追加型文件,归档只移动历史条目,不删除任何内容
**resource-register 离场 90 天归档:**
- 状态为 `已离场`/`已调出` 且离场超过 90 天的人员 → 归档到本项目 `resources/resource-register-archive.md`
- 归档触发:在周报生成时检查
- 归档后主体文件仅保留 `在岗`/`待进场` 状态的资源
- 归档操作记录在 Change Log 中
## 2. 文件命名规范
### 2.1 事实源文件
固定文件名,不附加日期:
```
todos/{date}/{owner}.md
todos/{date}/_index.md
pending-changes.md
risks/risk-register.md
issues/issue-register.md
decisions/decision-log.md
plans/progress-plan.md
plans/PLAN-NNN-{name}.md
plans/budget.md
requirements/requirement-register.md
requirements/change-log.md
requirements/source-type-registry.md
requirements/contract-register.md
requirements/canonical/canonical-index.md
requirements/canonical/CAN-*.md
requirements/atoms/atom-index.md
requirements/atoms/{category}-index.md
requirements/atoms/{category}.md
resources/resource-register.md
resources/transfer-log.md
```
### 2.2 集层事实源(本包不写)
集层 `portfolio/` 路径已迁 ChronoPM-Portfolio。本包事实源仅 §2.1 所列本项目文件。
### 2.3 过程记录文件
按日期命名,格式:`YYYY-MM-DD-[描述].md`
**目录层级规则:按月归档,使用 `YYYYMM` 单级目录,不再使用 `YYYY/MM` 两级。**
```
reports/daily/project/YYYYMM/YYYY-MM-DD-[project]-项目日报.md
reports/weekly/YYYY/YYYY-Wxx.md
meetings/YYYYMM/YYYY-MM-DD-[topic].md
reviews/YYYYMM/YYYY-MM-DD-[event]-retrospective.md
```
> **v2.0.0**:个人日报文件与个人进度汇总文件(原 `reports/daily/personal/` 及 `summaries/[name]-progress.md`)已删除;成员工作汇报写入待办文件工作日志段,个人进度由待办文件实时聚合。
>
> **v2.1.0 废弃路径标注**:`reports/daily/personal/`(任何子目录层级)已废弃,**禁止写入**(见 01 号 §1.2a 与本文件 §12 禁用清单);周报路径统一为 `reports/weekly/YYYY/YYYY-Wxx.md`(R-1,以 01 号 §3.0 单项目周报为准,不再使用 `YYYY-Wxx-[project]-周报.md` 旧命名)。
### 2.4 月度文件数量阈值规则
默认一个月的项目日报放在同一 `YYYYMM/` 目录。当单月日报数量超过 **800** 个时,AI 建议启用按日期二级拆分:
```
reports/daily/project/YYYYMM/YYYY-MM-DD/[project]-项目日报.md
```
未超过阈值不主动拆分,避免目录过深。
### 2.5 索引文件
固定文件名:`index.md`,放在对应目录下。
### 2.6 历史计划导入快照(external_import)
历史计划批量导入(R1)生成的快照复用 `todos/snapshots/daily|weekly/` 目录,文件名以 `imported-` 前缀区分:`imported-{YYYYMMDD}.md`,frontmatter 标注 `source_type: external_import`。文件命名、元数据与冻结规范详见 `references/15-snapshot-rules.md`(本文件不重复)。
### 2.7 路径书写基准(v2.1.0 新增,需求十二)
为消除各规则文件路径前缀不一致(有的带 `ai/` 前缀有的不带),统一书写基准:
1. 规则中书写的路径均为**本项目 `ai/` 根相对路径**,如 `reports/weekly/` = `ai/reports/weekly/`
2. 本包不使用 `ai/portfolio/` 或 `ai/projects/{子项目}/` 作为默认存储路径
3. 跨项目引用由 ChronoPM-Portfolio 处理;本包需提示时只给项目名 / 兄弟项目 ai 路径指针,不代写
## 3. 文档元数据头
每份正式文档头部必须包含:
```yaml
---
doc_type: [文档类型]
project: [项目名]
milestone: [当前里程碑]
version: v1.0
date: YYYY-MM-DD
status: 草稿 / 评审中 / 已确认 / 已归档
author: AI辅助生成
---
```
## 4. 文件创建规则
1. 新文件创建时必须从 `templates/` 目录对应模板复制。
2. 如果模板不存在,先创建模板再创建文件。
3. 创建后必须在对应 `index.md` 中登记。
4. 文件创建时状态默认为"草稿"。
## 5. 文件更新规则
1. 事实源文件更新必须经过人工确认。
2. 更新前必须读取文件当前内容,确认版本一致。
3. 状态为"已确认"或"已归档"的文件不可直接修改:
- 已确认文件:追加新版本,保留旧版本。
- 已归档文件:不可修改。
4. 每次更新必须在文件底部 Change Log 中记录。
5. 更新后版本号递增(v1.0 → v1.1 小修订,v1.0 → v2.0 大变更)。
## 6. 文件瘦身规则
### 6.1 拆分触发条件
当单个 Markdown 文件满足以下任一条件时,AI 应建议拆分:
1. 超过 300 行。
2. 超过 30 条记录。
3. 包含超过 3 个月的连续记录。
4. 同时包含多个不同管理对象。
5. 用户需要频繁检索其中某类子记录。
### 6.2 拆分规则
| 文件类型 | 拆分方式 |
|----------|----------|
| 日报 | 按天拆分(已执行) |
| 会议纪要 | 按会议拆分(已执行) |
| 复盘 | 按事件或里程碑拆分 |
| Change Log | 活跃区上限 50 行或超过 30 天触发按月归档到 `change-log/archive/YYYYMM-change-log.md`,并维护 `change-log/index.md` 月份导航 |
| 风险登记册 | 超过30条时按类别或时间段拆分,保留 index |
| 需求登记册 | 超过50条时按模块拆分,保留 index |
| 待办文件 | 按人按日天然拆分(`todos/{date}/{执行人}.md`),无需再拆;绑定文件 `_index.md` 与待办文件同日同目录 |
| PLAN 文件 | 每计划一文件(`plans/PLAN-NNN-{name}.md`)天然拆分,无需再拆;WP 粗规划表保持一行/WP,不内嵌每日明细 |
| decision-log | 超过30条或文件超300行时按季度拆分到 `decisions/archive/YYYY-QN-decision-log.md`,保留 index |
| issue-register | 超过30条时按状态拆分(`已解决`/`已关闭` 归档,主体保留活跃),保留 index |
| transfer-log | 超过100条或文件超300行时按年度拆分到 `logs/archive/YYYY-transfer-log.md`,保留 index |
> Change Log 归档采用统一的「活跃区 50 行 / 30 天」规则:活跃区超过 50 行或距上次归档超过 30 天时,将历史条目按月归入 `change-log/archive/YYYYMM-change-log.md`(YYYYMM 为归档月份),并在 `change-log/index.md` 登记该月份导航。主动变更(pending)记录在写入时合并写入,同会话确认只记 1 条。
### 6.3 拆分后处理
1. 拆分后必须建立或更新 `index.md`。
2. 原文件保留为"当前状态"视图,只保留活跃记录。
3. 历史记录移入归档文件,命名 `YYYY/archive-[描述].md`。
4. **持续拆分模式**(适用于随状态持续增长的文件,如 issue-register):主体文件只保留活跃状态记录,已关闭/已解决记录定期移入 `archive/` 下的分片文件(命名 `YYYY-[类型]-register.md`)。归档后仍维护主体 `index.md`。此模式与"第 3 点单文件归档"命名并存,二者均为正式规范。
## 7. 索引文件规范
索引文件必须包含相应的列定义,完整 markdown 模板见 `assets/templates/index-formats.md`。
### 7.1 日报索引
必须包含列:`Date | Type | File | Owner | Summary | Task Sync | Risk Sync | Issue Sync | Weekly Sync`
### 7.2 会议索引
必须包含列:`Date | Meeting ID | Title | Key Decisions | Action Items | File`
### 7.3 周报索引
必须包含列:`Week | Date Range | File | Status | Key Highlights`
## 8. Change Log 规范
事实源文件底部必须包含 Change Log,格式见 `assets/templates/index-formats.md`:
- Change Type:`add` / `update` / `remove` / `status` / `archive`
- Source:来源文件或会议 ID
- Confirmed By:确认人姓名(AI 建议的记录为"待确认")
> 主动变更模式下,`Confirmed By: 待确认` 的条目还必须同步登记到 `pending-changes.md`(待确认变更索引),与该条目一一对应;PM 确认/驳回后按 §1.4 处理并更新 pending-changes.md。
> 注:此处的 Change Type 是**记录操作类型**(对事实源记录执行的操作),与 `references/08-change-control-rules.md` 中需求变更**影响分类**(requirement/scope/schedule/cost/resource/plan_change)是两个不同概念域,不可混用。计划变更(plan_change)在待办文件底部 Change Log 中以 `update` 操作 + Description 标注体现,不在本枚举中新增类型。
## 9. 归档规则
以下实体满足触发条件时,AI 应在当前处理流程末尾执行归档检查(通常为日报处理 §5.8 通用归档检查、周报生成或相应实体变更流程):
| 实体 | 触发条件 | 归档目标 | 索引 |
|------|----------|----------|------|
| issue(已关闭) | >30 条 | `issues/archive/YYYY-issue-register.md` | `issues/index.md` |
| risk(已关闭) | >30 条 | `risks/archive/YYYY-risk-register.md` | `risks/index.md` |
| decision(已执行) | >30 条 | `decisions/archive/YYYY-QN-decision-log.md` | `decisions/index.md` |
| transfer-log | >100 条 | `logs/archive/YYYY-transfer-log.md` | `logs/index.md` |
| resource(已离场) | 离场 >90 天 | `resource-register-archive.md` | — |
| snapshot/actuals | >90 天 | `snapshots/archive/YYYY/`、`actuals/archive/YYYY/` | —(v2.0.0 起无 history-index,目录内按月直查) |
| outputs(已导出) | >90 天 | `ai/outputs/archive/YYYY/`(v2.1.0 起 outputs/ 在 ai/ 下) | `ai/outputs/index.md` |
归档检查时机:日报处理末尾(01 号 §5.8 通用归档检查)、周报生成时、或对应实体变更流程末尾(见各实体级联传播规则 [AUTO]/[SUGGEST])。
运维规则:
1. 归档操作本身必须记录在原文件的 Change Log 中(Change Type: `archive`)。
2. 归档文件状态改为"已归档";主体文件保留"当前状态"视图。
3. 涉及移动/归档**事实源**文件的动作走 SUGGEST(待 PM 确认);仅派生视图(索引)刷新走 AUTO。
统一归档粒度标准:
- Change Log(各事实源底部):50 行 / 30 天 → 月归档(已有,不变)
- 注册表主体(risk/issue/requirement/待办文件):按条数触发(30-50 条)→ 按类别/状态拆分
- 日志型文件(transfer-log/decision-log):按条数触发(30-100 条)→ 按时间拆分
- 目录型文件(snapshots/outputs/daily-reports):按时间触发(90 天)→ 年度归档
- ATOM 类别文件 `{category}.md`:超 300 行 → 按 source_type 分片(如 `technical-design_spec.md`),并新增对应 L2 `{category}-index.md` 分片条目
- Canonical 文件:超 50 条 → 按 scope_scope/类别拆分
- project-notes:超 100 条 / 6 个月 → 季度归档到 `context/project-notes-archive/`
- 所有归档后必须维护索引
## 10. 安全规则
1. 不得在文件中记录密码、密钥、Token 等凭证。
2. 涉及客户敏感信息时使用脱敏代号。
3. 不得删除或覆盖状态为"已确认"的文件,只能新增版本。
## 11. PM Profile 文件规范
| 模式 | 路径 | 说明 |
|---|---|---|
| 本项目 | `ai/context/pm-profile.md` | 本项目 PM 偏好档案 |
规则:文件不存在时降级跳过(不视为错误);初始化时自动创建;旧工作区可 `migrate_workspace.py --create-profile` 补建;已存在不覆盖;pending 偏好不按 confirmed 应用;每条记录保留 Source。详见 `references/21-pm-profile-rules.md`。
## 12. v1.x 遗留路径禁用清单(v2.1.0 新增,读写均禁,统一维护点)
**设计动机**:规则中指向不明、模糊描述(如"继续作为历史缓存""查询兜底仍读")是 AI 继续插入/维护低版本目录的根因。除物理删除外,规则层明确:**高版本 AI 不得再查低版本目录文件**。本清单为全部 v1.x 遗留禁用路径的**唯一维护点**(需求五三层防护与需求十二三层禁令共用本清单)。
**禁用清单(迁移完成后生效)**:
| 禁用路径 | 禁用原因 | v2 替代入口 |
|---|---|---|
| `projects/*/reports/daily/personal/` | v1 个人日报,能力已并入待办工作日志 | `todos/{date}/{owner}.md` §3 工作日志段 |
| `projects/*/summaries/` | v1 个人进度汇总 | 待办文件实时聚合 |
| `projects/*/tasks/board.md` 及 `tasks/_historic/` | v1 看板体系 | `todos/{date}/` 待办文件 |
| `projects/*/tasks/backlog.md` | v1 遗留 | `pending-changes.md` |
| v1.x 非标准命名/层级的日报周报文件 | 迁移后不应存在 | v2 标准结构(YYYYMM/ 单级、YYYY/Wxx) |
**禁止读写**:AI 对禁用路径的任何读/写/创建操作均视为严重错误,必须中止并输出警告「⚠️ 命中 v1.x 禁用路径 {path},已中止。正确入口:{v2 替代入口}」。
**路径校验规则(需求五第三层)**:
1. AI 写入前必须检查目标路径是否在当前版本允许列表中(本文件 §2 命名规范 + 目录树);命中禁用清单 → 中止并警告。
2. **历史遗留文件识别**:若目标路径下存在大量按日期排列的历史文件,AI 应怀疑这是旧体系遗留,不得照其格式创建新文件(联动 `00-pm-main-rules.md` §4a 执行前自检);检测到禁用路径存在文件时,提示"迁移未完成"并按 `governance/migrations/upgrade-to-2.1.0.md` 补做迁移,而非就地读取/维护。
3. 版本层拦截见 `20-workspace-version-rules.md`(工作区版本 ≥ 2.1.0 检测到禁用路径存在文件或 AI 试图引用 → 阻断 + 提示迁移/整改);查询路由排除见 `05-query-rules.md` §2.5 查询性能规则第 5 条。
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 |