# @abblor/agent-os 中文文档 规范地址：https://npmcn.com/package/%40abblor/agent-os/ 版本：0\.17\.0 npm 元数据更新时间：2026-11-08T10:01:12.640Z 中文译文更新时间：2026-11-08T10:02:06.447Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40abblor/agent-os 原文对照：https://npmcn.com/package/%40abblor/agent-os/?lang=original 项目主页：https://github.com/abblor/packages#readme 源码仓库：https://github.com/abblor/packages ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.3 MB，175 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=20\.0\.0 - 运行依赖：0 个 - 首次发布：2026-07-28T15:52:52.807Z - 最新版本发布：2026-11-08T10:01:12.421Z - 近 30 天下载量：1909（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：28（近 12 个月 28 个） ## 中文简介 技能,工作流程,内存,规格,宪法,钩子,以及从事abblor repos项目的AI编码代理的规则. ## 安装 ```sh npm install @abblor/agent-os ``` 也可以使用：`pnpm add @abblor/agent-os`、`yarn add @abblor/agent-os`、`bun add @abblor/agent-os` ## README # @ abblor/ 代理服务器 技能、工作流程、内存、规格、章程、钩子和AI的规则 编码代理( Claude Code, GitHub 副驾驶 CLI, Cursor等) 工作 横跨 ablor repos 工程。 把它看作是共同的"操作" aI代理商在这些代码库中的行为: - **规则** (内核政策)——每个代理人必须遵循不可谈判的法律. - **技能** (驱动器)——方法与堆栈特有诀窍代理商 每个任务加载. - **内存** 编号 : **钩子** (运行时间服务)——自修伐木和 寿命周期执法. - **规格** 编号 : **宪法** - 共享文件模板和 每个缩略语 repos项目继承的通用规则. 见 [`NOTICE.md`](https://npmcn.com/package/%40abblor/agent-os/NOTICE.md) 属性: 此软件包捆绑和 适应麻省理工学院许可的内容 [obra/超能力](https://github.com/obra/superpowers) 财务报告和审定财务报表 [Sahir619 可行办法](https://github.com/Sahir619/fable-method), (中文(简体) ), 与一个内部编写的扩展技能图书馆。 许可证根据 [麻省理工学院](https://npmcn.com/package/%40abblor/agent-os/LICENSE)。见 [`CHANGELOG.md`](https://npmcn.com/package/%40abblor/agent-os/CHANGELOG.md) 为释放历史. ## 里面的东西 ``` agent-os/ skills/ 40 skills: core methodology (superpowers), extended stack skills (web-ui, api-design, avd, docker-expert, ...) + the fable-method family (fable-method, fable-loop, fable-judge, fable-domain), plus SKILL_INDEX.template.md and consolidation-manifest.json workflows/ *.template.md workflow scripts (build-feature, check-docker) constitution/ constitution.md — universal, non-negotiable rules rules/ rules.template.md — thin per-project rules layer specs/ app-blueprint.template.md — SRS/Architecture/Features documentation templates memory/ lessons-template.md — cross-project lessons log format hooks/ agent/ agent lifecycle hook conventions + reference configs (Claude Code SessionStart/PreToolUse, etc.) git/ real git hooks (commit-msg, pre-push) enforcing the constitution regardless of which agent tool is used ci/ enforce-commit-msg.template.yml — GitHub Actions CI-level backstop for the constitution's Conventional Commits + Zero AI Watermark Policy rules test/ automated tests for bin/cli.js (npm test) ``` ## 在项目中采用此软件包 1. **安装**数字 : npm 安装 -- save- dev@abblor/ agent-os@latest npm pkg 设置“ devDependencys . @abblor/ agent- os=latest ” npm 更新 @abblor/ agent-os -- package-lock- only ```` 2. **Link the shared, generic content** (skills, hooks, constitution) into your repo's `.agents/`: ```bash npx agent-os link ```` 这将创建连锁, 并通过此软件包自动运行 拥有 `postinstall` 每页脚本 `npm install` 技能/宪法/ 钩子从头开始就保持零手动步骤 继续复制 软件包拥有的路径用链接替换已过时的本地副本 到已安装的软件包。 仅限App技能(如:. `.agents/skills/-Domain-Expert/`)和项目拥有的基特钩 被保留下来. > **版本政策**:每个消费者必须申报 `"@abblor/agent-os": "latest"` 内 `package.json`释放后, 运行 `npm update @abblor/agent-os` 刷新锁文件并安装 最新发布的软件包。 不要钉上精确的版本或范围. 3. **脚手架您项目自己的定制文件** (一次): ```bash npx agent-os init ``` 交互提示您的工程名称/ slug/ 域名( 或通过) `--name`, (中文(简体) ), `--slug`, (中文(简体) ), `--domain`, (中文(简体) ), `--yes` 供非交互式使用)和 写入 `.agents/rules.md`, (中文(简体) ), `.agents/app-blueprint.md`, (中文(简体) ), `.agents/skills/SKILL_INDEX.md`, (中文(简体) ), `.agents/workflows/*.md`,以及 `.agents/tasks/lessons.md` 并填入占位符. **从不 覆盖已存在的文件** ——增加新内容后可以安全地重新运行 上游工作流程模板. 4. **指向您的IDE/代理工具 `.agents/`**: 确保 `.cursorrules`, (中文(简体) ), `.github/copilot-instructions.md`, (中文(简体) ), `AGENTS.md`,或同等指示 要读的代理 `/.agents/constitution/constitution.md`, (中文(简体) ), `/.agents/rules.md`, (中文(简体) ), `/.agents/app-blueprint.md`,以及 `/.agents/skills/SKILL_INDEX.md` 开始任何任务之前(本文本为 现成 `constitution.md` §0——抄入). 5. **Git 钩自动安装** —— 说 `npm install` 已经运行 页:1 `commit-msg` 财务报告和审定财务报表 `pre-push` 钩入 `.git/hooks/` 作为 步骤 2's `postinstall` 步骤(只要 `.git/` 已经存在于 安装时间和否 `--ignore-scripts` 使用了旗帜)。 以 : ```bash ls -la .git/hooks/commit-msg .git/hooks/pre-push ``` 如果缺少一个( 例如您运行) `git init` _之后_ `npm install`, (中文(简体) ), 或使用过的 `--ignore-scripts`,重新运行 `npx agent-os link` -或者说 手动安装 : ```bash ln -sf ../../.agents/hooks/git/commit-msg .git/hooks/commit-msg ln -sf ../../.agents/hooks/git/pre-push .git/hooks/pre-push ``` 永远也不要打出一个真正的(非同义的)钩子 胡斯基,左撇子,或你自己的剧本——它警告并放过那些人. > **卡维特**: 一些AI工具添加自己的 `Co-authored-by: ` 拖动到默认的每次任务( 如 GitHub 副驾驶 CLI, 除非 )). Zero AI 水印政策被禁词列表 包括工具名称,例如 `copilot`编号 :`claude`编号 :`chatgpt`,所以一个承诺 带着这样的拖车 **将被屏蔽** 被这个钩子安装过. 或配置您的 AI 工具, 在重置时省略预览 这个钩子,或者不安装钩子 如果你依赖它 透明度/审计目的——两者目前不相容. 6. **添加承诺信息CI 备份** (可选的,选入的——只添加) 一旦您已有的承诺历史已经符合,因为它会 不履行任何承诺的公关: ```bash npx agent-os init --with-ci ``` 脚手架 `.github/workflows/enforce-commit-msg.yml`,执行 常规承诺和关于每项承诺的零AI水印政策 在牵引请求中——CI级检查不能绕过方式 上方的地基钩可以(例如:. `git commit --no-verify`) (中文(简体) ). 7. **填写 `.agents/rules.md` 第1节** 任何规则,你独有的 不属于共同宪法的项目. ## 更新 每个消费者都必须使用 `latest` dis. 刷新到最近发布的 软件包并更新锁定文件 : ```bash npm update @abblor/agent-os npx agent-os check # confirm every new skill is routed in your SKILL_INDEX.md ``` 保留 `"@abblor/agent-os": "latest"` 在消费清单中。 一个普通的 `npm update @abblor/agent-os` 安装最新发布的版本及其 邮购自动刷新软件包拥有的技能、章程和 吉特钩子. 没有每个项目的审批政策、标志设置或人工再链接 这是需要的。 一揽子宪法是唯一的执行政策所有人: 长期授权涵盖当前和未来功能推力和PR 合并,而直接主/主推仍被禁止. `npm ci` 故意安装已记录的锁文件; `latest` 已经 不得推翻可复制性担保。 刷新并提交锁文件 在通过释放时。 已禁用寿命周期脚本的安装无法运行 自动设置; 使用普通的脚本启用安装, 或运行 `agent-os link` 作为明确的恢复命令。 软件包不修改依赖性 版本通过嵌入式安装在邮站内部. `link` 也为通过软件包升级而退休的技能提供僵硬的同音链接,但只有当 链接目标是一个直接的孩子 `skills/` 目录. App-lean技能目录和项目拥有的同义链接永远不会被删除. 软件包 路径总是链接到已安装的 npm 软件包, 替换已过时的本地副本 。 因为 `init` 从未覆盖消费者定制的 `SKILL_INDEX.md`,跟踪释放迁移 路由重命名和运行的注释 `agent-os check` 后结. 新发行可以增加技能. `link` 把它们连在一起,但每个项目 保留 **其本身** `.agents/skills/SKILL_INDEX.md` —— 此模板 软件包是脚手架 `init`而不是一个活的连锁——所以新加的 在为它添加一行路径之前, 技能对代理是看不见的。 这是 什麽 `agent-os check` 用于; 连接到 CI( 见下文) , 因此空隙失败 一个建筑而不是无人注意. ## 验证消费者 `agent-os check` ```bash npx agent-os check # exits non-zero if the wiring is broken ``` 它在以下时间失败 : - 4个强制文件之一(`constitution/constitution.md`, (中文(简体) ), `rules.md`, (中文(简体) ), `app-blueprint.md`, (中文(简体) ), `skills/SKILL_INDEX.md`缺少或 无法读取 - 任何符号链接在 `.agents/` 起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起 `npm install`,或之后 `npm install --omit=dev` - 技能安装在 `.agents/skills/` 但从未提到过 `SKILL_INDEX.md`,所以没有代理可以永远装入 - `SKILL_INDEX.md` 通向不存在的技能(或工作流程路径)的路径 它毫不迟疑地警告,当某一技能被编入索引时 由任何“必要技能”一行引用,因为代理匹配的任务与 路线表. 把它添加到CI 旁边的您指阶: ```yaml - run: npx agent-os check ``` 审查 [`CHANGELOG.md`](https://npmcn.com/package/%40abblor/agent-os/CHANGELOG.md) 对于在撞倒之前所发生的变化, 并登陆 `package.json`编号 :`package-lock.json` 通过你的正常 公关程序。 保持显示的规格 `latest`,包括当npm的 保存精确的设置将另写一个版本。 锁定文件记录 混凝土安装放出供再生产建造. 文件脚手架 `init` (规则.md,应用蓝印.md, SKILL INDEX.md, 工作流程/\*.md,任务/教训.md)属于你的进取—— `init` 永远不会 覆盖他们。 如果上游模板以某种方式变化,则要拉动 中,通过手动进行对比 `node_modules/@abblor/agent-os` 合并 手给我. ## 平台要求 `agent-os link` 依赖真实的文件系统连锁( 其中130+ 横跨) 技能、宪法和钩子。 这在Linux 和 macOS 上是本土操作的. **目前没有验证或支持Windows**数字 : `git` 仅在窗口上 将符号链接作为真实的符号链接 `core.symlinks=true` 设定 _财务报告和审定财务报表_ 用户已启用开发者模式( 或作为管理员运行) - 在不同时包含两个字的情况下,检查出符号链接成为包含以下字段的纯文本文件: 链接目标路径,默默地打破 每一个技能,宪法,和 钩子 如果您的团队在 Windows 上开发, 请明确验证 在通过此软件包之前,或使用 WSL . ## 提供新技能或修补现有技能 此软件包发布于 [`abblor/packages`](https://github.com/abblor/packages) 重置, 在 `agent-os/`。如果一个技能或规则 你添加是真正的 除了一个项目之外,请在这里提出,而不是保留在本地 见 `skills/writing-skills/SKILL.md` 用于编写指南. 运行 `npm test` 从 `agent-os/` 在打开公关之前,它会装入真实的 柏油球,安装到抓取目录和练习中 `agent-os link`编号 :`agent-os init` 端到端(偶发性,同位素-连接处理, 占位符替换,永不覆盖行为). ## 常见问题 ### @abblor/agent-os 是什么？ 技能,工作流程,内存,规格,宪法,钩子,以及从事abblor repos项目的AI编码代理的规则\. ### 如何安装 @abblor/agent-os？ 在项目目录运行 npm install @abblor/agent-os，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-os，可以用 npx agent-os 直接运行。 ### @abblor/agent-os 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/abblor\_\_agent-os 是否存在。 ### @abblor/agent-os 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @abblor/agent-os 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @abblor/agent-os 可以商用吗？ @abblor/agent-os 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @abblor/agent-os 的下载量有多少？ 根据 npm 官方下载统计，@abblor/agent-os 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,909 次，日均约 64 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @abblor/agent-os 还在维护吗？ 最新版本 0\.17\.0 发布于 2026/11/08（今天）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/07/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。