Release v1.0.103: forbid redundant market-doc H1
All checks were successful
技能自动化发布 / release (push) Successful in 6s

This commit is contained in:
2026-09-03 10:32:41 +08:00
parent 295b2356ac
commit 201d4d1367
11 changed files with 59 additions and 15 deletions

View File

@@ -28,6 +28,23 @@ README.md(能力与边界;不写步骤)
**铁律:** 说明就是说明,教程就是教程。**禁止**在 README 里写分步操作、Agent 话术块、排障「点哪里」;这些一律进 `TUTORIAL.md`。
### 0.1 标题层级(说明 / 教程共用)
宿主详情页**已经**展示技能名;「说明 / 使用教程」Tab(及数据管理右侧教程抽屉)**已经**标明文档类型。因此:
| 层级 | 用途 |
|------|------|
| `#` | **正文不要用**(会与页头/Tab 标题重复抢视觉) |
| `##` | 主分节(能帮你做什么、入口一:数据管理…) |
| `###` | 分节内步骤 |
**禁止:**
- `README.md` 文首 `# 【技能名】` / `# 审计疑点辅助` 这类与页头重复的 H1
- `TUTORIAL.md` 文首 `# 【技能名】· 使用教程` 这类与 Tab/抽屉标题重复的 H1
去掉重复 H1 后,**不要**把原来的 `##` 全部升成 `#`。
---
## 1. README.md(说明 Tab)
@@ -36,7 +53,7 @@ README.md(能力与边界;不写步骤)
| 问题 | 写法 |
|------|------|
| 这是什么 | 标题 + 一两句价值 |
| 这是什么 | 开篇一两句价值(**普通段落或引用**,不要再写技能名 H1) |
| 能做什么 | 3~6 条能力 bullet(**无步骤编号**) |
| 适合谁 / 场景 | 业务语言 |
| 使用前准备 | 安装、账号、权限等**前置条件**;不写「去哪张表点哪」 |
@@ -60,7 +77,7 @@ README.md(能力与边界;不写步骤)
### 1.4 建议章节(标题可微调)
```text
# 【技能中文名】
(开篇一两句价值;不要写 # 技能名)
## 这个技能能帮你做什么
## 适合什么场景
## 使用前需要准备什么
@@ -77,8 +94,7 @@ README.md(能力与边界;不写步骤)
复制业务技能后,**验收章节(标题可微调,语义不可缺)**:
```text
# 【技能中文名】· 使用教程
(开篇:数据管理与对话平行;定时有/无一句)
(开篇:数据管理与对话平行;定时有/无一句。不要写 # 技能名 · 使用教程)
## 本技能做什么 ← 业务数据流(非 CLI/SQL)
## 开始前