Token导航 LogoToken导航TokenDH.com
研究检索external-servicegithub未标认证来源可访问许可证需确认审计通过

specification-writing规范编写

Agent Skill

用于辅助文档、README、Markdown、说明文和内容稿件的整理与改写。它适合让 Agent 提炼结构、补齐章节、统一术语、检查链接或把零散材料整理成可读文档。使用时应保留项目已有事实、命令和路径,不要把未确认的信息写成确定结论;涉及对外文案时,还需要控制语气,避免过度营销或夸大能力。

总安装

753

周安装

32

GitHub Stars

7,763

下载量

264
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:specification-writing(规范编写)
来源仓库:https://github.com/wanshuiyin/auto-claude-code-research-in-sleep
仓库路径:skills/specification-writing
安装命令:
npx skills add https://github.com/wanshuiyin/auto-claude-code-research-in-sleep --skill specification-writing
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/wanshuiyin/auto-claude-code-research-in-sleep --skill specification-writing

简介

specification-writing 用于辅助文档、README、Markdown、说明文和内容稿件的整理与改写,适合让 Agent 提炼结构、补齐章节、统一术语或检查链接。

  • 它可帮助 Agent 把零散材料整理成可读文档,并保留项目已有事实、命令和路径。
  • 使用时应避免把未确认的信息写成确定结论;涉及对外文案时,还需控制语气,避免过度营销或夸大能力。
  • 安装前建议核实权限范围、维护状态,以及是否会触发联网、命令执行或文件读写操作。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

SKILL.md

Specification Writing: Section-by-Section Patent Description

Write the patent specification based on: $ARGUMENTS

Adapted from /paper-write for patent specifications. The specification supports the claims -- it is not a paper.

Constants

  • REVIEWER_MODEL = gpt-5.4 — External reviewer for specification quality
  • JURISDICTION = "auto" — Inherit from pipeline or detect from args; CN, US, EP, ALL
  • OUTPUT_FORMAT = "markdown" — Markdown drafts; converted to filing format by /jurisdiction-format
  • OUTPUT_DIR = "patent/" — Base output directory
  • LANGUAGE = "auto" — Auto from jurisdiction: CN->Chinese, US/EP->English

Inputs

  1. patent/CLAIMS.md — the drafted claims (primary source)
  2. patent/INVENTION_DISCLOSURE.md — invention decomposition
  3. patent/PRIOR_ART_REPORT.md — for background section
  4. User-provided figures (if any)

Shared References

Load ../shared-references/patent-writing-principles.md for specification writing rules, language guidelines, and reference numeral conventions. Load ../shared-references/patent-format-cn.md or patent-format-us.md or patent-format-ep.md based on jurisdiction.

Workflow

Step 1: Initialize Specification Structure

Create the output directory and section files:

patent/specification/
├── title.md
├── technical_field.md
├── background.md
├── summary.md
├── drawings_description.md
├── detailed_description.md
└── abstract.md

Step 2: Write Title (发明名称)

  • Must match the broadest claim scope
  • No trademarks, no "improved" or "new" or "novel"
  • CN format: "一种[领域]的[技术主题]" or "[领域]的[技术主题]装置"
  • US/EP format: "[Technical topic] for [purpose]" or "[Technical topic] and method thereof"
  • Keep concise (CN: typically under 25 characters; US: under 500 characters)

Step 3: Write Technical Field (技术领域)

1-2 paragraphs identifying the technical domain:

  • "The present invention relates to [broad field], and more particularly to [specific area]."
  • CN: "本发明涉及[技术领域],具体涉及[具体领域]。"

Step 4: Write Background (背景技术)

This is NOT a literature review. It directly sets up the problem.

Structure:

  1. Describe the closest prior art approaches (2-3 paragraphs)
  2. Identify specific technical deficiencies of each approach
  3. The deficiencies must be technical, not commercial or social
  4. DO NOT admit the prior art is "superior" or "better"
  5. DO NOT cite specific patent numbers unless they are known prior art (citations go in IDS for US, or Background section for CN)

CN format: "背景技术" section describing existing technology and its shortcomings.

Step 5: Write Summary (发明内容)

Three parts, directly mirroring INVENTION_DISCLOSURE.md:

Technical Problem (要解决的技术问题):

  • State the problem derived from background deficiencies
  • CN: "本发明要解决的技术问题是..."

Technical Solution (技术方案):

  • Describe how the invention solves the problem
  • Must provide support for ALL claim elements
  • Start from the broadest claim and describe the core inventive concept
  • CN: "为解决上述技术问题,本发明采用的技术方案是:..."
  • NO formulas, NO mathematical derivations, NO circuit models — these belong in 具体实施方式, not 发明内容

Advantages (有益效果):

  • Benefits derived from the structural/technical features (qualitative reasoning)
  • CN: "本发明的有益效果是:..."
  • NO specific numerical results (e.g., "detection limit 70μm", "response time 105ms") — these are experimental findings, not invention properties
  • Frame advantages structurally: "由于采用了...结构,因此具有...效果"

Step 6: Write Brief Description of Drawings (附图说明)

Invoke /figure-description as a sub-skill if user has provided figures:

/figure-description "patent/figures/"

If no user figures, describe what figures should exist based on the claims.

Format:

  • CN: "图1是...的示意图;图2是...的流程图;"
  • US: "FIG. 1 is a block diagram showing...; FIG. 2 is a flowchart illustrating..."

Step 7: Write Detailed Description (具体实施方式)

Invoke /embodiment-description as a sub-skill:

/embodiment-description "patent/CLAIMS.md"

This section must:

  • Describe at least one complete embodiment with reference numerals
  • Enable a POSITA to make and use the invention
  • Support every claim element with explicit description
  • Include variations and alternatives for broader claim interpretation

Step 8: Write Abstract (摘要)

Jurisdiction-specific word limits:

JurisdictionWord LimitNotes
CN300 words (Chinese characters)Include most representative claim reference
US150 words (2500 characters)Enable efficient searching, no legal phrases
EP~150 wordsNo statements on merits or value

The abstract summarizes:

  1. The technical field
  2. The problem being solved
  3. The technical solution (core features)
  4. Key advantages

Step 9: Claim Support Verification

Verify every claim element finds support in the specification:

ClaimElementSpecification SectionParagraph(s)Reference Numeral
1step adetailed_description¶3202
1step bdetailed_description¶4204
Xcomponent Adetailed_description¶2102

If any element lacks support, add the necessary description before proceeding.

Step 10: Cross-Model Review

Call REVIEWER_MODEL via mcp__codex__codex with xhigh reasoning:

mcp__codex__codex:
  config: {"model_reasoning_effort": "xhigh"}
  prompt: |
    You are a patent examiner reviewing a specification for completeness.
    CLAIMS: [all claims]
    SPECIFICATION: [all specification sections]

    Check for:
    1. Written description support: Does every claim element have explicit or inherent support?
    2. Enablement: Can a POSITA practice the invention from this specification?
    3. Consistency: Do reference numerals match across figures and specification?
    4. Language quality: Any subjective terms, relative terms without definition, or result-to-be-achieved language?
    5. Missing embodiments: Are there claim features that need additional embodiments?
    6. Background deficiencies: Are they technical and specific enough?

Step 11: Output

All specification sections are in patent/specification/.

Summary file: patent/specification/SPECIFICATION_INDEX.md with:

## Patent Specification

### Sections
| Section | File | Word Count | Status |
|---------|------|-----------|--------|
| Title | title.md | | Complete |
| Technical Field | technical_field.md | | Complete |
| Background | background.md | | Complete |
| Summary | summary.md | | Complete |
| Drawings Description | drawings_description.md | | Complete |
| Detailed Description | detailed_description.md | | Complete |
| Abstract | abstract.md | | Complete |

### Claim Support Status
| Claim | Elements Supported | Elements Missing |
|-------|-------------------|-----------------|
| 1 | All | None |
| X | All | None |

Key Rules

  • The specification supports the claims, not the other way around. Every claim element must have support.
  • Use consistent terminology -- same word for the same concept throughout.
  • DO NOT include experimental results, accuracy metrics, or empirical evaluations.
  • DO NOT use subjective language ("excellent", "surprising", "superior").
  • Reference numerals must be consistent: same component, same numeral, everywhere.
  • Background section describes specific deficiencies, not general "need for improvement."
  • Multiple embodiments strengthen the specification but are not always required.
  • Large file handling: if a Write operation fails, retry with Bash cat <<'EOF' heredoc.
  • If mcp__codex__codex is not available, skip cross-model review and note it in the output.

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Claude

33.4%
按下载量换算88

Codex

32.23%
按下载量换算85

Cursor

19.32%
按下载量换算51

Gemini CLI

9.82%
按下载量换算26

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

external-service

该 Skill 可能调用第三方服务、云服务或外部模型 API,使用前需要确认账号、额度、数据发送范围和服务条款。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills