From d8c6724ffdc5dcf4f4b0de7dd14c9ae48a621734 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 17:51:14 +0800 Subject: [PATCH 01/12] =?UTF-8?q?docs:=20=E8=AE=BE=E8=AE=A1=20Agent=20?= =?UTF-8?q?=E9=98=85=E8=AF=BB=E4=BD=93=E7=B3=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2026-08-08-agent-reading-system-design.md | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 docs/plans/2026-08-08-agent-reading-system-design.md diff --git a/docs/plans/2026-08-08-agent-reading-system-design.md b/docs/plans/2026-08-08-agent-reading-system-design.md new file mode 100644 index 0000000..729d480 --- /dev/null +++ b/docs/plans/2026-08-08-agent-reading-system-design.md @@ -0,0 +1,30 @@ +# Agent 阅读体系设计 + +## 目标 + +为 `XiyouMobile3G-iOS/.github` 建立仅服务当前仓库的轻量 Agent 阅读体系，让 Agent 在编辑组织首页前快速获得稳定、准确的上下文。 + +## 文件与职责 + +- `AGENTS.md`：仓库级自动入口，规定必读顺序、仓库目标、修改边界、工作流程和验证清单。 +- `memory.md`：记录组织身份、仓库现状、长期内容决策和待确认事项，不保存敏感信息，也不复制首页正文。 +- `profile/README.md`：GitHub 组织首页内容的唯一事实来源。 + +## 阅读顺序 + +1. 阅读根目录 `AGENTS.md`，理解工作约束。 +2. 阅读根目录 `memory.md`，获取稳定背景和既有决策。 +3. 阅读 `profile/README.md`，确认当前实际页面内容。 + +## 维护原则 + +- 首页结构、目标受众或长期设计决策发生变化时，同步更新 `memory.md`。 +- 普通措辞、标点和格式微调不进入 `memory.md`。 +- `memory.md` 不保存 Token、凭据、成员隐私或其他敏感数据。 +- 修改组织首页后检查链接、Markdown/HTML 结构和变更范围。 + +## 非目标 + +- 不建设跨仓库通用模板。 +- 不引入脚本、自动化工具或复杂文档层级。 +- 本次不修改 `profile/README.md` 的展示内容。 From 501a36459bc81436980dfc9310ad396505141e0d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 17:52:03 +0800 Subject: [PATCH 02/12] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20Agent=20?= =?UTF-8?q?=E9=98=85=E8=AF=BB=E4=BD=93=E7=B3=BB=E5=AE=9E=E6=96=BD=E8=AE=A1?= =?UTF-8?q?=E5=88=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/plans/2026-08-08-agent-reading-system.md | 189 ++++++++++++++++++ 1 file changed, 189 insertions(+) create mode 100644 docs/plans/2026-08-08-agent-reading-system.md diff --git a/docs/plans/2026-08-08-agent-reading-system.md b/docs/plans/2026-08-08-agent-reading-system.md new file mode 100644 index 0000000..0a16b1b --- /dev/null +++ b/docs/plans/2026-08-08-agent-reading-system.md @@ -0,0 +1,189 @@ +# Agent Reading System Implementation Plan + +> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. + +**Goal:** 在仓库根目录建立可自动发现的 `AGENTS.md` 与被其引用的 `memory.md`，让 Agent 在修改组织首页前获得稳定上下文和明确约束。 + +**Architecture:** `AGENTS.md` 是覆盖整个仓库的执行入口，定义阅读顺序、事实来源、编辑边界和验证流程。`memory.md` 只保存稳定背景、长期决策和待确认事项；实际首页内容继续由 `profile/README.md` 唯一承载。 + +**Tech Stack:** Markdown、Git、GitHub Organization Profile README + +--- + +### Task 1: 建立 Agent 自动入口 + +**Files:** +- Create: `AGENTS.md` +- Read: `profile/README.md` +- Read: `docs/plans/2026-08-08-agent-reading-system-design.md` + +**Step 1: 确认入口尚不存在** + +Run: `test ! -e AGENTS.md` + +Expected: 命令退出码为 0。 + +**Step 2: 创建最小入口文件** + +创建 `AGENTS.md`，完整内容如下： + +```markdown +# AGENTS.md + +## 适用范围 + +本文件适用于仓库根目录及其全部子目录。 + +## 必读顺序 + +开始任务前，按顺序阅读： + +1. `AGENTS.md` +2. `memory.md` +3. `profile/README.md` +4. 与当前任务直接相关的 `docs/plans/` 文档 + +## 仓库目标 + +本仓库是 `XiyouMobile3G-iOS` 的 GitHub 组织资料仓库。`profile/README.md` 会渲染为组织首页，所有改动应服务于清晰介绍组织、展示项目和引导参与。 + +## 事实来源 + +- 首页实际内容以 `profile/README.md` 为唯一事实来源。 +- 稳定背景、长期决策和待确认事项记录在 `memory.md`。 +- 不要在 `memory.md` 中复制首页正文。 + +## 工作规则 + +- 修改前先查看 `git status`，保留与当前任务无关的用户改动。 +- 优先进行范围最小、易于审阅的修改。 +- 面向访客的内容默认使用简洁、自然的中文，除非任务另有要求。 +- 仅使用 GitHub Markdown 支持的语法与安全 HTML。 +- 不记录或提交 Token、凭据、成员隐私等敏感信息。 +- 只有长期有效的目标、结构或设计决策变化时才更新 `memory.md`；普通措辞和格式调整无需记录。 +- 未经明确要求，不修改仓库设置、远程地址、分支策略，不提交或推送变更。 + +## 修改流程 + +1. 阅读必读文件并确认任务边界。 +2. 检查目标文件和现有风格。 +3. 实施最小变更。 +4. 长期决策有变化时同步更新 `memory.md`。 +5. 执行验证并检查最终差异。 + +## 验证清单 + +- 运行 `git diff --check`，确保没有空白错误。 +- 检查 Markdown 标题层级、HTML 标签闭合和表格结构。 +- 检查新增或修改的链接、图片地址和仓库名称。 +- 运行 `git status --short` 和 `git diff --stat`，确认变更范围符合任务。 +``` + +**Step 3: 验证入口结构** + +Run: `rg -n '^# AGENTS.md$|^## (适用范围|必读顺序|仓库目标|事实来源|工作规则|修改流程|验证清单)$' AGENTS.md` + +Expected: 输出主标题和七个二级标题。 + +**Step 4: 提交入口文件** + +```bash +git add AGENTS.md +git commit -m "docs: 添加 Agent 仓库指引" +``` + +### Task 2: 建立持久上下文 + +**Files:** +- Create: `memory.md` +- Read: `AGENTS.md` +- Read: `profile/README.md` + +**Step 1: 确认记忆文件尚不存在** + +Run: `test ! -e memory.md` + +Expected: 命令退出码为 0。 + +**Step 2: 创建最小持久记忆** + +创建 `memory.md`，完整内容如下： + +```markdown +# Repository Memory + +## 使用方式 + +本文件为 Agent 提供稳定、精简的仓库上下文。仅记录长期有效的信息；页面正文以 `profile/README.md` 为准。 + +## 组织身份 + +- GitHub 组织：`XiyouMobile3G-iOS` +- 展示名称：`XiyouMobile3G - iOS` +- 方向：iOS 与 Apple 平台开发、学习资料、项目规范、开发工具和知识分享 + +## 仓库职责 + +- 仓库：`XiyouMobile3G-iOS/.github` +- 可见性：公开 +- 默认分支：`main` +- 组织首页入口：`profile/README.md` +- 当前阅读体系仅服务本仓库，不作为跨仓库通用模板 + +## 长期决策 + +- `profile/README.md` 是组织首页内容的唯一事实来源。 +- `AGENTS.md` 是 Agent 的仓库级入口，并强制阅读本文件。 +- `memory.md` 不复制首页正文，只保留背景、决策和待确认事项。 +- 面向访客的主要内容默认使用中文。 +- 保持阅读体系轻量，不引入脚本或复杂文档层级。 + +## 待确认事项 + +- 组织首页的美化方向尚未选定。 +- 组织简介、所在地、官网和公开邮箱等 GitHub 组织元数据目前未完善。 + +## 更新规则 + +- 组织定位、首页结构、目标受众或长期设计原则改变时更新本文件。 +- 普通措辞、链接维护、标点和排版微调不记录。 +- 禁止写入 Token、凭据、成员隐私或其他敏感信息。 +``` + +**Step 3: 验证持久上下文结构** + +Run: `rg -n '^# Repository Memory$|^## (使用方式|组织身份|仓库职责|长期决策|待确认事项|更新规则)$' memory.md` + +Expected: 输出主标题和六个二级标题。 + +**Step 4: 提交记忆文件** + +```bash +git add memory.md +git commit -m "docs: 添加仓库持久记忆" +``` + +### Task 3: 验证阅读链路与仓库状态 + +**Files:** +- Verify: `AGENTS.md` +- Verify: `memory.md` +- Verify: `profile/README.md` + +**Step 1: 验证三个必读文件存在** + +Run: `test -f AGENTS.md && test -f memory.md && test -f profile/README.md` + +Expected: 命令退出码为 0。 + +**Step 2: 验证入口引用阅读链路** + +Run: `rg -n 'memory\.md|profile/README\.md' AGENTS.md` + +Expected: 两个路径都至少出现一次。 + +**Step 3: 检查 Markdown 与变更范围** + +Run: `git diff HEAD~2 --check && git status --short --branch && git log -4 --oneline` + +Expected: 无空白错误，工作区干净，历史中包含两个新文件的提交。 From 439141a35533bebeafb3c198674cc012bde04e2c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 17:53:45 +0800 Subject: [PATCH 03/12] =?UTF-8?q?chore:=20=E5=BF=BD=E7=95=A5=E6=9C=AC?= =?UTF-8?q?=E5=9C=B0=20worktree=20=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 1 + 1 file changed, 1 insertion(+) create mode 100644 .gitignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e458ed5 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.worktrees/ From bf78af373230d6d30b6fbb1563750e00e2fa92b0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 17:56:17 +0800 Subject: [PATCH 04/12] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20Agent=20?= =?UTF-8?q?=E4=BB=93=E5=BA=93=E6=8C=87=E5=BC=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..1cdc816 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,49 @@ +# AGENTS.md + +## 适用范围 + +本文件适用于仓库根目录及其全部子目录。 + +## 必读顺序 + +开始任务前，按顺序阅读： + +1. `AGENTS.md` +2. `memory.md` +3. `profile/README.md` +4. 与当前任务直接相关的 `docs/plans/` 文档 + +## 仓库目标 + +本仓库是 `XiyouMobile3G-iOS` 的 GitHub 组织资料仓库。`profile/README.md` 会渲染为组织首页，所有改动应服务于清晰介绍组织、展示项目和引导参与。 + +## 事实来源 + +- 首页实际内容以 `profile/README.md` 为唯一事实来源。 +- 稳定背景、长期决策和待确认事项记录在 `memory.md`。 +- 不要在 `memory.md` 中复制首页正文。 + +## 工作规则 + +- 修改前先查看 `git status`，保留与当前任务无关的用户改动。 +- 优先进行范围最小、易于审阅的修改。 +- 面向访客的内容默认使用简洁、自然的中文，除非任务另有要求。 +- 仅使用 GitHub Markdown 支持的语法与安全 HTML。 +- 不记录或提交 Token、凭据、成员隐私等敏感信息。 +- 只有长期有效的目标、结构或设计决策变化时才更新 `memory.md`；普通措辞和格式调整无需记录。 +- 未经明确要求，不修改仓库设置、远程地址、分支策略，不提交或推送变更。 + +## 修改流程 + +1. 阅读必读文件并确认任务边界。 +2. 检查目标文件和现有风格。 +3. 实施最小变更。 +4. 长期决策有变化时同步更新 `memory.md`。 +5. 执行验证并检查最终差异。 + +## 验证清单 + +- 运行 `git diff --check`，确保没有空白错误。 +- 检查 Markdown 标题层级、HTML 标签闭合和表格结构。 +- 检查新增或修改的链接、图片地址和仓库名称。 +- 运行 `git status --short` 和 `git diff --stat`，确认变更范围符合任务。 From 0fb0f2e130cf4bb9281bf999c92cb231a35049e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 18:02:04 +0800 Subject: [PATCH 05/12] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=20Agent=20?= =?UTF-8?q?=E5=8F=98=E6=9B=B4=E9=AA=8C=E8=AF=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 1cdc816..60e66c3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -43,7 +43,7 @@ ## 验证清单 -- 运行 `git diff --check`，确保没有空白错误。 +- 运行 `git diff HEAD --check`，确保没有空白错误。 - 检查 Markdown 标题层级、HTML 标签闭合和表格结构。 - 检查新增或修改的链接、图片地址和仓库名称。 -- 运行 `git status --short` 和 `git diff --stat`，确认变更范围符合任务。 +- 运行 `git status --short` 和 `git diff HEAD --stat`，确认变更范围符合任务。 From 992c7e9ead71f47e2856ba7d2ef05dd1d291a486 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 18:06:09 +0800 Subject: [PATCH 06/12] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E4=BB=93?= =?UTF-8?q?=E5=BA=93=E6=8C=81=E4=B9=85=E8=AE=B0=E5=BF=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- memory.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 memory.md diff --git a/memory.md b/memory.md new file mode 100644 index 0000000..0dd17e1 --- /dev/null +++ b/memory.md @@ -0,0 +1,38 @@ +# Repository Memory + +## 使用方式 + +本文件为 Agent 提供稳定、精简的仓库上下文。仅记录长期有效的信息；页面正文以 `profile/README.md` 为准。 + +## 组织身份 + +- GitHub 组织：`XiyouMobile3G-iOS` +- 展示名称：`XiyouMobile3G - iOS` +- 方向：iOS 与 Apple 平台开发、学习资料、项目规范、开发工具和知识分享 + +## 仓库职责 + +- 仓库：`XiyouMobile3G-iOS/.github` +- 可见性：公开 +- 默认分支：`main` +- 组织首页入口：`profile/README.md` +- 当前阅读体系仅服务本仓库，不作为跨仓库通用模板 + +## 长期决策 + +- `profile/README.md` 是组织首页内容的唯一事实来源。 +- `AGENTS.md` 是 Agent 的仓库级入口，并强制阅读本文件。 +- `memory.md` 不复制首页正文，只保留背景、决策和待确认事项。 +- 面向访客的主要内容默认使用中文。 +- 保持阅读体系轻量，不引入脚本或复杂文档层级。 + +## 待确认事项 + +- 组织首页的美化方向尚未选定。 +- 组织简介、所在地、官网和公开邮箱等 GitHub 组织元数据目前未完善。 + +## 更新规则 + +- 组织定位、首页结构、目标受众或长期设计原则改变时更新本文件。 +- 普通措辞、链接维护、标点和排版微调不记录。 +- 禁止写入 Token、凭据、成员隐私或其他敏感信息。 From dedd6ec2f0e5a8124fe69c3597ad3b6f3cb8beb9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 18:49:03 +0800 Subject: [PATCH 07/12] =?UTF-8?q?docs:=20=E8=AE=BE=E8=AE=A1=E7=BB=84?= =?UTF-8?q?=E7=BB=87=E9=A6=96=E9=A1=B5=E6=9E=81=E7=AE=80=E7=BE=8E=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...08-organization-homepage-refresh-design.md | 62 +++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 docs/plans/2026-08-08-organization-homepage-refresh-design.md diff --git a/docs/plans/2026-08-08-organization-homepage-refresh-design.md b/docs/plans/2026-08-08-organization-homepage-refresh-design.md new file mode 100644 index 0000000..e0f390c --- /dev/null +++ b/docs/plans/2026-08-08-organization-homepage-refresh-design.md @@ -0,0 +1,62 @@ +# 组织首页极简美化设计 + +## 目标 + +在不增加栏目和图片素材的前提下，美化 `XiyouMobile3G-iOS` 的 GitHub 组织首页。首页优先服务准备加入实验室的 iOS 学习者，同时让招聘方、合作方和学校能够快速理解组织定位与代表性项目。 + +## 设计方向 + +采用 Apple 风格的极简黑白排版：克制、清晰、重视内容层级和留白。设计不依赖横幅、插画、Emoji、动态效果或复杂 HTML，以保证 GitHub 深浅色模式、移动端和长期维护的稳定性。 + +## 信息架构 + +保留现有内容区域和顺序： + +1. 品牌区 +2. 关于我们 +3. 精选项目 +4. 知识沉淀 +5. 关注方向 +6. 一起构建 +7. 页脚标语 + +不新增学习路径、成员展示、成果数据或其他栏目。 + +## 视觉层级 + +- 品牌区居中，使用现有组织头像、组织名称、精简标语和三个页内导航链接。 +- 正文全部左对齐，使用标准 Markdown 二级标题。 +- 品牌区与正文之间使用单条分隔线，不堆叠装饰元素。 +- 精选项目继续使用两列表格，统一项目简介的语气与长度。 +- 关注方向继续使用行内代码样式作为低调标签，不引入远端徽章图片。 +- 页脚保留英文标语，拆成两句以形成简洁节奏。 + +## 内容语气 + +- 面向访客的主要内容使用简洁、自然的中文。 +- 首屏标语聚焦 Apple 平台、工程实践和可交付产品。 +- 关于我们保留两段短文：第一段说明资源范围，第二段说明学习和实践方式。 +- 链接文字使用明确动作，如“浏览项目”“查看知识库”“参与共建”。 +- 不夸大规模、成果或活跃度，不加入无法验证的数据。 + +## 可访问性与兼容性 + +- 组织头像保留准确的替代文本。 +- 不使用依赖固定颜色的文字或背景，避免深色模式对比度问题。 +- 不使用宽幅图片或双列卡片，避免移动端横向滚动。 +- 仅使用 GitHub 支持的 Markdown 与简单 HTML 对齐属性。 +- 链接名称应能独立表达目标，不使用含糊的“点击这里”。 + +## 文件与数据流 + +- 修改 `profile/README.md`，它仍是组织首页内容的唯一事实来源。 +- 更新 `memory.md`，记录已确定的极简视觉方向，并移除“美化方向尚未选定”的待确认项。 +- 不新增图片、脚本、依赖或自动生成文件。 + +## 验证 + +- 检查 Markdown 标题层级、表格、HTML 标签和页内锚点。 +- 检查所有仓库链接、组织链接和图片地址。 +- 使用 `git diff HEAD --check` 检查空白错误。 +- 确认最终差异仅包含 `profile/README.md`、`memory.md` 和设计/计划文档。 +- 确认 README 在窄屏下不依赖固定宽度布局。 From a5080a74a4f7a166d4a2053ac5b6c439ecafacdd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 18:50:03 +0800 Subject: [PATCH 08/12] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E7=BB=84?= =?UTF-8?q?=E7=BB=87=E9=A6=96=E9=A1=B5=E7=BE=8E=E5=8C=96=E5=AE=9E=E6=96=BD?= =?UTF-8?q?=E8=AE=A1=E5=88=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...026-08-08-organization-homepage-refresh.md | 193 ++++++++++++++++++ 1 file changed, 193 insertions(+) create mode 100644 docs/plans/2026-08-08-organization-homepage-refresh.md diff --git a/docs/plans/2026-08-08-organization-homepage-refresh.md b/docs/plans/2026-08-08-organization-homepage-refresh.md new file mode 100644 index 0000000..4a8b65b --- /dev/null +++ b/docs/plans/2026-08-08-organization-homepage-refresh.md @@ -0,0 +1,193 @@ +# Organization Homepage Refresh Implementation Plan + +> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. + +**Goal:** 在不增加栏目或图片素材的前提下，将组织首页重排为清晰、克制、面向 iOS 学习者的 Apple 风极简页面。 + +**Architecture:** `profile/README.md` 继续作为首页唯一事实来源，只调整现有内容的层级、措辞和间距。`memory.md` 同步保存已确定的长期视觉决策，并移除已经解决的待确认事项。 + +**Tech Stack:** GitHub Flavored Markdown、GitHub README 安全 HTML、Git + +--- + +### Task 1: 重排组织首页 + +**Files:** +- Modify: `profile/README.md` +- Read: `AGENTS.md` +- Read: `memory.md` +- Read: `docs/plans/2026-08-08-organization-homepage-refresh-design.md` + +**Step 1: 验证新首页尚未实现** + +Run: `! rg -q '探索 Apple 平台。沉淀工程实践。构建可交付的产品。' profile/README.md` + +Expected: 命令退出码为 0，证明新首屏标语尚不存在。 + +**Step 2: 用最小实现替换首页正文** + +将 `profile/README.md` 完整替换为： + +```markdown +
+ + XiyouMobile3G iOS + + +

