القائمة
Architecture Decision Records and API docs. Use when making architectural decisions, changing APIs, or shipping features.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/MQjehovah/agent --skill documentation-and-adrsيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
月度经营复盘。适用于"XX月经营情况 / 经营分析 / 经营报告 / 月度复盘"类任务。固化已验证可用的批量 SQL 查询集与报告模板，一次并行查完、直接出报告，禁止自由探索数据库。
产品经营分析。分析销售、采购、库存、成本、现金流、生产等业务数据并生成报告。已按数字中台真实数据库校准：明确标注哪些指标数据库能算、哪些无数据源不得编造，每个维度附可用 SQL。
严格 Prove-It 测试驱动开发模式。先写失败测试，证明它失败，再写代码，证明它通过，最后重构。
استنادا إلى تصنيف SOC المهني
| name | documentation-and-adrs |
| description | Architecture Decision Records and API docs. Use when making architectural decisions, changing APIs, or shipping features. |
文档是代码的说明书，ADR（架构决策记录）是技术演进的日记。好的文档记录 WHY 而非仅仅 WHAT，让后来者理解上下文而非猜测意图。
做出架构决策时（创建 ADR）
修改或新增 API 时同步更新文档
发布功能前确保文档完备
审核代码时发现缺少注释或文档
NOT for：替代干净的代码（代码本身应自解释）
NOT for：重复代码逻辑的注释
| Rationalization | Reality |
|---|---|
| "下次再补文档" | 下次永远不存在，写代码时一并写文档 |
| "代码自解释，不需要注释" | 代码解释 WHAT，注释解释 WHY |
| "ADR 浪费时间，我们直接写代码" | 没有 ADR 的架构决策 3 个月后被遗忘，新人反复踩坑 |
| "API 变了但文档忘更新了" | 这就是用工具从代码生成文档的原因 |