context-onboarding

context-onboarding 是一个专为 Clawdy/Clawd 工作空间设计的轻量级 CLI 导览工具，旨在帮助新成员快速理解项目的工作空间身份配置。该技能通过 Python 脚本读取 SOUL.md、USER.md、AGENTS.md、TOOLS.md 等核心身份文件，并生成结构化的内容摘要，让新人在不翻阅大量文档的情况下，迅速掌握项目的性格设定、操作规则和工具约束。

核心用法十分直观。用户通过命令行运行 context_onboarding.py，默认会读取工作目录下的四份标准身份文件，每份展示前五行内容。通过 --files 参数可灵活添加额外的参考文档，如 HEARTBEAT.md 或自定义的 PLAYBOOK.md；--lines 参数控制展示行数，适合不同深度的需求；--brief 模式则仅输出每份文件的首句，适用于会议中的闪电同步；--workspace 参数支持跨工作空间对比，方便管理多个相似项目。

显著优点体现在其极简架构和高度透明性。工具完全基于 Python 标准库开发，无第三方依赖，避免了供应链攻击风险；功能单一明确，仅执行文件读取和格式化输出，无隐藏逻辑；命令行参数设计完善，通过 argparse 实现类型安全的输入验证；输出完全可控，数据仅流向 stdout，不上传云端。

潜在局限性不容忽视。首先，来源为个人开发者账号（T3 级），虽代码质量良好，但长期维护性和组织背书弱于企业级项目；其次，功能相对单一，仅支持文本文件的头部预览，无法解析复杂格式或提供交互式导航；再者，默认读取固定文件名，若项目使用非标准命名需手动指定；最后，缺乏缓存机制，每次执行都重新读取文件，高频使用可能影响性能。

该技能特别适合以下群体：刚加入工作空间的新成员，需要快速了解项目文化和技术约束；项目经理，需要定期向团队同步配置变更；以及维护多个工作空间的高级用户，需要批量对比不同项目的身份设定。

使用风险主要集中在数据隐私方面。虽然工具本身不会主动收集或上传数据，但用户通过 --files 参数指定的文件内容会被完整读取并输出。若不慎将包含 API 密钥、密码或敏感商业信息的文件路径传入，可能导致信息在终端日志中泄露。建议在使用前审查目标文件内容，避免在共享屏幕或记录日志的环境中暴露敏感信息。此外，虽然代码已做路径安全检查，但仍建议仅从可信渠道获取该工具。