kiokuko 1.0.25 → 1.0.27
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.
- package/README.ja.md +3 -0
- package/README.md +3 -0
- package/dist/agent-file/render.d.ts +1 -1
- package/dist/agent-file/render.js +1 -1
- package/dist/akinator/instructions.d.ts +1 -1
- package/dist/akinator/instructions.d.ts.map +1 -1
- package/dist/akinator/instructions.js +2 -2
- package/dist/akinator/instructions.js.map +1 -1
- package/dist/assurance/codex-hooks.d.ts.map +1 -1
- package/dist/assurance/codex-hooks.js +33 -1
- package/dist/assurance/codex-hooks.js.map +1 -1
- package/dist/assurance/inspect.d.ts.map +1 -1
- package/dist/assurance/inspect.js +12 -3
- package/dist/assurance/inspect.js.map +1 -1
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +5 -0
- package/dist/mcp/server.js.map +1 -1
- package/dist/setup/standard-skills.d.ts +14 -0
- package/dist/setup/standard-skills.d.ts.map +1 -1
- package/dist/setup/standard-skills.js +14 -0
- package/dist/setup/standard-skills.js.map +1 -1
- package/docs/README.ja.md +1 -0
- package/docs/README.md +1 -0
- package/docs/agenticreplay.ja.md +88 -0
- package/docs/agenticreplay.md +88 -0
- package/docs/client-compatibility.md +21 -1
- package/docs/normal-workflow-acceptance.md +330 -0
- package/package.json +5 -1
- package/skills/coding-ideal-routine-skill/SKILL.md +59 -0
- package/skills/kiokuko-soul/SKILL.md +45 -4
- package/skills/one-shot-software-completion/SKILL.md +8 -0
- package/skills/repair-user-workflow/SKILL.md +118 -0
- package/skills/repair-user-workflow/references/scenarios.md +33 -0
- package/templates/AGENTS.md +2 -2
|
@@ -20,12 +20,18 @@ export declare const STANDARD_SOUL_SKILL_FILES: readonly ["SKILL.md"];
|
|
|
20
20
|
export declare const STANDARD_WORKFLOW_SKILL_NAME = "veteran-programmer-skill";
|
|
21
21
|
export declare const STANDARD_WORKFLOW_SKILL_MANAGED_MARKER = "<!-- KIOKUKO MANAGED STANDARD SKILL: veteran-programmer-skill -->";
|
|
22
22
|
export declare const STANDARD_WORKFLOW_SKILL_FILES: readonly ["SKILL.md"];
|
|
23
|
+
export declare const STANDARD_REPAIR_SKILL_NAME = "repair-user-workflow";
|
|
24
|
+
export declare const STANDARD_REPAIR_SKILL_MANAGED_MARKER = "<!-- KIOKUKO MANAGED STANDARD SKILL: repair-user-workflow -->";
|
|
25
|
+
export declare const STANDARD_REPAIR_SKILL_FILES: readonly ["SKILL.md", "references/scenarios.md"];
|
|
23
26
|
export declare const STANDARD_JAPANESE_SKILL_NAME = "natural-japanese-output";
|
|
24
27
|
export declare const STANDARD_JAPANESE_SKILL_MANAGED_MARKER = "<!-- KIOKUKO MANAGED STANDARD SKILL: natural-japanese-output -->";
|
|
25
28
|
export declare const STANDARD_JAPANESE_SKILL_FILES: readonly ["SKILL.md"];
|
|
26
29
|
export declare const STANDARD_COMPLETION_SKILL_NAME = "one-shot-software-completion";
|
|
27
30
|
export declare const STANDARD_COMPLETION_SKILL_MANAGED_MARKER = "<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->";
|
|
28
31
|
export declare const STANDARD_COMPLETION_SKILL_FILES: readonly ["SKILL.md", "references/discovery-and-scope.md", "references/boundaries-and-lifecycle.md", "references/verification-and-completion.md", "references/failure-recovery.md"];
|
|
32
|
+
export declare const STANDARD_CODING_ROUTINE_SKILL_NAME = "coding-ideal-routine-skill";
|
|
33
|
+
export declare const STANDARD_CODING_ROUTINE_SKILL_MANAGED_MARKER = "<!-- KIOKUKO MANAGED STANDARD SKILL: coding-ideal-routine-skill -->";
|
|
34
|
+
export declare const STANDARD_CODING_ROUTINE_SKILL_FILES: readonly ["SKILL.md"];
|
|
29
35
|
export declare const STANDARD_SKILL_MANIFESTS: readonly [{
|
|
30
36
|
readonly name: "kiokuko-ui-design-soul";
|
|
31
37
|
readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-ui-design-soul -->";
|
|
@@ -46,6 +52,10 @@ export declare const STANDARD_SKILL_MANIFESTS: readonly [{
|
|
|
46
52
|
readonly name: "veteran-programmer-skill";
|
|
47
53
|
readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: veteran-programmer-skill -->";
|
|
48
54
|
readonly files: readonly ["SKILL.md"];
|
|
55
|
+
}, {
|
|
56
|
+
readonly name: "repair-user-workflow";
|
|
57
|
+
readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: repair-user-workflow -->";
|
|
58
|
+
readonly files: readonly ["SKILL.md", "references/scenarios.md"];
|
|
49
59
|
}, {
|
|
50
60
|
readonly name: "natural-japanese-output";
|
|
51
61
|
readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: natural-japanese-output -->";
|
|
@@ -54,6 +64,10 @@ export declare const STANDARD_SKILL_MANIFESTS: readonly [{
|
|
|
54
64
|
readonly name: "one-shot-software-completion";
|
|
55
65
|
readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->";
|
|
56
66
|
readonly files: readonly ["SKILL.md", "references/discovery-and-scope.md", "references/boundaries-and-lifecycle.md", "references/verification-and-completion.md", "references/failure-recovery.md"];
|
|
67
|
+
}, {
|
|
68
|
+
readonly name: "coding-ideal-routine-skill";
|
|
69
|
+
readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: coding-ideal-routine-skill -->";
|
|
70
|
+
readonly files: readonly ["SKILL.md"];
|
|
57
71
|
}, {
|
|
58
72
|
readonly name: "kiokuko-soul";
|
|
59
73
|
readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-soul -->";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"standard-skills.d.ts","sourceRoot":"","sources":["../../src/setup/standard-skills.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,gCAAgC,oEAAoE,CAAC;AAClH,eAAO,MAAM,sBAAsB,qHAOzB,CAAC;AACX,eAAO,MAAM,wBAAwB,+OAO3B,CAAC;AACX,eAAO,MAAM,uBAAuB,yRAI1B,CAAC;AACX,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAChE,eAAO,MAAM,oCAAoC,iEAAiE,CAAC;AACnH,eAAO,MAAM,2BAA2B,uBAAwB,CAAC;AACjE,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AAC/E,eAAO,MAAM,sCAAsC,8EAA8E,CAAC;AAClI,eAAO,MAAM,4BAA4B,oIAO/B,CAAC;AACX,eAAO,MAAM,8BAA8B,gPAOjC,CAAC;AACX,eAAO,MAAM,6BAA6B,gUAKhC,CAAC;AACX,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,oCAAoC,8DAA8D,CAAC;AAChH,eAAO,MAAM,2BAA2B,uBAAwB,CAAC;AACjE,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AACvD,eAAO,MAAM,kCAAkC,0DAA0D,CAAC;AAC1G,eAAO,MAAM,yBAAyB,uBAAwB,CAAC;AAC/D,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,sCAAsC,sEAAsE,CAAC;AAC1H,eAAO,MAAM,6BAA6B,uBAAwB,CAAC;AACnE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,sCAAsC,qEAAqE,CAAC;AACzH,eAAO,MAAM,6BAA6B,uBAAwB,CAAC;AAEnE,eAAO,MAAM,8BAA8B,iCAAiC,CAAC;AAC7E,eAAO,MAAM,wCAAwC,0EAA0E,CAAC;AAChI,eAAO,MAAM,+BAA+B,qLAMlC,CAAC;
|
|
1
|
+
{"version":3,"file":"standard-skills.d.ts","sourceRoot":"","sources":["../../src/setup/standard-skills.ts"],"names":[],"mappings":"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"}
|
|
@@ -62,6 +62,9 @@ export const STANDARD_SOUL_SKILL_FILES = ['SKILL.md'];
|
|
|
62
62
|
export const STANDARD_WORKFLOW_SKILL_NAME = 'veteran-programmer-skill';
|
|
63
63
|
export const STANDARD_WORKFLOW_SKILL_MANAGED_MARKER = '<!-- KIOKUKO MANAGED STANDARD SKILL: veteran-programmer-skill -->';
|
|
64
64
|
export const STANDARD_WORKFLOW_SKILL_FILES = ['SKILL.md'];
|
|
65
|
+
export const STANDARD_REPAIR_SKILL_NAME = 'repair-user-workflow';
|
|
66
|
+
export const STANDARD_REPAIR_SKILL_MANAGED_MARKER = '<!-- KIOKUKO MANAGED STANDARD SKILL: repair-user-workflow -->';
|
|
67
|
+
export const STANDARD_REPAIR_SKILL_FILES = ['SKILL.md', 'references/scenarios.md'];
|
|
65
68
|
export const STANDARD_JAPANESE_SKILL_NAME = 'natural-japanese-output';
|
|
66
69
|
export const STANDARD_JAPANESE_SKILL_MANAGED_MARKER = '<!-- KIOKUKO MANAGED STANDARD SKILL: natural-japanese-output -->';
|
|
67
70
|
export const STANDARD_JAPANESE_SKILL_FILES = ['SKILL.md'];
|
|
@@ -74,6 +77,9 @@ export const STANDARD_COMPLETION_SKILL_FILES = [
|
|
|
74
77
|
'references/verification-and-completion.md',
|
|
75
78
|
'references/failure-recovery.md',
|
|
76
79
|
];
|
|
80
|
+
export const STANDARD_CODING_ROUTINE_SKILL_NAME = 'coding-ideal-routine-skill';
|
|
81
|
+
export const STANDARD_CODING_ROUTINE_SKILL_MANAGED_MARKER = '<!-- KIOKUKO MANAGED STANDARD SKILL: coding-ideal-routine-skill -->';
|
|
82
|
+
export const STANDARD_CODING_ROUTINE_SKILL_FILES = ['SKILL.md'];
|
|
77
83
|
export const STANDARD_SKILL_MANIFESTS = [{
|
|
78
84
|
name: STANDARD_UI_SKILL_NAME,
|
|
79
85
|
managedMarker: STANDARD_UI_SKILL_MANAGED_MARKER,
|
|
@@ -94,6 +100,10 @@ export const STANDARD_SKILL_MANIFESTS = [{
|
|
|
94
100
|
name: STANDARD_WORKFLOW_SKILL_NAME,
|
|
95
101
|
managedMarker: STANDARD_WORKFLOW_SKILL_MANAGED_MARKER,
|
|
96
102
|
files: STANDARD_WORKFLOW_SKILL_FILES,
|
|
103
|
+
}, {
|
|
104
|
+
name: STANDARD_REPAIR_SKILL_NAME,
|
|
105
|
+
managedMarker: STANDARD_REPAIR_SKILL_MANAGED_MARKER,
|
|
106
|
+
files: STANDARD_REPAIR_SKILL_FILES,
|
|
97
107
|
}, {
|
|
98
108
|
name: STANDARD_JAPANESE_SKILL_NAME,
|
|
99
109
|
managedMarker: STANDARD_JAPANESE_SKILL_MANAGED_MARKER,
|
|
@@ -102,6 +112,10 @@ export const STANDARD_SKILL_MANIFESTS = [{
|
|
|
102
112
|
name: STANDARD_COMPLETION_SKILL_NAME,
|
|
103
113
|
managedMarker: STANDARD_COMPLETION_SKILL_MANAGED_MARKER,
|
|
104
114
|
files: STANDARD_COMPLETION_SKILL_FILES,
|
|
115
|
+
}, {
|
|
116
|
+
name: STANDARD_CODING_ROUTINE_SKILL_NAME,
|
|
117
|
+
managedMarker: STANDARD_CODING_ROUTINE_SKILL_MANAGED_MARKER,
|
|
118
|
+
files: STANDARD_CODING_ROUTINE_SKILL_FILES,
|
|
105
119
|
}, {
|
|
106
120
|
name: STANDARD_SOUL_SKILL_NAME,
|
|
107
121
|
managedMarker: STANDARD_SOUL_SKILL_MANAGED_MARKER,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"standard-skills.js","sourceRoot":"","sources":["../../src/setup/standard-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAC/D,MAAM,CAAC,MAAM,gCAAgC,GAAG,iEAAiE,CAAC;AAClH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,mBAAmB;IACnB,aAAa;IACb,aAAa;IACb,qBAAqB;IACrB,cAAc;IACd,cAAc;CACN,CAAC;AACX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,oCAAoC;IACpC,8BAA8B;IAC9B,kCAAkC;IAClC,4CAA4C;IAC5C,uCAAuC;IACvC,iCAAiC;CACzB,CAAC;AACX,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU;IACV,GAAG,wBAAwB;IAC3B,4BAA4B;CACpB,CAAC;AACX,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAChE,MAAM,CAAC,MAAM,oCAAoC,GAAG,8DAA8D,CAAC;AACnH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,UAAU,CAAU,CAAC;AACjE,MAAM,CAAC,MAAM,4BAA4B,GAAG,kCAAkC,CAAC;AAC/E,MAAM,CAAC,MAAM,sCAAsC,GAAG,2EAA2E,CAAC;AAClI,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,kBAAkB;IAClB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,sBAAsB;IACtB,kBAAkB;CACV,CAAC;AACX,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,wCAAwC;IACxC,gCAAgC;IAChC,gCAAgC;IAChC,yCAAyC;IACzC,4BAA4B;IAC5B,4CAA4C;CACpC,CAAC;AACX,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,UAAU;IACV,GAAG,8BAA8B;IACjC,gCAAgC;IAChC,gCAAgC;CACxB,CAAC;AACX,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAC7D,MAAM,CAAC,MAAM,oCAAoC,GAAG,2DAA2D,CAAC;AAChH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,UAAU,CAAU,CAAC;AACjE,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC;AACvD,MAAM,CAAC,MAAM,kCAAkC,GAAG,uDAAuD,CAAC;AAC1G,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,UAAU,CAAU,CAAC;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AACvE,MAAM,CAAC,MAAM,sCAAsC,GAAG,mEAAmE,CAAC;AAC1H,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,UAAU,CAAU,CAAC;AACnE,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,sCAAsC,GAAG,kEAAkE,CAAC;AACzH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,UAAU,CAAU,CAAC;AAEnE,MAAM,CAAC,MAAM,8BAA8B,GAAG,8BAA8B,CAAC;AAC7E,MAAM,CAAC,MAAM,wCAAwC,GAAG,uEAAuE,CAAC;AAChI,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,UAAU;IACV,mCAAmC;IACnC,wCAAwC;IACxC,2CAA2C;IAC3C,gCAAgC;CACxB,CAAC;
|
|
1
|
+
{"version":3,"file":"standard-skills.js","sourceRoot":"","sources":["../../src/setup/standard-skills.ts"],"names":[],"mappings":"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"}
|
package/docs/README.ja.md
CHANGED
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
- [Akinator のプロフィール補助](akinator-memory.md) — 候補提示、限定的な対象補完、索引の再構築。
|
|
11
11
|
- [Security and trust](security-and-trust.ja.md) — secret拒否、記憶の境界、External Skills、公開エラー。
|
|
12
12
|
- [CLI contract](cli-contract.md) — 安定したコマンドとレスポンス。
|
|
13
|
+
- [AgenticReplay](agenticreplay.ja.md) — ホストクライアントのモデル通信の記録と、Kiokukoを使ったオフライン再生の検証。
|
|
13
14
|
|
|
14
15
|
実装者向けは[architecture](architecture.md)、[database](database.md)、[execution ledger](execution-ledger.md)、
|
|
15
16
|
[client compatibility](client-compatibility.md)、[retrieval evaluation](retrieval-evaluation.md)を参照してください。
|
package/docs/README.md
CHANGED
|
@@ -11,6 +11,7 @@ Choose a guide by what you need to do:
|
|
|
11
11
|
- [Akinator profile memory](akinator-memory.md) — optional hints, strict target resolution, and index rebuilding.
|
|
12
12
|
- [Security and trust](security-and-trust.md) — secret rejection, memory boundaries, External Skills, and public errors.
|
|
13
13
|
- [CLI contract](cli-contract.md) — stable command and response details.
|
|
14
|
+
- [AgenticReplay](agenticreplay.md) — record the host client's model traffic and verify offline replay with Kiokuko.
|
|
14
15
|
|
|
15
16
|
Implementation references: [architecture](architecture.md), [database](database.md),
|
|
16
17
|
[execution ledger](execution-ledger.md), [client compatibility](client-compatibility.md),
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# AgenticReplayでKiokukoのセッションを記録する
|
|
2
|
+
|
|
3
|
+
Kiokukoに接続したクライアントのモデルAPI通信は
|
|
4
|
+
[AgenticReplay](https://github.com/askdkc/AgenticReplay)で記録できます。
|
|
5
|
+
任意で使う外部ツールです。Kiokukoからインストールしたり、記録のために
|
|
6
|
+
クライアント設定を変更したりはしません。互換性チェックの対象は`agenticreplay@0.1.2`です。
|
|
7
|
+
|
|
8
|
+
## コマンドを確認する
|
|
9
|
+
|
|
10
|
+
インストール済みなら、そのコマンドを使ってください。
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
agenticreplay --version
|
|
14
|
+
agenticreplay doctor
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
未導入のマシンでは、次のコマンドでインストールします。
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install --global agenticreplay@0.1.2
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## クライアントを記録する
|
|
24
|
+
|
|
25
|
+
先に`kiokuko setup`でクライアントのMCP接続を設定し、必要なら再起動します。
|
|
26
|
+
作業対象のプロジェクトで、モデルへリクエストを送る**ホストクライアント**を
|
|
27
|
+
レコーダーから起動してください。`kiokuko mcp`だけを包んでも、ホスト側の
|
|
28
|
+
モデル通信は記録できません。
|
|
29
|
+
|
|
30
|
+
Claude Codeの場合:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
agenticreplay record claude -- -p "Use Kiokuko to recall relevant context for this project."
|
|
34
|
+
agenticreplay show last
|
|
35
|
+
agenticreplay replay last --worktree
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
記録時はクライアントの既存の認証情報を使い、モデル利用料が発生する場合があります。
|
|
39
|
+
サブスクリプション認証のCodex CLIなど、base URLの設定でモデルAPIの接続先を
|
|
40
|
+
変更できないホストでは、プロセス内のTLS傍受を使います。
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
agenticreplay record exec --tls-intercept -- codex
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
独自のモデルAPIホストを使う場合は、AgenticReplayの`--tls-hosts`とupstream設定を
|
|
47
|
+
確認してください。クライアントはレコーダーから起動します。起動済みのデスクトップ
|
|
48
|
+
クライアントには、新しいプロセスの記録用環境変数は引き継がれません。
|
|
49
|
+
|
|
50
|
+
## 記録を確認して再生する
|
|
51
|
+
|
|
52
|
+
記録は対象プロジェクトの`.agenticreplay/runs/`に保存されます。
|
|
53
|
+
シリアライズされたリクエストから、ホストが実際にモデルへ送ったKiokukoの
|
|
54
|
+
ツールスキーマと結果を確認できます。プロバイダー内部の非公開の推論や、
|
|
55
|
+
記録境界より前の変更は観測できません。
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
agenticreplay list
|
|
59
|
+
agenticreplay show last --json
|
|
60
|
+
agenticreplay replay last --worktree --json
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
exact replayでは、記録済みのモデル応答を返します。作業用worktreeでプロジェクトの
|
|
64
|
+
ファイルは保護できますが、**Kiokukoのデータベースは巻き戻りません**。
|
|
65
|
+
ツールが再実行され、記憶を書き込む場合があります。書き込み操作のテストでは、
|
|
66
|
+
使い捨てのKiokukoデータディレクトリとクライアント設定を使ってください。
|
|
67
|
+
通信本文とファイルのスナップショットは機密情報として扱い、共有前に確認します。
|
|
68
|
+
Kiokukoの記憶は、Git管理下のファイルでなくてもモデルへのリクエストに含まれます。
|
|
69
|
+
|
|
70
|
+
## リポジトリの互換性チェック
|
|
71
|
+
|
|
72
|
+
Node.jsとAgenticReplay 0.1.2が使える環境で実行します。
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm ci
|
|
76
|
+
npm run test:agenticreplay
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Kiokukoをビルドし、テスト用のNodeホストから実際のMCPサーバーを起動して、
|
|
80
|
+
ローカルのモデルfixtureへの2件のリクエストを記録します。
|
|
81
|
+
記録された`task_inspect`のスキーマとSOULの結果を確認した後、モデルの接続先を停止し、
|
|
82
|
+
オフライン再生で2件がcanonical exact一致し、divergences、unmatched、liveCallsがすべて0になることを
|
|
83
|
+
検証します。一時的な記録、設定、記憶データは終了後に削除します。
|
|
84
|
+
コマンドが`PATH`にない場合は、`AGENTICREPLAY_BIN`に実行ファイルのパスを指定できます。
|
|
85
|
+
|
|
86
|
+
認証情報や有料のモデル呼び出しは不要です。モデル通信と実際のKiokuko MCP境界を
|
|
87
|
+
検証するチェックであり、すべてのクライアント、streaming、TLS傍受、MCP shim、
|
|
88
|
+
ファイル復元、記憶への永続的な書き込みを保証するものではありません。
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Recording Kiokuko sessions with AgenticReplay
|
|
2
|
+
|
|
3
|
+
Use [AgenticReplay](https://github.com/askdkc/AgenticReplay) to record the model
|
|
4
|
+
API traffic of a client connected to Kiokuko. It is an optional external tool;
|
|
5
|
+
Kiokuko does not install it or change your client configuration for recording.
|
|
6
|
+
The compatibility check targets `agenticreplay@0.1.2`.
|
|
7
|
+
|
|
8
|
+
## Check the command
|
|
9
|
+
|
|
10
|
+
If AgenticReplay is already installed, use that command:
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
agenticreplay --version
|
|
14
|
+
agenticreplay doctor
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
On a machine without it:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install --global agenticreplay@0.1.2
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Record the client
|
|
24
|
+
|
|
25
|
+
Configure the client's Kiokuko MCP connection with `kiokuko setup` first, and
|
|
26
|
+
restart it if needed. Run the recorder from the project being worked on, wrapping
|
|
27
|
+
the **host client** that sends model requests. Wrapping only `kiokuko mcp` cannot
|
|
28
|
+
capture the host's model traffic.
|
|
29
|
+
|
|
30
|
+
For Claude Code:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
agenticreplay record claude -- -p "Use Kiokuko to recall relevant context for this project."
|
|
34
|
+
agenticreplay show last
|
|
35
|
+
agenticreplay replay last --worktree
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Recording uses the client's existing credentials and can incur model charges.
|
|
39
|
+
For a host that cannot redirect its model API through a base-URL setting, such
|
|
40
|
+
as subscription-authenticated Codex CLI, use process-local TLS interception:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
agenticreplay record exec --tls-intercept -- codex
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
For custom model API hosts, consult AgenticReplay's `--tls-hosts` and upstream
|
|
47
|
+
options. Start the client under the recorder; an already-running desktop client
|
|
48
|
+
does not inherit a new process's capture environment.
|
|
49
|
+
|
|
50
|
+
## Inspect and replay
|
|
51
|
+
|
|
52
|
+
Runs are stored under `.agenticreplay/runs/` in the recorded project. Inspect the
|
|
53
|
+
serialized requests to see the Kiokuko tool schemas and results the host actually
|
|
54
|
+
sent to its model. Provider-hidden reasoning and changes before the capture
|
|
55
|
+
boundary are not observable.
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
agenticreplay list
|
|
59
|
+
agenticreplay show last --json
|
|
60
|
+
agenticreplay replay last --worktree --json
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Exact replay serves recorded model responses. A scratch worktree protects project
|
|
64
|
+
files, but does **not** roll back the Kiokuko database: tools can execute again and
|
|
65
|
+
write memories. Use a disposable Kiokuko data directory and client configuration
|
|
66
|
+
when testing write operations. Treat trace bodies and filesystem snapshots as
|
|
67
|
+
sensitive; review them before sharing. Kiokuko memories can appear in model
|
|
68
|
+
requests even when they are not committed project files.
|
|
69
|
+
|
|
70
|
+
## Repository compatibility check
|
|
71
|
+
|
|
72
|
+
With Node.js and AgenticReplay 0.1.2 available:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm ci
|
|
76
|
+
npm run test:agenticreplay
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
The check builds Kiokuko, launches its real MCP server from a synthetic Node host,
|
|
80
|
+
and records two requests to a local model fixture. It verifies the captured
|
|
81
|
+
`task_inspect` schema and SOUL result, stops the model endpoint, then requires two
|
|
82
|
+
canonical exact offline matches with zero divergences, unmatched requests or live calls.
|
|
83
|
+
Temporary recordings, configuration and memory data are removed afterward.
|
|
84
|
+
Set `AGENTICREPLAY_BIN` to an executable path when the command is not on `PATH`.
|
|
85
|
+
|
|
86
|
+
This check uses no credentials or paid model calls. It proves the model transport
|
|
87
|
+
and real Kiokuko MCP boundary; it does not certify every client, streaming mode,
|
|
88
|
+
TLS interception, MCP shim, filesystem restoration or persistent memory write.
|
|
@@ -30,7 +30,8 @@ commands and global rules. Claude Code supports user-scoped stdio MCP servers,
|
|
|
30
30
|
global `CLAUDE.md`, and auto-discovered skills. `kiokuko setup` uses the MCP and
|
|
31
31
|
instruction surfaces and installs the bundled `memory-reasoning`, `kiokuko-soul`, `kiokuko-simple-work`,
|
|
32
32
|
`kiokuko-single-purpose-functions`, `kiokuko-ui-design-soul`, `veteran-programmer-skill`,
|
|
33
|
-
|
|
33
|
+
`repair-user-workflow`, `natural-japanese-output`, `one-shot-software-completion`, and
|
|
34
|
+
`coding-ideal-routine-skill` skills in the selected supported clients by
|
|
34
35
|
default. The skills are copied from a fixed package manifest and never downloaded
|
|
35
36
|
during setup. Codex uses host-specific names (`kiokuko-codex-soul`,
|
|
36
37
|
`kiokuko-codex-memory-reasoning`, and the other manifest-listed Codex names),
|
|
@@ -45,6 +46,25 @@ while preserving technical identifiers and required output structure. Both are
|
|
|
45
46
|
routed by `kiokuko-soul` when applicable; neither introduces DSH-specific
|
|
46
47
|
execution or changes the MCP intake gate.
|
|
47
48
|
|
|
49
|
+
`coding-ideal-routine-skill` is routed for coding requests after intake. It
|
|
50
|
+
connects investigation, meaningful failing tests, implementation, ordinary-use
|
|
51
|
+
acceptance checks, and evidence-based reporting. Explanation-only requests need
|
|
52
|
+
no implementation or Red/Green tests. Codex receives the manifest-listed name
|
|
53
|
+
`kiokuko-codex-coding-ideal-routine-skill`; other hosts keep the canonical name.
|
|
54
|
+
|
|
55
|
+
`repair-user-workflow` must be read through SOUL after intake and memory review,
|
|
56
|
+
before planning or implementing repairs when installation, update, build, or
|
|
57
|
+
registration succeeds but ordinary launch, use, restart, or exit fails; source
|
|
58
|
+
checks pass but the installed artifact, current profile, or consumer fails; or
|
|
59
|
+
a previous fix still requires manual rescue. SOUL judges the reported workflow,
|
|
60
|
+
including Japanese reports, without depending on keyword matches or capability
|
|
61
|
+
similarity recommendations. Explanation-only requests, commit-message drafting,
|
|
62
|
+
and isolated logic fixes without a workflow boundary do not select this route.
|
|
63
|
+
Setup includes its on-demand scenario reference;
|
|
64
|
+
Codex receives `kiokuko-codex-repair-user-workflow`, and other hosts keep the
|
|
65
|
+
canonical name. These instructions require the model to read the skill; they
|
|
66
|
+
do not prove future model compliance or update an already installed package.
|
|
67
|
+
|
|
48
68
|
Hermes Agent v0.20.4 uses a profile-scoped native stdio MCP client. Kiokuko writes
|
|
49
69
|
only the effective profile's `config.yaml` entry:
|
|
50
70
|
|