Menu

Individual skill

engineering-docs

0upvotes

写、改、评审研发技术文档（技术方案、系统设计、RFC、ADR、重构与迁移方案、设计评审），产出主次分明、结论先行、表格列表为主、不写大段文字的正文；以及在技术文档里画、改、重画任何工程图（架构、上下文/容器/组件/部署、流程、泳道、时序、状态、数据流、ER、前后对照、里程碑），新图优先桥接随包 Archify，按关系选型；原生缺少的专用视图由改良旧后端兜底，交付平台通用源与实际产物；旧图仍用 diagram_kit 维护 SVG/draw.io（发布到某个平台只是可选的最后一步）。不手写 mermaid、不在画板 DSL 中从零摆节点。纯润色、教程、API 手册、调研笔记和非技术文档不用。用户说「帮我写个技术方案」「把这张架构图重画一下」「评审下这份 RFC」时触发。

skills/engineering-docs/SKILL.md

Read pinned source

Source commit ffb15d3b95ee07a0ae7ab5115186e506986e32bb

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
No
Repository scan complete
No
Skill scan complete
No
Observed behavior
Not checked yet
Last checked
Nov 11, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
102
Repository last updated
Nov 6, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

# 研发技术文档

读者先看到结论和全貌，再按需进入细节；图让人一眼看出重点，并且以后能直接改。下面先说交付物长什么样，再说怎么做。

## 触发与归属：只要在技术文档里画工程图，就是本技能

不需要用户点名“用 engineering-docs 画图”。命中下面任一情况，走本技能的内容判断与绘图桥接，哪怕当前任务只是“更新文档、回评论、补一张图”。**原生能力适合时优先 Archify；它缺少而旧后端明确支持的专用图型用旧能力兜底。维护 `.py` 图源仍用 `diagram_kit`。**

- 在技术方案/系统设计/RFC/ADR/设计评审/迁移方案里**新增、修改、重画**一张图。
- 图里出现的是**服务、模块、组件、容器、节点、角色、阶段、状态、表实体、数据存储、上下游**及其调用/数据/时序关系。
- 已经有一张 mermaid 流程图、或在飞书画板上手摆的结构图，需要改、替换、统一风格。

归属优先级（高到低）：
Back to top