github-repo-product-naming

GitHub 仓库产品命名技能

目的

为公开的开发者项目命名，使名称令人难忘、便于搜索、联想丰富，并且符合产品的实际定位。

好的仓库名称不只是一个类别，而是浓缩的心智模型。

较弱：

workstation-setup
engineering-methods
profile-updater-app
automation-tool
my-scripts

更强：

AgentDesk
SystemSmith
ProofStack
CodexBar
LazyVim
OpenClaw

名称应让访客产生这样的想法：

“I roughly know what world this belongs to, and I want to inspect it.”

适用场景

当用户提出以下需求时，使用此技能：

• 为仓库命名
• 为仓库改名
• 选择产品名称
• 选择仓库 slug
• 让名称更令人难忘、更酷、更容易走红、更符合开源文化或更具市场吸引力
• 将一个仓库拆分为多个公开仓库
• 构建协调一致的仓库生态
• 撰写 GitHub 关于说明
• 将技术文件夹名称改成更像产品的项目名称
• 避免引发错误联想
• 检查某个名称是否已被过度使用

只要仓库名称会影响采用率，也应在 github-repo-launch-page 中自动使用此技能。

核心原则

名称通过联想迁移发挥作用。

好的名称会借用人们熟悉的事物所承载的含义，再将其转向新的使用场景。

联想迁移示例：

OpenAI -> OpenClaw / OpenCode / OpenSpec
LazyGit -> LazyVim -> LazyBrowser / LazyDocs / LazyForms
Codex -> CodexBar
language models + chaining components -> LangChain
mythic messenger -> Hermes Agent

目标不是随机耍聪明，而是触发正确的思维捷径。

需要收集的信息

命名之前，先明确：

1. 命名对象

   • 仓库
   • CLI
   • 应用
   • 技能包
   • 框架
   • 插件
   • 个人资料系统
   • 设置系统
   • 文档系统

2. 用户

   • 开发者
   • 维护者
   • 数据工程师
   • AI Agent 构建者
   • 求职者
   • 创作者
   • 运维人员
   • 个人效率工具用户

3. 要完成的任务

   • 设置机器
   • 编写个人资料
   • 构建 Agent
   • 审查代码
   • 组织工单
   • 编写系统文档
   • 避免重复劳动
   • 自动化浏览器工作流
   • 打包可复用的方法

4. 情感承诺

   • 就绪
   • 掌控
   • 杠杆效应
   • 证明
   • 速度
   • 技艺
   • 从容
   • 清晰
   • 本地掌控权
   • 减少重复决策

5. 技术定位

   • 代码
   • Agent
   • 系统
   • 架构
   • 浏览器
   • 桌面／工作站
   • 证明／证据
   • 文档
   • 工作流
   • 技能

6. 需要避免的错误联想

   • 船只、游戏、同人小说、加密货币、恶意软件、监控、军事、约会、赌博、低质量 SEO、不相关的公司，或过于宽泛的咨询用语

7. 生态关系

   • 独立项目
   • 套件中的一个仓库
   • 现有工具的插件
   • 对知名模式的扩展
   • 个人品牌系统

命名模式

1. 熟悉的词 + 巧妙变化

适用于项目属于某个知名运动或趋势的场景。

公式：

<known-token><twist>

示例：

OpenClaw
OpenCode
OpenSpec
AgentDesk
CodexBar

适用于：

• AI Agent
• 开发者工具
• 开源实用工具
• 插件／扩展
• 与趋势相关的产品

风险：

• 如果变化不够巧妙，可能显得缺乏原创性
• 如果名称过于接近商标或公司名称，可能暗示存在关联

2. 生态系统前缀 + 相邻使用场景

适用于用户已经理解某个命名系列的场景。

公式：

<ecosystem-prefix><new-domain>

示例：

LazyVim
LazyGit
LazyDocker
AgentBrowser
AgentInbox
AgentDesk

适用于：

• 简化令人厌烦的工作流
• 开发者实用工具
• 设置系统
• 为熟悉任务提供 UI 封装

风险：

• 如果受众重视严谨，“Lazy”可能让人觉得不够严谨
• 避免过于贴近现有活跃品牌

3. 将技术概念用作隐喻

适用于项目的架构或心智模型本身就是亮点的场景。

公式：

<technical-concept><mechanism>

示例：

LangChain
VectorStore
SystemSmith
ProofStack
CodeGraph

适用于：

• 框架
• 架构工具
• 技能系统
• 工程方法仓库
• 知识系统

风险：

• 如果副标题没有说明使用场景，名称可能过于抽象

4. 表层隐喻

适用于项目将某项功能放在熟悉的 UI 或位置中的场景。

公式：

<known-thing><surface>

示例：

CodexBar
ClaudeDesk
SlackLens
JiraRadar
GitHubPilot

适用于：

• 桌面应用
• 菜单栏应用
• 仪表板
• 浏览器扩展
• CLI 封装
• 助手界面

风险：

