Skip to content

Add ai-signals skill (RFM, CLTV, NBA, NBP) - #211

Draft
hanzhenliu wants to merge 4 commits into
mainfrom
feat/ai-signals-skill
Draft

Add ai-signals skill (RFM, CLTV, NBA, NBP)#211
hanzhenliu wants to merge 4 commits into
mainfrom
feat/ai-signals-skill

Conversation

@hanzhenliu

Copy link
Copy Markdown

Draft / prototype — opening early for feedback on the setup flow and the reference structure.

Adds the ai-signals skill covering Treasure AI's PrecisionML suite: RFM, CLTV, NBA, and NBP. Each signal is a Treasure Workflow that POSTs to the ML Batch API and writes scored results to a TD table.

Contents

  • SKILL.md — solution-choice table, prerequisites, regional endpoints, the submit-then-poll API pattern, and a 9-step setup flow from signal choice through activation
  • references/rfm.md, cltv.md, nba.md, nbp.md — per-signal input requirements, complete working .dig workflows, parameter tables, output schemas, verification and analysis queries, and troubleshooting
  • references/data-discovery.md — candidate-table search, column mapping (including platform patterns for Shopify/Segment/Salesforce), and data-quality checks

Latest commit — plan confirmation gate

The last commit adds a confirmation checkpoint at the end of step 3, before project generation. Previously the only gate confirmed the source data; nothing showed the user what step 4 was about to write. The new plan block covers the prep table schema, solution_arguments, output schema, the .dig files to be created, and the train/predict cadence.

Cadence moved from step 7 to step 3 because it decides the file layout, not just the schedule. Splitting train from predict forces a fixed model_name — the references' ${session_id} names don't resolve across sessions — so deciding after generation means pulling the project and editing both files.

Open questions for review

  • Is one confirmation gate right, or should the source-data mapping keep its own sign-off in data-discovery.md?
  • ai-signals-skills.zip is committed at the repo root — intentional, or should it be built rather than tracked?

🤖 Generated with Claude Code

hanzhenliu and others added 4 commits August 25, 2026 14:26
Customer-facing skill for Treasure AI's AI Signals (PrecisionML) suite,
covering all four signals in one skill with progressive disclosure via
references/.

Owns the AI-Signals-specific material: the ML Batch API call pattern
(POST /v1/runs with solution_name + solution_arguments, 408-while-running
status polling, regional endpoints), per-signal input and output schemas,
complete .dig workflows, parameter tables, output verification and analysis
queries, model-quality interpretation, and troubleshooting.

Delegates rather than re-explains: .dig syntax, secrets and scaffold to
digdag; the http> external-API chassis to llm-workflow; tdx wf operations to
tdx-skills:workflow; table exploration to tdx-basic; td_interval to
time-filtering; and activation to parent-segment, segment, activation, and
connector-config.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Step 3 now ends by posting a plan summary and getting explicit
confirmation, and step 4 depends on it. Previously the only gate was
data-discovery's Step 4, which confirms the source data but says nothing
about what step 4 is about to write - so the user approved the input and
then got a generated project they never reviewed.

The plan block covers the forward half: prep table schema,
solution_arguments, output schema, the .dig files to be created, and the
train/predict cadence. Cadence moves here from step 7 because it decides
the file layout - splitting train from predict also forces a fixed
model_name, since the references' ${session_id} names do not resolve
across sessions, so deciding after generation means pulling the project
and editing both files.

The plan is posted in the conversation rather than written to the project
directory: tdx wf push uploads the whole directory as one revision, so a
plan.md beside the .dig would be deployed to TD and then drift.

data-discovery's Step 4 becomes a hand-off to that block so there is one
confirmation gate rather than two.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the tdx:core-skills Touches core skills: tdx-skills, sql-skills, workflow-skills label Aug 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tdx:core-skills Touches core skills: tdx-skills, sql-skills, workflow-skills

1 participant