docs(review): consultant audit tracker, 10 post batches and the posts/case-studies upgrade plan
- 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
This commit is contained in:
1 parent
c5e473aaad
commit
86edd40c74
15 files changed
+43272
No files matched your search
@@ -0,0 +1,41 @@
|
||||
# 外部顾问审阅前置须知与工程背景规范
|
||||
|
||||
> **本文档目标**:本批次包含 `blog.hoelee.com` 的待审阅技术文章全文。请外部顾问在审阅正文与技术主张时,以此规范为最高评估准则。
|
||||
|
||||
## 1. 站点定位与双重业务目的
|
||||
- **受众 A(技术招聘官 / 资深技术主管)**:寻找具备 Senior 全栈 + DevOps + AI 智能体闭环能力的架构工程师。文章定位为**“不可伪造的工程实操交付证据(Proof of Expertise)”**,要求代码真实、日志可查、有架构权衡与技术深度。
|
||||
- **受众 B(中小企业主 SME / 商业客户)**:寻找能提供系统研发、私有化部署、24/7 AI 获客系统、高可用基础设施的技术顾问。文章需清晰阐述业务痛点、商业 ROI、上线效率与交付保障。
|
||||
|
||||
## 2. 核心人设铁律与工程硬约束(必须严格遵守)
|
||||
1. **彻底杜绝业余爱好者/玩具口吻**:
|
||||
- ❌ **绝对禁用词**:`homelab`, `home lab`, `家用`, `小主机`, `玩具`, `折腾`。
|
||||
- ✅ **标准替代词**:`the infrastructure I manage`(我管理的私有基础设施)、`self-hosted production node`(自托管生产节点)、`on-premise host`(私有化服务器)。
|
||||
2. **严禁捏造虚假指标与性能数字**:
|
||||
- 所有 benchmark 数据必须有明确的测试基准与单设备限制。
|
||||
- 严格区分“耗时减少比例”与“吞吐加速倍数”(例如耗时从 352s 降至 218s 是耗时减少 38.0%,吞吐提升 1.61×,严禁偷换概念混淆)。
|
||||
- 时间戳精度与物理帧对齐:视频帧率上限(如 30 fps 单帧 33.3ms)不可妄称“微秒级精确”。
|
||||
3. **去模板化叙事与真实物理锚点**:
|
||||
- 拒绝千篇一律的 AI 模板味。文章采用三大叙事架构:① 故障排查谜案(Symptom → False Lead → Kernel Evidence → Fix);② 商业交付复盘(Client Bottleneck → Trade-offs → State Machine → ROI);③ 架构演进对比(V1 Naive → Concurrency Crash → V2 Redesign)。
|
||||
- 每篇文章必须包含至少一个物理真实世界锚点(主机真实硬件规格、生产维护窗口、真实业务场景)。
|
||||
4. **代码与配置展示规范**:
|
||||
- 超过 20 行的配置或日志采用 HTML `<details><summary>` 原生折叠,`<summary>` 必须精准标注文档名与行数。
|
||||
|
||||
## 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` — 上一轮顾问诊断全景资料包。
|
||||
Reference in new issue
Block a user