mcpField
T
tk-to-spec

tk-to-spec

github.com/mtgvimDevelopment186 installsUpdated today
Repository

About tk-to-spec

tk-to-spec is a manually triggered skill that turns readable source evidence into a self-contained specification in the current repository. It preserves evidence lineage and uncertainty, and stops at an approval boundary without changing implementation or remote state.

Key features

  1. 01Manual trigger only
  2. 02Writes .tigerkit/spec.md
  3. 03Tracks claims to source evidence
  4. 04Separates facts, decisions, and unverified claims
  5. 05Records missing evidence and conflicts
  6. 06Requires explicit approval to mark ready

Use cases

  1. 01Convert issue and repository research into a specification
  2. 02Document acceptance criteria and verification evidence
  3. 03Record conflicting or missing requirements before implementation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mtgvim/tiger-kit --skill tk-to-spec

After installing, type/tk-to-specin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
evals/
evals.json
triggers.json

Details

From the project README

Evidence를 spec으로 변환

명시적으로 /tk-to-spec 또는 $tk-to-spec 을 선택한 경우에만 실행한다. 입력은 대화, issue, artifact, repository 조사 결과 등 실제로 읽을 수 있는 source evidence다. 다른 skill을 호출하거나 구현·ticket·원격 상태를 수정하지 않는다.

출력 계약

유효한 source evidence가 있을 때만 현재 repository root의 .tigerkit/spec.md에 쓰고, 먼저 git rev-parse --show-toplevel로 root를 확인한 뒤 결과에 그 root에서 파생한 실제 absolute path를 보고한다. 문서는 다음을 직접 포함하는 self-contained Markdown이어야 한다.

  • Status: Pending (사용자가 명시적으로 승인하기 전에는 downstream이 소비하지 않음)
  • source/R-AC와 lineage (각 주장과 출처의 연결)
  • goal, scope, exclusions, constraints
  • acceptance criteria와 verification 명령/증거
  • facts, confirmed decisions, unverified claims를 별도 표시
  • missing evidence와 conflicts 및 영향
  • 설명 문장과 제목은 한국어로 작성하고, 정확한 필드·상태·ID·명령·경로·URL·리터럴만 원문으로 유지한다.

절차

  1. source를 읽고 각 문장을 Fact | Confirmed decision | Unverified claim으로 분류한다.
  2. 없는 정보는 채우지 말고 Missing evidence로 적는다. 모순은 양쪽 근거와 해결 owner를 Conflict로 적고 상태를 Blocked 또는 Unverifiable로 둔다.
  3. goal/scope/제외/제약/acceptance/verification/lineage를 작성한다. 기술적 literal, 변경 path, 실패 조건도 원문 그대로 둔다.
  4. 저장 전 self-contained인지, 승인 경계가 있는지 확인한다. 사용자가 승인하면 그 명시적 승인만으로 Pending을 Ready로 바꿀 수 있다.

정보가 부족해도 self-contained 문서를 만들고 부족한 항목과 절대 경로를 명시한 뒤 Status: Unverifiable로 멈춘다. conflict가 해소되지 않으면 양쪽 근거를 보존해 Status: Blocked로 멈춘다. .tigerkit/ 외 state, archive/current pointer/global 설정은 만들지 않는다.

경계

일반적인 계획 작성, 구현, ticket 분해, 단순 질문에는 trigger하지 않는다. 사실을 추론으로 승격하지 않으며, Pending 문서를 downstream 입력으로 전달하지 않는다.

Comments

Markdown supported