Add knowledge from jira
Skill cat2000/domain-knowledge-ops/.cursor/skills/add-knowledge-from-jira
Agent skills for Cursor: Confluence/Jira → domain briefs → story risk & INVEST splits and test case Design. Offline DEMO-1 — no Atlassian needed to try.
npx -y skills add cat2000/domain-knowledge-ops --skill add-knowledge-from-jiraAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 24 days oldThe repository was created 24 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
@add-knowledge-from-jira + team/board-id or sprint-id: Jira Ingest→Classify, shared Recognize, unified Compose S3→S7. Jira tickets are primary business-rule evidence, not post-S7 appendices. Default = prep (Ingest+Classify). No external OpenAI API.
SKILL.md
5.3 KB, as published. Nobody here has run it
add-knowledge-from-jira (Jira → business-rule evidence)
Pipeline: Ingest → Classify → Recognize (shared confirm with wiki) → Compose (unified S3→S7). AC, comments, and last-wins decisions are first-class domain evidence — they enter the S3/S4/S5 mainline, not a post-brief patch.
confirm authorizes Compose; it is not “briefs already done”. (zh-CN strings for these tokens: domain-knowledge/language/deliverable-locale-tokens.json.)
Compose language (same as wiki): S6 = source-language brief; S7 = convert to deliverable_locale (expression only).
When to use
- Fold sprint/history ticket rules, AC, and comment decisions into the same domain library
- Not for single-ticket risk/split/test-design →
@requirement-risk/@ticket-splitter/@ticket-test-design
Prep vs Compose (stop boundaries)
| Label | Contains | Who | Stops at |
|---|---|---|---|
| Script prep | Ingest + Classify | run_jira_knowledge.py (no flag = board history; --sprint-id = one sprint) | After domain_check jira --full-raw |
| Full prep | Script prep + Cursor Recognize | Agent (wiki RUNBOOK · S2) | Checklist + closure ready → wait for confirm |
| Compose | Unified S3→S7 | Agent + wiki RUNBOOK | Only confirmed themes; S3 includes eligible Jira materializations |
User mode= → CLI
User mode= | Agent runs |
|---|---|
history + team=<t> | python3 scripts/run_jira_knowledge.py --team <t> (board history through current sprint) + Classify |
history + board-id=<id> | Resolve team via team-roots.json, then same as history |
sprint + sprint-id=<id> | run_jira_knowledge.py --team <resolved> --sprint-id <id> + Classify |
| (default / prep) | history if team/board given; sprint if sprint-id given |
compose / continue | Wiki RUNBOOK Compose (S3→S7); S3 reads Confluence and Jira evidence |
distill / reconcile / full | Removed — refuse; use prep → Recognize → Compose |
Hard rules
- Ingest (script):
jira/raw/—INGEST-CLI.md - Classify (script):
attribution/+ theme indexes —CLASSIFY-CLI.md - Ticket count ≠ done: Classify coverage is not pipeline completion (
pipeline-design.md) - Jira is not an appendix:
distill_tier=proposition_core/platform_varianttickets enter S3 proposition candidates - Recognize shares
DOMAIN_MODULE_CHECKLIST.mdwith wiki; confirm authorizes Compose - Compose follows
generate-knowledge-from-wiki/RUNBOOK.md(S6 source brief → S7 locale brief) - Legacy Extract/Integrate paths are deleted — do not revive post-S7 Jira patches
primary/themes[]= confirmed slugs;gateway/requirementsare sink buckets, not domains- Source of truth is Jira; do not treat hand-edited
jira/materialized/as authority - No in-repo HTTP LLM API
- No translation in S1–S6; locale conversion only in S7
User examples
@add-knowledge-from-jira team=demo mode=history
@add-knowledge-from-jira board-id=1 mode=history
@add-knowledge-from-jira team=demo mode=sprint sprint-id=1726
Review checklist → confirm → continue → verify aggregates/work drafts/S6+S7 briefs include Jira rules.
Agent checklist
| # | Action |
|---|---|
| 1 | Ingest: run_jira_ingest.py or run_jira_knowledge.py (INGEST-CLI.md) |
| 2 | Read JIRA_PIPELINE_HANDOFF.json → curated/by-root/<R>/ |
| 3 | Classify (CLASSIFY-CLI.md) → Recognize → pause at full prep |
| 4 | On continue (confirm rows only): Compose S3→S7; proposition lists should show source_system: jira |
| 5 | After Compose: domain_check distill --root-id <R>; optionally domain_check jira --full-raw |
Forbidden
- Report “pipeline done” because N tickets have attribution
- Claim Jira rules merged from the gap-scan index (
by-theme/<team>/output ofread_business.py) alone - Compose without confirm
- Promote
gateway/requirementsto confirmed checklist rows - Run deleted legacy scripts or post-S7 patches
- Skip S6 and write only a translated S7 file
Further reading
| Doc | Purpose |
|---|---|
RUNBOOK.md | Jira stages + shared layers |
RUNBOOK.zh-CN.md | Chinese locale playbook |
INGEST-CLI.md / CLASSIFY-CLI.md | Script flags & gates |
generate-knowledge-from-wiki/RUNBOOK.md | Shared Recognize + Compose |
../../contracts/domain-knowledge-pipeline-contract.md | Artifact layers |
Next
@requirement-risk → @ticket-splitter → @ticket-test-design (read S7 Compose briefs).