cognitive-walkthrough - SKILL.md Agent Skill

name: cognitive-walkthrough description: 学生认知走查引擎。模拟 DMA 大二学生按课堂时间顺序逐段"听课"，通过 7 条认知探针（rule_student_empathy_guard.md）捕获视听矛盾、解法超界、认知急转弯等体验层逻辑漏洞。当用户提到"认知走查"、"学生视角审查"、"逻辑排雷"、"Phase 0"、"cognitive walkthrough"时触发。也适用于 /audit Part B-8 的完整走查模式。

学生认知走查引擎 (Cognitive Walkthrough Engine)

理论框架：教学认知走查 (CWI) + 带认知状态追踪的虚拟学习者 (Simulated Learner with Epistemic State Specification)

与 Rule 层的分工

rule_student_empathy_guard.md：定义 7 条探针的标记名和判定规则（什么算 Bug、什么严重度）
本 Skill：定义探针的执行协议（如何逐段走查、如何维护知识背包、如何输出报告）

执行协议

Step 0：认知画像构建（听课前必须完成）

建立"学生知识背包"——Agent 此后只能使用此背包中的知识来理解脚本：

读取课程元数据：通过 extract_week.py --week N 获取当前周次的 steps 结构
确定知识边界：
- 本模块之前的模块教过的概念 → L1 已知层
- 跨周次概念按 rule_prerequisite_awareness.md §3.2 遗忘衰减模型标注衰减等级
确定能力边界：按 rule_dma_course_design.md §1 DMA 护栏
- ✅ 能力域：Figma / PS / AE / 视觉设计 / 排版 / 摄影 / 社交媒体 / 视频剪辑 / 前端基础
- ❌ 禁区域：后端开发 / 数据库 / API 对接 / 商业运营 / 硬件工程 / 统计建模

必须输出：

> **我是谁**：DMA 大二学生，上周学了 [前序模块关键概念]
> **我知道什么**：[L1 已知层概念列表]
> **我不知道什么**：[L3 禁区列表]

Step 1：逐段走查（核心环节）

按脚本的 ### 块物理顺序，逐段执行 rule_student_empathy_guard.md §1 中的 7 条探针（P1-P7）。

1.1 走查纪律

严禁跳读：必须从第一个 ### 块开始，不可跳到后文
严禁反向推理：不可用后文信息来"理解"前文。前文不可理解就打标，即便后文会解释
知识背包递增更新：每个 ### 块结束后，将该段教授的新概念加入背包。后续段落可使用更新后的背包

1.2 Persona 漂移防护

每 5 个 ### 块后，Agent 必须重新输出当前"知识背包"状态快照：

📦 知识背包检查点 (第 N 段后):
已知: [累积的 L1 概念列表]
本轮新增: [最近 5 段新学到的]
仍不知道: [L3 禁区 - 未被教授的仍为禁区]

此机制防止 Agent 在长篇走查中逐渐退回全知全能视角（LLM Competence Paradox）。

1.3 单段输出格式

对每个 ### 块输出：

### [段落标题]
📍 知识背包更新：+[本段新学到的概念]
🧠 内心独白：[第一人称 DMA 学生真实感受，20-50 字]
🔍 探针结果：P1 ✅ | P2 ✅ | P3 ⚠️ [COGNITIVE_WHIPLASH] | ...
📝 详情：[对每个非 ✅ 的探针，引用具体违规文本 + 学生困惑描述]

内心独白示例：

P1 违规：「老师在说 App 多好用，但我看到的是一堆齿轮，我是不是看错 PPT 了？」
P2 违规：「打通银行 API？我连后端是什么都不知道，这跟我有什么关系……」
P3 违规：「等等，刚才不是说交互设计是吃饭的手艺吗？怎么现在又说没用了？那我白学了？」

Step 2：汇总诊断报告

走查完所有段落后，输出汇总表：

位置 (行号)	探针	标记	严重度	学生困惑描述（一句话）
L125	P1	`[SCENE_INTENT_MISMATCH]`	🔴	老师赞美软件，Slide 展示齿轮
L180	P2	`[SOLUTION_OUT_OF_BOUNDS]`	🔴	建议打通银行 API，超出 DMA 能力
...	...	...	...	...

判定：按 rule_student_empathy_guard.md §3 执行。

Step 3：修复引导（可选，仅在用户批准后执行）

按 rule_student_empathy_guard.md §4 的优先级修复标记的认知漏洞。修复后重跑 Step 1 验证，确认所有 🔴 标记已清除。

与现有工作流的集成点

集成点	调用方式	执行范围
`/audit` Part B-8	`audit_standard.md` 引用 Rule §1 全部 7 条探针	标准/深度审计时执行
`/write` Phase C	`write_phase2_compose.md` 引用 Rule §1 P1-P6（静态版，无 P7 走查）	每模块达标确认时执行
独立触发	用户手动激活本 Skill 或在 `prompts.md` 中使用 Phase 0 指令	完整逐段走查（含 P7）

上下文管理

Token 预算：完整走查会消耗大量上下文（全文逐段 + 知识背包状态）。对 > 5000 字的模块，建议拆分为 2 轮走查
SubAgent 委托：当主 Agent 上下文已超过 30% 时，可将走查委托给 SubAgent，仅返回汇总诊断表