• 如果该界面不是产品的核心，名称可能过于字面化

5. 工艺 / 锻造 / 铁匠隐喻

适用于涉及工程判断、方法、系统或转型的仓库。

公式：

<object><craft-word>

工艺相关词汇：

Smith
Forge
Craft
Foundry
Workbench
Kit
Stack
OS
Lab

示例：

SystemSmith
ProofForge
SignalCraft
AgentFoundry
MethodKit

适用于：

• 可复用的工程方法
• Agent 式 AI 实践
• 架构框架
• 代码／设计评审系统
• 公开的方法论仓库

风险：

• Forge、Craft 和 Foundry 经常被过度使用
• 检查是否与其他名称冲突，或产生错误联想

6. 证明 / 信号 / 证据系列

适用于将私人证据转化为公开定位的仓库。

示例：

ProofStack
SignalCraft
ProofKit
StoryProof
CareerSignal

适用于：

• 职业定位
• LinkedIn／简历系统
• 作品集／故事生成器
• 可信度证明材料
• 可公开的成就转化

风险：

• 如果副标题没有提到职业、简历或公开档案，含义会过于模糊

7. Agent + 环境／工作场景

适用于为人类和 Agent 准备协作场所的仓库。

示例：

AgentDesk
AgentBrowser
AgentInbox
AgentShell
AgentOS
AgentBridge

适用于：

• 工作站配置
• 浏览器自动化
• WSL2/macOS/CLI 配置
• MCP／工具环境
• Agent 与人类的工作空间

风险：

• 如果仓库只包含一组范围狭窄的脚本，名称就会过于宽泛

8. 否定式宣言

谨慎使用。它可能令人印象深刻，但通常更适合作为标语，而非仓库名称。

示例：

never-do-work-twice
dont-repeat-yourself
zero-to-one

适用于：

• 宣言
• 随笔
• 口号
• README 顶部文字

风险：

• 太长
• 不适合作为命名空间
• 重点在于想避开的痛点，而非期望的定位

通常可以将它改写为：

Name: SystemSmith
Tagline: Never solve the same engineering problem twice.

评分标准

按 1–5 分为候选名称评分。

联想契合度

它能否让人联想到正确的领域？

1 = random or wrong domain
3 = somewhat related
5 = immediately points to the right ecosystem

明确性

它表达的是项目的实际内容，而非泛泛的类别吗？

1 = vague category
3 = usable but broad
5 = compressed mental model

易记性

别人能记住并复述它吗？

1 = forgettable
3 = decent
5 = short, distinctive, sticky

错误联想风险

它会让人联想到无关的含义吗？

1 = strong wrong association
3 = manageable ambiguity
5 = clean association

重要：此项得分越高，代表风险越低。

生态契合度

它与用户其他仓库的命名风格相符吗？

1 = disconnected
3 = acceptable
5 = coherent naming family

Slug 质量

它适合作为 GitHub 仓库 slug、软件包、CLI、URL 和文件夹名称吗？

1 = long/ugly/confusing
3 = workable
5 = short, lowercase, command-friendly

扩展潜力

未来增加范围后，它仍能适用而不产生误导吗？

1 = too narrow or too grandiose
3 = enough room
5 = can become a suite/category

总分：35 分。

除非用户明确想要古怪或实验性的名称，否则只推荐得分至少为 26 的名称。

错误联想测试

推荐名称前，先手动进行测试。

请思考：

1. 这个词已经有哪些含义？
2. Google 自动补全可能会显示什么？
3. GitHub 搜索可能会显示什么？
4. 它听起来像游戏、同人小说工具、加密货币、恶意软件、军事工具、成人产品或无关公司吗？
5. 它会让人误以为与用户并不拥有的公司或产品有关联吗？
6. 副标题能消除歧义吗？还是歧义太强？
7. 技术招聘人员、开源维护者或工程师能在 5 秒内理解它所属的领域吗？

如果错误联想强于预期联想，就不要采用该名称。

示例：

ShipCraft

问题：

• “ship”很容易让人联想到船只、舰船、游戏、海事历史和模型制作。
• 它本意可能是“发布软件”，但组合词会让人更容易联想到海事相关含义。

结论：

Reject for software engineering methods unless the project is actually about shipping/logistics/maritime.

冲突检查

检查或请用户检查：

• GitHub 仓库
• 与项目相关的软件包注册表：npm、PyPI、crates.io、Homebrew、Docker Hub
• 如果需要网站，检查域名是否可用
• 搜索引擎的前几条结果
• 用于商业用途时的商标风险
• 如果涉及公开品牌，检查社交媒体账号名

存在冲突不代表必须放弃某个名称。但在以下情况下应放弃：

• 搜索结果无关且占据主导
• 同类别的活跃项目已经使用该名称
• 名称会造成虚假的关联印象
• 用户的 GitHub 命名空间中无法使用该 slug
• 错误联想难以消除

输出格式

请提供：

## Naming Diagnosis

