modkh 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (256) hide show
  1. package/README.md +24 -2
  2. package/dist/agent/bundled-skills.d.ts +13 -0
  3. package/dist/agent/bundled-skills.js +95 -0
  4. package/dist/agent/images.d.ts +10 -0
  5. package/dist/agent/images.js +33 -0
  6. package/dist/agent/loop.d.ts +56 -0
  7. package/dist/agent/loop.js +155 -0
  8. package/dist/agent/skills.d.ts +20 -0
  9. package/dist/agent/skills.js +169 -0
  10. package/dist/agent/types.d.ts +132 -0
  11. package/dist/agent/types.js +12 -0
  12. package/dist/cli/agents.d.ts +8 -0
  13. package/dist/cli/agents.js +12 -0
  14. package/dist/cli/approval.d.ts +27 -0
  15. package/dist/cli/approval.js +62 -0
  16. package/dist/cli/catalog.d.ts +39 -0
  17. package/dist/cli/catalog.js +76 -0
  18. package/dist/cli/chat.d.ts +18 -0
  19. package/dist/cli/chat.js +733 -0
  20. package/dist/cli/clipboard.d.ts +9 -0
  21. package/dist/cli/clipboard.js +54 -0
  22. package/dist/cli/color.d.ts +42 -0
  23. package/dist/cli/color.js +176 -0
  24. package/dist/cli/config.d.ts +41 -0
  25. package/dist/cli/config.js +188 -0
  26. package/dist/cli/editor.d.ts +16 -0
  27. package/dist/cli/editor.js +77 -0
  28. package/dist/cli/keys.d.ts +18 -0
  29. package/dist/cli/keys.js +82 -0
  30. package/dist/cli/language.d.ts +1 -0
  31. package/dist/cli/language.js +105 -0
  32. package/dist/cli/limits.d.ts +13 -0
  33. package/dist/cli/limits.js +19 -0
  34. package/dist/cli/lines.d.ts +18 -0
  35. package/dist/cli/lines.js +80 -0
  36. package/dist/cli/models.d.ts +4 -0
  37. package/dist/cli/models.js +69 -0
  38. package/dist/cli/permissions.d.ts +25 -0
  39. package/dist/cli/permissions.js +30 -0
  40. package/dist/cli/plugins.d.ts +1 -0
  41. package/dist/cli/plugins.js +53 -0
  42. package/dist/cli/providers.d.ts +46 -0
  43. package/dist/cli/providers.js +76 -0
  44. package/dist/cli/terminal.d.ts +143 -0
  45. package/dist/cli/terminal.js +742 -0
  46. package/dist/cli/usage.d.ts +29 -0
  47. package/dist/cli/usage.js +75 -0
  48. package/dist/index.d.ts +11 -0
  49. package/dist/index.js +164 -0
  50. package/dist/language/catalog.d.ts +44 -0
  51. package/dist/language/catalog.js +100 -0
  52. package/dist/language/commonlisp-bundled.d.ts +11 -0
  53. package/dist/language/commonlisp-bundled.js +22 -0
  54. package/dist/language/commonlisp-dependencies.d.ts +16 -0
  55. package/dist/language/commonlisp-dependencies.js +68 -0
  56. package/dist/language/commonlisp-install.d.ts +14 -0
  57. package/dist/language/commonlisp-install.js +213 -0
  58. package/dist/language/commonlisp-reader.d.ts +17 -0
  59. package/dist/language/commonlisp-reader.js +47 -0
  60. package/dist/language/commonlisp-systems.d.ts +3 -0
  61. package/dist/language/commonlisp-systems.js +32 -0
  62. package/dist/language/commonlisp-tls.d.ts +10 -0
  63. package/dist/language/commonlisp-tls.js +51 -0
  64. package/dist/language/detect.d.ts +29 -0
  65. package/dist/language/detect.js +103 -0
  66. package/dist/language/grammars/LICENSE +24 -0
  67. package/dist/language/grammars/manifest.json +76 -0
  68. package/dist/language/grammars/tree-sitter-c.wasm +0 -0
  69. package/dist/language/grammars/tree-sitter-cpp.wasm +0 -0
  70. package/dist/language/grammars/tree-sitter-css.wasm +0 -0
  71. package/dist/language/grammars/tree-sitter-html.wasm +0 -0
  72. package/dist/language/grammars/tree-sitter-javascript.wasm +0 -0
  73. package/dist/language/grammars/tree-sitter-php.wasm +0 -0
  74. package/dist/language/grammars/tree-sitter-python.wasm +0 -0
  75. package/dist/language/grammars/tree-sitter-ruby.wasm +0 -0
  76. package/dist/language/grammars/tree-sitter-rust.wasm +0 -0
  77. package/dist/language/grammars/tree-sitter-swift.wasm +0 -0
  78. package/dist/language/grammars/tree-sitter-tsx.wasm +0 -0
  79. package/dist/language/grammars/tree-sitter-typescript.wasm +0 -0
  80. package/dist/language/install.d.ts +50 -0
  81. package/dist/language/install.js +293 -0
  82. package/dist/language/lsp/client.d.ts +97 -0
  83. package/dist/language/lsp/client.js +337 -0
  84. package/dist/language/lsp/pool.d.ts +67 -0
  85. package/dist/language/lsp/pool.js +122 -0
  86. package/dist/language/lsp/service.d.ts +46 -0
  87. package/dist/language/lsp/service.js +138 -0
  88. package/dist/language/native.d.ts +8 -0
  89. package/dist/language/native.js +100 -0
  90. package/dist/language/platform.d.ts +14 -0
  91. package/dist/language/platform.js +20 -0
  92. package/dist/language/positions.d.ts +20 -0
  93. package/dist/language/positions.js +46 -0
  94. package/dist/language/syntax/assets.d.ts +9 -0
  95. package/dist/language/syntax/assets.js +73 -0
  96. package/dist/language/syntax/parser.d.ts +24 -0
  97. package/dist/language/syntax/parser.js +144 -0
  98. package/dist/language/typescript-capability.d.ts +6 -0
  99. package/dist/language/typescript-capability.js +42 -0
  100. package/dist/lisp/config.d.ts +16 -0
  101. package/dist/lisp/config.js +159 -0
  102. package/dist/lisp/routing.d.ts +5 -0
  103. package/dist/lisp/routing.js +24 -0
  104. package/dist/lisp/runtime.d.ts +21 -0
  105. package/dist/lisp/runtime.js +83 -0
  106. package/dist/memory/kiokuko.d.ts +32 -0
  107. package/dist/memory/kiokuko.js +102 -0
  108. package/dist/memory/mcp.d.ts +38 -0
  109. package/dist/memory/mcp.js +211 -0
  110. package/dist/model/ai-sdk.d.ts +27 -0
  111. package/dist/model/ai-sdk.js +180 -0
  112. package/dist/model/chatgpt/login.d.ts +42 -0
  113. package/dist/model/chatgpt/login.js +180 -0
  114. package/dist/model/chatgpt/responses.d.ts +41 -0
  115. package/dist/model/chatgpt/responses.js +202 -0
  116. package/dist/model/chatgpt/tokens.d.ts +11 -0
  117. package/dist/model/chatgpt/tokens.js +50 -0
  118. package/dist/model/connection.d.ts +6 -0
  119. package/dist/model/connection.js +65 -0
  120. package/dist/model/context.d.ts +9 -0
  121. package/dist/model/context.js +69 -0
  122. package/dist/model/factory.d.ts +25 -0
  123. package/dist/model/factory.js +88 -0
  124. package/dist/model/fixed.d.ts +17 -0
  125. package/dist/model/fixed.js +41 -0
  126. package/dist/model/reasoning.d.ts +16 -0
  127. package/dist/model/reasoning.js +62 -0
  128. package/dist/plugins/api.d.ts +60 -0
  129. package/dist/plugins/api.js +1 -0
  130. package/dist/plugins/manager.d.ts +34 -0
  131. package/dist/plugins/manager.js +261 -0
  132. package/dist/plugins/package.d.ts +13 -0
  133. package/dist/plugins/package.js +99 -0
  134. package/dist/plugins/registry.d.ts +8 -0
  135. package/dist/plugins/registry.js +14 -0
  136. package/dist/session/store.d.ts +82 -0
  137. package/dist/session/store.js +285 -0
  138. package/dist/session/workspace.d.ts +19 -0
  139. package/dist/session/workspace.js +73 -0
  140. package/dist/subagents/processes.d.ts +18 -0
  141. package/dist/subagents/processes.js +73 -0
  142. package/dist/subagents/request.d.ts +4 -0
  143. package/dist/subagents/request.js +21 -0
  144. package/dist/subagents/service.d.ts +39 -0
  145. package/dist/subagents/service.js +352 -0
  146. package/dist/subagents/settings.d.ts +10 -0
  147. package/dist/subagents/settings.js +32 -0
  148. package/dist/subagents/types.d.ts +43 -0
  149. package/dist/subagents/types.js +1 -0
  150. package/dist/subagents/verification.d.ts +31 -0
  151. package/dist/subagents/verification.js +178 -0
  152. package/dist/tools/diff.d.ts +6 -0
  153. package/dist/tools/diff.js +82 -0
  154. package/dist/tools/edit.d.ts +3 -0
  155. package/dist/tools/edit.js +152 -0
  156. package/dist/tools/files.d.ts +6 -0
  157. package/dist/tools/files.js +96 -0
  158. package/dist/tools/formal.d.ts +8 -0
  159. package/dist/tools/formal.js +77 -0
  160. package/dist/tools/guard.d.ts +7 -0
  161. package/dist/tools/guard.js +48 -0
  162. package/dist/tools/job-tools.d.ts +19 -0
  163. package/dist/tools/job-tools.js +148 -0
  164. package/dist/tools/jobs.d.ts +77 -0
  165. package/dist/tools/jobs.js +181 -0
  166. package/dist/tools/language.d.ts +6 -0
  167. package/dist/tools/language.js +174 -0
  168. package/dist/tools/registry.d.ts +28 -0
  169. package/dist/tools/registry.js +105 -0
  170. package/dist/tools/run.d.ts +13 -0
  171. package/dist/tools/run.js +159 -0
  172. package/dist/tools/search.d.ts +2 -0
  173. package/dist/tools/search.js +156 -0
  174. package/dist/tools/shell-process.d.ts +115 -0
  175. package/dist/tools/shell-process.js +286 -0
  176. package/dist/tools/skills.d.ts +2 -0
  177. package/dist/tools/skills.js +46 -0
  178. package/dist/tools/web.d.ts +24 -0
  179. package/dist/tools/web.js +386 -0
  180. package/docs/ci-repair-20261116.md +30 -0
  181. package/docs/commonlisp-provider-migration.md +22 -0
  182. package/docs/commonlisp-qlot-recovery.md +28 -0
  183. package/docs/commonlisp-tls-recovery.md +28 -0
  184. package/docs/context-efficiency.md +100 -0
  185. package/docs/input.md +66 -0
  186. package/docs/languages.md +117 -0
  187. package/docs/models.md +85 -0
  188. package/docs/modkh-evidence.json +641 -0
  189. package/docs/modkh-failure-comparison.json +675 -0
  190. package/docs/modkh-namespace.md +39 -0
  191. package/docs/modkh-qlot-evidence.json +37 -0
  192. package/docs/modkh-verification.md +173 -0
  193. package/docs/modkh.md +124 -0
  194. package/docs/presets.md +19 -0
  195. package/docs/setup.md +112 -0
  196. package/docs/subagents.md +134 -0
  197. package/docs/web.md +57 -0
  198. package/experiments/presets/common-lisp.lisp +38 -0
  199. package/experiments/presets/css.lisp +38 -0
  200. package/experiments/presets/formal.lisp +7 -0
  201. package/experiments/presets/html.lisp +38 -0
  202. package/experiments/presets/js.lisp +38 -0
  203. package/experiments/presets/php.lisp +38 -0
  204. package/experiments/presets/svelte.lisp +38 -0
  205. package/experiments/presets/tailwindcss.lisp +24 -0
  206. package/experiments/presets/ts.lisp +38 -0
  207. package/package.json +49 -4
  208. package/plugins/modkh-explorer/index.mjs +3 -0
  209. package/plugins/modkh-explorer/plugin.json +1 -0
  210. package/plugins/modkh-worker/index.mjs +3 -0
  211. package/plugins/modkh-worker/plugin.json +1 -0
  212. package/skills/kiokuko-dsh/LICENSE +21 -0
  213. package/skills/kiokuko-dsh/coding-ideal-routine-skill/SKILL.md +106 -0
  214. package/skills/kiokuko-dsh/japanese-translation-for-oss-models/SKILL.md +65 -0
  215. package/skills/kiokuko-dsh/kiokuko-architecture/SKILL.md +20 -0
  216. package/skills/kiokuko-dsh/kiokuko-architecture/references/cases.md +11 -0
  217. package/skills/kiokuko-dsh/kiokuko-benchmark/SKILL.md +20 -0
  218. package/skills/kiokuko-dsh/kiokuko-benchmark/references/cases.md +11 -0
  219. package/skills/kiokuko-dsh/kiokuko-investigate/SKILL.md +20 -0
  220. package/skills/kiokuko-dsh/kiokuko-investigate/references/cases.md +11 -0
  221. package/skills/kiokuko-dsh/kiokuko-lisp/SKILL.md +390 -0
  222. package/skills/kiokuko-dsh/kiokuko-review/SKILL.md +20 -0
  223. package/skills/kiokuko-dsh/kiokuko-review/references/cases.md +11 -0
  224. package/skills/kiokuko-dsh/kiokuko-simple-work/SKILL.md +70 -0
  225. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/SKILL.md +79 -0
  226. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/boundaries-and-ownership.md +52 -0
  227. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/domain-and-types.md +48 -0
  228. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/effects-and-data.md +43 -0
  229. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +314 -0
  230. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/problem-shaping-and-language.md +90 -0
  231. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/protocols-and-idempotency.md +42 -0
  232. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/review-checklist.md +92 -0
  233. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/verification.md +45 -0
  234. package/skills/kiokuko-dsh/kiokuko-skill-authoring/SKILL.md +20 -0
  235. package/skills/kiokuko-dsh/kiokuko-skill-authoring/references/cases.md +11 -0
  236. package/skills/kiokuko-dsh/kiokuko-soul/SKILL.md +25 -0
  237. package/skills/kiokuko-dsh/kiokuko-technical-writing/SKILL.md +20 -0
  238. package/skills/kiokuko-dsh/kiokuko-technical-writing/references/cases.md +11 -0
  239. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/SKILL.md +64 -0
  240. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/accessibility-and-navigation.md +31 -0
  241. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/async-recovery.md +49 -0
  242. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/forms-and-controls.md +35 -0
  243. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/interaction-feedback.md +34 -0
  244. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/responsive-and-platform.md +38 -0
  245. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/safety-and-review.md +43 -0
  246. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/ui-checklist.md +75 -0
  247. package/skills/kiokuko-dsh/kiokuko-verification/SKILL.md +20 -0
  248. package/skills/kiokuko-dsh/kiokuko-verification/references/cases.md +11 -0
  249. package/skills/kiokuko-dsh/manifest.json +168 -0
  250. package/skills/kiokuko-dsh/memory-reasoning/SKILL.md +44 -0
  251. package/skills/kiokuko-dsh/one-shot-software-completion/SKILL.md +113 -0
  252. package/skills/kiokuko-dsh/one-shot-software-completion/references/boundaries-and-lifecycle.md +70 -0
  253. package/skills/kiokuko-dsh/one-shot-software-completion/references/discovery-and-scope.md +71 -0
  254. package/skills/kiokuko-dsh/one-shot-software-completion/references/failure-recovery.md +43 -0
  255. package/skills/kiokuko-dsh/one-shot-software-completion/references/verification-and-completion.md +73 -0
  256. package/skills/kiokuko-dsh/veteran-programmer-skill/SKILL.md +66 -0
