feat(commands): ac.mjs 통합 디스패처 + 결과 중심 기록 원칙 - #6
Merged
Conversation
1. 스킬 커맨드 레이어 — tools/ac.mjs 단일 디스패처
- export/import/current: 세션 내보내기·불러오기·포인터 (handoff 래퍼)
- issue/learning/idea/note/todo/decision: frontmatter 자동 생성 entry 작성
(파일명 규약·decision NNNN·diary append 자동 처리, level 비우면 lite AI 배정)
- history/search/index/validate: 기존 도구 래퍼
- 슬래시 별칭 (/ac-export, /ac-import, /ac-issue ...) 을 SKILL.md 양쪽에 표로 문서화
2. 결과 중심 기록 원칙 (사용자 아이디어 채택)
- 도구 호출 로그를 기억에 추가하지 않음 — '결론 + refs(검증 링크)'만 저장
- schema.json에 optional refs 필드 추가
- docs/protocol.md에 원칙 섹션, ac.mjs learning 템플릿이 cause/fix/lesson+refs 형식 강제
- README 명령어 섹션에 원칙 요약
근거: 도구 사용 과정·출력 전문은 토큰 낭비. 다음 에이전트는 결론을 쓰거나
의심 시 refs로 직접 확인하면 되므로 중간 과정은 가치 없음.
버그의 repro는 과정 로그가 아니라 재현 레시피로 최소 유지.
검증: /tmp/ac-test 샌드박스에서 issue/learning/export/history 실측,
node --check 통과, validate ok, T2Editor 언급 0건
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
1. 스킬 명령어 — tools/ac.mjs 단일 디스패처
node tools/ac.mjs export --session S --task "..." --done "a;b" --next "c"node tools/ac.mjs import [file]node tools/ac.mjs currentnode tools/ac.mjs history "query" --limit Nnode tools/ac.mjs issue --title "..." [--refs "p1,p2"]node tools/ac.mjs learning --title "..." --cause C --fix F2 --lesson L2. 결과 중심 기록 원칙 (사용자 아이디어 채택)
도구 호출 로그를 기억에 추가하지 않음:
❌ "Grep으로 검색하고 Read로 3개 읽었더니..."
✅ "JWT race → 전역 mutex 해결. 검증: src/auth/refresh.ts:42"
refs필드 추가docs/protocol.md원칙 섹션 신설ac.mjs learning템플릿이 cause/fix/lesson+refs 형식을 강제해 원칙을 코드로 강제검증
/tmp/ac-test 샌드박스에서 issue/learning/export/history 실측 통과.
node --check 전체 통과. validate ok. T2Editor 언급 0건.