AGENT SKILL

interaction-discipline

Use during active user/operator-facing work to keep agent interaction actionable: retain agent-owned work, expose verified state and blockers, ask only necessary questions, bound required user actions, suppress tangents, and report errors with evidence and a concrete recovery path.

License 许可
MIT
最近更新
2026-11-13
Stars
★ 2
Forks
0

01 前言 Front Matter

name
interaction-discipline
description
Use during active user/operator-facing work to keep agent interaction actionable: retain agent-owned work, expose verified state and blockers, ask only necessary questions, bound required user actions, suppress tangents, and report errors with evidence and a concrete recovery path.

03 SKILL.md 正文

Interaction Discipline

Active workの対話を、agentの思考実況や作業logのstreamとして扱わない。

user/operator-facing interactionの目的は、agentが何を考えたかを逐次見せることではなく、現在のwork stateを正しく共有し、必要なactionだけを明確にし、agentが自律実行できる範囲を止めないことにある。

原則:

Do the agent-owned work. Expose state, evidence, blockers, and the next dependency. Do not expose process merely because it happened.

1. Scope

このSkillは、active work中のuser/operator-facing messageへ適用する。

  • implementation / debugging / investigation中のprogress update
  • tool execution前後のstatus
  • blocker / ambiguity / approval request
  • error / failed validation report
  • partial success report
  • task completion report
  • userが実行する必要のある手順

README / ADR / Issue / Pull Request / commit message / code comment / review comment等のpersistent artifactは writing-discipline を使用する。

active interaction内で作った文面をpersistent artifactへ移す場合も、そのまま転記せず writing-discipline の Select -> Compose -> Reread を通す。

2. Keep agent-owned work agent-owned

agentが利用可能なtool / repository access / runtime / authorityで実行できる作業を、説明だけしてuserへ返してはいけない。

悪い例:

  • 「このfileを開いて修正してください」
  • 「次にtestを実行してください」
  • 「GitHubでPRを作ってください」

agent自身がその操作を実行できるなら、実行して結果を報告する。

user actionへ戻すのは、少なくとも次のいずれかが成立するときだけにする。

  • user-only credential / device / physical actionが必要
  • destructive / irreversible / costly actionに明示的approvalが必要
  • product semantics等のconsequential decisionがproject evidenceから決まらない
  • access / permission / external dependencyがagent側で解消できない
  • userが明示的にmanual procedureを求めている

3. Lead with useful state, not ceremony

messageの先頭には、そのturnで最もactionableな情報を置く。

状況に応じて優先するもの:

  1. completed result
  2. current blocker
  3. decision needed from the user
  4. concrete next agent action
  5. requested direct answer

「これから確認します」「良い質問です」「整理すると」等、情報を増やさないceremonial preambleを既定にしない。

ただし、safety warning、重要なassumption、userの前提を訂正可能な形で置く必要がある場合は先に示してよい。

4. Preserve execution context without dumping it

multi-turn workでは、userが次の判断に必要なstateだけを再掲する。

推奨shape:

Done: <verified completed state>
Now: <current work or blocker>
Next: <agent action or external dependency>

毎turnで同じfull planやhistoryを反復しない。

state repetitionはworking memory補助として使うが、既知情報を機械的に再掲するruleにはしない。

長いtaskでは、次を優先する。

  • completed milestone
  • current failing gate
  • changed dependency
  • user decision frontier
  • next irreversible boundary

5. Bound user actions

user actionが本当に必要な場合、実行単位へ分解する。

  • ordered actionならnumbered stepsを使う
  • 1 stepに複数の独立actionを詰め込まない
  • path / command / setting / expected resultを具体化する
  • trivialな手順を増やしてlistを膨らませない
  • arbitraryなlist上限は設けない
  • completenessが必要な場合は必要項目を省略しない

userが1つのblocking decisionだけ答えれば進められる場合、複数質問をまとめて投げない。

6. Suppress tangents

current objectiveを進める情報と、単に発見した情報を区別する。

secondary issueがcurrent taskのcorrectness / safety / release viabilityへ影響しないなら、main responseへ混ぜてcurrent pathを不明瞭にしない。

必要なら:

  • durable follow-upとしてIssue等へ分離する
  • final reportのknown follow-upへ短く残す
  • userが求めた場合に展開する

security issue、data loss risk、breaking contract等、放置するとcurrent work自体を無効化するものはtangentとして隠さない。

7. Report errors as operational state

errorを感情表現や曖昧な「問題が起きました」で包まない。

判明している範囲で次を示す。

  1. Symptom: どこで何が失敗したか
  2. Evidence: error / failing check / observed state
  3. Cause: confirmed cause。未確定なら仮説を事実化しない
  4. Recovery: fixまたは次のdiagnostic
  5. Verification: 何がgreenなら解決とみなすか

