zrwangems/dsh-zrwang-plugin / ars/skills/deep-research
deep-research
Flagged学术研究前置:把模糊想法收敛成可研究的问题,并做文献综述、事实核查、系统综述(PRISMA)与三向文献扫描。Triggers: research, deep research, literature review, systematic review, meta-analysis, PRISMA, fact-check, guide my research | 研究, 文献综述, 系统性文献回顾, 事实核查, 引导我研究, 帮我确定研究问题。输出 RQ Brief、方法论蓝图、带核验的注释书目。
_shared/contracts/passport/human_read_log.schema.json
View on GitHub{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/Imbad0202/academic-research-skills/shared/contracts/passport/human_read_log.schema.json",
"title": "ARS user-attested reading ledger (peer file of the Material Passport)",
"description": "Schema for <passport-stem>_human_read_log.yaml, the user-owned USER_ATTESTED_READ ledger written by scripts/ars_mark_read.py (v3.6.8 §3.6; #513/#738 read_scope attestation). It records a declaration, not verified reading or comprehension. Deliberately a sidecar: literature_corpus_entry.schema.json stays adapter-owned and unmodified. The ledger is append-only; unmark appends rescinded_at, never deletes. New marks require read_scope; legacy absence means coverage_unknown and never licenses promotion to ok. Nothing is inferred or backfilled.",
"type": "object",
"additionalProperties": false,
"required": ["session_id", "created_at", "human_read"],
"properties": {
"session_id": {
"type": "string",
"minLength": 1
},
"created_at": { "$ref": "#/$defs/rfc3339_utc" },
"human_read": {
"type": "array",
"items": { "$ref": "#/$defs/human_read_entry" }
}
},
"$defs": {
"human_read_entry": {
"type": "object",
"additionalProperties": false,
"required": ["citation_key", "marked_at"],
"properties": {
"citation_key": {
"type": "string",
"minLength": 1,
"description": "Joins against literature_corpus[].citation_key in the active passport."
},
"attestation_type": {
"const": "USER_ATTESTED_READ",
"description": "Written on new marks. Optional only so pre-#738 ledger entries remain parseable as legacy declarations."
},
"marked_at": { "$ref": "#/$defs/rfc3339_utc" },
"rescinded_at": {
"$ref": "#/$defs/rfc3339_utc",
"description": "Appended in place by /ars-unmark-read; presence means this mark no longer counts. Most-recent-timestamp-wins per v3.6.8 §3.6."
},
"read_scope": { "$ref": "#/$defs/read_scope" }
},
"allOf": [
{
"if": { "required": ["read_scope"] },
"then": { "required": ["attestation_type"] }
},
{
"if": { "required": ["attestation_type"] },
"then": { "required": ["read_scope"] }
}
]
},
"read_scope": {
"type": "object",
"additionalProperties": false,
"required": ["level"],
"description": "#513/#738 coverage attestation: how much of the source the user declares reading. Declaration-only — adapters and agents never infer or backfill it. `unknown` is explicit coverage_unknown and never licenses promotion to ok. Locators require level: sections.",
"if": { "required": ["locators"] },
"then": {
"properties": { "level": { "const": "sections" } }
},
"properties": {
"level": {
"type": "string",
"enum": ["full_text", "sections", "abstract_only", "toc_only", "unknown"]
},
"locators": {
"type": "array",
"minItems": 1,
"items": { "type": "string", "minLength": 1, "maxLength": 200 },
"description": "Free-text section/page declarations (e.g. 'pp. 10-24', 'section 3'). Only meaningful — and only accepted by the CLI — with level: sections."
},
"note": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
}
},
"rfc3339_utc": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,6})?Z$",
"description": "RFC 3339 timestamp normalized to UTC with a literal Z suffix. The runtime also validates calendar/time values and rescinded_at >= marked_at."
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |