Skip to content

qiusuo0226/chrono-pm-skill / governance-shared/baselines/3.18.0/ChronoPM-Project

chrono-pm-project

Verified

Markdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio(只读)。触发:项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/整理记录/补全/回填/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好、画图、责任链图。支持主动变更+人工确认:写入即标记待确认并登记 pm-decisions,确认后生效。需求只绑工作包,计划只绑工作包。

FileKindSize
CHANGELOG.mdmarkdown127.1 KB
SKILL.mdskill md14.1 KB
SKILL_BLUEPRINT.mdmarkdown52.6 KB
SKILL_MODULE_MAP.mdmarkdown6.4 KB
VERSIONother7 B
assets/templates/archive/resource-register-template.mdmarkdown3.9 KB
assets/templates/archive/transfer-log-template.mdmarkdown3.8 KB
assets/templates/change-log-archive-template.mdmarkdown1.2 KB
assets/templates/change-log-index-template.mdmarkdown1.2 KB
assets/templates/change-log-template.mdmarkdown1.8 KB
assets/templates/contract-register-template.mdmarkdown3.1 KB
assets/templates/daily-todo-binding-template.mdmarkdown6.2 KB
assets/templates/decision-log-template.mdmarkdown685 B
assets/templates/domain-glossary-template.mdmarkdown2.2 KB
assets/templates/import-log-template.mdmarkdown1.3 KB
assets/templates/index-formats.mdmarkdown4.9 KB
assets/templates/issue-register-template.mdmarkdown1.5 KB
assets/templates/legacy-sources-template.mdmarkdown1022 B
assets/templates/lessons-learned-template.mdmarkdown1.8 KB
assets/templates/meeting-template.mdmarkdown1.4 KB
assets/templates/ops-log-index-template.mdmarkdown534 B
assets/templates/ops-log-template.mdmarkdown1.5 KB
assets/templates/output-manifest-template.mdmarkdown1.0 KB
assets/templates/outputs-index-template.mdmarkdown1.2 KB
assets/templates/personal-daily-todo-template.mdmarkdown9.0 KB
assets/templates/plan-import-template.mdmarkdown1.7 KB
assets/templates/plan-template.mdmarkdown3.7 KB
assets/templates/pm-decisions-template.mdmarkdown5.3 KB
assets/templates/pm-profile-template.mdmarkdown8.0 KB
assets/templates/project-brief-template.mdmarkdown4.4 KB
assets/templates/project-context-template.mdmarkdown4.0 KB
assets/templates/project-lineage-template.mdmarkdown1.3 KB
assets/templates/project-notes-template.mdmarkdown1.1 KB
assets/templates/project-status-template.mdmarkdown2.3 KB
assets/templates/requirement-index-template.mdmarkdown813 B
assets/templates/requirement-register-template.mdmarkdown4.5 KB
assets/templates/risk-register-template.mdmarkdown1.8 KB
assets/templates/source-type-registry-template.mdmarkdown6.3 KB
assets/templates/weekly-report-template.mdmarkdown2.4 KB
assets/templates/workspace-health-template.mdmarkdown1.9 KB
assets/templates/wp-chart-template.mdmarkdown797 B
assets/templates/wp-index-template.mdmarkdown1.8 KB
assets/templates/wp-template.mdmarkdown9.2 KB
governance/contracts/skill-contract.mdmarkdown7.8 KB
governance/migrations/README.mdmarkdown141 B
governance/migrations/upgrade-to-3.10.0.mdmarkdown10.2 KB
governance/migrations/upgrade-to-3.11.0.mdmarkdown6.1 KB
governance/migrations/upgrade-to-3.12.0.mdmarkdown7.2 KB
governance/migrations/upgrade-to-3.13.0.mdmarkdown6.6 KB
governance/migrations/upgrade-to-3.14.0.mdmarkdown10.0 KB
governance/migrations/upgrade-to-3.15.0.mdmarkdown7.2 KB
governance/migrations/upgrade-to-3.16.0.mdmarkdown6.0 KB
governance/migrations/upgrade-to-3.17.0.mdmarkdown5.7 KB
governance/migrations/upgrade-to-3.18.0.mdmarkdown5.3 KB
governance/migrations/upgrade-to-3.6.0.mdmarkdown2.3 KB
governance/migrations/upgrade-to-3.7.0.mdmarkdown3.1 KB
governance/migrations/upgrade-to-3.8.0.mdmarkdown19.4 KB
governance/migrations/upgrade-to-3.9.0.mdmarkdown11.1 KB
references/00-pm-main-rules.mdmarkdown77.7 KB
references/01-daily-report-rules.mdmarkdown33.9 KB
references/02-meeting-rules.mdmarkdown7.5 KB
references/04-risk-issue-rules.mdmarkdown15.0 KB
references/05-query-rules.mdmarkdown45.2 KB
references/06-file-rules.mdmarkdown29.4 KB
references/07-requirement-rules.mdmarkdown31.0 KB
references/08-change-control-rules.mdmarkdown10.2 KB
references/09-portfolio-rules.mdmarkdown391 B
references/10-update-trigger-rules.mdmarkdown22.4 KB
references/11-output-artifact-rules.mdmarkdown13.2 KB
references/12-excel-generation-rules.mdmarkdown15.4 KB
references/13-continuity-rules.mdmarkdown12.2 KB
references/14-self-check-rules.mdmarkdown26.9 KB
references/15-snapshot-rules.mdmarkdown3.9 KB
references/16-skill-governance-rules.mdmarkdown15.3 KB
references/17-domain-glossary-rules.mdmarkdown18.7 KB
references/18-init-wizard-rules.mdmarkdown13.8 KB
references/19-info-completeness-rules.mdmarkdown17.2 KB
references/20-workspace-version-rules.mdmarkdown15.3 KB
references/21-pm-profile-rules.mdmarkdown24.5 KB
references/22-carried-over-rules.mdmarkdown19.7 KB
references/23-procedure-index.mdmarkdown5.2 KB
reply-norm-skill/CAPABILITY.mdmarkdown807 B
reply-norm-skill/references/capability-boundary.mdmarkdown880 B
reply-norm-skill/references/reply-rules.mdmarkdown2.3 KB
scripts/_version.pyscript2.2 KB
scripts/carryover_step0.pyscript12.1 KB
scripts/chronopm_init/__init__.pyscript247 B
scripts/chronopm_init/config.pyscript9.5 KB
scripts/chronopm_init/file_registry.pyscript20.4 KB
scripts/chronopm_init/template_renderer.pyscript2.7 KB
scripts/chronopm_init/validators.pyscript1.2 KB
scripts/chronopm_init/workspace_builder.pyscript5.1 KB
scripts/init_workspace.pyscript2.0 KB
scripts/migrate_workspace.pyscript96.2 KB
scripts/sync_version.pyscript4.6 KB
scripts/verify_contract_ri.pyscript1.9 KB
scripts/verify_projection.pyscript11.1 KB
scripts/verify_requirement_wp.pyscript3.3 KB
scripts/verify_todo_continuity.pyscript3.4 KB
skill-gap-skill/CAPABILITY.mdmarkdown834 B
skill-gap-skill/assets/templates/skill-gap-demand-template.mdmarkdown2.5 KB
skill-gap-skill/references/capability-boundary.mdmarkdown1.0 KB
skill-gap-skill/references/gap-capture-rules.mdmarkdown4.7 KB
skill.jsonconfig38.7 KB
source-split-skill/CAPABILITY.mdmarkdown884 B
source-split-skill/assets/templates/source-atoms-index-template.mdmarkdown412 B
source-split-skill/assets/templates/source-doc-meta-template.mdmarkdown2.6 KB
source-split-skill/assets/templates/source-index-template.mdmarkdown739 B
source-split-skill/assets/templates/source-parse-log-template.mdmarkdown582 B
source-split-skill/references/capability-boundary.mdmarkdown1.3 KB
source-split-skill/references/split-rules.mdmarkdown3.5 KB
tests/regression-suite.mdmarkdown93.8 KB

