Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Growth Assisted Coding

growth-assisted-coding 是一个可同时用于 Codex 和 Claude Code 的 Agent Skill,用来把 AI 编程从“只帮你把活干完”,调整成“在真实任务里辅助成长”。

它适合新人接手项目、学习开源工程、完成业务开发、修 bug、做阶段成长规划等场景。目标不是让 AI 讲更多课,也不是让新人绕开真实任务,而是在 AI 协作过程中把关键学习动作留下来:

  • 任务开始前先做能力校准
  • 输出任务卡或学习卡
  • 按层级接手陌生项目
  • 在关键判断点解释为什么这样做
  • 明确验证方式
  • 任务结束后做复盘
  • 按需在当前工作区记录成长轨迹

适用场景

当你希望 Codex 或 Claude Code 做下面这些事时,可以使用这个 Skill:

  • 带新人完成一个真实编码任务
  • 接手一个陌生的已有项目
  • 阅读开源工程并准备第一次贡献
  • 规划新人阶段性成长路径
  • 复盘一次 AI 辅助编码到底学到了什么
  • 在不牺牲业务交付的前提下,保留项目学习记录

仓库结构

.
├── growth-assisted-coding/      # 真正的 Agent Skill 目录
│   ├── SKILL.md
│   ├── agents/openai.yaml
│   └── references/
├── scripts/
│   ├── install.ps1
│   ├── install.sh
│   └── validate.ps1
├── README.md
└── LICENSE

需要安装到 AI 编程工具里的只有 growth-assisted-coding/ 这个子目录。仓库根目录的 README.mdLICENSEscripts/ 是给人看的说明和辅助脚本,不属于 Skill 本体。

这个 Skill 使用通用的 SKILL.md 目录结构:

  • Codex:复制到 ~/.codex/skills/growth-assisted-coding/
  • Claude Code 个人级:复制到 ~/.claude/skills/growth-assisted-coding/
  • Claude Code 项目级:复制到当前项目的 .claude/skills/growth-assisted-coding/

快速安装

Windows PowerShell

git clone https://github.com/crazywen/growth-assisted-coding.git
cd growth-assisted-coding
.\scripts\install.ps1

安装到 Claude Code:

.\scripts\install.ps1 -Target claude

同时安装到 Codex 和 Claude Code:

.\scripts\install.ps1 -Target both

macOS / Linux

安装到 Codex:

git clone https://github.com/crazywen/growth-assisted-coding.git
cd growth-assisted-coding
bash scripts/install.sh

安装到 Claude Code:

bash scripts/install.sh claude

同时安装到 Codex 和 Claude Code:

bash scripts/install.sh both

安装脚本会把 Skill 复制到对应目录:

  • Windows 已设置 CODEX_HOME 时:$env:CODEX_HOME\skills\growth-assisted-coding
  • Windows 未设置 CODEX_HOME 时:$HOME\.codex\skills\growth-assisted-coding
  • macOS / Linux:${CODEX_HOME:-$HOME/.codex}/skills/growth-assisted-coding
  • Claude Code:$HOME\.claude\skills\growth-assisted-coding$HOME/.claude/skills/growth-assisted-coding

安装完成后,如果 Codex 或 Claude Code 已经在运行,请重启对应工具,让 Skill 列表刷新。

手动安装

也可以直接复制目录。

Codex:

growth-assisted-coding/ -> ~/.codex/skills/growth-assisted-coding/

Claude Code 个人级:

growth-assisted-coding/ -> ~/.claude/skills/growth-assisted-coding/

Claude Code 项目级:

growth-assisted-coding/ -> <your-project>/.claude/skills/growth-assisted-coding/

Windows PowerShell 示例:

$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
New-Item -ItemType Directory -Force -Path (Join-Path $codexHome "skills") | Out-Null
Copy-Item -Recurse -Force .\growth-assisted-coding (Join-Path $codexHome "skills\growth-assisted-coding")

Claude Code 个人级 Windows PowerShell 示例:

$claudeHome = Join-Path $HOME ".claude"
New-Item -ItemType Directory -Force -Path (Join-Path $claudeHome "skills") | Out-Null
Copy-Item -Recurse -Force .\growth-assisted-coding (Join-Path $claudeHome "skills\growth-assisted-coding")

使用示例

在 Codex 中可以用 $growth-assisted-coding 明确触发;在 Claude Code 中可以用 /growth-assisted-coding 明确触发,也可以让 Claude 根据描述自动判断是否加载。

接手陌生项目:

使用 $growth-assisted-coding 带我接手这个项目。先不要直接读函数细节,请先帮我建立技术栈角色导览和项目全景地图。

Claude Code 写法:

/growth-assisted-coding 带我接手这个项目。先不要直接读函数细节,请先帮我建立技术栈角色导览和项目全景地图。

带新人修 bug:

使用 $growth-assisted-coding 带新人完成这个 bug 修复。业务交付优先,但请在入口定位、风险判断和验证设计处停下来解释。

规划成长路径:

使用 $growth-assisted-coding 规划一个新人 4 周成长路径。目标是能看懂项目主链路,并能完成低风险 bug 修复。

本地校验

如果你的 Codex 环境里有系统自带的 skill-creator,可以运行:

.\scripts\validate.ps1

在 Windows 上,校验脚本会自动设置 PYTHONUTF8=1,避免中文 Skill 文件在默认编码下触发 UnicodeDecodeError

使用边界

  • 这个 Skill 不能替代导师、代码 review 或真实项目反馈。
  • 不能因为 AI 总结了资料,就登记为“新人已经学会”。
  • 能力判断要来自具体任务证据,例如复述、定位、验证、代码 review 或用户确认。
  • 成长记录应该保存在使用者自己的工作区,不要把私人成长记录、项目敏感信息或业务数据提交到这个公开仓库。

Claude Code 兼容说明

Claude Code 会从 ~/.claude/skills/、项目 .claude/skills/ 和插件内置 skills 目录发现 Skill。每个 Skill 是一个包含 SKILL.md 的目录,description 用来帮助 Claude 判断何时自动加载,也可以通过 /growth-assisted-coding 直接触发。

本仓库的 growth-assisted-coding/SKILL.md 只使用 namedescription 这类基础 frontmatter 字段,没有绑定 Codex 专属字段,因此可直接作为 Claude Code Skill 使用。

License

MIT

About

ai coding growth assist

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages