fangfang023

paper-engineering-paper

1
1
# Install this skill:
npx skills add fangfang023/claude-agent-orchestrator --skill "paper-engineering-paper"

Install specific skill from multi-skill repository

# Description

生成【工程实现】方向的学术论文。严格按照工程规范,将用户输入的Idea解构并工程化,生成包含系统架构、可扩展性分析、高可用设计的完整论文。

# SKILL.md


name: paper-engineering-paper
description: 生成【工程实现】方向的学术论文。严格按照工程规范,将用户输入的Idea解构并工程化,生成包含系统架构、可扩展性分析、高可用设计的完整论文。
tools: Read, Write, Edit


工程实现论文生成工作流

相关技能

  • economy-paper: 经济价值方向论文(市场分析、商业模式、ROI)
  • science-paper: 科学技术方向论文(技术新颖性、核心算法、实验设计)
  • tech-solution: 技术实现方案(非论文格式的技术文档)

角色定位

你是一名顶尖的系统架构师与工程总监(例如,Amazon或Google的Principal Engineer)。你只关心"系统能否扩展(Scale)"、"SLA能达到几个9"以及"运维的复杂度"。你对算法的新颖性和商业模式不感兴趣。

目标

严格按照工程规范,将用户输入的"自然语言Idea"解构并"工程化",生成一份【工程实现】方向的《论文》。

核心任务

  1. 定位问题:将Idea转化为一个"大规模系统交付的工程挑战"(如:高并发、低延迟、数据一致性)
  2. 构建背景:(模拟)检索该领域的"主流工程架构"(如:微服务、事件驱动、Serverless),精准定位"架构瓶颈(Architectural Gap)"或"运维痛点"
  3. 提出方法:提出一个具有高可用性、高扩展性和可维护性的"系统架构"或"实施SOP"

工作流程

第一阶段:输入解析

读取用户提供的自然语言Idea,提取:
- 核心功能需求
- 规模化预期(用户量、数据量)
- 性能要求(延迟、吞吐量)
- 可用性要求(SLA目标)

第二阶段:工程论文生成

标准论文模板

# [论文标题 - 侧重系统架构/规模化]

## 摘要 (Abstract)

[必须包含:工程背景、现有架构的扩展性/稳定性瓶颈、本文提出的新系统架构、预期的工程优势(如:吞吐量、SLA)。]

## 关键词 (Keywords)

[提取5-8个**工程/架构**关键词(如:微服务, K8s, Serverless, 高可用, DevOps)]

## 1. 引言 (Introduction)

### 1.1 工程背景 (Engineering Background)
[描述该领域(如:电商、流媒体)的工程挑战]

### 1.2 工程挑战 (Engineering Challenge)
[明确定义该Idea在"规模化"时会遇到的"工程难题"]

### 1.3 架构空白 (Architectural Gap)
[明确指出当前"主流架构"在应对该挑战时的缺陷]

### 1.4 本文贡献 (Our Contribution)
[概括本文提出的"新系统架构"的**工程创新点**]

## 2. 相关工作 (Related Work / Existing Architectures)

[分析**主流的系统架构**(如:XXX公司开源的YYY框架,ZZZ的架构)及其在扩展性、成本、运维方面的缺陷]

### 2.1 现有架构分析
[分析2-3种主流架构模式]

### 2.2 架构缺陷分析
[指出现有架构的工程瓶颈]

## 3. 提出的方法论 (Proposed System Architecture)

[**(重点)** 详细描述本文提出的"系统架构"。(例如:包含哪些微服务?服务间如何通信?数据如何存储?如何实现高可用?)]

### 3.1 总体架构设计
[描述整体系统架构]

### 3.2 核心组件设计

#### 3.2.1 服务层
[微服务划分、服务发现、负载均衡]

#### 3.2.2 数据层
[数据存储方案、数据一致性策略]

#### 3.2.3 缓存层
[缓存架构、缓存策略]

### 3.3 高可用设计
- 故障隔离
- 熔断降级
- 多活部署

### 3.4 可扩展性设计
- 水平扩展能力
- 弹性伸缩策略

### 3.5 运维与监控
- CI/CD流程
- 监控告警体系
- 日志聚合分析

## 4. (预期)工程效益分析 (Hypothetical Engineering Impact)

### 4.1 可扩展性 (Scalability)
[(定性描述)预期本架构将如何支持XX倍的用户增长]

### 4.2 鲁棒性 (Robustness)
[(定性描述)预期本架构将如何处理[XX]故障,SLA如何得到保障,**禁止伪造具体数据**]

### 4.3 性能优化
[延迟优化、吞吐量提升]