references/18-init-wizard-rules.md

View on GitHub
# 项目初始化向导规则

本文件定义 ChronoPM 的项目初始化向导机制。当用户首次进入工作区或主动请求初始化时,AI 通过分步引导方式录入项目基线信息,替代传统"创建空白模板后手动填写"的流程。

---

## 1. 触发条件

AI 在以下任一情况下启动初始化向导:

1. **新工作区检测**:检测到 `ai/.skill-version.json` 的 `initializedAt` 为当天,或 `project-brief.md` 的 `status: 草稿` 且关键字段(项目名称、合同总额等)为空。
2. **用户主动触发**:用户说"初始化项目""录入项目信息""设置项目基线""补全项目基础信息"等。
3. **脚本完成引导**:`init_workspace.py` 执行完成后提示"对 AI 说:初始化项目"。

### 触发检查流程

```
AI 进入工作区
  → 读取 ai/.skill-version.json(如存在)
  → 读取 context/project-brief.md
  → 检查 brief status 是否为"草稿"且关键字段为空
  → 是 → 主动提示:"检测到项目尚未完成基线信息录入,是否开始初始化向导?"
  → 否 → 不触发
```

---

## 2. 六步向导流程

### Step 1: 合同层(必填)

**提示词**:

```
【Step 1/6 合同信息】
请提供以下信息(*为必填):
* 合同名称:
* 合同总额(万元):
* 立项时间(YYYY-MM):
* 启动时间(YYYY-MM-DD):
* 人工计量单位(按贵司标准,如人日/人时/人月/其他,不预设默认):
* 默认能耗规则(无投喂日如何计,如「有日报产出=1 单位」/「不计」):
  合同类型:
  合同范围摘要(一段话概括):
  计划完工时间(YYYY-MM-DD):

你也可以上传合同文档,我来解析提取。
```

**录入字段**:

| 字段 | 必填 | 目标文件 |
|------|------|----------|
| 合同名称 | 是 | project-context.md, project-brief.md |
| 合同总额 | 是 | project-context.md |
| 立项时间 | 是 | project-context.md, project-brief.md |
| 启动时间 | 是 | project-context.md, project-brief.md |
| 人工计量单位 | 是 | project-context.md「成本核算方式」段,project-brief.md |
| 默认能耗规则 | 是 | project-context.md「成本核算方式」段,project-brief.md |
| 合同类型 | 否 | project-context.md |
| 合同范围摘要 | 否 | project-context.md |
| 计划完工时间 | 否 | project-context.md, project-brief.md |

> **成本核算方式(R14 / N-44)**:人工计量单位与默认能耗规则为必填,与合同总额同级。单位中立,规则/向导不得写死单一计量单位。成本单价选填(涉密可留空)。**外部填报映射 / 分次明细 / 折金额不进向导**(首次表投喂时再问,写入 project-context 可选段)。**两项缺失 → 向导不放行**,不得以「稍后补充」跳过;后续每轮对话持续提醒直至补录。能耗段单位取此处登记值。

**文档类型多选(v3.6.0)**:Step1 询问「本项目涉及哪些源文档类型?」(多选,对照 `source-type-registry` 基线包 11 大类)。只**启用**已选类型(registry 行 `覆盖默认?`/启用标记),**不预建**空的 `sources/{类型}/` 或旧 `{type}-source/` 目录。未选类型保持 registry 可追加、默认不启用。存量项目升级时输出「可用新类型清单」供勾选,**不预灌**约 40 行未用类型。

