writing-fragments

writing-fragments 개요

writing-fragments skill은 개요부터 시작하는 대신, 원재료를 모아 글을 만드는 데 쓰는 skill입니다. 초점을 맞춘 인터뷰를 진행하고, 바로 쓸 수 있는 문장들을 수집한 뒤, 초안이 잡혀 가는 동안 하나의 markdown 문서에 계속 덧붙일 수 있게 도와줍니다. 최종 구조를 정하기 전에 주장, 짧은 사례, 표현, 반쯤 떠오른 아이디어를 먼저 잡아두고 싶다면, 이 writing-fragments skill이 맞습니다.

이 skill은 Knowledge Capture와 초기 단계 초안 작성에 가장 잘 맞습니다. 이 단계에서는 다듬는 일보다, 실제로 남길 만한 내용이 무엇인지 찾는 일이 더 중요하기 때문입니다. 핵심 차별점은 writing-fragments가 단계, 섹션, 깔끔한 논지를 너무 일찍 강요하지 않는다는 점입니다. 이미 구조를 알고 있다면 일반적인 prompt로도 충분한 경우가 많지만, 먼저 원재료가 필요하다면 이 skill이 더 적합합니다.

이 skill이 필요한 경우

사용자가 아이디어를 풀어놓고 싶다거나, 생각을 쏟아내고 싶다거나, 조각난 내용을 모으고 싶다거나, 거친 주제를 글감으로 바꾸고 싶다고 할 때 writing-fragments를 사용하세요. 원본 내용이 뒤섞여 있거나, 작성자 본인도 최종 글이 무엇이 될지 아직 확신하지 못하는 상황에서 특히 유용합니다.

무엇이 다른가

이 workflow는 대화형이면서 누적형입니다. 묻고, 담고, 다시 읽고, 덧붙이는 방식이죠. 이 skill은 세션이 진행되는 동안 문서가 계속 수정 가능하다고 가정하므로, 새 문장을 만드는 것만큼 사용자의 편집 내용을 지키는 일도 중요합니다. 그래서 즉석 브레인스토밍 prompt보다 실제 라이브 writing session에 더 실용적입니다.

이런 경우에는 쓰지 마세요

처음부터 완성된 개요, 구조화된 brief, 또는 다듬어진 article이 필요한 경우에는 writing-fragments를 쓰지 마세요. 결과물이 즉시 독자에게 바로 읽히는 형태의 self-contained 문서여야 할 때도 적합하지 않습니다.

writing-fragments skill 사용 방법

설치하고 context를 불러오기

skills directory에서 writing-fragments install 흐름을 사용한 다음, 먼저 skills/in-progress/writing-fragments/SKILL.md를 여세요. 이 repo에는 helper script나 support folder가 없어서, skill 동작은 거의 전부 skill file 안에 들어 있습니다. 즉, 설치 성공은 숨은 automation을 찾는 데 달린 것이 아니라, 지침을 꼼꼼히 읽는 데 달려 있습니다.

거친 목표를 좋은 prompt로 바꾸기

이 skill은 사용자가 주제, 대상 독자, 그리고 어떤 종류의 fragments를 남기고 싶은지 알려줄 때 가장 잘 작동합니다. 좋은 입력 예시는 “AI note-taking tools를 작은 팀이 왜 채택하는지에 대해 쓰고 있어요. 날카로운 주장과 예시를 끌어낼 수 있게 인터뷰해 주세요” 또는 “내 system이 왜 실패했는지에 대한 Knowledge Capture essay용 fragments를 모으는 걸 도와 주세요” 같은 식입니다. 반대로 “productivity에 관한 거 뭐라도 써 줘” 같은 입력은 모호해서, 이런 grilling session에서 쓸 만한 재료를 얻기 어렵습니다.

세션 중 실전 workflow

먼저 path가 주어지지 않았다면 파일을 어디에 저장할지 물은 뒤, 세션 내내 그 path를 일관되게 유지하세요. append할 때마다 markdown file을 다시 읽어서 사용자의 편집이 덮어써지지 않게 해야 합니다. 첫 번째 write에서는 상단에 working title H1 하나만 두고, 그다음부터는 섹션으로 너무 일찍 바꾸지 말고 떠오르는 fragment를 그대로 추가하세요.

repo에서 읽는 순서

먼저 SKILL.md부터 읽고, 같은 파일 상단의 fragment 정의, session style, file-format rules를 확인하세요. 출력 품질에 가장 큰 영향을 주는 부분이 바로 그 항목들입니다. writing-fragments guide를 자신의 workflow에 맞게 조정하려면, 구조에 대한 제약, 문서 상태, 무엇이 fragment로 간주되는지를 특히 주의해서 보세요.

writing-fragments skill FAQ

writing-fragments는 초보자에게도 좋은가요?

네, 주제에 대해 질문에 답할 수 있고 반복적인 과정을 감당할 수 있다면 그렇습니다. 중요한 건 writing 실력보다, prompt에 반응하면서 세션이 진행되는 동안 문서를 계속 열어 둘 의지가 있느냐입니다.

일반 prompt와는 무엇이 다른가요?

일반 prompt는 보통 완성된 글 한 편을 만들려고 합니다. 반면 writing-fragments는 먼저 재료를 모으고, 정리는 나중으로 미루도록 설계되어 있습니다. 글의 형태를 정하기 전에 가장 좋은 문장부터 찾아내야 할 때 이 차이가 특히 중요합니다.

Knowledge Capture workflow에 맞나요?

네. writing-fragments for Knowledge Capture 활용 사례는 살아 있는 경험, 통찰, 인터뷰 답변을 즉시 요약으로 밀어 넣지 않고 재사용 가능한 writing fragments로 남겨야 할 때 특히 강합니다.

어떤 경우에는 피해야 하나요?

구조, 최종 주장, 한 번에 끝나는 deliverable이 필요한 경우에는 건너뛰세요. 또한 같은 file을 계속 편집할 수 없을 때도 적합하지 않습니다. 이 skill은 현재 문서를 보존하고 다시 읽는 데 의존하기 때문입니다.

writing-fragments skill 개선 방법

모델에 더 나은 원재료를 주세요

writing-fragments usage를 개선하는 가장 좋은 방법은 추상적인 주제 대신 구체적인 사례, 대비, 인용문, 특정 순간으로 답하는 것입니다. “remote work에 대한 fragments가 필요해요”라고 하면 뻔한 재료가 나오기 쉽지만, “팀이 회의를 더 이상 믿지 않게 되는 순간에 대한 fragments가 필요해요”라고 하면 훨씬 날카로운 writing fuel을 얻을 수 있습니다.

구조 과잉으로 세션이 흐트러지지 않게 하세요

흔한 실패 모드는 너무 일찍 outline으로 흘러가는 것입니다. 대화가 재료를 모으는 대신 요약 쪽으로 가기 시작하면, 남길 만한 문장, 기억에 남는 주장, 최종 article에 살아남을 수 있는 디테일로 방향을 돌리세요. 구조는 나중의 편집 단계로 두는 편이 이 skill에 더 잘 맞습니다.

살아남는 것에 맞춰 반복하세요

첫 번째 패스가 끝나면 문서에서 읽기 쉽고, 구체적이며, 다시 쓸 수 있는 fragment를 골라 보세요. 가장 강한 문장 주변에 더 많은 재료를 요청하거나, 가장 약한 부분에 대해서만 대안을 생성해 달라고 하세요. 목표가 synthesis 전에 fragment bank를 키우는 것이라면, 전체를 다시 쓰게 하는 것보다 이런 방식이 대개 더 효과적입니다.