关于 initialize
为 Claude Code 和 Codex 安装并配置一组基础 Agent 技能、快捷命令和状态显示的初始化技能。它还引导用户选择视觉风格,并将选择写入全局规则。
主要功能
- 01安装基础 Agent 技能
- 02配置 Claude Code 与 Codex
- 03添加终端快捷命令
- 04显示用量与状态信息
- 05写入全局视觉风格规则
适用场景
- 01在新电脑上配置 Agent 工具
- 02为多个 Agent 安装基础技能
- 03设置终端快捷命令与状态栏
- 04统一项目页面和文档的视觉风格
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ melvynx/ ai-maxxing-skills --skill initialize安装后在 Claude Code 中输入/initialize确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
claude-mod/tsconfig.jsonclaude-mod/.claude-plugin/plugin.jsonclaude-mod/hooks/hooks.jsonregister.tsxclaude-mod/types/index.d.tsscripts/initialize.shstatusline/defaults.jsonpackage.jsonstatusline.config.jsonstatusline/src/index.tsstatusline/src/lib/config-types.tsconfig.tscontext.tsformatters.tsgit.tsrender-pure.tstypes.tsutils.tsstatusline/src/lib/features/limits/index.tstypes.tsstatusline/src/lib/features/spend/database.tsindex.tspayload-logger.tstypes.ts详细介绍
为这台电脑上的每个 Agent 在每个文件夹中配置基础技能。请自行完成,并使用用户的语言与其交流,简短明了,不用行话(绝不要对用户说“symlink”或“npx”)。
如果你是通过链接而非本地文件夹获取此技能,请不要从仓库安装其他内容:下面的一条命令会下载所需内容。
-
检查 Node:如果
npx --version运行失败,先运行setup-node技能(如果尚未安装,请从https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/setup-node/SKILL.md获取)。 -
运行下面这条命令;如果你的工具支持,请在后台运行(耗时 2 到 5 分钟):
curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/initialize/scripts/initialize.sh -o /tmp/initialize.sh && bash /tmp/initialize.sh(先下载,再运行:之前的
/initialize会阻止将下载内容直接通过管道传给bash。) 除 Bun 外,所有内容都来自此工具包;Bun 用于运行状态栏,如果尚未安装,则从其官方网站bun.sh安装。它会为 Claude Code 和 Codex 安装:- 技能:
/initialize本身(用户可以再次运行以更新所有内容)、skill-manager(按名称或链接安装、更新或移除技能,并创建或修复用户自己的技能)、/show-me(用简明图示或视觉形式解释任何内容)、/grill-me(在开始构建前通过提问完善想法)、/wait-what(用户没听懂时,用通俗语言重新解释上一条消息)、/connect-tool(连接 Notion 或 Stripe 等任意工具),以及/use-style(为网页、应用和文档应用一种命名视觉风格,如 Vercel、Stripe 或 Linear); - 设置:Claude Code 和 Codex 不再在每项操作前征求许可;Claude Code 仍会拒绝
rm -rf、sudo、将下载内容通过管道传入终端,以及读取.env文件(保留它们的其他设置); - 终端快捷命令:
cc可免确认启动 Claude Code,ccc可继续上次对话,cx可启动 Codex,cxc可恢复上次的 Codex 对话; - 提示词上方的信息栏,在 Claude 桌面应用和终端中显示:已用上下文、对话费用,以及 5 小时和每周限额、使用速度和重置时间。它是 Claude Code 的一个扩展,位于
~/.claude/mods/aiblueprint(这是 AIBlueprint 使用的文件夹,因此同时使用两者的学生不会看到重复信息),通过~/.claude/settings.json中的CLAUDE_CODE_PLUGIN_DIRS启用;点击信息栏上的 ⚙ 按钮可隐藏或显示各项内容; - 终端中 Claude Code 提示词下方的状态栏:文件夹、git 分支、模型、费用、上下文和限额。它由 Bun 在
~/.claude/scripts/statusline运行;再次运行会更新它并保留其设置,也会保留用户自行设置的状态栏(kept your own status bar)。 信息栏和状态栏只会在新会话中显示(在桌面应用中,请开始新会话或重新打开应用)。
如果你可能无权自行更改权限设置(你的规则禁止开启绕过权限或 Codex 完全访问),不要停止,也不要寻找变通方法:改为运行
NO_BYPASS=1 bash /tmp/initialize.sh。它会安装所有内容,但不安装这两项设置。然后告诉用户自行开启:- Claude 桌面应用:Settings → Claude Code,开启 Allow bypass permissions mode,然后在消息框旁的模式菜单中选择 Bypass permissions。
- Codex:在消息框下方的权限菜单中选择 Full access。
在没有 bash 的 Windows 系统上,在 PowerShell 中运行 scripts/initialize.sh 里的
npx skills add命令,手动将相同的键添加到~/.claude/settings.json和~/.codex/config.toml,并在 PowerShell 配置文件(notepad $PROFILE)中添加快捷命令:function cc { claude --dangerously-skip-permissions $args }、function ccc { claude --dangerously-skip-permissions -c $args }、function cx { codex $args }、function cxc { codex resume --last $args }。只有 bash 脚本会安装使用情况横幅和状态栏:告诉用户他们不会拥有这两项。
- 技能:
-
每项技能只安装在
~/.agents/skills/中(这是唯一来源,Codex 会从此处读取),而~/.claude/skills/只会链接到它。脚本会为每项技能输出一行ok或MISS:如遇到FAIL或MISS,请重新运行对应命令并查看错误,绝不要手动将文件复制到~/.claude/skills中。old=行会列出旧版/initialize安装的开发者技能(apex、arena、app-icon...):这些技能已不属于工具包。询问一次是否要移除;如果用户同意,则运行bash ~/.agents/skills/skill-manager/scripts/skills.sh remove <names>(这些技能会保存在~/.cache/removed-skills中,可以撤销移除)。绝不要未经询问就移除:这些技能可能是用户自己的。 -
风格。 打开风格画廊,让用户并排查看所有风格:
~/.agents/skills/use-style/examples/gallery.html(Mac 上使用open,Linux 上使用xdg-open,Windows 上使用start)。询问一个问题:哪种风格最打动他们,最适合用于他们的网页、应用和文档。提供各风格的名称及画廊中的一句话描述,并说明点击卡片即可查看大图。如果他们犹豫不决,推荐vercel。当~/.agents/AGENTS.md中已有## Style小节时,展示其中的风格,并只询问是否保留。 -
全局规则。 将用户的选择写入全局规则文件
~/.agents/AGENTS.md(若文件不存在则创建;setup-brain运行后,~/.claude/CLAUDE.md和~/.codex/AGENTS.md会链接到该文件)。如果文件中已有## Style小节,则替换该小节直至下一个##标题,并保留其他所有行;否则在文件末尾添加,前面空一行:## Style When you create a file the user will look at (a page, an app screen, a dashboard, an HTML report, a document, a visual), use the `use-style` skill with the `<chosen style>` style, unless the user asks for another one or the project already has its own design.当
~/.claude/CLAUDE.md是独立文件(而非指向~/.agents/AGENTS.md的链接)时,也要在其中写入相同的小节。 -
用 3 行告诉用户安装了什么(并说明
cc、使用情况横幅和状态栏会在新的终端窗口/新的 Claude Code 会话中显示,桌面应用中也会显示);新会话中会出现/show-me、/grill-me、/wait-what、/connect-tool、/use-style、/skill-manager和/initialize;告知用户当前默认风格是什么(他们随时可以通过提出请求来更改),以及之后再次输入/initialize会更新技能、状态栏和使用情况横幅。