**文件上传支持**:如用户上传合同文档,AI 先解析提取上述字段,再补充询问缺失项。落点 `requirements/sources/{CON-… 或 SRC-NNN}/`(见 07 号 §8.11)。

**多合同循环登记(CR-20260813-002)**:可能有多份主合同、主合同+补充协议。Step1 录入完一份合同后询问"是否还有其他合同/补充协议?",是则循环录入下一份,直到用户确认无更多合同。每份合同分配 `CON-{YYYYMMDD}-{HHmmss}` ID(同秒冲突追加 `-02`;旧号 `CON-NNN` 双格式兼容、不重编),并登记到本项目 `requirements/contract-register.md`(本包不写 `portfolio/requirements/`):

| 补充登记字段 | 必填 | 说明 |
|---|---|---|
| scope_level | 是 | portfolio(跨项目成套,本项目存一套)/ project(本项目)/ supplement(补充协议)。此为覆盖概念,不是集层存储路径 |
| parent_contract_id | supplement 必填 | 指向被补充合同 CON-{YYYYMMDD}-{HHmmss}(旧号兼容) |
| coverage 覆盖对象 | 是 | 本项目;若合同还覆盖他项目,仅在 project-context「兄弟项目」段记名,不在本包初始化他项目 |
| 关联招投标/立项/密评 | 否 | 成套文档簇关联 |

> 合同登记册结构见 `07-requirement-rules.md` §8.9。本向导只写本项目登记册。

### Step 2: 项目层(必填)

**提示词**:

```
【Step 2/6 项目信息】
请确认本项目名称和一句话描述。
(如已从合同范围识别,请确认是否正确)
```

**目标文件**:`context/project-index.md`, `context/project-brief.md`

本向导只初始化当前项目。不录入多子项目清单,不创建 `projects/{子项目}/`。若合同还覆盖其他项目,将他项目名记入 `project-context`「兄弟项目」段,并提示到对应项目对话分别初始化。

### Step 3: 计划层(选填)

**提示词**:

```
【Step 3/6 计划规划】
现在为本项目登记计划信息:
该项目规划分几个阶段?请列出阶段名称和计划时间段。
(如暂未规划可回答"跳过")
```

**目标文件**:`context/project-brief.md`(计划概览段)

**录入字段**:阶段名称、计划开始时间、计划结束时间。

**规则**:
- 初始化阶段只记录计划概览;PLAN 文件(`plans/PLAN-NNN-{name}.md`)由 AI 在正式排计划时按需创建,向导不预建。
- 关联里程碑字段选填(可后置)。
- 计划阶段与里程碑是并存关系,可选关联(Q1=C)。

### Step 4: 需求层(选填)

**提示词**:

```
【Step 4/6 需求规划】
阶段"[阶段名]"预计包含多少需求?
(如已有需求文档可上传,我来解析。如暂未拆解可回答"跳过")
```

**目标文件**:`requirements/requirement-register.md`(需求数量、需求ID列表字段)

**规则**:
- 初始化阶段允许只登记需求数量(Q4=C)。
- 需求 ID 列表默认为"待补充",后续可补充。
- 如已有需求登记册,可补充完整需求 ID 列表。

### Step 5: 资源层(选填)

**提示词**:

```
【Step 5/6 资源分配】
阶段"[阶段名]"的开发资源有谁?请列出姓名和岗位。
(如暂未确定可回答"跳过")
```

**目标文件**:当天 `todos/{today}/_index.md`(**必须含 §1 花名册与 §6 TD 缩写**;不创建 `resource-register.md`。跨项目共享人员提示用 ChronoPM-Portfolio,本包不写集层索引)

