360 Secure SkillHub
360 安全技能中心

Context Onboarding

为新手贡献者与 Agent 提供工作区上下文导览：Python CLI 默认读取 SOUL.md、USER.md、AGENTS.md、TOOLS.md，打印每个文件开头若干行（默认 5 行）；支持 --files 追加文档、--lines 控制行数、--brief 只取首句、--workspace 切换工作区根目录。

crimsondevil333333
crimsondevil333333
热度 92.09
最近更新 2026-05-17 11:20:10
分类：知识依赖：代码执行 / 读写文件应用场景：摘要总结

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add context-onboarding
Metadata
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 <path>: Accepts extra markdown files (comma/space separated) that the script should include in the output order you provide.
  • --lines <n>: 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 <dir>: 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