XiyouMobile3G · iOS

+

探索 Apple 平台。沉淀工程实践。构建可交付的产品。

+

+ 浏览项目 +  ·  + 查看知识库 +  ·  + 参与共建 +

+
+ +--- + +## 关于我们 + +这里汇集与 iOS 开发相关的学习资料、项目规范和开发工具。 + +我们从代码与原理出发，在持续学习、实践与复盘中积累对 Apple 平台开发的理解。 + +## 精选项目 + +| 项目 | 内容 | +| --- | --- | +| [Weather-Forecast-Requests](https://github.com/XiyouMobile3G-iOS/Weather-Forecast-Requests) | 天气预报功能的需求、实现要求与核验资料。 | +| [Raycast-Apple-Developer-Docs](https://github.com/XiyouMobile3G-iOS/Raycast-Apple-Developer-Docs) | 面向 Apple 开发者文档的 Raycast 检索工具。 | +| [3G-share-request-source](https://github.com/XiyouMobile3G-iOS/3G-share-request-source) | 3G Share 的需求说明与配套资源。 | +| [books](https://github.com/XiyouMobile3G-iOS/books) | iOS 与软件开发相关的技术阅读资源。 | + +## 知识沉淀 + +- [**awesome-ios-interview**](https://github.com/XiyouMobile3G-iOS/awesome-ios-interview)：系统整理从基础到进阶的 iOS 面试知识。 +- [**tips**](https://github.com/XiyouMobile3G-iOS/tips)：记录 iOS 学习与实践过程中值得沉淀的知识点。 + +## 关注方向 + +`iOS` · `Objective-C` · `Apple Developer Documentation` · `Developer Tools` · `Knowledge Sharing` + +## 一起构建 + +欢迎通过 [Issues](https://github.com/orgs/XiyouMobile3G-iOS/issues) 提出建议、补充资料或分享实践。 + +
+ Designed for clarity.
Built for learning. +
+``` + +**Step 3: 验证页面内容契约** + +Run: `rg -n '^## (关于我们|精选项目|知识沉淀|关注方向|一起构建)$|探索 Apple 平台|href="#精选项目"|href="#知识沉淀"|href="#一起构建"' profile/README.md` + +Expected: 输出五个既有二级标题、新标语和三个页内导航链接。 + +**Step 4: 验证范围和空白** + +Run: `git diff HEAD --check && git diff --name-only HEAD` + +Expected: 无空白错误，只有 `profile/README.md`。 + +**Step 5: 提交首页重排** + +```bash +git add profile/README.md +git commit -m "docs: 美化组织首页" +``` + +### Task 2: 同步长期视觉决策 + +**Files:** +- Modify: `memory.md` +- Read: `AGENTS.md` +- Read: `profile/README.md` + +**Step 1: 验证记忆仍是旧状态** + +Run: `rg -q '组织首页的美化方向尚未选定' memory.md && ! rg -q 'Apple 风极简黑白排版' memory.md` + +Expected: 命令退出码为 0。 + +**Step 2: 更新长期决策和待确认事项** + +在 `## 长期决策` 末尾增加： + +```markdown +- 组织首页采用 Apple 风极简黑白排版：品牌区居中、正文左对齐，不使用装饰横幅、Emoji 或复杂 HTML。 +- 首页美化只重排现有栏目，不新增内容栏目或图片素材。 +``` + +删除 `## 待确认事项` 中的： + +```markdown +- 组织首页的美化方向尚未选定。 +``` + +将 `## 更新规则` 第一项替换为： + +```markdown +- 组织定位、首页结构、目标受众、长期设计原则或组织与仓库元数据变化时更新本文件。 +``` + +**Step 3: 验证记忆同步** + +Run: `rg -n 'Apple 风极简黑白排版|只重排现有栏目|组织与仓库元数据变化' memory.md && ! rg -q '美化方向尚未选定' memory.md` + +Expected: 三条新规则均被找到，旧待确认项不存在。 + +**Step 4: 验证范围和空白** + +Run: `git diff HEAD --check && git diff --name-only HEAD` + +Expected: 无空白错误，只有 `memory.md`。 + +**Step 5: 提交记忆更新** + +```bash +git add memory.md +git commit -m "docs: 记录组织首页视觉方向" +``` + +### Task 3: 验证最终首页 + +**Files:** +- Verify: `profile/README.md` +- Verify: `memory.md` +- Verify: `AGENTS.md` + +**Step 1: 验证文件与阅读链路** + +Run: `test -f AGENTS.md && test -f memory.md && test -f profile/README.md && rg -q 'memory\.md' AGENTS.md && rg -q 'profile/README\.md' AGENTS.md` + +Expected: 命令退出码为 0。 + +**Step 2: 验证首页结构没有新增栏目** + +Run: `test "$(rg -c '^## ' profile/README.md)" -eq 5` + +Expected: 命令退出码为 0，首页仍有五个正文二级标题。 + +**Step 3: 验证链接目标存在** + +依次运行： + +```bash +gh api repos/XiyouMobile3G-iOS/Weather-Forecast-Requests --jq .html_url +gh api repos/XiyouMobile3G-iOS/Raycast-Apple-Developer-Docs --jq .html_url +gh api repos/XiyouMobile3G-iOS/3G-share-request-source --jq .html_url +gh api repos/XiyouMobile3G-iOS/books --jq .html_url +gh api repos/XiyouMobile3G-iOS/awesome-ios-interview --jq .html_url +gh api repos/XiyouMobile3G-iOS/tips --jq .html_url +``` + +Expected: 六个命令均输出对应仓库的 GitHub URL。 + +**Step 4: 验证完整功能差异** + +Run: `git diff main...HEAD --check && git status --short --branch && git diff --stat main...HEAD` + +Expected: 无空白错误，工作区干净；完整分支包含 Agent 阅读体系、首页设计文档、实施计划、首页重排和记忆更新。 From 73e9bcfcc5de6520f4a7e3d3720fd8c597bbee02 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 18:52:16 +0800 Subject: [PATCH 09/12] =?UTF-8?q?docs:=20=E7=BE=8E=E5=8C=96=E7=BB=84?= =?UTF-8?q?=E7=BB=87=E9=A6=96=E9=A1=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- profile/README.md | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/profile/README.md b/profile/README.md index 9525d21..e3a8d94 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,38 +1,40 @@
- XiyouMobile3G iOS + XiyouMobile3G iOS