**规则**:
- **禁止**创建 `resources/resource-register.md` / `transfer-log.md`。
- 引导创建当天 `_index.md`:§1 花名册(7 列:姓名|缩写|岗位|状态(在岗/空闲/请假/借出/待进场/已出组)|首次进组|分配方式|备注);§6 TD 缩写映射(姓名|现行缩写|历史别名|冻结日|备注)。init 当日即为花名册应建档全员(状态 ≠ 已出组)建个人 md,§1 待办表可空。已出组不建。
- project-brief.md 计划概览中记录资源摘要(姓名(岗位)),并指针到 `_index` §1。
- **待办文件 §0 人员信息段引导**。向导不直接为全员创建待办文件;某人首次出现于待办文件(`todos/{date}/{姓名}.md`)时,因无前一天文件可 T+1 拷贝,AI 必须引导 PM 填写 §0(**只留联系方式、负责模块**;岗位/首次进组/在组状态以花名册 §1 为准),后续按 T+1 拷贝沿用(见 `00-pm-main-rules.md` §4d)。

### Step 6: 里程碑层(选填)

**提示词**:

```
【Step 6/6 里程碑时间】
除默认 M01-M12 里程碑体系外,是否有其他关键里程碑时间需要登记?
(如暂无可回答"跳过")
```

**目标文件**:`project-info/progress-plan.md`

**规则**:
- M01-M12 默认体系已预置,用户只需补充计划日期。
- 如有额外门禁,后续在 PLAN §2 手写;WP §8 将对应阶段标关键阶段=是。

---

## 3. 跳过机制

- 每步标注必填/选填。
- 选填步骤用户可回答"跳过",该步标记为"待补充"。
- 必填步骤不可跳过,但允许用户回答"稍后补充",写入 brief 草稿区域。**例外**:人工计量单位与默认能耗规则不得「稍后补充」,缺失则向导不放行。
- 跳过的步骤在确认摘要中标注"待补充"。

---

## 4. 进度记忆

### 记录位置

向导进度记录在 `project-brief.md` 的 front matter 中:

```yaml
---
doc_type: project-brief
project: "[项目名]"
version: v1.0
date: "YYYY-MM-DD"
status: 草稿
init_wizard_progress: "step3"  # 当前完成到第几步
init_wizard_started: "YYYY-MM-DD HH:MM:SS"
---
```

### 断点续接

- 向导中断后,下次进入时检测 `init_wizard_progress` 字段。
- 如检测到未完成的向导,提示用户:"检测到未完成的初始化向导(已完成到 Step X),是否继续?"
- 用户确认后从断点步骤继续。

### 完成标记

向导全部完成且用户确认后:

```yaml
status: 已确认
init_wizard_progress: "completed"
init_wizard_completed: "YYYY-MM-DD HH:MM:SS"
```

---

## 5. 确认写入流程

### 5.1 生成确认摘要

向导完成后,AI 输出"初始化确认摘要":

```markdown
# 项目初始化确认摘要

## 合同信息
- 合同名称:XXX
- 合同总额:XXX 万元
- 立项时间:YYYY-MM-DD
- 启动时间:YYYY-MM-DD
- 计划完工时间:YYYY-MM-DD

## 成本核算方式
- 人工计量单位:[单位]
- 默认能耗规则:[规则]
- 成本单价:(选填)

## 项目信息
| 项目ID | 项目名称 | 计划阶段数 | 需求总数 | 资源数 |
|---|---|---|---|---|

## 计划概览
| 项目 | 阶段名称 | 时间段 | 需求数 | 资源 |
|---|---|---|---|---|

## 里程碑
| 里程碑 | 计划日期 | 状态 |
|---|---|---|

## 待补充项
- [列出所有跳过或未完成的步骤]

## 将更新的文件
| 文件 | 更新内容 |
|---|---|

请确认以上信息是否正确,确认后我将写入对应文件。
```

### 5.2 写入规则

- 用户确认后才写入事实源文件。
- 所有写入的文件 `status` 从"草稿"改为"已确认"。
- 写入操作遵循 `06-file-rules.md` 的文件操作规则。
- 写入完成后输出确认清单,列出所有已更新的文件。

