用途
diagnosing-team-skills 用于对 adlc-team-skills 的接线故障进行“证据优先”的诊断。当团队上下文在会话启动时未出现（Use 部分没有 Team Context）、本应匹配的规则没有加载、更新后安装行为异常，或有人询问某次会话为何如此运行时，可使用本技能。
不适用场景：与团队上下文链路无关的应用缺陷，或关于技能行为的争论（那属于 goldset/eval 问题）。
主要能力
该技能把诊断链路拆成恰好五个环节，每个环节都可用一条命令检查。其核心原则是：没有命令输出的诊断只是猜测，而猜测会被粘贴进缺陷报告。
五个检查环节如下：
- 未配置：运行
cat .adlc/init-options.json，绿色表示存在一个有效的 team_ai_directives 路径。 - 缺少工具：运行
command -v jq，绿色表示 jq 在 PATH 中（技能注册表需要它）。 - 处理器损坏：从项目根目录运行
bash .agents/skills/team-boot/scripts/boot.sh，绿色表示指令索引输出到 stdout，并包裹在 EXTREMELY_IMPORTANT 中。 - 安装过期：在技能仓库中运行
pytest tests/unit/test_generated_artifacts_sync.py -q，或比较skills/**/SKILL.md与.agents/skills/名称，绿色表示镜像与源一致。 - 注入侧：生成的插件是否存在并为该代理加载？如果 1–4 均为绿色而会话仍缺少上下文，则属于 adlc-cli 的领域，应携带检查 1–4 的输出到那里提交。
针对“某条规则没有加载”的情况：先确认会话以索引开始（检查检查 3 的内容），再检查任务是否确实匹配该规则的描述符——按需拉取是匹配驱动的，不是读心术。
整体回路检查：scripts/acceptance-test.sh 会进行临时安装并端到端断言整条链路（加 --live 可运行真实代理会话）。
使用方式
按顺序运行检查——在首个失败处停止，修复，然后重跑。
适用场景
- 会话启动时团队上下文缺失。
- 本应匹配的规则未加载。
- 更新后安装行为异常。
限制与边界
本仓库负责 .events.json 和启动脚本的输出。注入侧（调度器、生成的按代理插件）归 adlc-cli 所有——adlc-team-skills 仓库中的 docs/event-hook-contract.md 划定了这条界线。诊断到该界线为止，然后进行路由。
报告格式
提交缺陷报告时需包含：失败的检查编号、命令、其逐字输出、代理名称/版本，以及仓库的安装方式（npx skills add 还是 adlc-cli）。不要经过删改的叙述——要原始输出。
危险信号
- 在运行命令之前就下结论——每个检查都只是一条命令。
- 在阅读检查 3 的输出之前就“重装一切”。
- 当检查 1–3 失败时却归咎于技能内容（那是配置问题，不是技能问题）。
- 把注入侧的缺陷提交到 adlc-team-skills（检查 5 会将其路由出去）。
以上所有情况都意味着：先运行检查，再报告。
验证
诊断在以下条件满足时完成：
- 检查 1–4 均已运行并捕获输出（或检查 5 已带证据路由）
- 失败的环节已连同其命令输出被指名
- 报告已路由到拥有该环节的仓库