Skip to content

qiusuo0226/chrono-pm-skill / governance-shared/baselines/1.11.0

chronopm

Verified

Markdown 驱动的 AI 项目管理技能。当用户需要管理软件研发项目(尤其 To G / To B 政企数字化转型领域)时使用,覆盖需求管理、任务跟踪、进度管控、风险与问题、里程碑、成本与P&L、日报周报、会议纪要、决策记录、复盘、项目集统筹、人员资源协调与流转、初始化向导、迭代管理、信息完整性巡检、历史计划导入与变更追溯、PM 偏好等全链路。触发场景包括:初始化项目、处理日/周报、整理会议纪要、需求评审与变更、风险识别、任务看板更新、项目状态查询、里程碑评审、项目复盘、项目集汇总、跨项目资源调配、完整性巡检、历史计划批量导入、计划变更追踪与延期统计、超期查询、词库管理、PM 偏好管理等。当用户提到"项目管理""日报""周报""风险登记册""任务看板""需求追踪""里程碑""ChronoPM""项目集""资源分配""人员流转""记录一下""更新一下""整理到项目里""归档""入库""评审""验收""会议纪要""接口文档"等关键词时触发。当用户提到"初始化项目""录入项目信息""设置项目基线"时触发初始化向导。当用户提到"迭代""迭代规划""迭代登记"时触发迭代管理。当用户提到"完整性巡检""缺失信息"时触发完整性巡检。当用户提到"导入历史计划""计划变更""延期/超期""变更了几次""延期了几次"时触发 R1-R4 计划同步与变更追溯。当用户上传或粘贴文件并要求处理时也触发。当用户提到"词库""术语""缩写""纠正"时触发词库管理。当用户提到"偏好""习惯设置"时触发 PM 偏好管理。支持 PM 偏好学习与输出适配,以 Markdown 文件为事实源、AI 为辅助、人工确认为最终控制点。支持"主动变更 + 人工确认"更新模式:低/中风险变更可直接写入事实源并标记待确认(登记 pending-changes),确认后方视为生效。

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):
  合同类型:
  合同范围摘要(一段话概括):
  计划完工时间(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-context.md |
| 计划完工时间 | 否 | project-context.md, project-brief.md |

**文件上传支持**:如用户上传合同文档,AI 先解析提取上述字段,再补充询问缺失项。

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

**提示词**:

```
【Step 2/6 项目清单】
该合同分为了几个项目?请列出每个项目名称和一句话描述。
(如已从合同范围识别,请确认是否正确)
```

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

**项目集模式**:录入多个子项目。
**单项目模式**:确认项目名称。

### Step 3: 迭代层(选填)

**提示词**:

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

**目标文件**:`plans/iteration-register.md`

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

**规则**:
- 迭代 ID 自动分配(ITR-01, ITR-02, ...)。
- 关联里程碑字段选填(可后置)。
- 迭代与里程碑是并存关系,可选关联(Q1=C)。

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

**提示词**:

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

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

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

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

**提示词**:

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

**目标文件**:`plans/iteration-register.md`(资源字段), `resources/resource-register.md`(项目集模式)

**规则**:
- 迭代登记册中记录资源摘要(姓名(角色))。
- 资源登记册中记录资源详细信息(RES-NNN/角色/所属项目/状态/分配方式等)。
- 资源登记册的"迭代分配视图"小节记录每个资源在各迭代的投入。

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

**提示词**:

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

**目标文件**:`milestones/milestone-board.md`

**规则**:
- M01-M12 默认体系已预置,用户只需补充计划日期。
- 如有额外里程碑,可追加到看板。

---

## 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 | 项目名称 | 迭代数 | 需求总数 | 资源数 |
|---|---|---|---|---|

## 迭代概览
| 项目 | 迭代ID | 迭代名称 | 时间段 | 需求数 | 资源 |
|---|---|---|---|---|---|

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

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

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

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

### 5.2 写入规则

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

### 5.3 写入范围

| 步骤 | 目标文件 | 写入内容 |
|------|----------|----------|
| Step 1 合同层 | `context/project-context.md` | 合同信息表 |
| Step 1 合同层 | `context/project-brief.md` | 基本信息(立项时间/启动日期/计划完成) |
| Step 2 项目层 | `context/project-index.md` | 子项目清单 |
| Step 2 项目层 | `context/project-brief.md` | 子项目清单 |
| Step 3 迭代层 | `plans/iteration-register.md` | 迭代总览表 |
| Step 3 迭代层 | `context/project-brief.md` | 迭代概览一行摘要 |
| Step 3 迭代层 | `context/project-index.md` | 子项目清单的迭代数列 |
| Step 4 需求层 | `plans/iteration-register.md` | 需求数量、需求ID列表字段 |
| Step 5 资源层 | `plans/iteration-register.md` | 资源字段 |
| Step 5 资源层 | `resources/resource-register.md` | 资源清单 + 迭代分配视图 |
| Step 6 里程碑层 | `milestones/milestone-board.md` | 计划日期 |

---

## 6. 异常处理

| 场景 | 处理方式 |
|------|----------|
| 用户中途退出 | 保存已录入信息到 `project-brief.md` 草稿区域,更新 `init_wizard_progress` |
| 用户提供的信息与已有文件冲突 | 提示冲突项,询问以哪个为准 |
| 用户上传文件解析失败 | 提示解析失败原因,改为对话式录入 |
| 项目集模式下某子项目信息暂时不可用 | 该子项目的迭代/需求/资源步骤标记为"待补充",不阻塞其他子项目 |
| 迭代数为 0 | 允许,跳过迭代相关步骤 |
| 重复触发向导 | 检测到 `status: 已确认` 时提示"项目已完成初始化,是否需要修改?" |

---

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

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

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

---

## 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