npm 10.8.2
node v18.20.8
npm install.envファイルに各種トークンを追加してください
- Redmineにログイン
- 右上のユーザー名をクリック → My account
- API access key セクションでキーを確認
- キーが表示されていない場合は、**"Generate API key"**をクリック
- 生成されたキーを
.envのREDMINE_API_KEYに設定
- Slack Appを作成: https://api.slack.com/apps
- "Create New App" → "From scratch"
- App nameを入力し、Workspaceを選択
- OAuth & Permissions → Scopes → Bot Token Scopes
- Bot Token Scopes に必要な権限を追加:
channels:history(パブリックチャンネルのメッセージ閲覧)channels:read(パブリックチャンネル情報の読み取り)chat:write(メッセージ送信)chat:write.customize(カスタム名前とアバターでメッセージ送信)chat:write.public(未参加チャンネルへのメッセージ送信)search:read.users(ユーザー検索)users:read(ワークスペースのユーザー情報閲覧)
- User Token Scopesも設定:
channels:history(パブリックチャンネルのメッセージ閲覧)channels:read(パブリックチャンネル情報の読み取り)chat:write(メッセージ送信)emoji:read(カスタム絵文字の閲覧)files:read(ファイル読み取り)search:read(メッセージ検索)
- Install Appをクリック
- Bot User OAuth Tokenをコピー（
xoxb-で始まる） - User OAuth Tokenをコピー（
xoxp-で始まる、必要に応じて） .envのSLACK_USER_OAUTH_TOKENにUser Tokenを設定.envのSLACK_BOT_USER_OAUTH_TOKENにBot Tokenを設定.envのSLACK_BOT_USER_NAMEにBotの表示名を設定
Bot Token vs User Token:
- Bot Token (
xoxb-): ボットとしての権限でアクセス（メッセージ送信等） - User Token (
xoxp-): ユーザーとしての権限でアクセス（メッセージ履歴取得等）
AIモデルを使用するには2通りの方法がある
- AWSコンソールで発行したAPIキーを設定
- 自分のAWSの認証情報を設定
APIキーを設定する場合:
- AWSコンソールにログイン
- dev-adminロールに切り替え
- Amazon Bedrock画面に移動
- APIキーメニューから長期APIキーを選択
- 「長期APIキーを生成」を押下
- 「APIキーの有効期限」の「有効期限なし」を選択してトークンを生成
- 生成したトークンを
.envのAWS_BEARER_TOKEN_BEDROCKに設定
認証情報を設定する場合:
- 認証情報は入社時に付与されるのでそちらを使用
- dev-adminロールが付与されていること
.envのAWS_ACCESS_KEY_IDにAccessKeyを設定.envのAWS_SECRET_ACCESS_KEYにSecretを設定
# 全体のヘルプ
npm run cli help
# プラットフォーム別のヘルプ
npm run cli help redmine
npm run cli help slack
# 全プラットフォームのコマンド一覧
npm run cli all-commands# 全テストを実行
npm test
# watchモードで実行
npm run test:watch
# カバレッジを確認
npm run test:coverage# E2Eテストを実行（実際のAPIを呼び出します）
RUN_E2E_TESTS=true npm test -- --testPathPatterns=e2e
# 特定のプラットフォームのみ
RUN_E2E_TESTS=true npm test -- --testPathPatterns=faq.e2e