profile-readme-positioning

个人资料 README 定位技能

适用场景

使用此技能撰写或修改：

• GitHub 个人资料简介
• GitHub 个人资料 README
• 项目 README 引言
• 个人实验室定位
• 开源项目描述
• 作品集技术项目页面

核心原则

GitHub 个人资料与简历不同。

简历会这样写：

Here is the business value I created in professional settings.

GitHub 个人资料可以这样写：

Here is the kind of builder I am when nobody assigns me a ticket.

步骤 1 — 明确仓库／个人资料的使命

思考：

• 此个人资料／项目解决哪类问题？
• 这些问题属于个人、职业、开源、教育还是实验性质？
• 这能展现出什么样的创作者？
• 访客应该在 5 秒内了解什么？
• 哪些内容不应夸大？

步骤 2 — 选择定位类型

个人自动化实验室

适用于为解决创作者自身问题而构建的工具。

模板：

Personal automation lab for [domain/tools] and practical systems that reduce [type of friction].

技术实验室

适用于探索性项目。

A public lab for experiments in [topics], focused on learning, prototypes, and reusable patterns.

开源实用工具个人资料

适用于可复用的工具。

Building small, practical tools for [audience/problem], with a focus on [qualities].

特定项目 README

[Project] helps [audience] solve [problem] by [mechanism].

步骤 3 — 诚实表达，但不要妄自菲薄

避免防御性的措辞：

This code is not good enough.
This is not representative of professional code.
This is just random personal stuff.

使用措辞适度的表达：

This is a public lab for practical experiments.
These projects prioritize solving real personal workflows quickly.
Some repos are prototypes, others are reusable tools.

步骤 4 — 说明此处展示的内容

对于个人资料 README，请包含：

• 此个人资料的内容
• 当前关注领域
• 工作内容类别示例
• 分享理念
• 必要时添加界限／免责声明

GitHub 简介选项

简短简介：

Personal automation lab: agentic AI systems, browser agents, workflows, and tools that reduce real-life friction.

Building practical tools for high-friction workflows with automation, agents, and browser-based systems.

Turning everyday friction into agentic workflows, browser automations, and reusable personal tools.

README 框架

# [Profile / Lab Name]

I use this GitHub as a public lab for [type of tools/projects].

Most projects here explore:

- [topic 1]
- [topic 2]
- [topic 3]
- [topic 4]

The goal:

> If I solve a real problem for myself and the solution might help someone else, I try to make it shareable.

Some projects are polished utilities. Others are experiments, prototypes, or learning artifacts.

项目 README 引言框架

# [Project Name]

[Project Name] helps [audience] solve [painful problem] by [mechanism].

It was built because [specific friction].

## What it does

- [capability]
- [capability]
- [capability]

## Why it exists

[Explain the before state and why existing solutions were insufficient.]

## Status

[Prototype / usable / production-ready / experimental]

质量标准

优秀的个人资料 README：

• 清楚展现创作者身份
• 不会把个人项目说成公司工作
• 不会为项目具有实验性质而道歉
• 解释串联各个项目的主题
• 帮助访客决定接下来查看什么