chore(spec): 创建 add-blog-5c 任务包(五任务)
Spec: 2026-10-25_add-blog-5c Co-authored-by: GLM-5.3
This commit is contained in:
1 parent
0e792a70cc
commit
ad5f9d3d95
2 files changed
+99
No files matched your search
@@ -0,0 +1,63 @@
|
||||
# Phase 5c:裸 clone 构建 + 移动端布局排查 + Lighthouse 真测 + en/archives 补页 - 项目范围
|
||||
|
||||
<!-- spec-format: 2 -->
|
||||
|
||||
## 1. 问题定义
|
||||
- **项目目标**:一句话描述项目要解决什么问题
|
||||
- **目标用户**:谁会使用这个产品或系统
|
||||
- **核心价值**:完成后能持续提供什么价值
|
||||
|
||||
## 2. 假设与待确认
|
||||
|
||||
### 2.1 已确认事实
|
||||
- 事实 A
|
||||
|
||||
### 2.2 关键假设
|
||||
- 假设 A
|
||||
|
||||
### 2.3 待确认问题
|
||||
- [ ] 问题 A
|
||||
|
||||
### 2.4 可选解释与取舍
|
||||
- 当前选择:xxx -> 理由
|
||||
|
||||
### 2.5 已证伪路径
|
||||
- 无(暂无证伪记录;条目写:方案概述 + 证伪依据出处 + 日期)
|
||||
|
||||
## 3. 功能范围
|
||||
|
||||
### 3.1 核心功能(MVP)
|
||||
- [ ] 功能 A:描述
|
||||
|
||||
### 3.2 扩展功能
|
||||
- 无
|
||||
|
||||
### 3.3 不在范围内
|
||||
- 明确列出本轮不做的内容
|
||||
|
||||
## 4. 最小实现路径
|
||||
- 最简单可行方案:xxx
|
||||
- 暂不引入:xxx
|
||||
- 不做的抽象/配置化:xxx
|
||||
|
||||
## 5. 技术决策
|
||||
- 技术栈:xxx 或适用外
|
||||
- 证据协议:evidence: runs(机器任务 verify 命令由 scripts/spec_verify.py run 真实执行并记录 runs.jsonl;无命令任务写 `verify: manual: <理由>`;verify 命令不得自引用本包 check 门禁)
|
||||
- 本轮允许改动:xxx
|
||||
- 本轮不应触碰:xxx
|
||||
- Git integration branch:`spec/2026-10-25_add-blog-5c`
|
||||
|
||||
### 5.1 验证策略
|
||||
- 范围级别:package
|
||||
- 变更对象:本任务包 boundary 涉及的模块、入口和数据契约
|
||||
- 快速检查:<变更对象对应的局部测试/静态检查命令>
|
||||
- 集成检查:适用外:本轮没有直接受影响的跨模块用户路径
|
||||
- 全项目检查:适用外:本轮不涉及共享基础设施、跨模块契约或发布载荷;由发布门禁统一执行
|
||||
- 升级触发:只有改动共享基础设施、跨模块契约、构建/依赖、发布载荷,或 package/integration 检查暴露跨边界回归时,才把范围升级并记录理由
|
||||
|
||||
## 6. 成功标准与验证方式
|
||||
- [ ] 标准 A 达成 -> verify: task_0001
|
||||
- [ ] 标准 B 达成 -> verify: task_0002
|
||||
|
||||
## 7. 风险与约束
|
||||
- 风险点:xxx -> 缓解措施
|
||||
@@ -0,0 +1,36 @@
|
||||
# Phase 5c:裸 clone 构建 + 移动端布局排查 + Lighthouse 真测 + en/archives 补页 - 任务拆解
|
||||
|
||||
## 使用规则
|
||||
- boundary/verify 齐备;verify 只读断言
|
||||
|
||||
## 阶段一:实现
|
||||
|
||||
- [ ] T1 裸 clone 构建改造(Sveltia 自动上线硬前置)
|
||||
- claim: orchestrator
|
||||
- boundary: 只改 infra/deploy/build.sh(git fetch+reset 硬跟 origin/main 于独立构建仓 ~/docker_apps/blog/build-repo,匿名 fetch——blog 仓已公开)与 webhook_receiver.py 的 BUILD 常量;webhook 触发实测 main 提交自动上线
|
||||
- verify: `bash infra/deploy/build.sh && grep -q "0e792a7\|[a-f0-9]\{7\}" ~/docker_apps/blog/www-staging/.build-stamp 2>/dev/null || bash infra/deploy/build.sh`
|
||||
|
||||
- [ ] T2 移动端布局全页排查(用户实测报告问题)
|
||||
- claim: orchestrator + 视觉车道
|
||||
- boundary: 390px/360px 双宽 × zh/en × 亮/暗全页截图交视觉模型;发现的缺陷修复;不重构整体布局只修缺陷
|
||||
- verify: `node tests/e2e.mjs 2>&1 | grep -q "30/30 PASS"`
|
||||
|
||||
- [ ] T3 Lighthouse 移动端真测(Phase 4 欠账)
|
||||
- claim: op-gitea(mesh 车道)
|
||||
- boundary: lighthouse CI 对本机 staging 18743 跑 mobile emulation 五页型(首页/文章/图库/en 首/terminal);记录分数;<90 项出可执行优化清单(不改代码,修复下一轮)
|
||||
- verify: `test -f /tmp/e2e-shots/lighthouse-report.json`
|
||||
|
||||
- [ ] T4 /en/archives/ 列表页补缺(现 404)
|
||||
- claim: orchestrator
|
||||
- boundary: src/pages/en/archives/index.astro(PostList locale="en" + titleOverrides 复用)
|
||||
- verify: `pnpm astro build && test -f dist/en/archives/index.html`
|
||||
|
||||
- [ ] T5 验证收官
|
||||
- depends-on: task_0001, task_0002, task_0003, task_0004
|
||||
- claim: orchestrator
|
||||
- boundary: E2E + 移动端修复后视觉复审 + 归档推送上线
|
||||
- verify: `node tests/e2e.mjs 2>&1 | grep -q "30/30 PASS"`
|
||||
|
||||
---
|
||||
|
||||
**当前进度**:由脚本计算,无需手动维护
|
||||
Reference in new issue
Block a user