claude/skills/tech_text2ir/SKILL.md
技術記事/RFC/ADR/ポストモーテム等をTechArticleIR(Procedure/Design+Evidence+Discourse)に変換する。手順・意思決定・落とし穴を直交に抽出。「技術記事をIRに変換して」「TechIR作って」「RFCを構造化」「ADRをYAMLに」等で使用。ir-pipelineのtext2ir工程でも自動呼出。
npx skillsauth add lilpacy/dotfiles tech_text2irInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
あなたは「技術文書→IRコンパイラ」です。入力から TechArticleIR を生成してください。
ir_version: "techir.v0"
core:
metadata: { title: "", context: "", id: "" }
anchors:
- id: "A1"
kind: "paragraph"
path: "S1.P1"
quote: ""
entities:
- id: "E1"
type: "Component|API|Config|Metric|Env|Actor|Term"
surface: ["..."]
note: ""
facets:
discourse:
sections:
- id: "S1"
heading: ""
anchors: ["A1"]
procedure_design:
goals:
- id: "G1"
statement: ""
anchors: ["A2"]
decisions:
- id: "D1"
statement: ""
rationale: ""
anchors: ["A3"]
tags: ["ADR?","RFC?"]
tradeoffs:
- id: "T1"
pros: []
cons: []
anchors: ["A4"]
steps:
- id: "P1"
kind: "Step|Checklist|Migration|Runbook"
statement: ""
preconditions: ["E?","P?"]
anchors: ["A5"]
pitfalls:
- id: "F1"
statement: ""
mitigation: ""
anchors: ["A6"]
links:
- type: "requires|enables|blocks|alternative_to|mitigates|leads_to"
from: "P1"
to: "P2"
anchors: ["A5"]
confidence: 0.0
evidence:
items:
- id: "V1"
kind: "Benchmark|Incident|Spec|Doc|Observation|Experiment"
summary: ""
anchors: ["A7"]
links: ["D?","P?"]
measures:
- metric: ""
value: ""
delta: ""
links:
- type: "evidences|contradicts"
from: "V1"
to: "D1"
anchors: ["A7"]
confidence: 0.0
exceptions:
notes:
- id: "X1"
kind: "CustomerSpecific|EnvSpecific|StateSpecific|Legacy"
statement: ""
anchors: ["A8"]
risk: "low|med|high"
uncertainty:
notes:
- id: "U1"
kind: "Unverified|NeedsTest|EnvDependent|Assumption"
statement: ""
anchors: ["A9"]
severity: "low|med|high"
plan:
surface_templates:
- type: "howto|rfc|adr|postmortem|blog"
outline:
- role: "Problem"
include: ["S?","G?"]
- role: "Decision"
include: ["D?","T?","V?"]
- role: "Steps"
include: ["P?","F?","X?"]
validation:
invariants:
- "Every decision/step/pitfall/uncertainty has >=1 anchor"
- "Evidence links must cite anchors"
- "No duplicated decision text inside evidence/discourse; link by IDs"
development
Use when searching the web or reading online documentation. Prefer DuckDuckGo for search and read documents through npx curl.md instead of raw HTML.
testing
Use when writing or editing tests. Tests should be ordered by near-normal, normal, then abnormal cases where applicable, and test names must be Japanese behavior descriptions from a reviewer/user perspective.
development
GoF/オブジェクト指向デザインパターンを関数型プログラミング(pure functions, higher-order functions, ADT, composition, immutability, effect boundaries)でシンプルに整理・設計・リファクタリングする。Strategy/Factory/Adapter/ObserverなどGoF全23パターンのFP置き換え、適用判断、具体事例を提示する必要があるときに使う。
tools
Use when committing, pushing, or preparing PRs. Defines the user's commit workflow, message style discovery, review handoff, and branch/worktree push requirements.