### 5.3 写入范围

| 步骤 | 目标文件 | 写入内容 |
|------|----------|----------|
| Step 1 合同层 | `context/project-context.md` | 合同信息表 +「成本核算方式」段 |
| Step 1 合同层 | `context/project-brief.md` | 基本信息(立项时间/启动日期/计划完成)+ 成本核算方式摘要 |
| Step 1 合同层 | `requirements/contract-register.md` | 合同登记册:每份合同(CON-{YYYYMMDD}-{HHmmss})的 scope_level/parent_contract_id/coverage/文档簇关联(CR-20260813-002);只写本项目 |
| Step 2 项目层 | `context/project-index.md` | 本项目名称/描述 |
| Step 2 项目层 | `context/project-brief.md` | 本项目名称/描述 |
| Step 3 计划层 | `context/project-brief.md` | 计划概览(阶段名称/时间段)+ 一行摘要 |
| Step 3 计划层 | `context/project-index.md` | 本项目计划阶段数 |
| Step 4 需求层 | `requirements/requirement-register.md` | 需求数量、需求ID列表字段 |
| Step 5 资源层 | 当天 `todos/{today}/_index.md` | §1 花名册 + §6 TD 缩写;不创建 resource-register |
| Step 5 资源层 | 待办文件 §0(仅首次出现有待办的人引导填写) | 联系方式/负责模块(岗位与在组状态读花名册 §1) |
| Step 6 里程碑层 | `project-info/progress-plan.md` | 计划日期 |

---

## 6. 异常处理

| 场景 | 处理方式 |
|------|----------|
| 用户中途退出 | 保存已录入信息到 `project-brief.md` 草稿区域,更新 `init_wizard_progress` |
| 用户提供的信息与已有文件冲突 | 提示冲突项,询问以哪个为准 |
| 用户上传文件解析失败 | 提示解析失败原因,改为对话式录入 |
| 计划阶段数为 0 | 允许,跳过计划相关步骤 |
| 重复触发向导 | 检测到 `status: 已确认` 时提示"项目已完成初始化,是否需要修改?" |

---

## 7. 文件上传解析规则

当用户在向导过程中上传文件时:

1. AI 先读取 `context/project-brief.md` 判断项目归属(即使 brief 是草稿也读取)。
2. 按文件类型选择解析方式:
   - 合同文档 → 提取合同名称/总额/类型/范围/时间
   - 需求清单 → 提取需求数量/需求ID/功能模块
   - 计划表 → 提取阶段名称/时间段/人员/任务
3. 解析结果结构化展示,请用户确认。
4. 确认后填入对应向导步骤。
5. 解析失败时降级为对话式录入。

---

## 7a. 可选步骤:实体粒度 WP + 推导规则(v3.7.0)

> 仅当项目存在多模块/多阶段/多市场主体时提示。不再创建 entity-registry。

**触发条件**:向导 Step 3 完成后,若检测到 ≥2 个模块或 ≥3 个计划阶段,提示:

```
【可选】复杂项目建议:WP 按模块/实体拆分,在 WP §3b 维护实体行;
在 project-context「项目级推导规则」填写推导链覆盖与终态事件扩展。
```

**引导**:① WP 按模块拆分并填 §3b;② 维护 project-context 模块表与推导规则段。不预灌空 registry。sources/ 已预建,本步不新增拆解预灌文件。

---

## 8. 与其他规则的关联

| 关联规则 | 关系 |
|----------|------|
| `00-pm-main-rules.md` §2.7 | 默认意图检测新增"初始化"意图,路由到本规则 |
| `06-file-rules.md` | 文件写入操作遵循文件规则 |
| `10-update-trigger-rules.md` | 向导写入属于高风险操作(基线信息),必须用户确认 |
| `19-info-completeness-rules.md` | 向导完成后,日常巡检接管信息完整性持续检查 |
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall