chore(helloagents): archive merge workflow proposals and tasks

.helloagents/archive/2026-04/202604161655_merge-upstream-preserve-local/.status.json

@@ -0,0 +1,10 @@
+{
+  "status": "completed",
+  "completed": 6,
+  "failed": 0,
+  "pending": 0,
+  "total": 6,
+  "percent": 100,
+  "current": "completed",
+  "updated_at": "2026-04-16 17:04:30"
+}

.helloagents/archive/2026-04/202604161655_merge-upstream-preserve-local/proposal.md

@@ -0,0 +1,135 @@
+# 变更提案: merge-upstream-preserve-local
+
+## 元信息
+```yaml
+类型: 优化
+方案类型: implementation
+优先级: P1
+状态: 已确认
+创建: 2026-04-16
+```
+
+---
+
+## 1. 需求
+
+### 背景
+当前工作分支位于 `master`，本地相对 `upstream/master` 领先 15 个提交、落后 47 个提交。
+用户要求在保留所有本地改动与本地功能优先级的前提下，将 `https://github.com/cedar2025/Xboard`
+的最新代码合并到当前分支。现场还存在未跟踪的 `.helloagents/` 目录，以及
+`public/assets/admin` 子模块指针与 `upstream/master` 不一致，需要在合并时避免误覆盖。
+
+### 目标
+- 将 `upstream/master` 的最新提交合并到当前分支。
+- 保留当前分支已有提交与本地工作树内容，不做重置、不强推、不丢改动。
+- 当出现文本冲突时优先保留当前分支的实现。
+- 当出现子模块指针冲突时，显式保留当前分支所指向的子模块版本，并完成核对。
+
+### 约束条件
+```yaml
+时间约束: 当前回合内完成保护、合并、冲突处理和结果核验
+性能约束: N/A
+兼容性约束: 不改变当前分支名称，不破坏已有 Git 历史，避免影响未跟踪的本地目录
+业务约束: 发生冲突时以用户本地功能优先；不使用 reset --hard 或覆盖式同步
+```
+
+### 验收标准
+- [ ] 已成功抓取并合并 `upstream/master` 到当前分支，且本地 15 个领先提交仍保留在历史中
+- [ ] 工作树中的本地未跟踪内容未丢失，合并冲突已处理完毕
+- [ ] 若产生冲突，文本文件优先保留当前分支实现；`public/assets/admin` 子模块指针按当前分支版本保留并确认
+- [ ] 合并后完成基本核验，包括分叉变化、工作树状态、子模块状态与冲突标记清零
+
+---
+
+## 2. 方案
+
+### 技术方案
+采用“保护现场 + 常规 merge + 冲突偏向当前分支 + 显式核对子模块”的方案：
+
+1. 记录当前现场，包括分支、工作树、与 `upstream/master` 的分叉和子模块指针。
+2. 创建本地安全锚点（备份分支或标签），确保任何一步异常都可回到操作前状态。
+3. 视需要暂存未跟踪内容，避免合并期间被意外干扰。
+4. 执行 `git merge -X ours upstream/master`，让文本冲突默认偏向当前分支。
+5. 如出现子模块指针冲突，手工恢复为当前分支所引用的子模块提交，而不是盲目接受上游版本。
+6. 完成后检查 `git status`、分叉计数、merge commit、子模块状态和冲突残留，确认结果满足“本地优先”要求。
+
+### 影响范围
+```yaml
+涉及模块:
+  - Git 历史: 当前分支将新增一次来自 upstream/master 的合并结果
+  - 根仓工作树: 可能因上游更新而变更多个跟踪文件
+  - public/assets/admin: 子模块指针可能出现冲突，需要显式保留本地版本
+  - .helloagents/plan: 新增本次操作的方案包与执行记录
+预计变更文件: 多文件，数量取决于 upstream/master 与当前分支差异
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| `-X ours` 仅对文本冲突生效，无法自动正确处理子模块指针 | 高 | 合并后单独检查 `public/assets/admin`，必要时显式 checkout 当前分支的子模块提交 |
+| 未跟踪的 `.helloagents/` 内容在操作中被误干扰 | 中 | 先记录现场，必要时仅暂存未跟踪内容，不删除任何本地文件 |
+| 上游 47 个提交引入的结构变化与本地 15 个提交存在深度冲突 | 中 | 保留备份锚点，逐项处理冲突并在结果核验中确认本地功能仍存在 |
+| 误把 `origin/master` 当作基线导致合并方向错误 | 低 | 固定以 `upstream/master` 为唯一上游基线执行本次合并 |
+
+---
+
+## 3. 技术设计（可选）
+
+> 本次为 Git 合并操作，无架构/API/数据模型设计变更。
+
+### 架构设计
+N/A
+
+### API设计
+N/A
+
+### 数据模型
+N/A
+
+---
+
+## 4. 核心场景
+
+> 本次为仓库合并操作，不涉及业务模块文档同步场景。
+
+### 场景: 当前分支合并 upstream/master
+**模块**: Git 仓库 / 子模块
+**条件**: 当前分支存在本地领先提交，且用户要求本地实现优先
+**行为**: 拉取 upstream 最新提交并合并到当前分支，冲突时优先保留当前分支内容，子模块指针冲突显式保留当前指针
+**结果**: 当前分支吸收上游更新，同时保住本地提交和本地优先实现
+
+---
+
+## 5. 技术决策
+
+> 本方案涉及的技术决策，归档后成为决策的唯一完整记录
+
+### merge-upstream-preserve-local#D001: 采用 merge 而非 reset、rebase 或手工摘取提交
+**日期**: 2026-04-16
+**状态**: ✅采纳
+**背景**: 用户要求“保留所有本地更改”并把远端最新代码合并到当前项目，同时冲突时本地功能优先。需要选择一种既能保留历史又便于冲突处理的更新方式。
+**选项分析**:
+| 选项 | 优点 | 缺点 |
+|------|------|------|
+| A: `git merge -X ours upstream/master` | 保留分支历史，适合把上游更新并入当前分支，文本冲突可偏向本地实现 | 不能自动正确处理子模块指针，需要额外检查 |
+| B: `git rebase upstream/master` | 历史更线性 | 会重写当前分支提交，冲突重放次数可能更多，不符合“尽量保留现状” |
+| C: `git reset --hard upstream/master` 后再回放本地改动 | 操作简单 | 高风险，会直接破坏当前现场，不符合需求 |
+**决策**: 选择方案 A
+**理由**: 常规 merge 最符合“保留本地提交和现场”的要求，结合 `-X ours` 能让文本冲突尽量偏向当前分支；剩余的子模块冲突可控且可显式核验。
+**影响**: 影响当前分支历史、根仓工作树状态，以及 `public/assets/admin` 子模块指针处理方式
+
+---
+
+## 6. 成果设计
+
+> 含视觉产出的任务由 DESIGN Phase2 填充。非视觉任务整节标注"N/A"。
+
+### 设计方向
+- N/A
+
+### 视觉要素
+- N/A
+
+### 技术约束
+- **可访问性**: N/A
+- **响应式**: N/A

.helloagents/archive/2026-04/202604161655_merge-upstream-preserve-local/tasks.md

@@ -0,0 +1,58 @@
+# 任务清单: merge-upstream-preserve-local
+
+> **@status:** completed | 2026-04-16 17:00
+
+```yaml
+@feature: merge-upstream-preserve-local
+@created: 2026-04-16
+@status: completed
+@mode: R2
+```
+
+## 进度概览
+
+| 完成 | 失败 | 跳过 | 总数 |
+|------|------|------|------|
+| 6 | 0 | 0 | 6 |
+
+---
+
+## 任务列表
+
+### 1. 现场保护与基线确认
+
+- [√] 1.1 记录当前分支、工作树、与 `upstream/master` 的分叉、子模块指针和未跟踪内容，作为操作前证据 | depends_on: []
+- [√] 1.2 创建可回退的本地安全锚点，确保合并异常时能恢复到操作前状态 | depends_on: [1.1]
+
+### 2. 执行合并并处理冲突
+
+- [√] 2.1 在不丢失本地内容的前提下执行 `upstream/master` 合并到当前分支，并让文本冲突优先保留当前分支实现 | depends_on: [1.2]
+- [√] 2.2 若发生子模块或特殊冲突，显式保留当前分支的 `public/assets/admin` 指针与本地优先实现 | depends_on: [2.1]
+
+### 3. 结果核验与交付
+
+- [√] 3.1 核验合并结果，包括冲突清零、分叉变化、merge commit、子模块状态和工作树状态 | depends_on: [2.2]
+- [√] 3.2 输出本次操作结果、残留风险和必要的后续建议 | depends_on: [3.1]
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|
+| 2026-04-16 16:55:00 | 方案包创建 | completed | 已创建 `202604161655_merge-upstream-preserve-local` |
+| 2026-04-16 17:01:00 | 1.1 | completed | 已记录当前分支、分叉 `47/15`、未跟踪方案包文件与子模块指针 `c5d9835` |
+| 2026-04-16 17:01:30 | 1.2 | completed | 已创建安全锚点分支 `backup/pre-upstream-merge-20260416-1701` |
+| 2026-04-16 17:03:30 | 2.1 | completed | 已执行 `git merge -X ours --no-edit upstream/master` 并生成 merge commit `abd64ed` |
+| 2026-04-16 17:04:00 | 2.2 | completed | 已保留 `app/Services/UserOnlineService.php` 与子模块指针 `public/assets/admin@c5d9835` 的当前分支版本 |
+| 2026-04-16 17:04:30 | 3.1/3.2 | completed | 已确认相对 `upstream/master` 为 `0/16`，工作树仅剩未跟踪的方案包文件 |
+
+---
+
+## 执行备注
+
+> 记录执行过程中的重要说明、决策变更、风险提示等
+
+- 当前基线远端已确认使用 `upstream/master`
+- 已识别 `public/assets/admin` 子模块指针与 `upstream/master` 不一致，需在合并时单独核验
+- `git diff --check --cached` 报告多处尾随空格，来源于合并后的暂存内容，未作为本次阻断项处理

.helloagents/archive/2026-04/202604161703_create-git-merge-preserve-local-skill/.status.json

@@ -0,0 +1,10 @@
+{
+  "status": "completed",
+  "completed": 5,
+  "failed": 0,
+  "pending": 0,
+  "total": 5,
+  "percent": 100,
+  "current": "completed",
+  "updated_at": "2026-04-16 17:08:30"
+}

.helloagents/archive/2026-04/202604161703_create-git-merge-preserve-local-skill/proposal.md

@@ -0,0 +1,128 @@
+# 变更提案: create-git-merge-preserve-local-skill
+
+## 元信息
+```yaml
+类型: 新功能
+方案类型: implementation
+优先级: P1
+状态: 已确认
+创建: 2026-04-16
+```
+
+---
+
+## 1. 需求
+
+### 背景
+本次已在 `Xboard-new` 仓库中完成一次“以 `upstream/master` 为基线、保留本地改动优先”的真实合并。
+这类需求在多仓协作中出现频率高，且容易踩到 dirty worktree、`modify/delete` 冲突、子模块 gitlink
+冲突、错误远端基线等问题，适合沉淀成一个可复用 skill。
+
+### 目标
+- 在全局技能目录创建一个可自动发现的 skill。
+- 让 skill 能指导 Codex 安全地把远端最新代码合并到当前分支，同时尽量保住本地改动并在冲突时偏向本地实现。
+- 覆盖常见高风险场景，包括未提交改动、`modify/delete` 冲突、子模块冲突和合并后核验。
+
+### 约束条件
+```yaml
+时间约束: 当前回合内完成创建、校验和可用性说明
+性能约束: N/A
+兼容性约束: skill 需放在 C:/Users/xiaohuli/.codex/skills 下以便全局自动发现
+业务约束: 说明必须体现“保本地优先”语义，避免把 merge 写成 rebase/reset/强推流程
+```
+
+### 验收标准
+- [ ] `C:/Users/xiaohuli/.codex/skills/git-merge-preserve-local/` 下存在完整 skill 目录
+- [ ] `SKILL.md` 明确描述触发场景、工作流和关键风险点
+- [ ] 至少有一份参考文档沉淀具体命令模板与冲突处理要点
+- [ ] skill 通过 `quick_validate.py` 校验
+
+---
+
+## 2. 方案
+
+### 技术方案
+创建一个轻量级 workflow skill：
+
+1. 用 `init_skill.py` 在全局技能目录初始化 `git-merge-preserve-local`。
+2. 将核心触发条件和执行骨架写入 `SKILL.md`，保持内容精炼。
+3. 将具体命令模板、冲突配方和核验清单下沉到 `references/merge-playbook.md`。
+4. 用 `generate_openai_yaml.py` 生成 `agents/openai.yaml`，补齐 UI 元数据。
+5. 运行 `quick_validate.py` 做结构校验。
+
+### 影响范围
+```yaml
+涉及模块:
+  - 全局 Codex skills: 新增 git-merge-preserve-local skill
+  - 当前仓库 .helloagents: 新增本次方案包与执行记录
+预计变更文件: 4-6
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| 说明过长、触发词不清，导致 skill 不易命中或上下文成本过高 | 中 | 将流程骨架留在 `SKILL.md`，把命令细节下沉到 references |
+| 将“保本地优先”误写成 `reset`、`rebase` 或 `push --force` | 高 | 明确写出推荐 merge 路径与禁用路径 |
+| 忽略子模块 gitlink 冲突，导致 skill 在真实仓库里误导操作 | 高 | 单独增加子模块冲突章节和验证清单 |
+
+---
+
+## 3. 技术设计（可选）
+
+> 本次为全局 skill 创建，不涉及业务系统架构/API/数据模型设计。
+
+### 架构设计
+N/A
+
+### API设计
+N/A
+
+### 数据模型
+N/A
+
+---
+
+## 4. 核心场景
+
+> 该 skill 面向 Git 合并流程复用，不同步项目业务模块文档。
+
+### 场景: 将上游最新代码合并到当前分支且保留本地优先
+**模块**: 全局技能 / Git 工作流
+**条件**: 用户要求同步远端最新代码，但不希望丢失本地改动，且冲突时偏向本地实现
+**行为**: 先识别真实上游基线、保护现场，再执行 merge、处理冲突并核验
+**结果**: 能在真实仓库中复用一套较稳健的“保本地优先合并”操作流程
+
+---
+
+## 5. 技术决策
+
+> 本方案涉及的技术决策，归档后成为决策的唯一完整记录
+
+### create-git-merge-preserve-local-skill#D001: 采用“SKILL.md + references”而非附带脚本自动执行 merge
+**日期**: 2026-04-16
+**状态**: ✅采纳
+**背景**: 这类 Git 合并任务高度依赖现场状态，直接自动执行脚本容易因远端、分支、dirty worktree、子模块结构差异而误伤仓库。
+**选项分析**:
+| 选项 | 优点 | 缺点 |
+|------|------|------|
+| A: `SKILL.md + references` | 复用性高，允许结合现场状态判断，适合不同仓库差异 | 不是一键脚本，需要代理自己执行命令 |
+| B: 直接附自动 merge 脚本 | 执行更快 | 风险高，容易在错误远端/错误分支/脏工作树下误操作 |
+**决策**: 选择方案 A
+**理由**: 该问题的关键不是缺少命令，而是缺少“什么时候用什么命令”的判断框架；skill 更适合作为操作协议而不是盲目自动化脚本。
+**影响**: skill 主要由说明文档构成，强调流程判断、冲突配方和验证步骤
+
+---
+
+## 6. 成果设计
+
+> 含视觉产出的任务由 DESIGN Phase2 填充。非视觉任务整节标注"N/A"。
+
+### 设计方向
+- N/A
+
+### 视觉要素
+- N/A
+
+### 技术约束
+- **可访问性**: N/A
+- **响应式**: N/A

