Skip to content

Instantly share code, notes, and snippets.

@k16shikano
k16shikano / SKILL.md
Last active July 10, 2026 05:14
japanese-tech-writing/SKILL
name japanese-tech-writing
description 日本語の技術文書・書籍原稿の文章規範。整形(一文一行、引用ブロック、脚注、コラム記法)、段落と論証の構成(パラグラフライティング)、論証の厳密さ(ツッコミどころの除去)、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。

日本語技術文書の文章規範

日本語で技術的な原稿(書籍の章、記事、解説文)を書く・推敲するときは、以下の規範に従う。

整形

@echo off
rem 作成者:en129(https://x.com/en129)
rem 遅延環境変数を有効にする
setlocal enabledelayedexpansion
rem エスケープ文字を取得して変数ESCに格納(色付けの準備)
for /F %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"
rem カラー設定の定義
@mala
mala / gist:5882869
Created June 28, 2013 06:30
htn.to デフォルトリダイレクト先変更に寄せて

もう皆すっかり忘れてると思うんだけど、2009年ごろに特定の検索エンジン(具体的にはGoogleね)が、 URLの中にURLが入ってるようなのを一律検索結果から除外するといったことがあった。

既存のURLをパラメータとして受け取って、際限なくコンテンツ生成するようなものは、Googleの検索結果から除外されることになった。 (キャッシュとか変換とか翻訳とかそういうのは自主的にrobots.txtやmetaタグで検索結果から除外されるようにすべきだと思う)

ソーシャルブックマークの場合は、単に変換したり翻訳したりしているわけではなく、付加的な情報があるわけだけど そんなことをわざわざGoogleが特別扱いはしなかった。単にURLの中にURLが入ってるものは除外された。

// Vimperator plugin: 'Cooperation LDRize Mappings'
// Version: 0.25
// Last Change: 07-Jan-2011. Jan 2008
// License: Creative Commons
// Maintainer: Trapezoid <trapezoid.g@gmail.com> - http://unsigned.g.hatena.ne.jp/Trapezoid
//
// Cooperation LDRize Mappings for Vimperator
//
// Variables:
// g:ldrc_captureMapping
@mEGGrim
mEGGrim / togetterfilter.user.js
Created October 21, 2010 18:00 — forked from anonymous/togetterfilter.user.js
TogetterFilter.js
// ==UserScript==
// @name TogetterFilter
// @namespace TogetterFilter
// @description Togetterを任意のユーザー名を用いてフィルタリング
// @include http://togetter.com/*
// ==/UserScript==
(function() {
// ここにフィルタリングしたいユーザーのIDを''で囲い、,で区切って記述して下さい
// wedata utility for Greasemonkey
// usage
/*
// ==UserScript==
// @name foo bar
// @namespace http://baz.com
// @require http://gist.github.com/raw/34615/04333b7e307eb029462680e4f4cf961f72f4324c
// ==/UserScript==