C✳CODEZ.WIN
🌐 简体中文

Skill 多语言阅读指南

writing-skills用途、用法与原始来源

在创建新技能、编辑现有技能或在部署前验证技能功能时使用。

原文采集时间:

来源仓库
obra/superpowers
SKILL.md
skills/writing-skills/SKILL.md
仓库 Star
309,479
仓库最近更新
2026/10/30
能力分类
Agent 工作流
最近采集时间

许可:MIT

流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill,不属于实测评测。

下面的用途和操作片段来自上游文档,由本站整理并翻译,和另行标注的 Codez 编辑分析分开展示。

这个 Skill 能做什么

在创建新技能、编辑现有技能或在部署前验证技能功能时使用。

如何使用:上游操作流程

发现工作流程

未来的经纪人如何找到你的技能:遇到问题(“测试不稳定”)搜索技能(搜索描述、浏览类别)找到技能(描述匹配)

原文片段 · L388 ↗

概述

写作技能是将测试驱动开发应用于流程文档。个人技能存储在运行时的技能目录中(~/.claude/skills/(关于克劳德代码)——参见codex-tools.md或者gemini-tools.md对于这些运行时环境的路径,Codex、Copilot CLI 和 Gemini CLI 也都能识别。~/.agents/skills/作为跨运行时别名。你编写测试用例(包含子智能体的压力场景),观察它们失败(基准行为),编写技能(文档),观察测试通过(智能体符合要求),然后重构(修复漏洞)。核心原则:如果你没有观察智能体在没有该技能的情况下失败,你就无法判断该技能是否教授了正确的内容。

原文片段 · L8 ↗

何时培养技能

这项技术对你来说并不直观。你会在多个项目中再次参考它。这种模式具有广泛的适用性(并非特定于某个项目)。其他人也会从中受益。

原文片段 · L47 ↗
原文片段 · ↗
skills/
  skill-name/
    SKILL.md              # Main reference (required)
    supporting-file.*     # Only if needed

环境与依赖

纪律执行技巧(rules/requirements)

例如:TDD、完成前验证、编码前设计。学术问题:他们理解规则吗?

原文片段 · L188 ↗

限制与结果检查

本次未从该文件选出独立的限制片段,不代表适用于所有输入或环境。请阅读完整原文,并自行验证实际结果。

开始使用前

  1. 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档,只复制 SKILL.md 可能漏掉依赖。
  2. 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境,本站不假定存在通用的安装命令。
  3. 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作,应逐项核对后再授权。
  4. 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高,都不能证明结果正确。

Skill 文件与目录格式规范 ↗

继续阅读原始文档

翻译与介绍范围

本页从固定版本的上游 SKILL.md 整理用途与操作片段,译文使用辅助翻译。它不是完整手册,也不代表经过兼容性实测;使用前请核对原文及其引用文件。

介绍依据下方列出的固定版本;当前仓库动态和目录采集时间单独展示。

固定版本来源
阅读原文 ↗
原文采集时间
来源提交版本
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b
原文 SHA-256
8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe
返回完整 Skill 目录