用途:对“脑文件”(技能、指令、智能体、提示、脚本等)做全面时效审查。brain-qa.cjs 只机械检查日期,本技能定义真正配得上该日期的完整评审:内容既符合外部现实,又内部自洽。
主要能力:按清单检查 frontmatter(currency 日期、description、applyTo、tier 取值与判定)、内容时效(API、版本号、URL、最佳实践、工具可用性、代码示例)、语义一致性(术语、声明真实性、交叉引用、矛盾、流程逻辑、架构对齐)、结构(去除冗余 Mermaid、渐进披露、可操作性)与继承性(inh=1 需在 MASTER-ALEX-PROTECTED.json 中,inh=0 不得含 master 专属内容)。技能分层仅允许 core、standard、extended,并给出各自判定测试与数量参考。
使用方式:先运行 node .github/muscles/brain-qa.cjs 读取 Priority Queue,按失败优先、缺失日期次之、最旧再次之的顺序处理,每批 10-15 个文件。逐文件走清单,修复后把 currency 设为当天日期,再运行 node .github/muscles/brain-qa.cjs --stdout | grep "filename" 验证(PowerShell 用 Select-String)。批量审计可按领域分组、每领域只研究一次、并行读取、最后统一打戳。
适用场景:brain-health-grid 显示过期或缺失日期时;向继承者发布脑文件前;每 90 天定期全量审计;外部重大变更后。
限制与规则:未完成全部清单不得打戳,日期戳是证明而非改日期;过期文件按决策表处理(仍准确则重打戳、轻微漂移则改后打戳、重大过时则重写、死领域标记 deprecated 且不打戳、历史记录标记 stable 并延长 reviewEvery)。语义过时审查队列记录于 .github/quality/review-queue.jsonl,含 currency-expired、lifecycle-warning、manual-flag、heir-feedback、drift-detected 等原因,状态流转为 pending → in-review → resolved 或 deferred。具体命令、字段与判定标准以资料为准,未提供的细节暂未说明。