child-session
Discipline a worker session loads at dispatch time — verify the brief's premises before implementing, work only on its own branch, and report in the fixed completion format. Use when a session has been dispatched as a worker (child) with a brief from a parent control session.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- child-session
- description
- Discipline a worker session loads at dispatch time — verify the brief's premises before implementing, work only on its own branch, and report in the fixed completion format. Use when a session has been dispatched as a worker (child) with a brief from a parent control session.
02 资源文件 1
- 参考文档agents/openai.yaml423 B
03 SKILL.md 正文
Child Session 스킬
control-loop을 쓰는 부모 세션이 워커를 디스패치할 때 함께 로드하는 스킬이다. 부모와
워커는 행위자·세션·권한이 다르므로 별도 스킬로 둔다 — 부모 쪽 규율은
control-loop가 소유하고, 이 스킬은 워커 자신에게 로드되는 규율만 소유한다.
브리프에 적힌 금지사항을 워커가 어긴 사고가 실제로 있었다 — 원칙을 부모 쪽 문서에만 적어 두는 것만으로는 부족했다. 규율이 워커 자신의 세션에 로드돼야 지켜진다.
0. 인자 4개 확인 — 가장 먼저
디스패치 시 다음 4개와 함께 로드된다:
- 부모 세션 이름/식별자
- 역할 + 워크트리 경로
- 4블록 브리프(전제 / 범위·계약 / 금지사항 / 보고형식 — 스키마 SSOT는
rules/delegation-contract.md) - 금지사항 기본값(push 금지, 통합 브랜치 쓰기 금지, 파괴적 git 명령 금지, 공유 원장 쓰기 금지 등)
하나라도 빠지면 추측하지 않는다. 부모에게 물어라 — 호스트가 제공하는 수단으로. 이 확인이 구현보다 먼저다.
1. 한 줄 확인 보고
인자 4개를 확보했으면, 작업을 시작하기 전에 무엇을 맡았고 어디서 작업하는지 부모에게 한 줄로 확인한다. 이것이 착수 신호다.
2. 마커 기록
로드 시 마커를 쓴다. 위치는 $(git rev-parse --git-dir)/kit/child.json.
- 이 경로는 워크트리마다 분리되고 구조적으로 untracked다 — 워킹트리를 더럽히지 않고
git ls-files에도 잡히지 않으므로.gitignore등재를 따로 검사할 필요가 없다. - 내용:
rules/child-marker.md의 스키마를 그대로 따른다 — 키 이름이 고정돼 있다 (schema·parent·role·base_commit·written_at). 키를 임의로 정하면 훅이 읽지 못해 "자식 아님"으로 오판한다(실측: 두 세션이base_commit·baseline_commit으로 갈렸다). 부모 없이 스스로 로드했으면parent는"self"다. - 치환으로 쓴다(추가가 아니라) — 새 브리프를 받을 때마다 마커를 덮어쓴다. 같은 워크트리를 다음 작업이 이어받는 경우, 이전 브리프의 부모 이름·기준 커밋이 낡은 채 남아 있는 것을 막는다.
- 예외 — 주 체크아웃에는 쓰지 않는다.
git rev-parse --git-common-dir과--git-dir이 같은 경로로 나오면 주 체크아웃이다. 이 스킬이 거기서 로드되더라도 마커를 쓰지 않는다 — 마커는 워커임을 확인하는 용도이지, 주 체크아웃(부모가 쓰는 자리)을 워커로 승격시키는 용도가 아니다. - gitdir이 없는 비-git 환경으로 폴백할 때만, 마커 대신 상태 파일이
.gitignore에 등재돼 있는지 확인한다.
3. 전제 검증 — 구현보다 먼저
브리프에 적힌 사실 주장을 코드에서 확인한다. "없다 / 신설한다"라고 적혀 있어도
그대로 믿지 않고 grep이나 대상 파일 직접 열람으로 재확인한다. 전제가 틀렸으면
구현하지 않는다 — 멈추고 부모에게 보고한다.
기준 커밋 확인: 브리프에 적힌 해시와 자기 워크트리의 git rev-parse HEAD를
대조한다. 다르면 착수하지 않고 즉시 에스컬레이션한다. 브랜치 이름(main 등)은
기준으로 쓰지 않는다 — 로컬 브랜치는 다른 체크아웃이 물고 있어 낡아 있을 수 있다.
4. 구현 — 금지사항은 명령 수준으로 지킨다
- 자기 워크트리의 피처 브랜치에만 커밋한다. 통합 브랜치(
main등) 체크아웃·쓰기 금지. push금지.- 데몬·상시 프로세스 재시작 금지 — 부모 세션이나 다른 워커에 영향을 준다.
- 공유 원장(병합 전 상태를 반영하는 파일) 쓰기 금지 — 병합 전까지 다른 워커·부모에 반영되지 않아 상태가 유실되거나 분기된다.
- 브리프의 금지사항은 명령 수준으로 지킨다. 예: "읽기만"이 아니라 "
--check만 실행,--apply실행 금지"처럼 구체적으로 해석한다. 원칙 수준 금지("깨뜨리지 않는다") 는 실제로 어겨진 전례가 있다.
5. 되돌려-FAIL 의무
수정이 실제로 결함을 고쳤다는 증거를 남긴다 — 그 수정을 되돌리면 검증이 실제로 FAIL하는지 최소 1건 확인한다. 이것 없이 "테스트 green"만으로 완료를 주장하지 않는다.
6. 테스트 결과는 종료코드가 살아 있는 채로
테스트 실행 결과를 파이프로 넘겨 종료코드를 죽이지 않는다 — … | tail류는 종료코드가
삼켜져 실패가 성공처럼 보고될 수 있다. 결과를 파일로 받거나 set -o pipefail 아래에서
실행한다. 상세 규칙은 계약(rules/delegation-contract.md)이 정의한다.
7. 완료 보고
보고 첫 줄의 고정 형식은 계약(rules/delegation-contract.md)이 SSOT다. 그 형식
그대로 쓴다 — 여기서 다시 정의하지 않는다.
파리티 — 킷이 차단 훅을 싣지 않는 하네스에서는 지침일 뿐이다
이 절차(브랜치 제한·push 금지·파괴적 명령 금지)를 Claude Code 훅(opt-in 예시)으로 자동 차단하는 경로가 있을 수 있다. 킷의 차단 훅(PreToolUse)은 Claude Code 에만 실린다. Codex 는 PreToolUse 차단을 지원하지만(실측) 킷은 Codex 에 차단 훅을 싣지 않는다 — 세션 시작 주입·자동 포맷 훅만 돈다(마켓플레이스 설치·훅 신뢰 승인 후. 승인 전과 디렉토리 ZIP 설치에서는 그것도 없다). 그래서 Codex 에서 이 규율은 이 스킬 본문을 읽고 따르는 지침으로 작동한다. Antigravity 등 킷 훅이 실리지 않는 하네스도 같다.
예외 — opt-in git 훅은 하네스와 무관하게 차단한다. 킷이 배포하는 git 훅
(setup/git-hooks/pre-push — 자식 워크트리의 git push, setup/git-hooks/reference-transaction
— 태그 없는 git stash)은 git 이 실행하므로 누가 명령을 내리든 똑같이 돈다. 단 opt-in
이다 — 그 레포에 설치돼 있을 때만 차단하고, 설치되지 않았으면 위와 같이 지침일 뿐이다.
이 스킬 자체가 로드돼야 규율이 적용된다는 점도 명시한다 — 이 스킬을 로드하지 않은 세션(또는 워크트리)은 마커도, 위 규율도 적용받지 않는다(fail-open). 없는 보호를 있다고 믿지 않는다.
관련
경로는 플러그인 루트 기준이다(소비자 프로젝트 cwd 가 아니다).
| 문서 | 위치 |
|---|---|
| 부모(컨트롤) 규율 | skills/control-loop/SKILL.md |
| 브리프 4블록·보고 형식 계약 | rules/delegation-contract.md |
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.