dualface/ste-zh

Agent skill: 按 ASD-STE100 (Simplified Technical English) 原则用中文向用户汇报结果

ste‑zh – 中文技術報告規範 Skill

概要

大規模言語モデル（LLM）エージェント（Claude、Cursor、Codex など）に、制御された曖昧さのない中国語スタイルでステータスレポートを書かせる Agent skill です。航空宇宙業界の標準 ASD‑STE100（簡易技術英語）を中国語（普通話）に適応させ、「重要情報を先に、証拠に基づき、固定状態」の形式を強制します。

重要性

AI エージェントは、バグ修正や機能提供の際に、冗長で推測的な、または不完全な更新を行うことがよくあります。ste‑zh はエージェントに以下を強制します：
1. 結果を最初に述べる（例：已完成…）、
2. 具体的な証拠（ファイル/行番号、テスト結果）を引用する、
3. 完了と検証を分離する、そして
4. 保留中の決定を番号付きオプションとして提示する。
これにより、誤解が減り、人間のレビューが迅速になり、複数エージェントのワークフロー（例：著者の Kander ボード）をスキャンしやすくなります。

主な機能

重要情報を先に – 最初の文で常にレポートの種類（結果、進捗、要約など）を宣言します。
固定ステータス語彙 – references/terminology.md で定義された限られたステータス語（已完成、已验证、未验证など）のセット。
証拠駆動 – すべての主張は検証可能な成果物（コード行、テストケース、コマンド出力）によって裏付けられなければなりません。
能動態と一語一義 – 曖昧な動詞やあいまいな表現を排除します。
決定オプション – 人間の入力が必要な場合、スキルは推奨選択肢付きの番号付きリストを自動フォーマットします。

インストール

推奨：Vercel‑Labs skills CLI を使用し、正規名 ste でスキルを登録します。

npx skills add dualface/ste-zh -g          # グローバルインストール
npx skills add dualface/ste-zh            # プロジェクトローカルインストール
npx skills add dualface/ste-zh -g -a claude-code  # 特定のエージェント用にインストール

手動：リポジトリをエージェントの skills ディレクトリにクローンし、フォルダ名を ste にします（例：~/.claude/skills/ste）。

使用方法

サポートされているエージェントとの会話で、トリガーコマンドのいずれかを入力します：
- /ste
- “用 STE 规范输出”
- “按 ASD‑STE100 汇报”
エージェントは、stop ste（または類似の停止コマンド）を送信するまで、後続のすべての返信を STE‑ZH ルールに従ってフォーマットします。
エージェントの出力が逸れた場合（例：長いコンテキスト後）、トリガーを再送信してスタイルを再アクティブ化します。

典型的なワークフロー

エージェントがタスクを実行（バグ修正、リファクタリングなど）。

レポートを依頼 – エージェントは STE‑ZH スタイルのブロックで返信します：

已完成：ログイン更新ロジックのコード修正。iOS 側は未検証。

原因：2 つのリクエストが同時にトークンを更新し、後から完了した更新が先に取得したトークンを無効にしました。

証拠：
- auth/refresh.ts:42 — 更新前に既に更新が進行中かどうかをチェックしていません。
…

決定を下す – オプション番号（例：1）を返信します。
エージェントが選択に基づいて進行。

対象者

LLM エージェントをコードレビュー、デバッグ、ドキュメント作成に利用し、簡潔で検証可能な更新を必要とするチーム。
Kander のようなマルチエージェントオーケストレーションツールのユーザーで、ボードに多くのタスクが表示され、迅速なスキャンが不可欠な場合。
毎回カスタムプロンプトを書かずに一貫した中国語のレポートスタイルを望む開発者。

ライセンス

MIT（LICENSE を参照）。

著者の関連プロジェクト

Kander – ルール駆動のマルチエージェントかんばんスケジューラー。
Ullage‑cli – Claude、ChatGPT、Grok、Cursor などの使用状況を追跡するローカルデーモン/CLI。
QuickTUI – モバイルファーストのコーディングエージェント用ターミナル UI。

上記の情報はすべて、リポジトリの README から直接取得したものです。