@ abblor/ 代理服务器
技能、工作流程、内存、规格、章程、钩子和AI的规则 编码代理( Claude Code, GitHub 副驾驶 CLI, Cursor等) 工作 横跨 ablor repos 工程。 把它看作是共同的"操作" aI代理商在这些代码库中的行为:
- 规则 (内核政策)——每个代理人必须遵循不可谈判的法律.
- 技能 (驱动器)——方法与堆栈特有诀窍代理商 每个任务加载.
- 内存 编号 : 钩子 (运行时间服务)——自修伐木和 寿命周期执法.
- 规格 编号 : 宪法 - 共享文件模板和 每个缩略语 repos项目继承的通用规则.
见 NOTICE.md 属性: 此软件包捆绑和
适应麻省理工学院许可的内容
obra/超能力 财务报告和审定财务报表
Sahir619 可行办法, (中文(简体) ),
与一个内部编写的扩展技能图书馆。 许可证根据
麻省理工学院。见 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)
在项目中采用此软件包
- 安装数字 :
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/<Project>-Domain-Expert/)和项目拥有的基特钩
被保留下来.
版本政策:每个消费者必须申报
"@abblor/agent-os": "latest"内package.json释放后, 运行npm update @abblor/agent-os刷新锁文件并安装 最新发布的软件包。 不要钉上精确的版本或范围.
-
脚手架您项目自己的定制文件 (一次):
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并填入占位符. 从不 覆盖已存在的文件 ——增加新内容后可以安全地重新运行 上游工作流程模板. -
指向您的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——抄入). -
Git 钩自动安装 —— 说
npm install已经运行 页:1commit-msg财务报告和审定财务报表pre-push钩入.git/hooks/作为 步骤 2'spostinstall步骤(只要.git/已经存在于 安装时间和否--ignore-scripts使用了旗帜)。 以 :ls -la .git/hooks/commit-msg .git/hooks/pre-push如果缺少一个( 例如您运行)
git init之后npm install, (中文(简体) ), 或使用过的--ignore-scripts,重新运行npx agent-os link-或者说 手动安装 :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: <Tool Name>拖动到默认的每次任务( 如 GitHub 副驾驶 CLI, 除非 )). Zero AI 水印政策被禁词列表 包括工具名称,例如copilot编号 :claude编号 :chatgpt,所以一个承诺 带着这样的拖车 将被屏蔽 被这个钩子安装过. 或配置您的 AI 工具, 在重置时省略预览 这个钩子,或者不安装钩子 如果你依赖它 透明度/审计目的——两者目前不相容. -
添加承诺信息CI 备份 (可选的,选入的——只添加) 一旦您已有的承诺历史已经符合,因为它会 不履行任何承诺的公关:
npx agent-os init --with-ci脚手架
.github/workflows/enforce-commit-msg.yml,执行 常规承诺和关于每项承诺的零AI水印政策 在牵引请求中——CI级检查不能绕过方式 上方的地基钩可以(例如:.git commit --no-verify) (中文(简体) ). -
填写
.agents/rules.md第1节 任何规则,你独有的 不属于共同宪法的项目.
更新
每个消费者都必须使用 latest dis. 刷新到最近发布的
软件包并更新锁定文件 :
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
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 旁边的您指阶:
- run: npx agent-os check
审查 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
重置, 在 agent-os/。如果一个技能或规则 你添加是真正的
除了一个项目之外,请在这里提出,而不是保留在本地
见 skills/writing-skills/SKILL.md 用于编写指南.
运行 npm test 从 agent-os/ 在打开公关之前,它会装入真实的
柏油球,安装到抓取目录和练习中 agent-os link编号 :agent-os init 端到端(偶发性,同位素-连接处理,
占位符替换,永不覆盖行为).