📢 【公告】一切皆可 Skill|SOLO 技能创作赛专区:规则奖励和参赛指引说明

1Skill简介

「疯了吧!我的生活账单竟成了规则怪谈!」是一个将日常名词转化为悬疑规则怪谈文案的创意Skill

输入任意一个日常词汇——比如外卖加班房租,或者月亮温柔——它就能瞬间生成三组不同风格的输入词汇对应的规则怪谈短句。适合内容创作者找灵感、想给朋友圈加点怪诞感的普通用户,以及喜欢规则怪谈文化的爱好者。

2、使用场 景

为什么想做 它?

我是个规则怪谈爱好者,但一直觉得市面上的怪谈内容太局限了——永远是医院、学校、电梯那几个场景。其实我们日常生活中充满了被系统规训的荒诞感:点外卖被算法投喂、加班被KPI绑架、会员自动续费停不下来……这些明明就是最真实的规则怪谈

2 个赞

不是,这怎么还有蒸馏器的?进化到我把全论坛大佬蒸馏了互相掐架

2 个赞

我感觉主要看一下大家都在研究什么,如何使用论坛,对自己也有一点帮助,分析观察完之后,

1 个赞

【Skill 创作】software-manual — 让 AI 替你把软件说明书写了

1、Skill 简介

software-manual 是一个通用型 Claude Code 技能,能为任意软件项目自动撰写、修改、校验和补充用户说明书。你只需要用自然语
言描述需求(比如"帮我写一份安装指南"或"检查一下文档里的 API
示例跟代码是否一致"),它就会先读源码、再动笔,确保写出来的每一句话都有代码依据。

适合所有"代码写得动、文档不想写"的开发者。


2、使用场景

做这个 Skill 之前,我遇到过几个非常真实的痛点:

  • 新项目快上线了,说明书还是空的。 README 写了半截,使用指南零散分布在几个 issue 里,用户根本不知道怎么上手。
  • 代码改了,文档忘了。
    接口参数加了两个、返回值变了,但文档还是三个月前的版本。同事来问"这个怎么用",才发现文档早就过时了。
  • 写文档太花时间,格式也不统一。
    每次都要从零梳理功能、截图、组织语言,一份像样的说明书动辄半天。不同项目文档风格参差不齐,阅读体验很差。

这个 Skill 做出来之后,省掉了这些动作:

  • 不用从零构思结构 → AI 读代码后自动梳理功能清单
  • 不用逐字推敲措辞 → AI 用一致风格输出中文文档
  • 不用手动核对代码和文档是否一致 → 一条指令自动校验,标出差异
  • 不用重复写相似内容 → 增量更新,只改变化的部分

3、创作过程

整个 Skill 是用 SOLO(Situation → Objective → Logic → Output) 方法驱动的,分四步走:

Step 1:定规则 —— 把"怎么写说明书"变成可执行的约束

我先梳理了自己写文档时的经验法则,提炼成 9 条核心规则写进 SKILL.md:

  1. 每次输出前必须阅读代码。不得在未查阅源码的情况下输出任何技术描述。
  2. 回答简洁。用最短的段落把功能说清楚,避免冗余修饰。
  3. 使用中文表述。专业术语保留英文原名,其余用中文。
  4. 以文字表述为主,尽量不用表格。
  5. 用户说"阅读代码,确认"时,逐项核对代码与之前输出的描述是否一致。

这些规则是 Skill 的"灵魂"。没有它们,AI 很容易变成自由发挥的模板填充器;有了它们,AI 的行为被约束成"先查代码 →
再写文档 → 允许校验修正"的闭环。

Step 2:定流程 —— 设计人机协作的工作流

用户给出标题 → 定位源码 → 通读代码 → 输出文档 → 用户反馈 → 循环迭代

关键设计决策:不追求全自动一步到位。每一轮输出后等待用户反馈(确认 / 修改 / 换说法 / 精简 / 核实),让人把关决策、AI
承担执行。这比一次生成全部内容可靠得多。

Step 3:写 SKILL.md —— 用极简配置驱动复杂行为

整个 Skill 只有一个文件:SKILL.md,不到 40 行。核心是 YAML frontmatter 中的 description 字段,它决定了 Skill
何时被自动触发:

description: 为软件项目编写用户说明书。触发场景:用户需要撰写、修改、校验、
补充软件说明文档内容时使用。通用型技能,适用于任意项目。

Step 4:迭代打磨 —— 在真实项目中反复调优

我在几个不同类型的项目上测试了它(CLI 工具、Web 应用、Python 库),发现初版有两个问题:一是对大型项目的代码定位不够精
准,二是输出偶尔会"脑补"未实现的功能。针对这两个问题,我强化了规则 1 和规则 9,要求必须 Grep/Read
确认实现细节后才能动笔,发现文档与代码不一致时必须明确指出差异让用户决策。


4、使用步骤

Skill 已内置在 Claude Code 技能系统中,直接对话即可触发:

安装:skill地址: https://github.com/fanfantop1/My_SKILLS


5、效果展示

使用前:为一个有 15 个 CLI 命令的 Python 工具写用户手册,手动梳理命令、参数、示例、配置项,耗时约 3-4
小时,且部分参数描述与实际代码有偏差。

使用后:输入"帮我写一份用户说明书",Skill 在 5 分钟内 完成:

  1. 自动扫描 cli.py、config.py、README 等关键文件
  2. 按安装 → 快速开始 → 命令参考 → 配置 → 常见问题的结构输出完整文档
  3. 每个命令的参数、默认值、示例均与源码一致

随后输入"阅读代码,确认",Skill 自动校对了全部 15 个命令的参数描述,发现 2 处代码中已改但文档未反映的差异,当场修正。

效率提升:从 4 小时 → 5 分钟 + 10 分钟审阅 = 约 15 分钟,提效 ~94%。


6、Skill 链接


7、总结与思考

最大的收获

好的 Skill 不是"让 AI 做更多事",而是"给 AI 画更清晰的边界"。 software-manual
之所以可靠,不是因为它模型多强,而是因为它被约束在"先读代码 → 再写文档 →
允许校验"的闭环里运行,每一步都有规则兜底。这比我之前让 AI 自由发挥生成文档可靠太多了。

目前最满意的地方

"阅读代码,确认"这个指令。 它解决了文档工作最大的痛点——不一致。一句指令就能让 AI
把文档和源码逐项比对,这在传统流程里几乎做不到(人工比对太枯燥,容易漏)。

后续优化方向

  1. 支持自动截图 —— 结合 Playwright 等工具,运行项目并截取关键界面
  2. 支持多版本文档维护 —— 同时对比不同分支的代码,生成差异化文档
  3. 增加"受众适配"能力 —— 同样的功能,面向开发者 vs 终端用户,输出不同风格

希望大家怎么体验

找一个你手头代码写得差不多但文档还空着的项目,对 Claude Code 说一句
“帮我写一份用户说明书”,看看它交出什么。欢迎反馈任何"写得好"和"写得不好"的地方,这对后续打磨最有价值。

帖子地址:【Skill 创作】software-manual — 让 AI 替你把软件说明书写了

skill地址: https://github.com/fanfantop1/My_SKILLS

2 个赞

为何不用Typora打开后直接导出word或pdf?

2 个赞

奖励丰厚啊!我也来搞一个!

2 个赞

嘿嘿嘿~ 你有没有想过——下载的Skill,真的安全吗? :smiling_face_with_horns:

2 个赞

期待开奖,是不是我抽奖中的东西也要发给我啦? :heart_eyes:

2 个赞
2 个赞

明天就截止了,期待嘿嘿

2 个赞

终于把作品做出来了,:sob:!有个小建议想反馈给官方一本次大赛的评审非常看重“社区互动数据”,其实这些数据如果能整理成一份开放的分析报告,肯定能极大帮助参赛者洞察评审偏好、优化作品方向。

受此启发,为了更直观地展示这些数据,我开发了一套工作流 TraeLens。【Skill 创作】30 天,7 个 Skill,看4000 个作品——这是我的 SOLO 故事 。它目前已经做成了数据分析的仪表盘 https://soloscope-xd21y01q2.maozi.io ,专门用来分析参赛作品的互动趋势。希望能为同样关注数据分析的参赛者们,提供一点有价值的参考。

感谢trae主办这样的活动,预祝各位都能取得理想的成绩!

2 个赞

你这必拿下评测官奖励啊!

1 个赞

牛批class

1 个赞