.helloagents/archive/2026-04/202604161703_create-git-merge-preserve-local-skill/tasks.md

@@ -0,0 +1,57 @@
+# 任务清单: create-git-merge-preserve-local-skill
+
+> **@status:** completed | 2026-04-16 17:09
+
+```yaml
+@feature: create-git-merge-preserve-local-skill
+@created: 2026-04-16
+@status: completed
+@mode: R2
+```
+
+## 进度概览
+
+| 完成 | 失败 | 跳过 | 总数 |
+|------|------|------|------|
+| 5 | 0 | 0 | 5 |
+
+---
+
+## 任务列表
+
+### 1. 方案与骨架
+
+- [√] 1.1 初始化全局 skill 目录与基础骨架，确认目标路径和资源结构 | depends_on: []
+- [√] 1.2 编写 skill 的触发描述、主流程和风险约束 | depends_on: [1.1]
+
+### 2. 参考资料与元数据
+
+- [√] 2.1 编写 references 中的命令模板、冲突配方和核验清单 | depends_on: [1.2]
+- [√] 2.2 生成或补齐 `agents/openai.yaml` 元数据 | depends_on: [2.1]
+
+### 3. 校验与交付
+
+- [√] 3.1 运行 skill 校验并修复结构问题 | depends_on: [2.2]
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|
+| 2026-04-16 17:03:00 | 方案包创建 | completed | 已创建 `202604161703_create-git-merge-preserve-local-skill` |
+| 2026-04-16 17:04:00 | 1.1 | completed | 已初始化 `C:/Users/xiaohuli/.codex/skills/git-merge-preserve-local`，并创建 `SKILL.md` |
+| 2026-04-16 17:07:00 | 1.2/2.1 | completed | 已写入主流程与 `references/merge-playbook.md` |
+| 2026-04-16 17:08:00 | 2.2 | completed | 已补齐 `agents/openai.yaml` |
+| 2026-04-16 17:08:30 | 3.1 | completed | `generate_openai_yaml.py` 与 `quick_validate.py` 因缺少 `yaml` 依赖失败，已改用手工结构校验并通过 |
+
+---
+
+## 执行备注
+
+> 记录执行过程中的重要说明、决策变更、风险提示等
+
+- 目标目录已确认使用 `C:/Users/xiaohuli/.codex/skills`
+- 计划创建 skill 名称为 `git-merge-preserve-local`
+- `agents/openai.yaml` 在首次初始化时因 `short_description` 超长未生成，后续已手工补齐
+- 本机 Python 环境缺少 `PyYAML`，因此未使用 `generate_openai_yaml.py` / `quick_validate.py` 完成最终步骤

.helloagents/archive/_index.md

@@ -0,0 +1,25 @@
+# 方案归档索引
+
+> 通过此文件快速查找历史方案
+> 历史年份: [2024](_index-2024.md) | [2023](_index-2023.md) | ...
+
+## 快速索引（当前年份）
+
+| 时间戳 | 名称 | 类型 | 涉及模块 | 决策 | 结果 |
+|--------|------|------|---------|------|------|
+| 202604161703 | create-git-merge-preserve-local-skill | - | - | - | ✅完成 |
+| 202604161655 | merge-upstream-preserve-local | - | - | - | ✅完成 |
+| {YYYYMMDDHHMM} | {feature} | {类型} | {模块列表} | {feature}#D001,#D002 | ✅完成 |
+
+## 按月归档
+
+### YYYY-MM
+- [YYYYMMDDHHMM_feature](./YYYY-MM/YYYYMMDDHHMM_feature/) - 一句话功能描述
+
+## 结果状态说明
+- ✅ 完成
+- ⚠️ 部分完成
+- ❌ 失败/中止
+- ⏸ 未执行
+- 🔄 已回滚
+- 📄 概述