parametric_forge

一个统一管理macOS与NixOS系统配置的Nix Flake基础设施仓库。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:parametric_forge。
它的用途是:一个统一管理macOS与NixOS系统配置的Nix Flake基础设施仓库。
完整的 Skill 内容见:https://321skill.com/skills/parametric-forge/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我的NixOS VPS需要新增一个服务用户并配置特定的SSH密钥,应该修改Parametric Forge里的哪个文件?” 它会引导你找到`hosts/context.nix`中对应主机的行,并解释如何添加用户和密钥字段。或者,当你在下游项目遇到工具链缺失时,它会提示你:“这个工具由Parametric Forge统一提供,请确保你的Forge配置已更新并重新部署系统。”

介绍

Parametric Forge是一个基于Nix Flake的系统配置管理仓库,旨在解决个人或团队在多台机器(如macOS工作站和Linux VPS)上维护一致、可复现的开发与系统环境的难题。它通过声明式配置,统一管理操作系统设置、GUI/CLI工具链、开发环境、字体、密钥、SSH配置乃至缓存策略,形成一个自包含的“机器资产”层。

使用方式是将此仓库作为Flake引用,通过定义不同的主机(host)配置(如macbook或maghz VPS)来生成具体的系统。其核心是hosts/context.nix文件,每台机器对应一行注册信息,包含系统架构、特性标志、用户身份等。修改配置后,通过Nix命令即可部署到对应主机,实现环境的同步与重建。

它非常适合追求基础设施即代码(IaC)、希望将个人或小团队的工作站与服务器环境进行版本化、模块化管理的全栈开发者、运维工程师或技术管理者。对于使用NixOS或希望在macOS上获得类似NixOS声明式管理体验的用户尤其有价值。

需要注意的是,此Skill要求使用者具备一定的Nix语言和Flakes使用基础。它并非一个即插即用的图形化工具,而是面向命令行和配置文件的底层基础设施。建议在熟悉Nix基础后,从克隆仓库、阅读docs/目录下的设计原则开始,逐步适配到自己的机器。

核心特点

与众多分散管理macOS(如通过Homebrew)和Linux配置的方案不同,Parametric Forge通过单一Flake统一声明并拥有整个“机器资产”,其下游项目(如Rasm, Maghz)仅依赖其输出的环境(PATH等)而不直接导入其代码,实现了配置的彻底解耦与单向依赖。

注意事项

不适合不熟悉Nix生态和命令行的初学者,或仅需管理单一操作系统简单配置的用户。

常见问题

Parametric Forge是做什么的?

它是一个用Nix Flake统一管理你多台电脑(比如苹果笔记本和Linux服务器)所有系统配置、软件和开发环境的代码仓库。

我需要会Nix才能用吗?

是的,需要具备基本的Nix和Flakes使用知识,因为它本质上是高级的Nix配置代码。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/parametric-forge/raw/index.md 读取 parametric_forge 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。