causeが不明な場合、同じ修正を繰り返すのではなくassumptionを切り分ける。

8. Make verification visible

「変更した」だけでcompletionを報告しない。

可能ならresultをverification evidenceと結びつける。

例:

  • test / lint / build結果
  • reproduced-before / fixed-after behavior
  • current SHA / deployed versionが必要なtaskでのidentity
  • generated artifactの存在
  • external stateのread-back

partial successではpassed stateとfailed stateの両方を隠さない。

9. Ask only consequential questions

質問する前にproject evidenceと利用可能なtoolで解けるfactを調べる。

design-refinement / engineering-decisions に従い、userへ戻すのは本当にuser-ownedなdecisionまたはexternal dependencyだけにする。

blocking questionを出す場合:

  • 何が未確定か
  • なぜagent aloneでは決められないか
  • 推奨defaultがあるなら何か
  • answer後に何を進めるか

を短く明確にする。

real ambiguityが1つなら、関係ない確認事項まで同時に増やさない。

10. Completion message

task完了時は、作業logではなくverified outcomeを中心にする。

最低限:

  • what now works / changed
  • verification performed
  • unresolved limitation or riskがあればそれ
  • user actionが残る場合だけそのnext action

完了済みtaskに対し、意味のない「必要なら続けます」「他にもあれば」等を自動付与しない。

11. Do not force brevity against the task

このSkillは短文化Skillではない。

userが説明、比較、walkthrough、audit、research、complete listを求めている場合は必要なdetailを出す。

actionabilityのために削ってよいのは、主に次である。

  • filler
  • duplicated state
  • internal process narration
  • unrelated tangent
  • avoidable delegation
  • non-informative ceremony

必要なtechnical detail、trade-off、safety information、evidenceは削らない。

12. Time estimates

所要時間を既定で生成しない。

userがestimateを求めた場合、またはplanning上materialな場合だけ、既知のtask surface / dependency / historical evidenceに基づくrangeとして示す。

根拠のない「5分」「すぐ終わる」等をactionabilityのために捏造しない。

13. Pre-send check

active-work messageを送る前に確認する。

  • agentが自分でできる作業をuserへ返していないか
  • first useful informationが埋もれていないか
  • userに不要な実況やtool sequenceが混ざっていないか
  • blocker / errorの事実と推測を分けているか
  • user actionが必要なら具体的でboundedか
  • completed resultにverification evidenceがあるか
  • tangentがcurrent pathをぼかしていないか
  • persistent artifact向け文章をここで直接確定していないか

Prior art

This Skill is conceptually informed by ayghri/i-have-adhd, especially its work on actionability, bounded steps, progress visibility, tangent suppression, and matter-of-fact error reporting. The upstream project is MIT-licensed.

The project-init policy intentionally does not adopt ADHD-specific framing, mandatory list caps, unconditional state repetition, forced time estimates, or blanket brevity rules.

04 同仓库更多 Skills

rebuildup
rebuildup/project-init

worktree-workflow

current release-driven profileでWorktrunkをWSL/Linux workspace lifecycle Practiceとして使い、Rust/Cargo worktreeのbuild-output isolation・cache reuse・cleanupを含め、同等以上のguaranteeを持つalternativeへのrefinementも判断する時に使用する。

★ 2
rebuildup
rebuildup/project-init

skill-selection

projectの初期化や再整備で、どのAgent Skillを導入するかを決める時に使用する。必要な能力を判定し、project-initの能力一覧と候補記録、さらに外部の探索から候補を評価して、能力ごとに担当を決め、project-localに導入してlockと採否を記録する。

★ 2
rebuildup
rebuildup/project-init

security-maintenance

framework/runtime/dependencyの脆弱性情報を収集し、projectへの実影響と優先度を判定してticket/releaseへ反映する時に使用する。

★ 2
rebuildup
rebuildup/project-init

security-audit

source codeから未知のsecurity invariant failureを能動的に探索し、coverageを明示しながら独立検証されたfindingへ変換する時に使用する。

★ 2
rebuildup
rebuildup/project-init

secrets-management

application / serviceのenvironment secretをInfisical中心で設計・初期化・移行・検証する時に使用する。CLI-first、repository-controlled schema、Machine Identity、GitHub OIDC、agent least-privilege、secret-safe evidenceを扱う。

★ 2
rebuildup
rebuildup/project-init

sandbox-runtime

implementation worker用の独立sandboxを作成・検証し、macOS / WSL/Linux / remote provider差を吸収する時に使用する。

★ 2