Current name:
Problem:
Desired association:
Associations to avoid:

## Best Recommendation

Product name:
Repo slug:
Tagline:
GitHub About description:
README hero:
Topics:

## Why This Works

- Association:
- Specificity:
- Memorability:
- Ecosystem fit:
- Wrong-association risk:

## Candidate Table

| Candidate | Score | Association | Risk | Verdict |
|---|---:|---|---|---|

## Rejected Names

- Name — reason rejected.

## Final Copy

# <ProductName>

> <Tagline>

<Positioning paragraph>

语气规则

给出明确判断。不要把 20 个名称说得都一样好。

优先考虑：

• 一个最强推荐
• 3-6 个有竞争力的备选名称
• 明确说明淘汰理由
• 清晰的最终决定

避免：

• 泛泛罗列大量名称
• 仅仅描述文件夹的名称
• 缺乏产品辨识度的噱头词
• 必须靠解释消除歧义的名称
• 暗示存在公司关联的名称

Arthur 专属命名体系

对于 Arthur Zakirov 的公开仓库生态，优先采用连贯的产品系列：

ProofStack   -> career proof and public-safe positioning
AgentDesk    -> machine and AI-agent workstation setup
SystemSmith  -> engineering methods for code, agents, and architecture

ProofStack

适用于：

• 职业定位
• 简历、LinkedIn 和个人资料系统
• 从私人证据到公开成果的工作流
• 作品集、博客和故事生成
• 招聘人员及面试材料
• 写作系统：先有证据，再做声明

标准文案：

# ProofStack

> Turn private work evidence into public-safe career signal.

ProofStack helps convert raw achievements into credible resumes, LinkedIn sections, portfolio stories, articles, and interview material without leaking private details or overclaiming.

关于描述：

Turn private work evidence into public-safe resumes, LinkedIn sections, portfolio stories, and interview material.

主题：

career-positioning
resume
linkedin
portfolio
technical-writing
proof-of-work
agent-skills
codex
claude-code
public-profile

AgentDesk

适用于：

• 工作站设置
• WSL2/macOS/Windows 设置
• 显示器、浏览器、Bitwarden、OpenClaw、Codex、Claude 设置
• 将本地计算机打造为可供 Agent 使用的工作区
• 人类与 AI 开发者环境设置

标准文案：

# AgentDesk

> Make any machine ready for human + AI work.

AgentDesk is a setup system for WSL2, macOS, browsers, monitors, Codex, Claude Code, OpenClaw, and other tools that turn a fresh machine into a productive agent-ready workstation.

关于描述：

Setup system for turning WSL2, macOS, browsers, and developer tools into an agent-ready workstation.

主题：

workstation-setup
wsl2
macos
developer-productivity
ai-agents
codex
claude-code
openclaw
browser-automation
agent-workstation

SystemSmith

适用于：

• 软件工程方法
• 代码审查和自我审查
• 安全卫生
• 技术沟通
• 持续维护的成果与文档
• 信息架构
• Agent 式 AI 工程
• 系统架构
• 可复用的工程判断

标准文案：

# SystemSmith

> Engineering methods for code, agents, and architecture.

SystemSmith turns recurring engineering judgment into reusable agent skills: how to scope tickets, review your own work, write durable docs, avoid leaking secrets, structure technical messages, reason about agentic systems, and build cleaner software/information architectures.

关于描述：

Engineering methods for code, agents, docs, security, reviews, and system architecture.

主题：

software-engineering
system-design
agentic-ai
ai-agents
agent-skills
code-review
technical-writing
security
information-architecture
developer-productivity
codex
claude-code

Arthur 当前拆分的名称与边界映射

除非仓库证据另有说明，否则使用以下边界：

ProofStack:
- resume
- LinkedIn
- bio
- public career positioning
- article/story frameworks
- portfolio proof
- proof-safe achievement packets

AgentDesk:
- hardware
- OS setup
- WSL2
- macOS
- browsers
- monitors
- Bitwarden local profile
- OpenClaw/Codex/Claude setup
- machine-specific config

SystemSmith:
- SWE method
- self-review
- security
- messaging framework
- living artifacts
- format markdown
- engineer agentic AI
- system/information architecture

如果某项技能涉及多个领域：

• 如果它用于安装或配置计算机或工具，将其放入 AgentDesk。
• 如果它体现职业信号或公开个人资料价值，将其放入 ProofStack。
• 如果它教授工程判断、架构、文档、审查、沟通或 Agent 设计，将其放入 SystemSmith。

命名检查清单

最终答复前：

• 已评估当前名称。
• 已说明期望关联。
• 已列出错误关联。
• 已考虑至少 6 个候选名称。
• 被淘汰的名称附有理由。
• 最终名称有标语和直白的副标题。
• 仓库 slug 使用小写，并适用于 CLI。
• 已提供 GitHub About 描述。
• 已提供主题。
• 已提供 README 首屏文案。
• 已说明与生态系统的契合度。