@basenative/claude-config

中文文档
3.3.0发布于 2026/11/03Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 2355

Bundled Claude 代码子代理,技能,斜线命令,钩子,以及 DuganLabs / BaseNative 项目的设置. 进来吧 bn-claude install。 。 。 .

中文使用文档
文档目录11 节
  1. 安装
  2. 里面的东西
  3. 代理人( .claude/agents/ (中文(简体) )
  4. 技能( .claude/skills/ (中文(简体) )
  5. 斜线命令( E) .claude/commands/ (中文(简体) )
  6. 钩子 .claude/hooks/ (中文(简体) )
  7. 设置( E) .claude/settings.json (中文(简体) )
  8. CLI 参考
  9. 扩展
  10. CLAUDE.md 模板
  11. 许可证

@ aslative/ claude- config

Bundled Claude 代码子代理,技能,斜线命令,钩子,以及 DuganLabs / BaseNative 项目的设置.

每个DuganLabs项目都应该充分利用克洛德代码. 这个软件包是由代理,技能,命令,钩子,和设置组成的一连串, 将它丢入任何一个指令的回放中, 你得到同样的紧凑的工作流程.

安装

在任何应该获得 BaseNative Claude 代码配置的项目中:

npx @basenative/claude-config install

它写到 .claude/ (创建如果缺失). 保存现有文件,除非您通过 --force 或及时确认覆盖. settings.json 实值 从未覆盖 ——只有在缺失时才会创建.

当 BaseNative 船舶新模板更新时:

npx @basenative/claude-config update

校验和列表 :

bn-claude verify
bn-claude list

里面的东西

代理人(.claude/agents/(中文(简体) )

探员何时援引
基底-包装-作者设计或脚手架 @basenative/* 软件包 – 生产 package.json, project.json, src/index.js, 测试骨架, README.
笔名作者从新想法写一个 PRD —— 一次采访用户一个问题, 写 docs/PRD.md。 。 。 .
光谱作者脚手架上刻有图文/相克风格 specs/NNN-slug/spec.md 带有FR/NFR识别码和Given/When/随后的情景.
参考调动医生诊断出Cloudflare部署失败——命名原因(绑定,env,迁移,秘密)并给出精确的补救.
og-图像设计器使用 @basenative/og-image 预设 DSL — 提出3个变体.
认证-移民规划计划分阶段从快递会议/下届奥地利/圣卢西亚/办事员向 @basenative/auth-webauthn。 。 。 .

技能(.claude/skills/(中文(简体) )

技能触发
基底平面图"X是否有BaseNative模式"——搜索 packages/* 并用工作片段或"不,这就是缺口"来回答
由 prd 驱动的问题将 PRD 部分转换为 即时的 GitHub 发行机构 .
dl -多普勒设置走过一个项目的多普勒设置——登录,项目,配置,npm脚本接线,CF桥.
dl-参照有约束力添加 Cloudflare 绑定( D1/ KV/ R2/ DO/ 队列/ 服务) 到 wrangler.toml 第一次是对的.
dl -wcag - 审计驱动 Claude Preview / Chrome MCP 注入轴核心, 运行审计, 生成 docs/a11y-audit-YYYY-MM-DD.md。 。 。 .

斜线命令( E).claude/commands/(中文(简体) )

命令它会做什么
/bn-init <name>脚手架 一个新的 BaseNative 项目 + 安装此配置 .
/bn-prd调出活字作者子剂.
/bn-spec <slug>引出相克-相克-相克-相克子剂.
/bn-doctor运行 bn doctor 并提议修正.
/bn-deploy [--env]明确确认部署和部署后日志尾翼.

钩子.claude/hooks/(中文(简体) )

钩子连接为目的
pre-commit-secret-scan.shUserPromptSubmitBlock 承诺包含 AWS / GitHub / Frede / Anthropic / Slack / Doppler 秘密 .
post-tool-edit-format.shPostToolUse (编辑-写作)在刚刚编辑的文件上运行更美 .
pre-bash-deploy-confirm.shPreToolUse (巴什语)屏蔽任意 wrangler deploy 编号 : wrangler secret put / 有破坏性的 D1 SQL 直至重新确认.

设置( E).claude/settings.json(中文(简体) )

模板 :

  • 允许安全操作( E)ls, (中文(简体) ), rg, (中文(简体) ), git status/diff/log, (中文(简体) ), pnpm test/lint/build, (中文(简体) ), wrangler whoami, (中文(简体) ), gh pr list) (中文(简体) ).
  • 要求有风险的人(git push, (中文(简体) ), pnpm publish, (中文(简体) ), wrangler deploy, (中文(简体) ), wrangler secret put, (中文(简体) ), gh pr create/merge) (中文(简体) ).
  • D. 灾难性的拒绝rm -rf /, (中文(简体) ), git push --force, (中文(简体) ), curl | sh) (中文(简体) ).
  • 接上三通钩.

编辑 .claude/settings.local.json 个人的扭伤 - settings.json 是团队合同.

CLI 参考

bn-claude install [--root DIR] [--force] [--dry-run] [--quiet]
bn-claude update  [--root DIR]               # alias for install --force
bn-claude verify  [--root DIR]
bn-claude list    [--root DIR]
bn-claude help

零运行时间依赖关系. 纯节点 parseArgsANSI代码内置.

扩展

要添加新的代理/ 技能/ 命令 :

  1. 将带有 YAML 前题的标记下文件放入此包中相应的目录 .
  2. 弹出版本, pnpm publish。 。 。 .
  3. 消费者经营 bn-claude update。 。 。 .

关于代理/技能/命令格式化惯例,见Anthropic的文件:

CLAUDE.md 模板

CLAUDE.md.tmpl 包含在还没有内存文件的项目中. bn-claude install 放弃它作为 CLAUDE.md (只在缺失的情况下). 填写 {{PROJECT_NAME}}, (中文(简体) ), {{ONE_LINE_PITCH}}等 (中文(简体) ).

许可证

阿帕奇2.0 (英语). 由 BaseNative 所建 — baseNative.dev 所建 :

版本与发布记录

@basenative/claude-config 共发布 14 个版本,首次发布于 2026/10/18;过去 12 个月发布了 14 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.3.0latest2026/11/034 天前
3.2.02026/11/035 天前
3.1.02026/11/017 天前
3.0.02026/10/317 天前
2.4.02026/10/2612 天前
2.3.22026/10/2216 天前

关于 @basenative/claude-config 的常见问题

@basenative/claude-config 是什么?

Bundled Claude 代码子代理,技能,斜线命令,钩子,以及 DuganLabs / BaseNative 项目的设置. 进来吧 bn-claude install。 。 。 .

如何安装 @basenative/claude-config?

在项目目录运行 npm install @basenative/claude-config,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bn-claude,可以用 npx bn-claude 直接运行。

@basenative/claude-config 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/basenative__claude-config 是否存在。

@basenative/claude-config 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@basenative/claude-config 可以商用吗?

@basenative/claude-config 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@basenative/claude-config 的下载量有多少?

根据 npm 官方下载统计,@basenative/claude-config 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,355 次,日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@basenative/claude-config 还在维护吗?

最新版本 3.3.0 发布于 2026/11/03(4 天前);至今共发布 14 个版本,其中过去 12 个月发布了 14 个;首次发布于 2026/10/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。