一、④段整套同步(用户选候选 A)
- 新增 `references/stage-proto-doc/assets/产品文档模板.html`(16 KB/247 行,从备份拷、转 LF)。
- ④段 SKILL.md 换成备份 15:28 那版,并按模板口径改齐:
· 「产品文档框架」从「四块+一附录」改成**六节** —— 页面结构/功能清单/使用场景/操作流程/
跨页与界面状态/待确认与偏离;与模板同构,⛔ 不从空白页重写结构。
· 编号从 R/S/F 改成 **P 页面/S 场景/F 功能/J 二级功能**,各自唯一、按展示顺序通排。
· 保留旧版有价值的要求:每项功能补齐 做什么/入口在哪/输入边界/异常与恢复;重点功能三处标红;
横向流程图每步写清页面/功能/操作/完成判据。
· 完成标准「七节」→「六节」,自查清单同步换掉「需求」那批条目,补模板与配图两条。
· 路径 `designs/<项目>/` → `docs/pm/<项目>/ui/`(2 处)。
· 补回本机那条「每份产出文档开头都要有一张图」的引用(指向主 skill,段内不复述)。
- 主 skill 同步:四段结构表④行、④段沿革、画图小节(④段画页面结构图 + 用户路径)。
二、open-design 移到技能根(用户选候选 A)
- `git mv product-planning/references/stage-delivery/assets/open-design → open-design/`(4178 文件)。
- `.gitignore` 白名单加 `!/open-design/` —— 否则移出去就不再纳入版本控制。
- 引用改 11 处:路径形态 `assets/open-design/...` → `<技能根>/open-design/...`;
「随段携带的自带件」改称「同根技能」;「路径怎么找」那条改成自带件(段内相对路径)与
同根技能(`<技能根>/<技能名>/`)两类分开写。
- open-design 自己的 ATTRIBUTION.md 两处同步(它现在与 oil-ui-pro 同层)。
- 副作用(有益):命名闸门读数由 2063 降到 225 —— 此前它把 open-design 里 919 个第三方 md
当成规则一起扫了;现在只扫本包 23 个 md。已确认④段的 H1 与 4a/4b/4c 子步仍在检查范围内。
三、验收
- check_naming.py --ws E:/ProgramData/AIProject/contentm_agent = 通过 225 / 失败 0 / 提示 27。
- 活文件里 `assets/open-design` 残留 0;工作区 CRLF 文件 0。
93 lines
3.2 KiB
JSON
93 lines
3.2 KiB
JSON
{
|
|
"sources": [
|
|
{
|
|
"type": "github_api",
|
|
"description": "GitHub REST API v3",
|
|
"endpoints": [
|
|
"GET /repos/nexu-io/open-design",
|
|
"GET /repos/nexu-io/open-design/contributors?per_page=100&page=1",
|
|
"GET /search/issues?q=repo:nexu-io/open-design+is:issue",
|
|
"GET /search/issues?q=repo:nexu-io/open-design+is:pr"
|
|
],
|
|
"fetchedAt": "2026-05-06T09:30:00Z"
|
|
}
|
|
],
|
|
"fields": [
|
|
{
|
|
"path": "repository.fullName",
|
|
"source": "GET /repos/nexu-io/open-design",
|
|
"field": "full_name"
|
|
},
|
|
{
|
|
"path": "metrics.stars.total",
|
|
"source": "GET /repos/nexu-io/open-design",
|
|
"field": "stargazers_count"
|
|
},
|
|
{
|
|
"path": "metrics.forks.total",
|
|
"source": "GET /repos/nexu-io/open-design",
|
|
"field": "forks_count"
|
|
},
|
|
{
|
|
"path": "metrics.contributors.total",
|
|
"source": "GET /repos/nexu-io/open-design/contributors?per_page=100&page=N",
|
|
"field": "paginated unique contributor count",
|
|
"note": "Display value may be capped or labelled as an estimate when only page 1 is available."
|
|
},
|
|
{
|
|
"path": "metrics.issues.total",
|
|
"source": "GET /search/issues?q=repo:nexu-io/open-design+is:issue",
|
|
"field": "total_count"
|
|
},
|
|
{
|
|
"path": "metrics.pullRequests.total",
|
|
"source": "GET /search/issues?q=repo:nexu-io/open-design+is:pr",
|
|
"field": "total_count"
|
|
},
|
|
{
|
|
"path": "charts.starGrowth",
|
|
"source": "estimated",
|
|
"note": "GitHub REST does not expose full historical star deltas; heights are display-normalized from available recent growth signals."
|
|
},
|
|
{
|
|
"path": "charts.forkTrend",
|
|
"source": "synthetic",
|
|
"note": "Generated as normalized 0-100% chart heights for visual trend preview."
|
|
}
|
|
],
|
|
"transformations": [
|
|
{
|
|
"step": "Data normalization",
|
|
"description": "Converted GitHub API responses to compact dashboard format",
|
|
"operations": [
|
|
"Formatted large numbers with comma separators",
|
|
"Estimated star and fork growth trends and marked them as non-auditable estimates",
|
|
"Extracted top 5 contributors by contribution count",
|
|
"Selected most recent 5 issues and pull requests",
|
|
"Generated normalized chart-height values for star growth and fork trends"
|
|
]
|
|
},
|
|
{
|
|
"step": "Privacy filtering",
|
|
"description": "Applied safe data practices",
|
|
"operations": [
|
|
"Preserved only public GitHub profile information",
|
|
"Used public avatar URLs",
|
|
"Excluded sensitive or internal repository metadata"
|
|
]
|
|
}
|
|
],
|
|
"notes": [
|
|
"Current repository totals are sourced from public GitHub API endpoints; growth series are explicitly estimated or synthetic as documented in fields[].",
|
|
"No authentication tokens or credentials stored",
|
|
"Star growth is estimated from available recent growth signals, not directly auditable from GitHub REST alone",
|
|
"Fork growth is synthetic for preview purposes",
|
|
"Chart heights are normalized percentages for responsive display"
|
|
],
|
|
"refreshPolicy": {
|
|
"recommended": "hourly",
|
|
"minInterval": "15 minutes",
|
|
"note": "GitHub API has rate limits; recommend caching for production use"
|
|
}
|
|
}
|