Skip to content

Commit 7e528f3

Browse files
committed
docs(examples): add Japanese demo docs
Add Japanese versions of the agent-pr-loop demo README and request prompt for local runs.
1 parent 5dca529 commit 7e528f3

2 files changed

Lines changed: 109 additions & 0 deletions

File tree

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# agent-pr-loop デモ(実際にコードを生成)
2+
3+
この例は、`examples/agent-pr-loop.yaml` がワークフローのメモだけでなく、実際にテスト可能なソースコードを新規のスクラッチリポジトリ(`/tmp` 配下)に生成できることを示します。
4+
5+
Bun + TypeScript の線形代数 CLI プロジェクトを作成し、次のループを最後まで実行します:
6+
7+
- `bootstrap -> branch -> design -> todo -> implement -> (review<->fix)* -> create_pr`(`create_pr` はデフォルトで無効)
8+
9+
## 前提条件
10+
11+
- `bun`
12+
- `git`
13+
- `opencode`(OpenCode)
14+
- `claude`(Claude Code)
15+
- `codex`(Codex CLI)
16+
17+
ワークフローの `bootstrap` ステップは、これらの worker CLI が `PATH` 上に存在することも検証します。
18+
19+
## 実行
20+
21+
Roboppi リポジトリのルートで:
22+
23+
```bash
24+
bash examples/agent-pr-loop-demo/run-in-tmp.sh
25+
```
26+
27+
デフォルトでは、`/tmp/` 配下に一意なワークスペースディレクトリを作成し、そのパスを表示します。
28+
29+
### 固定のワークスペースパスを使う
30+
31+
```bash
32+
TARGET=/tmp/roboppi-prloop-bun-linalg \
33+
bash examples/agent-pr-loop-demo/run-in-tmp.sh
34+
```
35+
36+
## 生成されるもの
37+
38+
生成されたワークスペースには次が含まれます:
39+
40+
- `src/`(ライブラリ + `src/cli.ts`)
41+
- `test/`(ユニットテスト)
42+
- `package.json`, `tsconfig.json`, `bun.lock`
43+
- `.agentcore-loop/`(ループの design/todo/review の成果物)
44+
45+
## 検証
46+
47+
```bash
48+
cd <表示されたワークスペースパス>
49+
bun test
50+
51+
bun run src/cli.ts solve --A '[[1,2],[3,4]]' --b '[5,6]'
52+
bun run src/cli.ts eigen2x2 --A '[[2,1],[1,2]]'
53+
bun run src/cli.ts project --basis '[[1,1,0],[0,1,1]]' --b '[3,1,2]'
54+
```
55+
56+
## PR 作成
57+
58+
最後の `create_pr` ステップは、次のマーカーファイルを作成しない限り意図的に無効になっています:
59+
60+
```bash
61+
touch .agentcore-loop/enable_pr
62+
```
63+
64+
その後、ワークフローを再実行してください。PR 作成には、`origin` リモートの設定と `gh` が必要です。
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# 小さな線形代数 CLI を作る(Bun + TypeScript)
2+
3+
※このファイルは `request.md` の日本語版です。
4+
5+
## 目的
6+
agent PR loop が、ワークフローのノートだけでなく「実際に動作し、テストできる」ソースコードを生成できることを示す。
7+
8+
## 作るもの
9+
Bun + TypeScript のプロジェクトを作成し、次を提供すること:
10+
11+
1) `src/` 配下の小さなライブラリ:
12+
- 小さな整数の行列/ベクトルに対して厳密計算ができる程度の有理数(分数)演算。
13+
- 行列/ベクトルのユーティリティ。
14+
- アルゴリズム:
15+
- 有理数を使ったガウス消去法により、正方線形系 `A x = b` を解く。
16+
- 2x2 行列の固有値/固有ベクトルと、対角化できるかの判定。
17+
- 与えられたベクトル集合の張る部分空間への直交射影(可能な限り有理数を使用)。
18+
19+
2) CLI エントリポイント `src/cli.ts`(コマンド):
20+
- `solve --A <json> --b <json>`
21+
- `eigen2x2 --A <json>`
22+
- `project --basis <json> --b <json>`
23+
24+
入力フォーマット:
25+
- `--A` は配列の配列の JSON(例: `[[1,2],[3,4]]`)。
26+
- `--b` は配列の JSON(例: `[5,6]`)。
27+
- `--basis` はベクトル配列の JSON(例: `[[1,0,0],[0,1,0]]`)。
28+
29+
出力:
30+
- 結果は stdout に JSON として出力する。
31+
- 有理数は、既約分数の文字列(例: `"11/2"` や `"-1"`)で出力する。
32+
33+
3) テスト:
34+
- `test/` 配下にユニットテストを追加(`bun test`)。3つのアルゴリズムすべてと、いくつかのエッジケースをカバーする。
35+
- `bun test` がパスすること。
36+
37+
4) ドキュメント:
38+
- `README.md` に "How to run" セクションを追加し、CLI の実行例と期待する JSON の形を記載する。
39+
40+
## 受け入れ条件
41+
- [ ] `package.json` が存在し、`bun test` がパスする。
42+
- [ ] `src/` にライブラリコードがあり、`src/cli.ts` が CLI を実装している。
43+
- [ ] 少なくとも1つの例で `bun run src/cli.ts solve ...` が動作する。
44+
- [ ] 出力の有理数は既約分数の文字列になっている(厳密に扱えるケースで浮動小数点を使わない)。
45+
- [ ] README が使い方をドキュメント化している。

0 commit comments

Comments
 (0)