본문으로 건너뛰기
cccskills
무료GitHub에 공개

report-spec

Turn a request for a report or a dashboard widget into something buildable: the question it answers, the metric and its definition, where the data comes from, the query shape, and what it will not answer. Use when a new report or dashboard is requested, when an existing one needs a metric added or changed, when a widget is asked for in a sentence and needs pinning down, or when two reports disagree about the same number.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md2.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Report spec

Goal

A spec somebody can build against without a follow up conversation, and a number that means the same thing next quarter as it does today.

Procedure

  1. Get the question behind the request. A request for a chart of complaints per site is really a question about which sites need attention, and the answer might not be that chart.
  2. Define the metric precisely: the numerator, the denominator, the window, the grain and the filters. Check memory/conventions/metrics.md first, since the same word usually already means something here.
  3. Say where each field comes from, which table or endpoint, at what grain, refreshed how often. A metric assembled from two sources with different refresh cadences will disagree with itself.
  4. Check the grain before designing the query. If the join can produce more rows than entities, every total downstream is inflated, and this is the defect that survives review because the numbers look plausible.
  5. Decide where it is computed. In the pipeline, in the query, or in the reporting layer. Computing the same metric in two places is how two reports end up disagreeing.
  6. Say what it will not answer, so nobody reads a cause into a count.
  7. Note the cost: how heavy the query is, how often it runs, and whether it needs its own pipeline step rather than running live.

Boundaries

  • Never ship a metric whose definition has not been agreed and written down.
  • Never compute a metric in a second place because it is easier than reusing the first.
  • Never build an audience-facing report on a source you have not checked the refresh cadence of.
  • Never include another audience's data in a scoped report, in any aggregate.
  • Do not build it as part of specifying it. The spec is the deliverable here.

What to record

Write every agreed definition into memory/conventions/metrics.md with its numerator, denominator, window, source and the date it was agreed, and note where it is computed. When two reports are found disagreeing, record the cause there too, because the same pair will disagree again after the next change.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Plan or review software architecture through a small expert panel. Use when the user explicitly asks for architecture planning, system design, technical strategy, an architecture assessment, a design review, or a system health review. Do not use for ordinary PR review, debugging, or implementation.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nanocoai/nanoclaw-templates202026년 9월 16일 업데이트

Thorough, consistently formatted competitor and product research. Produces a structured "About" doc, a "Recent News" log, and a row in a tracking spreadsheet. Use whenever the user researches a company or competitor, builds or updates a competitor doc, compares products, or logs a competitor to the tracker.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nanocoai/nanoclaw-templates202026년 9월 16일 업데이트

Household assistant for a whole family. Runs a morning brief, plans meals and builds grocery lists (hunting the best prices), looks ahead at the week's logistics, stays on top of the kids' school, watches prices on things the family wants, and helps book appointments and reservations. Use it for anything that keeps the family's day or week running. Trigger even on implicit asks - "what's on today", "what do the kids have this week", "what should we make for dinner", "add milk to the list", "when's the dentist", "did anything come from school", "remind me about the permission slip", "watch this jacket and tell me if it drops", "book us a table Friday".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nanocoai/nanoclaw-templates202026년 9월 16일 업데이트

Reporting workflow for a working journalist, using web research and Apify's X scraper (social signals). Onboards the journalist, monitors their beat and builds digests, evaluates story pitches, finds and vets sources, and prepares interviews. Use for any newsroom task, such as "what's new on my beat", "is this pitch any good", "who should I talk to about X", "prep me for this interview", or "turn these notes into a draft".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nanocoai/nanoclaw-templates202026년 9월 16일 업데이트

Check that the scheduled data work behind the reports actually ran and produced something sensible: the daily reshaping scripts, the API pulls, the tables the reports read from. Use each morning before anyone opens a report, when a report looks wrong and nobody knows whether it is the data or the query, after a schema or API change, when a new audience or source is added to the pipeline, or when a scheduled job failed or finished suspiciously fast.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nanocoai/nanoclaw-templates202026년 9월 16일 업데이트

Write the SQL or MongoDB query that answers a question and keeps answering it: the right grain, no fan out, parameterised window, checked against something known. Use when a number is needed that no report carries, when an existing query returns something that looks wrong, when a query is slow or expensive, or when somebody asks for a one off pull.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

nanocoai/nanoclaw-templates202026년 9월 16일 업데이트

nanocoai의 스킬 모두 보기

이 스킬의 문제 신고