qiusuo0226/chrono-pm-skill / governance-shared/baselines/3.20.0/ChronoPM-Project
chrono-pm-project
VerifiedMarkdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio(只读)。触发:项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/整理记录/补全/回填/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好、画图、责任链图。支持主动变更+人工确认:写入即标记待确认并登记 pm-decisions,确认后生效。需求只绑工作包,计划只绑工作包。
skill-gap-skill/references/gap-capture-rules.md
View on GitHub# 技能缺口捕捉规则
由 P-SKILL-GAP 加载(SKILL.md「技能缺口」行;10 号技能缺口信号)。禁止未加载本文件就落 `需求-*.md`。禁止把本文件内容写成项目 REQ。
主包交叉点:闸 1 B 路、11 号批次、00 P-ALWAYS 第 4 步(只检测)、20 号版本字段。需求/WP 绑定仍在 07/00,与本文件无关。
## 1. 过程签名
| 项 | 值 |
|---|---|
| ProcID | P-SKILL-GAP |
| Home | 本文件 |
| Pre | 闸 1 = B 路;已载 11 |
| Calls | 必须 CALL P-OUTPUT(建 `ai/outputs/{YYYYMMDDHHMMSS}/` + 登记 outputs/index.md)。**Type=skill_gap 不建 manifest.md**,元数据写在需求文件 front matter |
| Writes | `{批次}/需求-{短标题}.md`(主文件,不走 draft.md)。同指纹原位更新时 **复用原批次**,不新开时间戳 |
| Forbidden | 写 requirements/wps/plans/todos;当 REQ/待办;嵌套 SKILL.md;数据缺失走本过程;未达触发阈值落盘;问「要不要记」;写入或提议写入 `pm-decisions.md`;请 PM 确认本产物;**追加 `revisions/rev-NNN.md`** |
P-ALWAYS 第 4 步只检测,不写文件。写文件只走 P-ROUTE → 本过程 → P-OUTPUT。
## 2. 要落盘(满足任一)
1. 用户明示:技能做不到 / 做不了 / 这是 skill 的问题 / 记成升级需求 / 记成技能缺口。
2. 同一意图本对话硬拒绝 ≥2 次(无合法路径,或必须违反硬约束且无替代)。
3. 10 号技能缺口信号命中,且过第 3 节排除清单。
简单查询(仅 05)不经 P-ALWAYS 第 4 步;但 Level 1 显式「记成升级需求」须改口加载本文件后落盘。
## 3. 不要落盘
- 缺数据 / 缺确认 → 19 / pm-decisions
- 换 Portfolio 或换项目对话就能做
- 规则已有、本轮未加载 → 先加载做完
- 纯格式口吻 → 21
- 口误已纠正
- 废弃 WP 等业务状态 → P-WP-RETIRE
- 用户追问、不满意、信息理解偏差(无明示词、无两次硬拒绝)
落盘文「三、定位 / 已排除」至少写 1 条排除。
## 3.1 扫描已装 Skill(落盘前强制)
禁止全文扫包。读本包 `VERSION` + 按痛点涉及的规则/模板 **定向读**(`source_files` 或本轮已定位的路径)。
- **已包含**该能力:找同指纹旧需求文档 → 标废弃(`status: deprecated`,`resolved_in_skill: vX.Y.Z`,标题下废弃横幅,index Status=已废弃)。用户已删旧文档 → **不动作**。
- **未包含**:走 §4 原位或新建。
- 判定拿不准 → 按 **未包含**(宁可重记,不可漏记)。
部分并入:保持 `draft`;迭代记录注明「vX.Y.Z 已并入条目…,剩余…」;§六只留未并入条目。
## 4. 写时机
先写后告知。禁止问「要不要记」。
不走 11 号 draft→final。主文件即 `需求-{短标题}.md`。禁止再问是否归档进事实源。本产物是 Skill 升级辅助记录,**不进** `pm-decisions.md`。改 Skill 仍走 16 号 AP/CR。
**禁止** `revisions/rev-NNN.md`(skill_gap 专用;周报等其它 Type 仍按 11 §5.3)。
**指纹**(无 7 日窗口):受影响规则文件路径 + 痛点关键词。正例:痛点「工作包图排列」+ `11-output-artifact-rules.md` §17 → 命中已有同路径文档则原位。反例:痛点「功能点留痕」+ `wp-template` / `00` → 与图排列不同指纹 → 新建。拿不准 → 新建不覆盖。
同指纹且未并入:
1. 旧主文档存在 → **原位更新**:〇~七以最新事实为准重写(不留过期表述);第八节迭代记录追加一行;front matter `updated_at`;**复用原批次目录**。
2. 不存在 → 新建批次 + 主文档。
3. 用户说另出一版 → 才新开批次。
用户说不要记 → 该批次 Status=已取消,本对话同类不再写。
**告知(强制,消灭猜)**:每次落盘或原位后一句话必须含:文件路径 + 本次记录了什么 + 历史迭代是否已包含在文中。禁止只报路径。废弃时告知路径 + 已并入版本。
证据截图等统一存该批次 `assets/`,迭代记录用相对路径引用。
## 5. 编号与头
`sg_id: SG-{今天}-NNN`。NNN = 当日 Type=skill_gap 已有最大号 +1,无则 001。读 `ai/outputs/index.md`,禁止猜。落盘前再读 index:该 `sg_id` 已存在且不是原位更新 = **级联失败**,不得写第二份同号。
YAML 必填:doc_type=skill-gap-demand;sg_id;skill_name;skill_version_installed(**只抄本包 `VERSION`,禁止手写/猜测**);workspace_skill_version 与 workspace_schema(**只抄 `ai/.skill-version.json`**);project;created_at;priority(AI 建议);batch_id;**status**(`draft` \| `deprecated`);**updated_at**;**resolved_in_skill**(未并入填 `~`)。建议:source_files。两行版本不一致须在正文写「版本差」。不另写 manifest.md。**读模板只读 Skill 包 `skill-gap-skill/assets/templates/` 与 `assets/templates/`,禁止以工作区 `ai/templates/` 为权威。**
落盘后检查:批次目录若出现 `manifest.md` = **级联失败**,删除该 manifest 并重写主文件 front matter。批次内出现 `revisions/rev-NNN.md` = **级联失败**,合并入主文档第八节后删除。
短标题 ≤20 字,来自一句话痛点。
## 6. 正文
落盘前必读 `skill-gap-skill/assets/templates/skill-gap-demand-template.md`。**当前模板为唯一范本**。禁止以 `ai/outputs/**/需求-*.md` 历史批次为范本。
节号 〇、〇·五、一~**八**,不得跳号、不得省 〇·五、不得省第八节。单表 ≤6 列。流图用 mermaid。
必选:文首痛点、元信息、〇开场、〇·五示例图、一现象原话后果、二为何(含现状 vs 应有)、三定位、四时间证据链、七复现、**八迭代记录**。
可选:五全景、六建议补丁(禁止完整 AP)。
〇·五:形态/图形/可视化类必须贴目标产出图(Mermaid/示意)。其它类节标题必须在,节内写「本条无目标产出形态图」。第二节数据流图不能代替 〇·五。
`status=deprecated` 时在标题下加横幅:`> **已废弃·已并入 Skill vX.Y.Z**`。
**落盘前结构自检(强制)**:对照模板节标题逐项打勾。缺节当场补全后再写文件、再登记 `outputs/index.md`。缺节仍落盘 = 级联失败。CALL P-OUTPUT 建批次后、更新 index 前完成自检。原位更新同样自检。
## 7. 与 P-OUTPUT
新建:先 P-OUTPUT 建批次(Type=skill_gap,Main File=需求-*.md,**不建 manifest、不建 revisions/**),再写主文件,再更新 index。原位:不新建批次,改主文件 + index Status/`updated`。缺任一步 = 级联未完成。批次内出现 `manifest.md` 或 `revisions/rev-NNN.md` = 级联失败。宿主默认目录落到项目根 → 仍映射本批次(闸 1)。
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 |