什么是 背景引导？

背景引导 (Context Onboarding) 技能是 Openclaw 技能生态系统中的一个基本工具，旨在为进入新工作区环境的任何人提供即时清晰的指导。通过程序化解析 SOUL.md、USER.md 和 AGENTS.md 等核心身份文件，它提供了关于性格、操作限制和工具偏好的高层概览。这确保了 AI 代理和人类开发者都能在不手动阅读冗长文档的情况下，与项目的风格和技术标准保持一致。

下载入口:https://github.com/openclaw/skills/tree/main/skills/crimsondevil333333/context-onboarding

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

背景引导 应用场景

• 引导新贡献者了解工作区性格和操作规则。
• 在会话期间快速提醒代理语气偏好或工具限制。
• 比较多个工作区或仓库克隆之间的身份文档。
• 使用简要输出模式为同步会议准备闪电般的摘要。

1. 脚本扫描工作区根目录，以查找默认身份文件，如 SOUL.md 和 AGENTS.md。
2. 它从每个文件中解析可配置的行数，以创建易于管理的摘要。
3. CLI 处理可选标志，以包含其他文档或调整详细程度。
4. 生成的输出提供关于角色、规则和工具说明的浓缩简报，供即时参考。

背景引导 配置指南

要在工作区中开始使用此技能，请导航至脚本目录并执行 python 入口点：

# 身份文档的基本摘要
python3 skills/context-onboarding/scripts/context_onboarding.py

# 包含自定义文件和行数的摘要
python3 skills/context-onboarding/scripts/context_onboarding.py --files docs/PLAYBOOK.md --lines 2

背景引导 数据架构与分类体系

name: context-onboarding
description: Provide new contributors and agents with a concise tour of the workspace identity files (SOUL.md, USER.md, AGENTS.md, TOOLS.md) plus onboarding tips. Use when a newcomer needs context or when you want to double-check how this workspace is configured.

Context Onboarding

When to use this skill

• You're guiding someone new through Clawdy/Clawd and want a quick summary of the personality, operating rules, and per-skill notes.
• You need to remind yourself of the tone preferences or tooling constraints without reading every document top to bottom.

What it does

• scripts/context_onboarding.py reads the key documents (SOUL.md, USER.md, AGENTS.md, TOOLS.md by default) and prints the first few lines of each so you can skim character, rules, and tooling notes.
• The CLI supports --files to include additional documents, --lines to control how many lines are shown per file, and --brief to emit only the opening sentence of each section.
• Use references/context-guidelines.md when you need more guidance about what newcomers should read next or how to keep the vibe consistent.

CLI usage

• python3 skills/context-onboarding/scripts/context_onboarding.py summarizes the default identity docs and prints the first five lines per file.
• Add --files docs/PLAYBOOK.md docs/ROLE.md to weave in extra reference material that onboards the newcomer to cadence notes or release rituals.
• Pair --lines 2 with --brief to emit single-line headlines when you just need the gist.
• --workspace /path/to/other-workspace lets you compare multiple workspaces or prepare summaries for a sister repo before pairing.

Example command

python3 skills/context-onboarding/scripts/context_onboarding.py --files references/context-guidelines.md HEARTBEAT.md --lines 2

This prints the opening two lines for the personality files plus the heartbeat and onboarding guide so you can review vibe, reminders, and cadence expectations without opening every file.

Options

• --files : Accepts extra markdown files (comma/space separated) that the script should include in the output order you provide.
• --lines : Controls how many lines from each file are shown (default 5) so you can tighten or loosen the briefing.
• --brief: Shrinks each preview to the first sentence (splitting on ., ?, or !). Use this for lightning summaries during sync calls.
• --workspace : Point the CLI at another workspace root; useful for onboarding clones, reviewing experimental docs, or prepping a new repo.

References

• references/context-guidelines.md documents onboarding topics, role expectations, cadence notes, and reminders for how this group runs.

Resources

• GitHub: https://github.com/CrimsonDevil333333/context-onboarding
• ClawHub: https://www.clawhub.ai/skills/context-onboarding