qiusuo0226/chrono-pm-skill / governance-shared/baselines/3.0.0/ChronoPM-Portfolio
chrono-pm-portfolio
Verified给项目集/组合经理用的只读 Skill。跨多个项目 ai 目录归集检索进度、风险、合同、周报。禁止写入成员项目事实源。触发:项目集、组合、跨项目、汇总周报、进度总览、人员排期、跨项目风险、门禁、P&L、合同去重、建议更新清单、挂载、健康巡检、ChronoPM-Portfolio。
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 967 B |
| SKILL.md | skill md | 7.7 KB |
| VERSION | other | 6 B |
| assets/templates/portfolio-weekly-template.md | markdown | 6.6 KB |
| assets/templates/project-index-template.md | markdown | 3.1 KB |
| assets/templates/suggested-update-list-template.md | markdown | 1.7 KB |
| references/01-readonly-boundary-rules.md | markdown | 4.6 KB |
| references/02-aggregation-query-rules.md | markdown | 5.7 KB |
| references/03-mount-awareness-rules.md | markdown | 3.8 KB |
| references/04-portfolio-report-rules.md | markdown | 4.0 KB |
| references/05-resource-shared-rules.md | markdown | 3.3 KB |
| references/06-version-health-rules.md | markdown | 3.7 KB |
| skill.json | config | 1.0 KB |
references/03-mount-awareness-rules.md
View on GitHub# 挂载、动态感知与防套娃(V-1)
## 1. 挂载流程
集经理将项目 `ai/` 包接入本联邦工作区:
```
1. 在 ai/projects/ 下新建与项目同名的目录
2. 将项目 ai 包解压为 ai/projects/{名}/ai/ (内部即完整单项目工作区)
3. 本包执行挂载校验(只读检查,不改包内文件)
4. 校验通过 → 提示登记进 project-index(须确认)
5. 校验失败 → 列出缺项,拒绝登记,不参与聚合
```
**挂载校验(三项全过才提示登记):**
| 检查 | 通过条件 | 失败 |
|------|----------|------|
| 结构完整性 | `{名}/ai/` 下必含 `todos/`、`context/`、`.skill-version.json` | 列出缺失;可提示补建须到该项目 ChronoPM-Project 对话执行 |
| 版本正向 | 该项目 `.skill-version.json` 的 skillVersion **≤** 本 Portfolio Skill 版本 | 提示「成员项目由更高版本创建,请升级 Portfolio 至 ≥ {项目版本}」;本包对该项目只读降级且**不纳入聚合**直至升级 |
| 防套娃 | `{名}/ai/` 内不存在 `portfolio/` 或 `projects/` 目录 | 告警「套娃结构」,拒绝聚合 |
skillName 兼容:`chrono-pm-project` 与历史 `chrono-pm` 均视为单项目包。
校验只读。本包不得为了「补齐结构」在成员项目内创建缺失目录或文件。
## 2. 动态感知
每次进入工作区、以及每次跨项目查询前:
1. 列出 `ai/projects/` **一级**目录名(不递归下级)。
2. 读取 `portfolio/context/project-index.md` 子项目清单。
3. 比对:
| 发现 | 行为 |
|------|------|
| 目录有、索引无 | 提示「发现新项目 {名},是否登记?」给出建议行(PRJ 编号/管理路径=`ai/projects/{名}/ai/`/状态待填)。**登记须集经理确认**后才写入 project-index |
| 索引有、目录无 | 提示清理失效条目;确认后才从索引删除或标记失效 |
| 两边都有 | 进入挂载校验(若本会话尚未校验) |
**扫描只发现候选,登记仍需确认。** 禁止把扫描结果直接当成正式成员写入索引。禁止用「扫一遍文件夹」代替 project-index 作为查询范围权威源。
新登记字段最低集:项目 ID(PRJ-NNN,短号不变)、子项目名称、管理路径、PM、状态、优先级、是否纳入周报。可选「下级集工作区路径」见 §5。
## 3. 防套娃硬约束
`ai/projects/{项目名}/ai/` 内 **禁止** 存在:
- `portfolio/` 目录
- `projects/` 目录
即:项目 ai 不得再是集工作区。挂载校验与 V-10 均检查。命中:
1. 告警,写明路径。
2. 该项目不参与任何 V-2~V-8 聚合。
3. 不自动删除套娃目录(写禁)。建议更新清单可建议「拆除套娃后重新挂载」,由人处理。
## 4. 查询自动路由
1. 范围默认 = project-index 中状态非「已取消」、校验通过的一级成员。
2. 「是否纳入周报=否」的项目:不进 V-5 集周报,但仍可被点名查询。
3. 用户不指定项目时,按索引自动遍历;指定则子集。
4. 未登记目录:发现后走 §2 提示,**先登记后聚合**。
## 5. 下级集工作区路径(本期不聚合)
project-index 可选列「下级集工作区路径」:登记另一个集工作区的路径,供组合经理关联查看。
- 仅登记,**不参与本期任何聚合**(禁止 Portfolio-of-Portfolio 递归读取)。
- V-1 / V-2 范围固定为一级成员项目。
- 查询时若用户问及该路径,只回显已登记路径,提示「本期不展开下级集」。
## 6. 管理路径口径
v3.0.0 联邦协议:管理路径 = `ai/projects/{名}/ai/`(多一层 `ai/`)。索引中若仍为旧路径 `ai/projects/{名}/`,提示集经理更正索引;读取时若 `{名}/ai/` 存在则用新路径,旧路径仅作兼容探测,不写回成员项目。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |