0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

DeepSeekで週報が二週間たってもふらつくなら、まずこの回の依頼をはっきりさせよう

0
Posted at

二週間、金曜ごとにDeepSeekへ週報を頼んでいるとします。ある週は、そのまま出せる下書きになります。次の週は、まだ終わっていない仕事が完了したように書かれ、メモに残していた細部が抜けます。同じ相手に、同じ種類の記録を渡しているのに、仕上がりが安定しません。

そんなときに先に確認したいのは、新しい機能が足りないかどうかではありません。この回の依頼は、読み手と形式と境界まで書けているか。来週も同じやり方を、また口頭で説明するつもりか。根拠になるファイルは、名前を見ただけでたどり着ける状態か。この三つを分けて扱うと、週報のぶれは直しやすくなります。

DeepSeek: まずプロンプトをはっきりさせる

DeepSeekで同じ週報がぶれるのは、機能不足ではない

週報には、毎回変わる作業記録と、毎週は変えたくない書き方があります。両方を短い「週報を書いて」に押し込めると、どの事実を残し、何を未完了として扱うかまで、その場のやり取りに任せることになります。金曜ごとの差を減らすには、先に判断基準を言葉にする必要があります。

この経路は、資料を書き、ファイルを整理し、繰り返しの仕事を進める人向けです。モデルの訓練、私設の展開、モデル比較が目的なら、別の話になります。最初の一歩は、公式の画面に入力できれば足ります。毎週のやり方を保存する段階からは、自分のパソコンにDeepSeek Harnessを一度入れる必要があります。Harnessの使い方と起動コマンドは、2026年11月時点の公式ドキュメントに照らしています。

まずはDeepSeekへの、この回の依頼をはっきりさせる

この段階はDeepSeekの公式チャットか、公式アプリで試せます。まだローカルツールは要りません。変えるのは機能ではなく、この回の依頼の境界です。

変更前

週報を書いて。

変更後:そのまま書き換えて使える依頼

【わたしは誰か】コンテンツ運営の担当者です。この週報は部門責任者向けです
【何がほしいか】下の作業記録を「今週の進捗・直面した問題・来週の予定」の3項目に整理してください。全体は400〜600字。各項目は先に結論、そのあと根拠となる事実を書いてください
【やってはいけないこと】未完了を完了したように書かないでください。空疎な標語を使わず、記録にない数字を補わないでください。記録にないことは「記録にない」と書いてください

---

[先週の実際の作業記録を貼る]

ここにあるのは特別な定型文ではありません。読み手、形式、境界を、この回の依頼として書いただけです。指示と資料の区切りは、この例のように一種類で足ります。いくつかを同時に混ぜる必要はありません。繰り返す要求を上に、毎回変わる記録を下に置くと、来週どこを差し替えるかもはっきりします。チャットで思考モード(thinking mode)がすでにオンなら、「一歩ずつ考えて」と重ねて書く必要はありません。

先週、実際に送った一文をこの形に書き直し、公式チャットで一度送ってみてください。見るのは点数ではありません。たとえば返答の第二段落に、記録に基づく具体的な事実が残ったかどうかです。一回の依頼を直せないまま、毎週の仕組みへ進んでも、曖昧さが保存されるだけです。

毎週使うDeepSeekのやり方は、skillとして残す

同じ注意を翌週もまた書いているなら、その部分はskill、つまり保存したやり方に向いています。ここから使うDeepSeek Harnessは、公式チャット画面の隠しボタンではありません。公式の、ローカルで動くオープンソースツールです。現在はdeveloper previewであり、後に互換性を壊す変更があり得ます。

先にNode.jsを入れてください。現在の要件はNode.js 24.9以上です。Node 22はもうサポートされません。入れたら、同じターミナルでnode --versionを実行して確認します。続いて次を実行します。

npx @deepseek-ai/dsh web

初回は、npxから@deepseek-ai/dshをインストールするか尋ねられることがあります。その場合は「はい」を選びます。そのあとダウンロードと初期化が続き、しばらくかかることがあります。既定の待ち受けは127.0.0.1:3080ですが、開くのはターミナルに表示された、ワンタイムtokenを含むURL全体です。ローカル起動では、ブラウザが自動で開くことが多いです。開かなければ、その一行をそのままブラウザに貼ります。tokenなしのhttp://127.0.0.1:3080だけを開くと401になり、入れません。ターミナルは開いたままにしてください。閉じると、画面も止まります。

画面の「設定 → モデル」に入り、DeepSeekのAPIキー取得ページで取得したキーを貼って保存します。保存後、再起動は不要です。続いて「ワークスペースを選択」を押し、資料を置くフォルダを追加して選びます。選ぶまでは、入力欄は使えません。選んだあと、エージェントはそのワークスペースのファイルをすでに読み書きでき、コマンドも実行できます。ファイルを読むためだけのプラグインは、ここでは要りません。

週報用skillの識別子はzhoubaoのままで構いません。選んだワークスペースに.dsh/skills/zhoubao/SKILL.mdを作り、次を入れます。選んだワークスペースがGitリポジトリのサブディレクトリなら、skillはリポジトリルートの.dsh/skillsに置きます。

---
name: zhoubao
description: "作業記録から週報を書いてほしい、整理してほしい、または確認してほしいと言われたときに使う。"
---

# 週報を書く

1. ユーザーの記録から、完了したこと、未完了のこと、来週の予定を分ける。
2. 「今週の進捗、直面した問題、来週の予定」で組み立てる。
3. 各項目は先に結論、そのあと根拠となる事実。記録に数字がなければ数字を足さない。
4. 未完了のことはそのまま書く。空疎な言葉で覆わない。
5. 提出前に、各結論が元の記録に根拠を持つかを確認する。

nameとdescriptionは必須です。descriptionは性能をうたう欄ではなく、いつ使うかを書く欄です。Harnessは先に名前と説明を見ます。本文は、実際に使うときに読みます。必要なら、入力欄で/zhoubaoと書いて呼び出せます。保存後の再起動は通常不要です。skillの一覧に名前とdescriptionが出たか確認し、本物の週報タスクを三つ試してください。三回とも発火しなければ、本文より先にdescriptionを直します。普段の依頼の言い方に、もっと近づけるのが先です。

最初はSKILL.mdだけで十分です。skillは、スキル用ルートの直下にある名前/SKILL.md、または平坦な名前.mdとして置けます。それより深い入れ子は作りません。あとからscripts/やreferences/が必要になっても、それらはSKILL.mdの兄弟ディレクトリであり、その中ではありません。.agents/skillsもスキャンされますが、優先度は低いので、この最初の例では使いません。

DeepSeekが資料を使えるかは、ファイル名で見つかるかどうかで決まる

ここでいう「知識ベース」は、製品の独立したボタンではありません。選んだワークスペース(作業フォルダ)のファイルを、名前とパスで探せるように整理することです。前の節で書いたとおり、ワークスペースを選んだ時点で、Harnessのエージェントはすでにファイルを読めます。読み取り用のプラグインを足す話ではありません。

たとえばフォルダに次の四つがあるとします。ファイルの内容も業務ルールも、説明用の作りものです。

01-套餐与报价.md
02-退款政策.md
03-发票说明.md
新建文本文档 (2).md

上から順に、料金と見積もり、返金ポリシー、請求書、そして「新規テキスト ドキュメント (2).md」のような既定名です。「顧客が299のプランを買い、5日目に返金したい。何をしてもらうべきか?」と聞かれたとき、最後のファイルは名前だけでは見落としやすいでしょう。

実はそのファイルに、返金には追加のチケットが必要で、管理画面で先に提出すること、番号はRF-で始まり、番号がなければ却下する、と書かれている、という設定です。名前を04-退款工单规则.md(返金チケット規則)に変えれば、フォルダの一覧自体が探す手がかりになります。ファイルを開かなくても、返金の問いならどこを見るべきかが分かります。ファイル名とパスが、その手がかりです。

