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