阅读建议
哪些部分必须看,哪些可以直接跳过。
非正式非正式非正式非正式非正式非正式非正式非正式非正式非正式非正式非正式装修中装修中装修中装修中装修中装修中装修中装修中装修中装修中
这里的文章不用从头读到尾。先判断值不值得读,再按需要取用;哪些必须看、哪些可以跳,标题和折叠里都标了。
一篇文章由哪些部分组成
从上到下固定几层,顺序不乱:
- 文首:两项标签(推荐指数、适用性)、一行索引、原型出处的引用块。
- 使用场景:读者卡在哪、一张任务流程图、用了之后的好处。
- skill 结构:几个技能怎么分工。标题上直接写着「可跳过」。
- 使用方法:安装、调用、怎么答、执行完成标志与产物、一段可复制的尝试提示词。
- 注意事项:什么时候调用、两个入口怎么选。
图、折叠卡片、可复制块是按需展开的层。不点节点、不展开卡片,主干照样读得通。
哪些需要重点阅读
三处,按顺序看,几分钟就能决定要不要用:
使用场景
写的是「你会卡在哪」。对不上,后面的技巧再好也和你无关,直接关掉这篇。
什么时候调用
在注意事项里,最容易被跳过,其实最该看:它划出了不值得调的场合。工具越好用越容易滥用,这一节是刹车。
执行完成标志与产物
告诉你最后会拿到什么、什么时候算完。带文档的版本还会多出术语表和 ADR,值不值这点代价,看这一段就够。
哪些内容可以跳过
下面这些不读,不影响你把这个技能用起来:
- 文首的推荐指数、适用性标签和原型出处引用块——是背景,不是方法。
- skill 结构——只有要改配置、排查「调不起来」时才回来翻。
- 安装卡片里的两个版本分支——装过一次就够了。
- 流程图里每个节点的解释卡——图本身已经把差别画完了。
跳过之后会漏掉什么
漏的是「为什么」,不是「怎么用」:某个技能为什么拆成入口和主体、为什么把追问单独留一份、 文档版多出来的那些东西值不值维护。要给别人讲清楚这套设计,或者打算照着写自己的技能时,再回来读。
一句话:先看使用场景,再看什么时候调用;要上手才翻使用方法,其余按需。