よく使う資料フォルダから手を付ければ足ります。「新規」や「最終版2」のような名前を、内容が分かる名前に変える。一つのファイルでは一つの主題に寄せる。新旧を区別するなら、日付か版を名前に入れる。いま必要なのは、探せる名前であって、いきなりベクトル検索の仕組みを組むことではありません。

確認も単純です。資料の中に確かに答えがある質問を一つし、続けて「この文はどのファイルのどの段落か?」と聞きます。答えをたどれなければ、先にワークスペースが合っているか、ファイルが入っているか、名前が明瞭かを見ます。モデルを変えたり、ファイル読み取りプラグインを足したりするのは、その後です。

あとで、いま掲載されているDeepSeekモデルを確認したくなることもあります。そのときはDeepSeekモデルカタログを見れば足ります。ページ上で現在の一覧を直接確かめたいなら、Crazyrouterで、現在利用できるDeepSeekモデルを確認する。これは、この経路を始めるための必須設定ではありません。ここまでの基本は、公式チャットと、Harnessに公式のDeepSeek APIキーを入れることです。

DeepSeekのプラグインは、ワークスペースで足りない仕事だけに足す

プラグインは追加機能です。ネット検索や、ワークスペース外のシステムとの接続など、次に頼みたい仕事が具体的になってから考えます。Gitから入れる場合のコマンドは次の形です。#<commit>で、特定のcommitに固定します。

npx @deepseek-ai/dsh plugin --profile web add github:owner/repo#<commit>

グローバルインストール済みなら、dsh plugin --profile web add ...も使えます。バンドルプラグインを入れた後は、dsh webを一度再起動します。ビルドスクリプトが拒否されて失敗した場合は、ターミナルの指示に従ってビルドを許可し、もう一度実行します。

次のようなときは、まだ入れません。

  • 次に頼む具体的な仕事を言えない。
  • Gitから入れるのにcommitを固定せず、中身やスクリプトも確認していない。
  • ソースを信頼できない、または確認ダイアログのソースを読んでいない。

プラグイン索引に、公式の組み込みソースが付いているわけではありません。中身は、自分で追加した第三者ソースに由来します。プログラムが検査するのはファイル形式であり、書かれた主張の正しさではありません。信頼できるソースだけを追加し、入れる前に確認ダイアログのソースを読んでください。

入れたら、一件の仕事で確かめます。ネット検索が必要なら、時間とともに変わり得るソフトの版を調べ、出典と照合するのが適切です。「ワークスペースのファイルを読めるか」では、ネット検索プラグインの確認になりません。

DeepSeekの一式は、来週も触れる大きさに保つ

依頼文、skill、ファイル名、プラグインには、それぞれ別の役割があります。この回だけの条件は依頼文へ。毎週守る書き方はskillへ。根拠になる資料は、探せる名前でワークスペースへ。ワークスペースの外の仕事が必要になったときだけ、プラグインへ。分けておけば、週報がぶれたときにも、直す場所を絞れます。

この一式は古くなります。しかも、使うほど早く古くなります。skillのdescriptionが数ヶ月前の仕事のままなら、もう発火しません。発火しても、いまの項目や口径とずれた手順を踏むこともあります。フォルダに「最終版2」や「新規」が増えれば、また探しにくくなります。プラグインは、本体の更新のあとに合わなくなることもあります。

月に一度、短く見直せば足ります。三ヶ月発火していないskillは削除する。内容が分からないファイル名は付け直す。プラグインは本体に合わせ、テスト版を追わない。増やし続けるより、来週も触れる大きさに保つ方が大事です。

まず一つやるなら、毎週繰り返す仕事を取り、そのやり方を一つのSKILL.mdに書いてください。他人に見せる必要はありません。来週の自分が使えるなら、それで十分です。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?