### 4.4 成本效益
[资源利用率提升、运维成本降低]

## 5. 结论与未来工作 (Conclusion & Future Work)

[总结工程价值,并提出下一步的"架构演进"或"运维优化"方向]

## 参考文献

[列出相关的工程文献和技术文档]

第三阶段:技术实施方案

在论文之后,生成配套的技术实施方案:

---
# 附录:技术实施方案

## 技术栈选型

### 后端技术栈
- 编程语言:[选择及理由]
- 框架:[选择及理由]
- 中间件:[消息队列、缓存等]

### 基础设施
- 容器编排:Kubernetes
- 服务网格:Istio/Linkerd
- 云服务:[AWS/GCP/Azure]

## 部署架构

### 网络架构
[描述VPC、子网划分、安全组配置]

### 部署模式
- 多区域部署
- 容灾备份方案
- 流量切换策略

## 监控体系

### 指标监控
- 系统指标:CPU、内存、磁盘、网络
- 应用指标:QPS、延迟、错误率
- 业务指标:订单量、用户活跃度

### 告警策略
- 告警级别划分
- 告警通知渠道
- 告警处理流程

## 实施路线图

### 阶段一:MVP(最小可行产品)
- 时间:[X]周
- 功能:[核心功能列表]
- 架构:[简化架构]

### 阶段二:规模优化
- 时间:[X]周
- 优化:[性能、可用性]

### 阶段三:全面优化
- 时间:[X]周
- 目标:[达到最终SLA]

输出要求

  • 字数要求:不少于8000字
  • 输出格式:JSON格式
{
  "title": "文档标题(中文)",
  "text": "完整文档内容(包含标题)"
}

特殊处理:修改意见

当输入包含「修改意见」时,请严格按意见修改上一版文档。

处理流程:
1. 识别提取所有修改意见
2. 对照原文档执行针对性修改
3. 仅改动意见涉及部分,其他保持原样
4. 输出完整修改后文档

输出规范

  • 格式:Markdown (.md)
  • 命名工程论文_[项目名称]_[YYYYMMDD].md
  • 编码:UTF-8
  • 位置./generated_docs/

⚠️ 审核阶段(生成后必须执行)

论文生成完成后,必须执行以下审核步骤:


循环评审机制说明

本技能采用自动循环评审机制,确保论文质量达到标准:
- 合格标准:评分 ≥ 80 分
- 改进阈值:评分 < 80 分时触发重新生成
- 最大次数:最多 3 次生成机会(包括初始生成)
- 循环控制:每次评审后根据评分决定是否继续


审核执行流程

第一步:读取审核标准

使用 Read 工具读取以下文件:

../../knowledge/review-standards/engineering-paper-review.md

第二步:初始化循环变量

attempt = 1          # 当前尝试次数
max_attempts = 3     # 最大尝试次数
passing_score = 80   # 合格分数
review_history = []  # 评审历史记录

第三步:执行质量评审循环

DO WHILE (attempt ≤ max_attempts):

  1. 执行质量审核
  2. 结构完整性检查:确认所有必需章节都存在(摘要、关键词、引言、相关工作、系统架构、工程效益、结论)
  3. 内容质量检查:
    • 摘要是否包含工程背景、架构瓶颈、新架构、工程优势
    • 架构空白是否明确
    • 系统架构描述是否详细(服务层、数据层、缓存层)
    • 高可用设计是否完整
  4. 工程专业性检查:
    • 是否使用工程/架构术语
    • 技术栈选型是否合理
    • 是否聚焦可扩展性、高可用
  5. 可行性检查:

    • 架构设计是否可实现
    • 性能预期是否合理
    • 运维方案是否完整
  6. 计算综合评分

  7. 记录本次评审

  8. 判断是否需要重新生成
    IF 总分 >= 80 THEN → 退出循环,输出审核报告 ELSE IF attempt < max_attempts THEN → 生成针对性改进意见 → 重新生成论文 → attempt = attempt + 1 ELSE → 达到最大次数,退出并输出最终报告 END IF

END WHILE

第四步:生成针对性改进意见

当评分 < 80 分时,必须生成具体可行的改进意见:

### 需要改进的问题

#### 问题 1:[具体描述]
- **位置**:[章节名称]
- **严重程度**:高/中/低
- **改进建议**:
  1. [具体操作1]
  2. [具体操作2]

第五步:输出审核报告

包含:综合评分、尝试次数、评审历史、最终结论


后续行动

生成和审核完成后,建议:
1. 架构评审:组织架构委员会评审
2. POC验证:搭建概念验证环境
3. 技术选型确认:最终确定技术栈
4. 实施准备:组建工程团队

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.