القائمة
CI检查流程，用于提交前的全面质量检查。包含：后端+前端静态检查（lint/type/test）、代码审查（最近提交）、文档一致性验证（ARCHITECTURE.md/specs/CONTEXT.md vs 代码）。触发词：ci-check、ci检查、提交前检查、pre-commit检查、质量检查、跑一下检查。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
为 AI Agent 创建元规则和领域知识，帮助用户在不熟悉领域建立 Agent 的思考方式和行为准则。专注于抽象的行事风格而非具体技术约束。适用场景：(1) 创建新 Agent 缺少行为准则，(2) 更新现有 Agent 的元规则或知识，(3) 用户不熟悉目标领域需要搜索最佳实践，(4) 希望 Agent 跨项目保持一致工作风格。
记录 AI 犯错或可改进点，生成可复用的学习资产。支持两种模式：(1) 当前会话 - 会话结束时触发，引导用户回顾本次会话中的纠正和可改进点；(2) 指定会话 - 通过 session_id 或 JSONL 文件路径分析历史会话。存储位置：D:\desktop\quackDocs\my_notes\ai_mistake\（index.md 索引 + records.md 实体）。触发词：记录错误、记录问题、AI 错误记录、会话总结、记录教训、record mistakes。
记录 AI 犯错或可改进点，生成可复用的学习资产。支持两种模式：(1) 当前会话 - 会话结束时触发，引导用户回顾本次会话中的纠正和可改进点；(2) 指定会话 - 通过 session_id 或 JSONL 文件路径分析历史会话。存储位置：D:\desktop\quackDocs\my_notes\ai_bug_history\（index.md 索引 + records.md 实体）。触发词：记录错误、记录问题、AI 错误记录、会话总结、记录教训、record mistakes。
指导 Manager 设计和创建 Loop 循环。当 Manager 需要创建自动化循环（如 Executor-Reviewer、Writer-Editor 模式）时使用。 提供完整的设计流程：需求澄清 → 节点设计 → 用户确认 → Subagent 验证 → 创建循环。 确保循环提示词质量，避免因上下文设计不当导致循环失败。 触发词：创建循环、loop、循环设计、迭代执行、自动审查。
记录架构决策（ADR）。触发条件：(1) 艰难选择——在方案间纠结、选了A但B也有优势、知道有副作用 (2) 重构/重大修改后——改了3+次才定方案、每次改有新考虑 (3) 奇怪代码——被问"为什么这样写"、审查被质疑、自己回看也觉得奇怪 (4) 用户做出重大决策或出现决策疑问
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
| name | ci-check |
| description | CI检查流程，用于提交前的全面质量检查。包含：后端+前端静态检查（lint/type/test）、代码审查（最近提交）、文档一致性验证（ARCHITECTURE.md/specs/CONTEXT.md vs 代码）。触发词：ci-check、ci检查、提交前检查、pre-commit检查、质量检查、跑一下检查。 |
只读检查，不做修改。Makefile 的自动格式化（ruff format、prettier）属于自动修复，允许执行。
Stage 1: 静态检查 (串行)
├─ make check (后端)
└─ cd frontend && make check (前端)
Stage 2 & 3: 并行执行
├─ [Agent A] 代码审查 — 使用 claude code-review 技能审查最近提交
├─ [Agent B] ARCHITECTURE.md 一致性检查
├─ [Agent C] docs/specs 一致性检查
└─ [Agent D] CONTEXT.md 一致性检查
Stage 4: 汇总报告 → docs/generated/NNN/YYYY-MM-DD-ci-report.md
可选: 运行 ci-check-fix 修复发现的问题
└─ python skills/ci-check-fix/scripts/run_ci_fix.py
运行项目 Makefile 的 check 目标：
# 后端检查
make check
# 前端检查
cd frontend && make check
使用 scripts/run_parallel_checks.py 并行执行 4 项检查。该脚本通过 claude CLI 的 -p（print mode）调用 Claude：
code-review 技能审查最近的提交内容docs/specs/ 中的规格说明与实际代码实现每项检查输出独立的 Markdown 文件到 docs/generated/NNN/ 编号目录（如 001/, 002/），文件命名格式为 YYYY-MM-DD-{检查项}.md。
所有 Agent 均通过 --allowedTools 限制为只读工具：Bash(git *) Bash(ls:*) Read Glob Grep WebSearch WebFetch，并附加 --append-system-prompt 强制只读指令。禁止使用 Edit, Write, NotebookEdit, Agent 等写入工具。
运行 scripts/summarize_report.py，将检查结果汇总到同一编号目录下 YYYY-MM-DD-ci-report.md，并更新 docs/generated/index.md 索引。包含：
汇总报告的执行摘要表包含「修复状态」列，用于跟踪 ci-check-fix 修复后的状态：
| 检查项 | 检查状态 | 修复状态 |
|---|---|---|
| 代码审查 | ✅ 完成 | 🟢 全部修复 (3/3) |
| ARCHITECTURE.md 一致性 | ✅ 完成 | 🟡 部分修复 (1/4) |
| docs/specs 一致性 | ✅ 完成 | 🔴 未修复 (0/2) |
| CONTEXT.md 一致性 | ✅ 完成 | — |
修复状态取值：
🟢 全部修复 (N/N) — 所有问题已修复🟡 部分修复 (N/M) — 部分问题已修复🔴 未修复 (0/N) — 未运行修复或修复失败⚪ 无需修复 — 检查通过，无需修复— — 未运行 ci-check-fix每个检查项章节内也会显示修复状态，并附带详细的修复状态表（由 ci-check-fix 生成）。
python skills/ci-check/scripts/run_ci_check.py
python skills/ci-check/scripts/run_ci_check.py --skip-static
python skills/ci-check/scripts/run_parallel_checks.py --only code-review
python skills/ci-check/scripts/run_parallel_checks.py --only architecture
python skills/ci-check/scripts/run_parallel_checks.py --only specs
python skills/ci-check/scripts/run_parallel_checks.py --only context
--allowedTools 限制 Bash 命令范围 + --append-system-prompt 强制限制make check 是否执行并记录结果？make check 是否执行并记录结果？docs/generated/NNN/ 编号目录？