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な情報を置く。
状況に応じて優先するもの:
- completed result
- current blocker
- decision needed from the user
- concrete next agent action
- 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を感情表現や曖昧な「問題が起きました」で包まない。
判明している範囲で次を示す。
- Symptom: どこで何が失敗したか
- Evidence: error / failing check / observed state
- Cause: confirmed cause。未確定なら仮説を事実化しない
- Recovery: fixまたは次のdiagnostic
- 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
worktree-workflow
current release-driven profileでWorktrunkをWSL/Linux workspace lifecycle Practiceとして使い、Rust/Cargo worktreeのbuild-output isolation・cache reuse・cleanupを含め、同等以上のguaranteeを持つalternativeへのrefinementも判断する時に使用する。
skill-selection
projectの初期化や再整備で、どのAgent Skillを導入するかを決める時に使用する。必要な能力を判定し、project-initの能力一覧と候補記録、さらに外部の探索から候補を評価して、能力ごとに担当を決め、project-localに導入してlockと採否を記録する。
security-maintenance
framework/runtime/dependencyの脆弱性情報を収集し、projectへの実影響と優先度を判定してticket/releaseへ反映する時に使用する。
security-audit
source codeから未知のsecurity invariant failureを能動的に探索し、coverageを明示しながら独立検証されたfindingへ変換する時に使用する。
secrets-management
application / serviceのenvironment secretをInfisical中心で設計・初期化・移行・検証する時に使用する。CLI-first、repository-controlled schema、Machine Identity、GitHub OIDC、agent least-privilege、secret-safe evidenceを扱う。
sandbox-runtime
implementation worker用の独立sandboxを作成・検証し、macOS / WSL/Linux / remote provider差を吸収する時に使用する。