149 added, 52 removed. Audit A to A.
---
name: lls-github-profile-writer
+ description: "把 GitHub 个人主页或项目 README 设计成访客能在一分钟内判断价值、找到代表作、成功运行并知道如何继续关注的公开门面。用于重写 Profile README、开源仓库首页、作品集目录或 Skill 总仓说明时；必须先核验仓库真实内容、安装命令、许可证和维护状态，区分个人主页与单项目任务，不用徽章、口号或 Star 请求掩盖空仓和失效入口。"
license: CC-BY-NC-SA-4.0
- description: 把GitHub个人主页或仓库README写成访客快速看懂、愿意使用和收藏的门面。 当用户需要“新建或升级GitHub主页、项目README和开源作品集。”时使用。
+ metadata:
+ short-description: 从访客任务到首屏、证据、安装和可验证入口
---
<!-- workbuddy-install: published; slug: lls-github-profile-writer -->
## 在 WorkBuddy 中找到并安装
**Skill slug：`lls-github-profile-writer`**
在 WorkBuddy 新会话粘贴：
```text
请按 https://skillhub.cn/install/skillhub.md 检查 SkillHub，搜索 `lls-github-profile-writer`；仅在 slug 完全一致时安装到 `~/.workbuddy/skills/`。安装后读取 `~/.workbuddy/skills/lls-github-profile-writer/SKILL.md`，核对 name、version 和实际路径，然后新开会话触发该 Skill。
```
也可以打开左侧「技能」→「添加技能 / 查找技能」，搜索 `lls-github-profile-writer` 后安装；界面文字可能随 WorkBuddy 版本变化。
# 罗老师 GitHub 首页助手
- > 类型：LLS Original
- > 当前版本：1.1.0
- ## 一句话用途
+ ## 先判断是哪一种首页
- 把GitHub个人主页或仓库README写成访客快速看懂、愿意使用和收藏的门面。
+ ### 个人 Profile README
- ## 什么时候使用
+ 回答“你是谁、主要解决什么问题、有哪些代表作、怎么联系或继续关注”。入口仓库通常与 GitHub 用户名同名。
- 新建或升级GitHub主页、项目README和开源作品集。
+ ### 单个项目 README
- ## 哪些情况换别的方法
+ 回答“这个项目解决什么、适合谁、如何在几分钟内成功运行、证据在哪里、如何贡献和获取更新”。
- 仓库还没有可运行内容或真实交付物。
+ ### 多 Skill/作品集总仓
- ## 3 分钟上手
+ 回答“有哪些可用能力、如何筛选和下载、来源如何区分、版本如何更新”。
- 复制下面这句话给 AI：
+ 不要把三种页面套成同一个自我介绍模板。
+ ## 必要输入
+
```text
- 请用 lls-github-profile-writer，重写这个Skill仓库首页。
+ 页面类型：Profile / 单项目 / 作品集总仓
+ 目标访客：用户 / 开发者 / 学员 / 合作者 / 招聘方
+ 希望访客完成的首要动作：
+ 现有仓库、Release、演示和文档：
+ 已验证安装命令：
+ 许可证和来源边界：
+ 维护状态与反馈渠道：
+ 可公开的个人信息：
```
- ## 标准工作流程
+ ## 一、做真实资产盘点
- 1. **确认目标访客和一个核心价值**
- 2. **把首屏写成价值、入口、代表作和Star引导**
- 3. **补安装、示例、来源、维护状态**
- 4. **检查所有链接、命令和下载入口**
+ 只使用可点击、可运行或可展示的资产：
- ## 完整案例
+ - 当前存在的仓库与默认分支；
+ - 真实 Release 和安装包；
+ - 已验证命令；
+ - 截图、演示或在线产品；
+ - 文档、教程和案例；
+ - 许可证、来源与维护状态；
+ - Issues、Discussions 或其他反馈入口。
- 输入：包含6个中文Skill的仓库。
+ 把计划中的功能标为 Roadmap，不写成“已支持”。空链接和伪造数据比没有数据更伤信任。
- 输出：首屏、能力目录、安装、来源政策、Star与Watch引导。
+ ## 二、定义访客的一分钟路径
- ## 输出标准
+ ```text
+ 看懂一句话价值
+ → 选择一个代表作
+ → 看到真实效果或证据
+ → 完成一次最小安装/体验
+ → Star 收藏或 Watch Releases
+ ```
- 最终结果至少包含：
+ 首屏只服务最重要的一种访客。其他人通过目录进入对应章节。
- - 用户真正要完成的任务；
- - 可执行步骤，而不是只有观点；
- - 关键事实、假设和未知项；
- - 完成前的检查清单；
- - 下一步最小动作。
+ ## 三、写首屏
- ## 隐私、依赖与权限
+ 建议包含：
- README示例使用公开资料；移除私人邮箱、内网地址和本机路径。
+ 1. 名称；
+ 2. 一句具体价值；
+ 3. 适合谁；
+ 4. 主要入口按钮或链接；
+ 5. Star 徽章或状态徽章；
+ 6. 一个真实结果或代表作。
- 默认只读取用户明确提供的材料。涉及账号登录、文件写入、网络请求或外部发布时，先说明实际动作与影响范围。
+ 一句话价值公式：
- ## 质量检查
+ ```text
+ 帮助【具体人群】用【能力/方法】完成【可观察结果】。
+ ```
- 交付前逐项检查：
+ 避免“热爱技术、持续学习、赋能未来”这类无法验证的表述。
- 1. 是否回答了用户的真实任务；
- 2. 是否把事实、推断和建议分开；
- 3. 是否给出至少一个可复制的下一步；
- 4. 是否移除了本机路径、账号、密钥和客户资料；
- 5. 是否说明依赖、权限和失败处理。
+ ## 四、选择代表作
- ## 常见问题
+ 个人主页保留 3–6 个；单项目展示 1 个完整主路径。每项写：
- ### 结果太泛怎么办？
+ - 名称；
+ - 一句话用途；
+ - 适用人群；
+ - 当前状态；
+ - 运行/下载/演示入口；
+ - 为什么值得看。
- 补充目标用户、真实输入、期望输出和一个失败例子，再运行一次。
+ 代表作按访客价值排序，不按创建日期或作者偏爱排序。
- ### 可以直接公开结果吗？
+ ## 五、写可验证的快速开始
- 先检查来源、个人信息、客户内容、截图和下载链接，再决定发布范围。
+ 快速开始必须能在干净环境复现：
- ## 版本与更新记录
+ ```text
+ 前置条件
+ → 安装
+ → 最小输入
+ → 预期输出
+ → 如何判断成功
+ → 常见失败与卸载/回滚
+ ```
- - 1.0.0：首次公开教学版。
+ 命令复制前检查路径、包名、版本和 shell。不要把维护者本机绝对路径写进公开 README。
- ## 三端入口
+ ## 六、建立信任区
- - GitHub 源码：https://github.com/PhilRobinluo/ai-coevolution-skills/tree/main/skills/lls-github-profile-writer
- - GitHub Release：https://github.com/PhilRobinluo/ai-coevolution-skills/releases/tag/lls-github-profile-writer-v1.0.0
- - 飞书中文教程：https://m2wlgni9k4.feishu.cn/wiki/VGD7woXEKivcbikHFE2cPCZ6nhf
- - SkillHub：搜索唯一 slug `lls-github-profile-writer`
+ - 当前版本与最近更新时间；
+ - 测试/构建状态（真实 CI 才放徽章）；
+ - 原创、改编、社区推荐的来源标识；
+ - 许可证和商业使用边界；
+ - 隐私与安全说明；
+ - 已知限制；
+ - 贡献、反馈和行为规范。
- ## 支持项目
+ 社区项目优先链接原作者，不把导航写成自己原创。
- 如果这个 Skill 帮你节省了时间，欢迎给总仓库点一个 Star，并使用 Watch Releases 接收新版通知：
+ ## 七、设计 Star 与更新引导
- https://github.com/PhilRobinluo/ai-coevolution-skills
+ 在用户看懂价值和成功体验后再邀请：
+
+ > 如果这个项目帮你节省了时间，请点右上角 Star 收藏；需要新版提醒时，请订阅 Watch → Releases。
+
+ 准确区分：
+
+ - Star：收藏、认可和发现；
+ - Watch Releases：接收新版本通知；
+ - Release：下载版本化资产；
+ - Fork：创建自己的开发副本。
+
+ 不写“点 Star 就能自动收到更新”。
+
+ ## 八、做两层信息结构
+
+ ### 首屏
+
+ 价值、代表作、开始按钮、Star。
+
+ ### 深入区
+
+ 完整目录、安装矩阵、来源、架构、贡献、FAQ、许可证。长说明使用折叠块或独立文档，不让首屏变成目录墙。
+
+ ## 输出格式
+
+ 1. 页面类型和访客任务；
+ 2. 真实资产盘点与缺口；
+ 3. 首屏文案；
+ 4. 代表作卡片；
+ 5. 快速开始；
+ 6. 完整 README 结构和正文；
+ 7. Star/Watch/Release 引导；
+ 8. 链接、命令、来源和隐私验收结果。
+
+ ## 失败处理
+
+ - 仓库没有可运行内容：先写最小交付与 Roadmap，不做大规模引流。
+ - 安装命令未验证：标记未验证并给测试步骤，不放“复制即用”。
+ - 项目太多：按访客任务分组并只选代表作。
+ - 个人信息过多：只保留公开需要的渠道，移除私人邮箱、手机号和位置。
+ - 徽章失效：删除或修正来源，不保留装饰性红叉。
+ - 中英文混乱：先确定主要读者，另一语言用锚点或独立文档。
+
+ ## 质量门禁
+
+ - [ ] 页面类型与首要访客清楚；
+ - [ ] 首屏一分钟内能回答价值、受众和下一步；
+ - [ ] 代表作真实存在且入口可点击；
+ - [ ] 安装命令在干净环境验证；
+ - [ ] 预期输出和成功信号明确；
+ - [ ] 计划功能没有冒充已实现；
+ - [ ] 来源、许可证和维护状态清楚；
+ - [ ] Star、Watch、Release 和 Fork 解释准确；
+ - [ ] 没有本机路径、凭证、客户资料或私人联系信息；
+ - [ ] 所有相对链接、锚点、图片和下载入口已检查；
+ - [ ] 移动端阅读没有超宽表格或首屏信息墙；
+ - [ ] README 的承诺与仓库当前内容一致。
+
+ 审查表见 [references/readme-visitor-test.md](references/readme-visitor-test.md)。
+
+ ## 使用入口
+
+ - [飞书中文教程](https://m2wlgni9k4.feishu.cn/wiki/VGD7woXEKivcbikHFE2cPCZ6nhf)
+ - [SkillHub 安装页](https://skillhub.cn/skills/lls-github-profile-writer)
+ - [GitHub 源码](https://github.com/PhilRobinluo/ai-coevolution-skills/tree/main/skills/lls-github-profile-writer)
+ - [GitHub 1.1.0 安装包](https://github.com/PhilRobinluo/ai-coevolution-skills/releases/download/lls-github-profile-writer-v1.1.0/lls-github-profile-writer-1.1.0.zip)