Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Gracker/gracker-writing

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gracker Writing Skill

技术文章写作 skill。

安装

默认安装仓库当前默认分支,不需要版本号:

npx skills add Gracker/gracker-writing --yes --global

需要可复现安装时,先发布 Git tag 或 release,再按安装器支持的 tag / commit 语法固定版本;当前命令不写虚构版本号。

触发词

写文章、写公众号、写博客、帮我写篇稿、按我的风格写、技术长文写作

核心原则

目标不是让读者觉得作者很懂,而是让读者真的看懂、能拿去用、知道边界。

技术文章的核心是三件事:

  1. 准确:术语、版本、路径、代码、数据都能对上
  2. 有用:读者看完知道怎么观察、怎么判断、怎么落手
  3. 易读:不是把信息塞满,而是把复杂问题讲顺

Android 技术稿

Android、性能优化、Perfetto、系统机制类稿件额外读取 references/android-terminology.md

这份规则用来区分「黑话」和「领域术语」:渲染链路输入链路Binder 调用链BufferQueuefenceSurfaceFlingerHWCHALVSync 等词只要能对应具体系统对象、trace 证据和起止边界,就按术语保留,不按黑话机械替换。

基础校对

references/copy-editing.md 补充中文技术长文的基础校对规则,覆盖可见正文与机器可读内容边界、直角引号、第二人称称呼、中英文留白、术语大小写、英文状态词误译、中文错词和数字表达。

Sample

一段典型 AI 味的 Camera trace 分析——技术事实没错,但读起来别扭:

修改前

分析 Camera 页面时,第一个要回答的问题很关键:真正的 Producer 其实不在 App 主进程里。sensor 的采集节奏由 capture request 参数决定,不等 vsync-app。cameraserver 里的 RequestThread 才是下发 request 的地方,它的节奏决定了后面整条链能不能按时交付。所以只盯宿主 main 线程就解释不了画面为什么卡——真正拖慢的往往是某一路 consumer 没及时 release buffer,反压到 HAL 侧。

修改后(骨架换回中文):

分析 Camera 页面时,Producer 不在 App 主进程——cameraserver 里的 RequestThread 负责下发 request,它的节奏决定了整条链能不能按时交付。sensor 的采集节奏由 capture request 参数决定,不等 vsync-app。只盯宿主 main 线程解释不了画面卡顿——拖慢的往往是某一路 consumer 没及时 release buffer,反压回 HAL。

对应 SKILL 规则

改动 规则
第一个要回答的问题很关键:[内容] → 直接讲内容 3.3.9 形容词 + 冒号起手式
真正的 Producer 其实不在Producer 不在 3.3.6 冗余确认副词 + 3.3.3 口水过渡词
RequestThread 才是下发 request 的地方RequestThread 负责下发 request 翻译腔骨架,典型是 X is the place where Y does Z 的直译
真正拖慢的拖慢的 3.3.6 冗余确认副词
反压到 HAL 侧反压回 HAL 英文方位尾巴 back to the X side 的残留

五处改动分布在 5 句话里,没有任何一句是被整体重写的——只是把每句里藏着的英文骨架抽掉。这就是翻译腔修改的典型密度:AI 生成的中文不会每句都踩点,但一段里几处小瑕疵累加起来,就是读者一段话看两行就能闻到的那股味儿。

修改思路不在"换词"——而是先识别翻译腔骨架(AI 像在英文里把意思想清楚再一字字换中文),然后用中文本来的讲法重说一遍

License

MIT

About

技术文章写作 skill。适用于技术深度文章、工具实战复盘、FAQ/Q&A、方法论、公众号长文等。

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Morty Proxy This is a proxified and sanitized view of the page, visit original site.