hoelee
86edd40c74
- docs/consultant-review/: review brief, per-batch post dumps (01-10), audit-tracker.json + AUDIT-TRACKER.md generated by scripts/manage_review.py - scripts/manage_review.py: list/approve/approve-batch/generate over the tracker - docs/consultant-review-2026-10-27-posts-and-casestudies-plan.md: locked decision register + 4 work orders for the /posts/ archive rework and the case-studies portfolio treatment
3.8 KiB
3.8 KiB
外部顾问审阅前置须知与工程背景规范
本文档目标：本批次包含
blog.hoelee.com的待审阅技术文章全文。请外部顾问在审阅正文与技术主张时，以此规范为最高评估准则。
1. 站点定位与双重业务目的
- 受众 A（技术招聘官 / 资深技术主管）：寻找具备 Senior 全栈 + DevOps + AI 智能体闭环能力的架构工程师。文章定位为**“不可伪造的工程实操交付证据（Proof of Expertise）”**，要求代码真实、日志可查、有架构权衡与技术深度。
- 受众 B（中小企业主 SME / 商业客户）：寻找能提供系统研发、私有化部署、24/7 AI 获客系统、高可用基础设施的技术顾问。文章需清晰阐述业务痛点、商业 ROI、上线效率与交付保障。
2. 核心人设铁律与工程硬约束（必须严格遵守）
- 彻底杜绝业余爱好者/玩具口吻：
- ❌ 绝对禁用词：
homelab,home lab,家用,小主机,玩具,折腾。 - ✅ 标准替代词：
the infrastructure I manage（我管理的私有基础设施）、self-hosted production node（自托管生产节点）、on-premise host（私有化服务器）。
- ❌ 绝对禁用词：
- 严禁捏造虚假指标与性能数字：
- 所有 benchmark 数据必须有明确的测试基准与单设备限制。
- 严格区分“耗时减少比例”与“吞吐加速倍数”（例如耗时从 352s 降至 218s 是耗时减少 38.0%，吞吐提升 1.61×，严禁偷换概念混淆）。
- 时间戳精度与物理帧对齐：视频帧率上限（如 30 fps 单帧 33.3ms）不可妄称“微秒级精确”。
- 去模板化叙事与真实物理锚点：
- 拒绝千篇一律的 AI 模板味。文章采用三大叙事架构：① 故障排查谜案（Symptom → False Lead → Kernel Evidence → Fix）；② 商业交付复盘（Client Bottleneck → Trade-offs → State Machine → ROI）；③ 架构演进对比（V1 Naive → Concurrency Crash → V2 Redesign）。
- 每篇文章必须包含至少一个物理真实世界锚点（主机真实硬件规格、生产维护窗口、真实业务场景）。
- 代码与配置展示规范：
- 超过 20 行的配置或日志采用 HTML
<details><summary>原生折叠，<summary>必须精准标注文档名与行数。
- 超过 20 行的配置或日志采用 HTML
3. 顾问重点开刀维度
- 事实与数字可核性：技术判断与性能数据是否自洽？有无过度夸大？
- 人设与语调纯洁性：有无遗漏的 hobbyist/homelab 口吻？
- 双轨转化引导有效性：是否有清晰的业务价值提炼与行动召唤（CTA）？
- 代码与生产安全性：有无未脱敏的凭据、绝对内部私密路径或不安全的权限配置？
4. 博客 7 大分类与内容策略参考
case-studies(商业案例)：求职与获客核心武器，以真实商业交付和解决瓶颈为核心。devops(私有基建)：高并发网关、Docker、Traefik、存储阵列与监控，最强差异化资产。ai(人工智能与智能体)：围绕自动化工作流、LiteLLM 网关、状态机防幻觉与本地私有大模型。engineering(系统架构与后端)：Java/Spring、PHP/CodeIgniter、TS/React 的硬核实战。tutorials(技术教程)：面向学习者的深度实战指南。notes(排障速记)：轻量级踩坑手记与高频高价值 gotcha。web3(智能合约)：Solidity/Foundry 严谨实践，诚实表达学习与验证阶段。
5. 既有核心参考文档清单（仓库内置）
docs/content-guide.md— 博客内容定位、选题规范、反模式与 i18n 策略。docs/post-publishing-sop-v2.md— 5 步叙事模型、代码折叠与 Bento 卡片技术规范。docs/consultant-review-2026-10-26-supplement.md— 上一轮顾问诊断全景资料包。