引导同步
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 文档
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Node.js · Bun
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# bQuery AI Guidance Sync
## When to Use
Use this skill when release metadata, supported engines, public exports, or shared AI-facing repo guidance change.
Typical triggers:
- version bump in `package.json`
- engine floor changes for Node.js or Bun
- changes in public module exports
- refreshes to `AGENT.md`, `llms.txt`, or `.github/copilot-instructions.md`
- updates to `.cursorrules` or `.clinerules`
- changes to the guidance sync script
- release sweeps for README, docs, or changelog after a public-surface change
## Source of Truth
Trust these in order:
1. `package.json`
2. `src/*/index.ts`
3. `AGENT.md`
4. `docs/guide/*.md`
5. `CHANGELOG.md` for release deltas and migration context
## Procedure
1. Confirm the real version, engines, scripts, and exports in `package.json`.
2. Verify the current public runtime surface in the relevant `src/*/index.ts` barrels.
3. Update the shared AI-facing files as a synced set:
- `AGENT.md`
- `llms.txt`
- `.github/copilot-instructions.md`
- `.cursorrules`
- `.clinerules`
- `README.md`
- `CONTRIBUTING.md`
4. If public exports changed, re-check `src/full.ts`.
5. If the release messaging changed, update the relevant docs guides and `CHANGELOG.md`.
6. Run the repo sync check before finishing.
## Project-Specific Guardrails
- Keep the role split clear:
- `AGENT.md` = deep reference
- `llms.txt` = compact mirror
- `.github/copilot-instructions.md` = behavioral and meta guidance
- `.cursorrules` and `.clinerules` = derived snapshots
- Do not let the guidance files drift from `package.json` version or engine metadata.
- Avoid updating only one guidance file when the change obviously applies to the synced set.
## Required Validation
Run:
- `bun run check:ai-guidance`
Use additional validation as needed for the actual code or docs touched.
---
> Source: [bQuery/bQuery](https://github.com/bQuery/bQuery) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
章节与文件索引
按说明文件中的顺序排列。
何时使用
真理之源
程序
项目特定护栏
所需的验证
文件/命令 -> package.json · AGENT.md · llms.txt · .github/copilot-instructions.md · .cursorrules · .clinerules · src/*/index.ts · docs/guide/*.md
内容校验值 -> 35afbb9264fc
当前原文的自动摘译,尚未人工审校。
何时使用
在发布元数据、支持的引擎、公共导出或面向 AI 的共享存储库指南更改时使用此技能。典型触发因素:Node.js 的
package.json引擎底层更改中的版本提升或公共模块导出中的 Bun 更改真理之源
按顺序信任这些:
package.json``src/*/index.ts``AGENT.md``docs/guide/*.md程序
在
package.json中确认真实版本、引擎、脚本和导出。验证相关src/*/index.ts桶中当前的公共运行时表面。将面向 AI 的共享文件更新为同步集:AGENT.mdllms.txt项目特定护栏
保持角色划分清晰:
AGENT.md=深度参考llms.txt=紧凑镜像.github/copilot-instructions.md=行为和元指导.cursorrules和.clinerules=派生快照所需的验证
运行:
bun run check:ai-guidance根据实际代码或接触的文档的需要使用额外的验证。来源:bQuery/bQuery — 由 TomeVault 分发。