docs(spec): record avatar navigation audit scope and remaining gaps

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
This commit is contained in:
XiaoSeS 2026-11-03 15:07:31 +08:00
parent 1139bb2103
commit c627889b4f
4 changed files with 27 additions and 8 deletions

View file

@ -30,7 +30,7 @@ A2 的 29 项导航不是本 PR 的发布承诺;P1/P2、D10 全页深度改造
- 快速开始采用教程结构,保留完整命令、结果样例和一次无破坏性的故意失败演示;不声称安装成功代表 Agent 执行成功。
- 四个操作页面移除旧模板结构,按角色分流,提供可执行步骤、完成标准、至少四行失败矩阵及限制。现有P0事实修正必须保留。
- 复杂流程或对象关系配合图示,权限/状态/故障条件使用表格;图示不替代可复制命令和文本解释。优先使用静态SVG,含可访问说明,兼顾390px与明暗主题,不引入渲染依赖。
- 页面不新增、不移动,侧边栏与Pager顺序不变;新增正文链接用相对.html,英文正文对应英文页面。仅在六页范围整合内容,不擅自改写其他批次。
- 第二批主体保持既有路由;维护者复核明确要求的头像部署新页及对应导航调整为例外,其余侧边栏顺序不变;新增正文链接用相对.html,英文正文对应英文页面。仅在六页范围整合内容,不擅自改写其他批次。
- 每页记录来源与D1九要素覆盖;不明确的保留期、权限、事件类别、扫描阈值必须查代码,不编造固定承诺。无固定值时明确配置来源或未定义行为。
验收:中文正文体量不超过3000汉字(参考/代码清单不以扩写为目标),没有禁用旧章节或空标题;中英结构/链接一致;所有新技术断言有稳定源码依据;OpenSpec、VitePress、正文链接/锚点及真实浏览器宽度/主题检查通过,一次集中独立Review完成后冻结。

View file

@ -8,7 +8,7 @@
第二批由维护者于2026-11-03确认推进,独立改造项目简介、快速开始、命名空间、审核、收藏评分通知及安全扫描六页及英文镜像。新增正式文体、完整任务说明和必要图表的验收要求,具体范围见 design.md 与 tasks.md 第4节。
保持既有路由、菜单顺序、接口、角色、发布和审核行为不变。中文改动与英文同批更新。新增站内链接使用相对 `.html` 路径,源码依据链接稳定的 `main` 文件。
保留既有页面URL、产品接口、角色、发布和审核行为。维护者复核要求的头像职责拆分和对应导航归属优先修正,其余目录不在本批重排。中文改动与英文同批更新。新增站内链接使用相对 `.html` 路径,源码依据链接稳定的 `main` 文件。
## Delivery Sequence
@ -30,4 +30,4 @@
## Impact
仅文档和 OpenSpec 记录。无需应用镜像、数据库迁移或真实业务部署。验证包括来源核对、文档构建、链接/锚点及中英页面/亮暗主题/移动宽度浏览器检查;PR CI 和独立 Review 单独记录。
仅文档、静态图示、文档主题样式和 OpenSpec 记录。无需应用镜像、数据库迁移或真实业务部署。验证包括来源核对、文档构建、链接/锚点及中英页面/亮暗主题/移动宽度浏览器检查;PR CI 和独立 Review 单独记录。

View file

@ -58,3 +58,19 @@ The second batch SHALL improve the introduction, quickstart, namespace, review,
- **WHEN** a reader opens the diagrams or tables at desktop or mobile width
- **THEN** the visual and surrounding text describe the same verified behavior and remain readable in light and dark themes
- **AND** the page does not depend on an added rendering service or package
### Requirement: Route avatar instructions by operator responsibility
The documentation SHALL separate skill-avatar submission and review from moderation-provider deployment configuration, preserving the existing operational page URL and synchronizing both locales, navigation, and ordered page links.
#### Scenario: Locate an avatar task
- **WHEN** a skill owner or reviewer opens team-governance guidance
- **THEN** avatar operations and review decisions are available there
- **AND** provider credentials and deployment verification are linked to a distinct deployment guide
### Requirement: State the scope and limitations of documentation review
A scoped review SHALL NOT be reported as complete verification of all site content. Known unresolved structural issues and unverified technical behavior SHALL remain explicit.
#### Scenario: Report an incremental review
- **WHEN** a document batch passes source, build, and browser checks
- **THEN** the report distinguishes verified changed paragraphs, site-structure observations, unresolved issues, and unexecuted business or external-service validation

View file

@ -36,8 +36,11 @@
第二批验证摘要:12个中英文页面、12张SVG,正式文体、来源路径、58个正文链接及示例语法检查通过;OpenSpec严格校验与VitePress构建通过。浏览器首次48次页面检查,图示尺寸修正后补跑受影响页面32次,明暗主题、390px布局、图片加载、图内文字边界及主题/导航交互通过。扫描诊断92项受控回归通过;教程参数失败命令实际返回退出码5且网络调用0次。独立Review未发现实质事实问题;本地视觉检查发现的图示过度放大已修正。不代表实际安装、Agent执行、通知投递或真实部署已验收。第三至第五批仍未完成,第二批不自动合并或发布。
## 5. 维护者复核补充
- [ ] VISUAL-CENTER 正文流程图水平居中,保留自然尺寸及移动缩放;浏览器检查实际几何位置。
- [ ] IA-AVATAR 技能头像上传/审核与供应商部署分页面、分导航职责,中英/导航/Pager/交叉链接同步。
- [ ] SITE-AUDIT 逐页核查站点结构、目标读者、导航归属、文书缺口并标注已修/待修/未核实;不得将增量Review汇报为整站通过。
- [ ] 对上述增量独立复核,并更新构建、链接、浏览器及交付说明。
- [ ] FACT-SPOT 全站补查发现的首次角色授权、私有搜索边界、CLI JSON与冲突处置四项问题完成双语局部修正,并保留其余页面缺口。
- [x] VISUAL-CENTER 正文流程图水平居中,保留自然尺寸及移动缩放;浏览器检查实际几何位置。
- [x] IA-AVATAR 技能头像上传/审核与供应商部署分页面、分导航职责,中英/导航/Pager/交叉链接同步。
- [x] SITE-AUDIT 逐页核查站点结构、目标读者、导航归属、文书缺口并标注已修/待修/未核实;不得将增量Review汇报为整站通过。
- [x] 对上述增量独立复核,并更新构建、链接、浏览器及交付说明。
- [x] FACT-SPOT 全站补查发现的首次角色授权、私有搜索边界、CLI JSON与冲突处置四项问题完成双语局部修正,并保留其余页面缺口。
复核补充验证摘要:全站结构台账覆盖23个中文页面及23个英文镜像,仍有10类明确缺口,未认定全站C10/A7通过。18个新增或重写页面的来源/108正文链接/示例检查通过;全站46页JSON语法与本地文件目标检查通过。实际浏览器覆盖本批24个修改页面的桌面/390px和明暗组合,共96次检查,另有16组头像双页导航归属及Pager检查,均通过。正文流程图水平位置检查通过。新头像部署页只核实现有代码与配置说明,未重新验证真实云账号或生产部署。用户反馈增量由独立Review核查;FAQ跨页指引夸大目标页内容的问题在补查中发现并修正。其余已知问题按逐页台账保留待办,不能因部分修正而标为完成。