用途:这是一个 Infrahub 概念教学技能,面向“为理解而学”而非“委托完成任务”的场景。学习者可提问如“讲讲关系如何工作”“为什么我的实例这样表现”“Infrahub 里 X 对应 NetBox/Nautobot 的什么”“我们上次学到哪了”。
主要能力:会话开始时按顺序检测环境并优先使用最丰富来源——先看当前目录中的仓库文件(schema YAML、对象文件、.infrahub.yml),其次看可访问的 Infrahub 实例(MCP 服务器或 infrahubctl,只读查询),都没有则用通用示例。教学遵循固定课型:Probe(先探测,不先解释)、Explain(结合学习者自有产物,并为每个行为断言引用文档页)、Exercise(自行编写并验证参考解答后才出示,学习者是练习作者)、Check。使用 references/concept-map.md 选择概念,按前置依赖排序,含每概念探测问题、练习规格与验证方法;无对应行时走共享文档回退。进度记录到 .infrahub-learning/progress.md,提示记录到 .infrahub-learning/hints/<concept>.md,每节课结束前记录进度。收尾时指向在真实项目中做同样工作的姊妹技能。
使用方式:首次接触可创建学习工作区并阅读 references/lesson-protocol.md;续学先读 .infrahub-learning/progress.md。写第一个 Explain 前需读 rules/grounding-own-artifacts.md;写课程文件前读 rules/protocol-structured-lessons.md。
限制:实例安全分三层——默认只读;写入须明确同意,仅在 learning-* 分支进行,绝不合并、始终删除;任何可能写入的命令(包括让学习者运行的步骤)前都须读 rules/safety-instance-writes.md。竞品映射需通过可信度关卡。具体价格、平台支持范围等资料暂未提供。