XiyouMobile3G · iOS

-

探索、学习、构建 iOS。

+

探索 Apple 平台。沉淀工程实践。构建可交付的产品。

- 浏览项目 + 浏览项目  ·  - 参与讨论 + 查看知识库 +  ·  + 参与共建

-
+--- ## 关于我们 这里汇集与 iOS 开发相关的学习资料、项目规范和开发工具。 -从一段代码、一次复盘到一个可以交付的应用，我们持续积累对 Apple 平台开发的理解。 +我们从代码与原理出发，在持续学习、实践与复盘中积累对 Apple 平台开发的理解。 ## 精选项目 -| 项目 | 简介 | +| 项目 | 内容 | | --- | --- | -| [Weather-Forecast-Requests](https://github.com/XiyouMobile3G-iOS/Weather-Forecast-Requests) | 天气预报功能的要求与核验资料。 | -| [Raycast-Apple-Developer-Docs](https://github.com/XiyouMobile3G-iOS/Raycast-Apple-Developer-Docs) | 在 Raycast 中检索 Apple 开发者文档的工具。 | -| [3G-share-request-source](https://github.com/XiyouMobile3G-iOS/3G-share-request-source) | 3Gshare 的需求说明与资源集合。 | -| [books](https://github.com/XiyouMobile3G-iOS/books) | 技术阅读资源。 | +| [Weather-Forecast-Requests](https://github.com/XiyouMobile3G-iOS/Weather-Forecast-Requests) | 天气预报功能的需求、实现要求与核验资料。 | +| [Raycast-Apple-Developer-Docs](https://github.com/XiyouMobile3G-iOS/Raycast-Apple-Developer-Docs) | 面向 Apple 开发者文档的 Raycast 检索工具。 | +| [3G-share-request-source](https://github.com/XiyouMobile3G-iOS/3G-share-request-source) | 3G Share 的需求说明与配套资源。 | +| [books](https://github.com/XiyouMobile3G-iOS/books) | iOS 与软件开发相关的技术阅读资源。 | ## 知识沉淀 -- [awesome-ios-interview](https://github.com/XiyouMobile3G-iOS/awesome-ios-interview)：系统化整理 iOS 面试知识体系。 -- [tips](https://github.com/XiyouMobile3G-iOS/tips)：记录 iOS 学习过程中的知识点。 +- [**awesome-ios-interview**](https://github.com/XiyouMobile3G-iOS/awesome-ios-interview)：系统整理从基础到进阶的 iOS 面试知识。 +- [**tips**](https://github.com/XiyouMobile3G-iOS/tips)：记录 iOS 学习与实践过程中值得沉淀的知识点。 ## 关注方向 @@ -40,8 +42,8 @@ ## 一起构建 -欢迎通过 [Issues](https://github.com/orgs/XiyouMobile3G-iOS/issues) 提出建议、补充资料或分享你的实践。 +欢迎通过 [Issues](https://github.com/orgs/XiyouMobile3G-iOS/issues) 提出建议、补充资料或分享实践。
- Designed for clarity. Built for learning. + Designed for clarity.
Built for learning.
From e94fbae2b38f87ea39d442b33d99571ee6233092 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 19:00:04 +0800 Subject: [PATCH 10/12] =?UTF-8?q?docs:=20=E4=BF=AE=E6=AD=A3=E9=A6=96?= =?UTF-8?q?=E9=A1=B5=E5=85=B1=E5=BB=BA=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index e3a8d94..2377a97 100644 --- a/profile/README.md +++ b/profile/README.md @@ -42,7 +42,7 @@ ## 一起构建 -欢迎通过 [Issues](https://github.com/orgs/XiyouMobile3G-iOS/issues) 提出建议、补充资料或分享实践。 +欢迎通过 [Issues](https://github.com/XiyouMobile3G-iOS/3G-share-request-source/issues/new/choose) 提出建议、补充资料或分享实践。
Designed for clarity.
Built for learning. From b6e99d761902c44e9f2c30b05dbaf4c4fa45054b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 19:05:14 +0800 Subject: [PATCH 11/12] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=E7=BB=84?= =?UTF-8?q?=E7=BB=87=E9=A6=96=E9=A1=B5=E8=A7=86=E8=A7=89=E6=96=B9=E5=90=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- memory.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/memory.md b/memory.md index 0dd17e1..8f4663b 100644 --- a/memory.md +++ b/memory.md @@ -25,14 +25,15 @@ - `memory.md` 不复制首页正文，只保留背景、决策和待确认事项。 - 面向访客的主要内容默认使用中文。 - 保持阅读体系轻量，不引入脚本或复杂文档层级。 +- 组织首页采用 Apple 风极简黑白排版：品牌区居中、正文左对齐，不使用装饰横幅、Emoji 或复杂 HTML。 +- 首页美化只重排现有栏目，不新增内容栏目或图片素材。 ## 待确认事项 -- 组织首页的美化方向尚未选定。 - 组织简介、所在地、官网和公开邮箱等 GitHub 组织元数据目前未完善。 ## 更新规则 -- 组织定位、首页结构、目标受众或长期设计原则改变时更新本文件。 +- 组织定位、首页结构、目标受众、长期设计原则或组织与仓库元数据变化时更新本文件。 - 普通措辞、链接维护、标点和排版微调不记录。 - 禁止写入 Token、凭据、成员隐私或其他敏感信息。 From 944e27f0a5def7fe22409d01f310b6a6500ee4f8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=AC=91=E5=B0=98?= Date: Sat, 8 Aug 2026 19:11:28 +0800 Subject: [PATCH 12/12] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=E4=BB=93?= =?UTF-8?q?=E5=BA=93=E8=AE=B0=E5=BF=86=E7=BB=B4=E6=8A=A4=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 +- memory.md | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 60e66c3..cda602d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,7 +30,7 @@ - 面向访客的内容默认使用简洁、自然的中文，除非任务另有要求。 - 仅使用 GitHub Markdown 支持的语法与安全 HTML。 - 不记录或提交 Token、凭据、成员隐私等敏感信息。 -- 只有长期有效的目标、结构或设计决策变化时才更新 `memory.md`；普通措辞和格式调整无需记录。 +- 长期有效的目标、结构、设计决策，或 `memory.md` 记录的组织与仓库元数据发生变化时，更新 `memory.md`；普通措辞和格式调整无需记录。 - 未经明确要求，不修改仓库设置、远程地址、分支策略，不提交或推送变更。 ## 修改流程 diff --git a/memory.md b/memory.md index 8f4663b..0fbc61c 100644 --- a/memory.md +++ b/memory.md @@ -26,6 +26,7 @@ - 面向访客的主要内容默认使用中文。 - 保持阅读体系轻量，不引入脚本或复杂文档层级。 - 组织首页采用 Apple 风极简黑白排版：品牌区居中、正文左对齐，不使用装饰横幅、Emoji 或复杂 HTML。 +- 组织首页优先服务准备加入实验室的 iOS 学习者，招聘方、合作方和学校展示为辅助受众。 - 首页美化只重排现有栏目，不新增内容栏目或图片素材。 ## 待确认事项