# @basenative/claude-config 中文文档

规范地址：https://npmcn.com/package/%40basenative/claude-config/

版本：3\.3\.0
npm 元数据更新时间：2026-11-03T01:38:23.478Z
中文译文更新时间：2026-11-07T21:52:20.802Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40basenative/claude-config
原文对照：https://npmcn.com/package/%40basenative/claude-config/?lang=original
项目主页：https://github.com/DuganLabs/BaseNative/tree/main/packages/claude-config#readme
源码仓库：https://github.com/DuganLabs/BaseNative

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：72.6 kB，29 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-18T05:29:03.283Z
- 最新版本发布：2026-11-03T01:38:23.132Z
- 近 30 天下载量：2355（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

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

## 安装

```sh
npm install @basenative/claude-config
```

也可以使用：`pnpm add @basenative/claude-config`、`yarn add @basenative/claude-config`、`bun add @basenative/claude-config`

## README

# @ aslative/ claude- config

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

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

## 安装

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

```bash
npx @basenative/claude-config install
```

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

当 BaseNative 船舶新模板更新时:

```bash
npx @basenative/claude-config update
```

校验和列表 :

```bash
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.sh` | `UserPromptSubmit` | Block 承诺包含 AWS / GitHub / Frede / Anthropic / Slack / Doppler 秘密 . |
| `post-tool-edit-format.sh` | `PostToolUse` (编辑-写作) | 在刚刚编辑的文件上运行更美 . |
| `pre-bash-deploy-confirm.sh` | `PreToolUse` (巴什语) | 屏蔽任意 `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
```

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

## 扩展

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

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

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

-   [https://docs.claude.com/en/docs/claude-code/分代理商](https://docs.claude.com/en/docs/claude-code/sub-agents)
-   [https://docs.claude.com/en/docs/claude-code/技能](https://docs.claude.com/en/docs/claude-code/skills)
-   [https://docs.claude.com/en/docs/claude-code/slash-commands 页面存档备份,存于互联网档案馆](https://docs.claude.com/en/docs/claude-code/slash-commands)
-   [https://docs.claude.com/en/docs/claude-code/设置](https://docs.claude.com/en/docs/claude-code/settings)

## CLAUDE.md 模板

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

## 许可证

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

## 常见问题

### @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 和提交记录判断。