@@ -0,0 +1,106 @@
1
+ ---
2
+ name: coding-ideal-routine-skill
3
+ description: コードを書く、変更するすべての依頼で使用する。バグ修正・機能追加・リファクタリング・挙動に関わる設定や配布物の変更を、まず動かす→正しくする→実践を続ける順で進め、調査→失敗するテスト→実装→実利用経路の受け入れ検証→事実に基づく報告を行う。単なる質問・説明・計画には実装手順を強制しない。
4
+ ---
5
+
6
+ <!-- KIOKUKO MANAGED STANDARD SKILL: coding-ideal-routine-skill -->
7
+
8
+ # Coding Ideal Routine
9
+
10
+ 目的は、変更箇所のテストを通すだけでなく、ユーザーが普段行う操作で要求を満たすこと。既存の作業規約とユーザーの目的・環境・権限を守り、変更リスクに見合う最小限の検証で根拠を積み上げる。
11
+
12
+ ## 基本原則: まず動かす → 正しくする → 実践を続ける
13
+
14
+ この順序は、動けば雑でよいという意味ではない。観測可能な成果を最小単位で成立させ、その挙動を固定してから構造を整え、再現可能な作業として仕上げる。[ub-mode](https://github.com/unclebob/ub-mode/blob/master/SKILL.md) の原則を、このリポジトリの権限・検証規約に合わせて次のように適用する。
15
+
16
+ ### まず動かす
17
+
18
+ - 一つの判断を一か所に置き、要求を満たす最小の編集から始める。ロジックを書く前にデータ形状と責務を決め、後続工程全体を簡単にする作業を先に行う。
19
+ - 共有状態を直ちにロックで囲わない。共有不要なら分離し、必要なら単一 writer を構造で保証する。外部入力は境界で一度検証・変換し、内部の業務判断は純粋で制約された値として扱う。コンパイラや型検査を黙らせない。
20
+ - 挙動変更は失敗する正直なテストから始め、期待した理由で失敗することを見て、通す最小変更を行う。現実の利用契約を表せないテストを数合わせで追加しない。
21
+ - 新要件を既存設計へ継ぎ足す前に、最初からその要件があればどう設計したかを考え、後戻りできる検証可能な単位へ分けて届ける。足す前に不要な複雑さを減らす。
22
+ - 同じ前提に立つ二つの修正が同じ関門で失敗したら、前提と状態を持つ主体を明示し、誤った責務の割当てを除いてから次の修正へ進む。
23
+ - 作業が一見して明らかでない反復なら、まず一単位を手で正しく実行し、それに一致する小さな道具を作る。違法状態を表現できないドメイン形状、共通語彙、再実行しても同じ終状態になる操作を優先する。既存コードが明快で局所的なら、抽象化を増やさない。
24
+
25
+ ### 正しくする
26
+
27
+ - 不具合は再現し、症状を隠す guard ではなく原因を直す。小さな単位を一つ終えて検証してから次へ進む。
28
+ - テストは内部実装ではなく、利用者と同じ入口から観測できる振る舞いを固定する。主要な処理が空でも通るテストは正しさの証拠にしない。
29
+ - Crapper、Dryer、Mutator または同等の品質ゲートが利用可能で変更リスクに見合う場合は、CRAP 10 未満、類似度 0.8 以上の重複除去、mutation survivor の排除を目安に使う。未導入の外部ツールを無断で追加せず、数値だけのために明快なコードを崩さない。
30
+ - リファクタリングでは先に現在の挙動を固定し、構造だけを変え、同じ外部挙動が保たれたことを証明する。
31
+
32
+ ### 実践を続ける
33
+
34
+ - 重要な操作、判断の根拠、観測した結果を簡潔な作業記録として残し、完了報告に要点を含める。非公開の推論過程や大量の生ログを開示しない。
35
+ - 主作業の文脈を小さく保ち、大きな出力は必要な証拠と要約だけを残す。
36
+ - worktree や一時成果物を片付ける前に利用中でないことを確認する。未コミット作業は削除せず、扱いを決めるまで保持する。
37
+ - 明示的に依頼された場合だけ commit や push を行う。その場合も、理由・変更・検証が対応する小さく順序立った commit にする。
38
+
39
+ ## 1. 作業の種類と完了条件を決める
40
+
41
+ - 質問・調査・計画だけなら、その回答を完成させる。依頼のない編集やテスト追加、記憶の読み直しを始めない。
42
+ - 修正・機能追加なら、現状の実装、関連テスト、利用手順、実行可能な環境を確認する。コードを書く前に「誰が、どの入口から、何をして、何が観測できれば成功か」を短く定義する。
43
+ - 挙動を変えない文章修正やリファクタリングでは、変更に適した検証を選ぶ。Red が不要な理由を明記し、無意味な失敗を作らない。文章・設定でも利用手順や実行結果が変わるなら挙動変更として扱う。
44
+ - 不明点は既存の仕様と利用実態から解消する。結果や権限を左右する曖昧さだけ確認し、勝手な機能拡張をしない。
45
+
46
+ ## 2. 部品ではなく、つながった利用経路を見る
47
+
48
+ DSH では、元の依頼と実際の結果に沿って調査・実装・検証を進める。作業前に Goal や内部 ID を登録する必要はない。準備済みタスクの実行結果はホストが記録する。必要なら `coding_workflow status` で確認し、`coding_workflow_apply` の `annotate` に説明と既存の証拠参照を添える。記録の整理や失敗で、許可済みの作業を止めない。
49
+
50
+ 実装の経路はホストが確定した Lisp 選択に従う。Lisp ON の通常作業は `lisp_eval` などの Lisp ツールから直接進める。記憶の準備・レビューや Goal 登録を開始条件にしない。明示的な保護ワークフローだけは、小さい関連試作を `lisp_eval`(`prototype:true`)で実行し、成功した保存結果を `lisp_inspect` で確認してから実装する。起動や試作に失敗したら原因を修復し、明示された選択を勝手に変更しない。
51
+
52
+ サブエージェントへ委譲する場合は、通常の直接編集と区別する。`subagent`/`subagent_fork` は親タスクの所有権と停止を子へ結び付けるため、起動前に親が `prepare_requested_work` を呼ぶ。元のユーザー依頼から `requestIntent` を解釈し、現在のホストが示す `evidenceRefs` を使う。準備済みの現在の親タスクは再利用し、委譲のためだけに Goal や記憶レビューを追加しない。準備前の委譲が拒否された場合は、子が起動していないことを結果で確認し、親の準備が成功してから再実行する。子に親タスクを準備させない。準備できない場合は、拒否・未解決の確認・Stop を守り、許可済みの直接作業を続ける。
53
+
54
+ 最新成果物を使って実際の利用経路を確認する。登録済みのチェックは `task_completion bind` で実行方法に紐付け、ホストが観測した結果を確認する。同じ検証が複数の目的を満たす場合は共有し、足りない確認を追加する。実行結果・未確認事項・記録の状態は分けて報告する。
55
+
56
+ 変更に関連する通常の操作を、入口から観測可能な結果までたどる。該当する場合は、配布・インストール → 読み込まれる指示/設定 → 公開ツールや UI → 実処理 → ユーザーの成果物までを対象にする。
57
+
58
+ - 各部品の成功を、連結した経路の成功に置き換えない。生産側が実際に出す値を、消費側がそのまま受け取れるか確かめる。
59
+ - 例: インストールされた指示が出す alias と prefix を組み合わせた参照が、実際の読み取りツールで解決できること。alias 単独、prefix 単独のテストだけでは不足する。
60
+ - 配布物や導入処理が関係する変更では、隔離した環境へ正規の方法で導入した成果物を境界テストに使う。ソース直読みや内部関数の直接呼び出しだけで代替しない。
61
+ - 本番相当の入力は、公開された利用契約や実際の成果物から得る。テスト側で canonical 名へ書き換える、欠けた設定を注入する、製品の不具合を補正するなどの救済をしない。
62
+ - AI が操作する製品では、被試験 AI に修正箇所・正解・特別な操作順を教え込まない。通常配布される指示と自然な依頼で試す。評価側だけが正解を保持する。
63
+
64
+ ## 3. 挙動変更は Red → Green
65
+
66
+ 1. 要求・仕様から期待値を先に決め、最小の回帰テストまたは受け入れテストを書く。新機能は未実装時に要求を満たさないことを表す。
67
+ 2. 修正前のコードで実行し、意図した挙動の不一致で失敗することを確認する。構文エラー、依存不足、認証失敗は Red の証拠に数えない。
68
+ 3. 原因を直す最小限の変更を行い、同じテストが通ることを確認する。テストを削除・弱体化したり、実装の出力を正解にして通したりしない。
69
+ 4. 必要な整理を行い、関連する既存テストと経路の受け入れ検証を再実行する。
70
+
71
+ 修正前の状態を実行できないなど、正当な制約で Red を確認できない場合は、その理由と代替証拠を残す。可能なら隔離した旧版で再現する。Red を観測していないのに「再現済み」「TDD 完了」と報告しない。
72
+
73
+ ## 4. 独立した正しさと、必要な範囲を検証する
74
+
75
+ - 期待値は要求・仕様・手計算・独立した fixture などから得る。被試験コードと同じ変換関数を使って期待値を計算しない。AI の「成功しました」やログの文字列だけを正解判定にしない。
76
+ - 影響する境界値、条件の組み合わせ、失敗後の復旧を選ぶ。個々の成功例だけでなく、今回壊れ得る接続部分を含める。
77
+ - 復旧が関係する変更では「一度失敗 → 許可された修正/再試行 → 正しい最終状態」を確認する。成功した最後の一回だけでなく、不要な副作用・重複・失敗状態の残留も確認する。
78
+ - 高速で決定的な回帰テストを基本にする。関連する公開境界のテストを加え、モックで確認できない実サービス固有の挙動がある場合だけ、目的と終了条件を決めて live 検証する。
79
+ - 毎回の全ホスト・全モデル・全 API の高額な総当たりは行わない。変更が触れる接続とリスクに応じて選び、未検証の範囲を残す。実サービスへの送信、費用、認証、外部変更は既存の許可範囲に従う。
80
+
81
+ ## 5. 障害と権限を混同しない
82
+
83
+ - ツール引数・構文・依存関係・テスト環境の問題は、原因を特定し、許可された範囲で修復して再実行する。最初の失敗だけで作業を打ち切らない。
84
+ - 明示的なアクセス拒否・承認不足は別扱い。別ツール、別アカウント、別経路で迂回しない。必要な操作・対象・不足する許可を報告し、その操作を止める。
85
+ - 再試行は原因に対する変更と観測可能な進展がある場合に行う。同じ条件で無限に繰り返さない。解消不能な制約や追加判断が必要なら、独立して進められる作業を終え、ブロッカーを明示する。
86
+
87
+ ## 6. 最終版の証拠で完了を判定する
88
+
89
+ - 最後の変更を含む revision/作業ツリーで検証する。ビルド・配布物が必要なら再生成し、それを使う。検証後に内容を変えた場合は影響する検証をやり直す。
90
+ - 実行した対象、検証数、終了状態、assertion、成果物を確認する。skip、空 suite、no-op、終了コード 0 だけ、古い成果物、自己申告を成功の代わりにしない。無関係な既存 skip がある場合も、必要な受け入れ条件まで通ったことを別に確かめる。
91
+ - 差分に無関係な変更やテスト専用の抜け道がないことを確認する。未検証の経路は「未検証」、環境障害は「検証不能」と区別し、全体成功に混ぜない。
92
+ - ユーザーには、変更内容、確認できた通常利用、実行した検証と結果、残る制約を簡潔に報告する。再現・実装・ローカル検証・公開/本番反映は別々の事実として扱う。許可のない公開やデプロイを完了条件に追加しない。
93
+
94
+ この Skill は実行時の判断を支援する手順であり、ホストによる毎回の呼び出しや不具合の完全防止を保証する仕組みではない。
95
+
96
+ ## Repository verification entry
97
+
98
+ When the target repository defines `npm run verify`, read `npm run verify:plan`
99
+ (or `npm run verify -- --plan --profile <profile>`) and use that declared scope.
100
+ Run the same profile locally and in CI; do not reconstruct independent checks
101
+ from CI YAML. `npm test` and focused commands are partial evidence. The JSON
102
+ result records each required check, prerequisite failure, platform exclusion,
103
+ and source/artifact identity. Only a current full-scope `completionReady: true`
104
+ result supports full verification. Recheck saved results with
105
+ `npm run verify -- --status <result.json>` after related edits or artifact changes.
106
+ Never derive skip permissions or expected failures from observed test output.
@@ -0,0 +1,65 @@
1
+ ---
2
+ name: natural-japanese-output
3
+ description: Write Japanese that reads as if it was originally Japanese. Use when the user writes in Japanese or requests Japanese output.
4
+ ---
5
+
6
+ <!-- KIOKUKO MANAGED STANDARD SKILL: natural-japanese-output -->
7
+
8
+ <!-- kiokuko:runtime contract -->
9
+ # Natural Japanese Output
10
+
11
+ Write naturally from meaning, not sentence order; keep reasoning private.
12
+
13
+ ## Meaning and structure
14
+
15
+ Resolve omissions/references like 「それ」「全部」「続けて」 from this session's request, work and proposals; preserve actor, negation and quotes. 「動作を見て」 means verify, not edit permission. Use evidence, not phrase rules. Honor host `requestIntent` refs; do not rewrite requests, invent targets, borrow chats or infer permission. Clarify ambiguity.
16
+
17
+ Preserve facts and distinguish must/need to/should/recommended/optional/likely/possible/uncertain; never weaken requirements or state speculation as fact. Lead technical answers with conclusions, then reasons and conditions.
18
+
19
+ Required schemas and block order take precedence. Apply style within the blocks; do not reorder a mandated structure. Explicit output-language requests take precedence over the input language. Preserve code identifiers, literal quotations, evidence references and machine-readable values; in JSON, apply this guidance only to human-readable Japanese strings.
20
+
21
+ Bilingual companion files must mirror the source's sections and order. Keep code blocks, commands, paths, configuration keys and identifiers byte-identical. Translate prose only; do not add examples, merge sections or insert explanations absent from the source. Update both files together.
22
+
23
+ ## Natural wording
24
+
25
+ - Omit unnecessary subjects, repeated names and English-style pronouns; name the referent when omission would make the actor ambiguous.
26
+ - Rebuild English word order, sentence boundaries, rhetoric and connective frequency. Merge related thoughts where natural; use ただし or そのため only when the connection needs stating.
27
+ - Prefer verbs and potential forms: 実装する、改善する、確認できる. Avoid bureaucratic nominalizations such as 実装を行う and repeated ことができます.
28
+ - Use という for definitions or quotations, not as filler. Prefer では/について/です over において/に関して/となります.
29
+ - Replace unsupported 良い、強力、高性能、柔軟、効率的 with the concrete effect or mechanism.
30
+ - Keep established technical terms when precise (event loop, race condition, worker, transaction, schema, retry). Prefer standard Japanese equivalents such as 依存関係、並行性、並列性、一貫性、可用性. Accuracy outranks forced localization.
31
+ - Never translate names such as `max_threads` or change numerical limits and syntax.
32
+
33
+ Useful reconstructions:
34
+ 「Laravelはリクエストを受け取ります。Laravelはルートを解決します。」→「Laravelがリクエストを受け取ると、ルートを解決する。」
35
+ 「それは60秒後に失効します」→「このキャッシュは60秒後に失効する。」
36
+ 「この方式は効率的です」→「この方式ならプロセス生成が不要なので、起動コストを抑えられる。」
37
+
38
+ Warning signs, not forbidden strings: 〜ということを意味します、〜であるという事実、これは〜です、しかしながら、加えて、〜の観点から、〜を提供します、〜を可能にします、〜することが重要です. Use a shorter concrete expression when it carries the same meaning.
39
+
40
+ ## Register and final check
41
+
42
+ Technical analysis: concise; distinguish fact/inference/recommendation/uncertainty and trade-offs. Keep general explanations natural; preserve requested voice, rhythm, humor and slang in creative/social writing; do not sanitize.
43
+
44
+ Before sending, check:
45
+ 1. Did the answer address the actual question and preserve facts, modality and technical distinctions?
46
+ 2. Does English sentence structure still show through? Rewrite the meaning rather than translating the wording.
47
+ 3. Are subjects, connectives and sentence endings needlessly repeated? Split cumbersome clauses or merge closely related sentences.
48
+ 4. Would a technically literate native speaker naturally write this? Grammatical correctness alone is insufficient.
49
+ <!-- /kiokuko:runtime -->
50
+
51
+ <!-- kiokuko:documentation examples -->
52
+ ## Further wording examples
53
+
54
+ These examples illustrate the runtime rules; they add no requirements.
55
+
56
+ | Stiff or translated phrasing | Natural phrasing |
57
+ | --- | --- |
58
+ | 設定の変更を実行することで問題の解決を行えます。 | 設定を変えれば解決できる。 |
59
+ | このコマンドを使用することでログを確認することができます。 | このコマンドでログを確認できる。 |
60
+ | Laravelにおいて、この設定に関して変更が必要です。 | Laravelでは、この設定を変更する必要がある。 |
61
+ | この方式は複数の利点を提供します。第一に、それは依存関係を明確にします。 | この方式には主に二つの利点がある。依存関係が明確になり、テストもしやすくなる。 |
62
+
63
+ Keep technical distinctions even when simplifying the wording: 「必須」と「推奨」、
64
+ 「確認済み」と「可能性がある」は別の意味を持つ。
65
+ <!-- /kiokuko:documentation -->
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: kiokuko-architecture
3
+ description: Resolve consequential interface, ownership or domain design choices before implementation.
4
+ ---
5
+
6
+ <!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-architecture -->
7
+
8
+ <!-- kiokuko:runtime contract -->
9
+ # Architecture
10
+
11
+ Follow SOUL and the current host directive. This skill grants no extra permissions, model changes or delegation. Use the current model and proportionate evidence.
12
+
13
+ Write caller usage first. Name domain concepts, ownership, inputs, failures and effects before choosing representations. Compare two structurally distinct alternatives only when a consequential uncertainty remains. Evaluate compatibility, complexity, testability and migration cost against explicit constraints. Keep mechanical changes on the simple-work route.
14
+
15
+ ## Completion
16
+
17
+ Deliver an interface sketch, decision, rejected alternative and focused verifier. Revisit the design when repeated workarounds expose a false premise. Do not commit broken scaffolding or replace required compatibility with a clean-slate assumption.
18
+
19
+ Read [worked cases](references/cases.md) only when the decision or failure boundary is unclear. Do not load unrelated specialists or repeat completed checks without new evidence.
20
+ <!-- /kiokuko:runtime -->
@@ -0,0 +1,11 @@
1
+ <!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-architecture -->
2
+
3
+ # Decision example
4
+
5
+ A new public field can be represented as optional properties or a discriminated union.
6
+
7
+ Write the two caller examples. Compare invalid states, serialization compatibility and migration cost. Choose the smallest shape that preserves existing consumers.
8
+
9
+ ## Non-trigger
10
+
11
+ A mechanical edit with known behavior uses the existing simple-work and code contracts. Do not turn it into a panel, benchmark or architecture exercise.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: kiokuko-benchmark
3
+ description: Measure performance or assess a speedup, regression or benchmark claim.
4
+ ---
5
+
6
+ <!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-benchmark -->
7
+
8
+ <!-- kiokuko:runtime contract -->
9
+ # Benchmark
10
+
11
+ Follow SOUL and the current host directive. This skill grants no extra permissions, model changes or delegation. Use the current model and proportionate evidence.
12
+
13
+ State the claim and inspect what the timer counts and excludes. Verify outputs and count failed, skipped and retried work. Identify the bottleneck and check physical limits. Match versions, data, production settings and cache state. Interleave at least five runs per side for comparisons; a requested one-run estimate must be labeled. Profile separately from timed runs.
14
+
15
+ ## Completion
16
+
17
+ Report baseline, candidate, method, sample count, distribution and uncertainty. A faster failure or no-op is not a speedup. Do not select a winner from unequal configurations or noise; explain what further measurement can resolve.
18
+
19
+ Read [worked cases](references/cases.md) only when the decision or failure boundary is unclear. Do not load unrelated specialists or repeat completed checks without new evidence.
20
+ <!-- /kiokuko:runtime -->
@@ -0,0 +1,11 @@
1
+ <!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-benchmark -->
2
+
3
+ # Decision example
4
+
5
+ A candidate exports twice as fast but rejects half the rows.
6
+
7
+ Count accepted and rejected rows and compare exact output. Reject the speedup claim; measure equivalent successful work before reporting a winner.
8
+
9
+ ## Non-trigger
10
+
11
+ A mechanical edit with known behavior uses the existing simple-work and code contracts. Do not turn it into a panel, benchmark or architecture exercise.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: kiokuko-investigate
3
+ description: Trace behavior, investigate design rationale, or explain a subsystem using bounded current evidence.
4
+ ---
5
+
6
+ <!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-investigate -->
7
+
8
+ <!-- kiokuko:runtime contract -->
9
+ # Investigate
10
+
11
+ Follow SOUL and the current host directive. This skill grants no extra permissions, model changes or delegation. Use the current model and proportionate evidence.
12
+
13
+ Trace the actual entry point, state, effects, failures and consumer result. For rationale, inspect relevant history and authorized sources; code alone cannot prove intent. Separate observed facts, historical evidence, inference and unknowns. Explain the smallest complete answer at the requested depth. Never mine other chats or search unrelated sources.
14
+
15
+ ## Completion
16
+
17
+ Evidence: cite paths and relevant lines or source links. Record missing sources and contradictions. Stop when the question is answered; do not turn explanation into an unsolicited refactor.
18
+
19
+ Read [worked cases](references/cases.md) only when the decision or failure boundary is unclear. Do not load unrelated specialists or repeat completed checks without new evidence.
20
+ <!-- /kiokuko:runtime -->
@@ -0,0 +1,11 @@
1
+ <!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-investigate -->
2
+
3
+ # Decision example
4
+
5
+ A retry function has a five-second delay but no rationale in history.
6
+
7
+ Trace when the retry runs and cite the constant. State that its historical motivation is unknown; do not invent an outage story.
8
+
9
+ ## Non-trigger
10
+
11
+ A mechanical edit with known behavior uses the existing simple-work and code contracts. Do not turn it into a panel, benchmark or architecture exercise.