SKILL.md
OKR to HTML
把结构化 OKR Markdown 导出为交互式 HTML（底部 Tab 切换 O1/O2/O3，样式以 assets/template.html 为准）。
工作流
- 按下方输入格式整理用户的文本或 Markdown（可写入临时
.md） - 执行生成脚本并指定输出路径：
python3 scripts/build.py path/to/okr.md -o path/to/output.html- 用浏览器打开输出 HTML；校验 O 与 KR 权重是否齐全
- 不要手改
assets/template.html里的样式逻辑凑数据；内容只走输入文件
从 stdin：
python3 scripts/build.py -o /tmp/okr.html <<'EOF'
...
EOF参考样例：references/demo.md（1~7 条 KR 兼容性压测）。
输入格式（仅 Markdown）
可选 YAML 头
| 字段 | 含义 |
|---|---|
title |
<title> 与默认页名 |
heading |
主标题（配合 accent 高亮一词） |
accent |
在 heading 中包裹 <span class="accent"> |
subtitle |
副标题 |
无 frontmatter 时可用 # 主标题 与 > 副标题 替代。
Objective 写法
---
title: OKR 兼容 Demo | O1–O3
heading: 团队成长 OKR 演示
accent: OKR
subtitle: 1~3 条 KR 写法示例
---
## O1 · 专注
季度只做一件事，做到极致
- **核心产品**月活突破 **50 万** | 100%
## O2 · 健康
守护团队可持续的节奏
- 关键服务 **99.9%** 可用 | 60%
- 人均加班时长低于 **10 小时/月** | 40%
## O3 · 招聘
补齐关键岗位的人才缺口
- 资深前端到岗 **2 人** | 40%
- 算法工程师到岗 **1 人** | 35%
- 实习生转正率 **≥ 60%** | 25%规则
## O{n} · {底部 Tab 文案}，分隔符支持·/./-- 标题下首行非列表 = 卡片上的 O 描述（单行）
- 每条 KR 以
-开头，行末| 40%或| 权重 40% - KR 文本支持
粗体 - 每个 O 必须有描述和至少一条 KR
- 所有 KR 权重之和建议 100%（脚本不强制）
输出约定
- 单文件 HTML，无外部依赖
- 首张卡片默认激活；键盘
1~9与方向键切换 - 样式、布局、权重铭牌以模板为准；仅替换标题、副标题、卡片与 Tab 文案
故障排查
| 现象 | 处理 | |
|---|---|---|
KR 行缺少权重 |
每行末尾补 `\ | NN%` |
未解析到任何 Objective |
检查 ## O1 · 格式 |
|
O{n} 缺少目标描述 |
标题下加一行目标说明 | |
| 生成后样式不对 | 对比 assets/template.html 是否被误改 |
Agent 注意
- 用户给的是自然语言 OKR 时，先转成合规 Markdown 再跑脚本
- 输出路径由用户指定；未指定则用
输入名.html同目录 - 需要微调视觉时改
assets/template.html，并同步更新references/demo.md与脚本占位符