Skip to content

Instantly share code, notes, and snippets.

View kogai's full-sized avatar
👁️
Watching you

Shinichi Kogai kogai

👁️
Watching you
View GitHub Profile
@k16shikano
k16shikano / SKILL.md
Last active September 21, 2026 07:24
cognitive-rhythm-writing/SKILL.md
name cognitive-rhythm-writing
description 説明的な文章に緩急を設計するための規範。緩急を装飾ではなく認知モードの切替(観察→逡巡→断定→再観察)と未回収の緊張の管理として扱い、文の拍、段落の密度波形、節の入り方、緩みと駄文の判別、執筆後の機械的な点検手順を定める。読み物として読ませたい章・記事・解説文を生成するとき、または「密度はあるが平坦でおもしろくない」文章を診断・修正するときに使用する。

認知リズムを生むための日本語ライティング規範

密度の高い文章が退屈になるのは、情報が多いからではなく、全文が同じ認知モードで書かれているからである。 この規範は、読者の認知モード(観察する、迷う、確信する、確かめ直す)を意図的に切り替え、常に「続きを読む理由」を維持することで、読み進める推進力を作る。

@k16shikano
k16shikano / SKILL.md
Last active September 21, 2026 09:48
japanese-tech-writing/SKILL
name japanese-tech-writing
description 日本語の技術文書・書籍原稿の文章規範。段落と論証の構成(パラグラフライティング)、論証の厳密さ(ツッコミどころの除去)、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、翻訳調の比喩と擬人化の禁止(「運ぶ」「効く」「開かれた問い」など)、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。
license Unlicense(https://gist.github.com/k16shikano/67625f2a7d96e3bbdfae8d571a936063

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

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

@ymmt2005
ymmt2005 / howto-tech-docs.md
Last active March 17, 2026 03:41
技術文書の書き方

技術文書の書き方

このメモは、私(@ymmt2005)が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。

科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。

しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。

@sairahul1526
sairahul1526 / sliding_window.go
Created August 25, 2020 17:04
Sliding Window Rate Limiting using Redis, Golang
// RateLimitUsingSlidingWindow .
func RateLimitUsingSlidingWindow(userID string, uniqueRequestID string, intervalInSeconds int64, maximumRequests int64) bool {
// userID can be apikey, location, ip
now := time.Now().Unix()
currentWindow := strconv.FormatInt(now/intervalInSeconds, 10)
key := userID + ":" + currentWindow // user userID + current time window
// get current window count
value, _ := redisClient.Get(ctx, key).Result()
#![feature(lang_items)]
#![no_std]
#[no_mangle]
pub fn add_one(x: i32) -> i32 {
x + 1
}
// needed for no_std
@voluntas
voluntas / webrtc_for_work.rst
Last active July 7, 2026 12:10
仕事で WebRTC

仕事で WebRTC

日時:2023-01-15
作:@voluntas
バージョン:2023.1
url:https://voluntas.github.io/

この資料は以下の製品の宣伝を含みます。

@voluntas
voluntas / naze_erlang.rst
Last active July 18, 2026 00:05
なぜ Erlang/OTP を使い続けるのか
module MS
def print(token)
case token
when MAtom
token.token
when Array
"( #{token.map{ |t| print(t) }.join(' ')} )"
else
raise 'Syntax Error!!'
end
@taichi
taichi / code_review_basics.md
Last active November 17, 2025 18:46
チームでコードを書き始めた後、「どうやらレビューってやつをした方が良いらしい」くらいの若手に向けた資料です。

コードレビューの基本


一番大事な事

ソースコードはプロジェクトの共同所有物である

  • 誰かだけが触れるコードを無くす