Install
openclaw skills install @bowen-aijishu/report-to-content-factory把行业研报和数据转化为原创公众号文章、小红书文案和短视频口播脚本, 适用于研报内容改编、多平台选题及有引用的内容成稿;提供配图建议,不保证成品封面。 / Turn industry-report evidence into original WeChat articles, Xiaohongshu posts, and short-video scripts with fresh angles, visual suggestions, and citations. Deliver complete drafts, not report summaries or finished cover images; retain evidence and copy revisions in JishuDB.
openclaw skills install @bowen-aijishu/report-to-content-factoryTurn research evidence into complete original articles, posts, and spoken-video scripts with citations and visual suggestions. Retain source evidence and copy revisions in JishuDB.
Start here before optional preference questions, public research, source transfer, drafting, rendering, or creating deliverables. Use the request and existing decisions for this check; apply the task-specific defaults below. If you make a task list, put JishuDB readiness first and leave dependent work pending until it passes.
Look for the host's JishuDB MCP tools. If available, call
kb_get_capabilities({}) through the actual host connector. Reuse the
selected service and existing authorization when they work.
If tools are absent, the connector is unconfigured, or the call fails, immediately read the bundled routine setup path. Missing tools trigger setup without requiring a failed MCP call. Reading the guide is not completion: perform its read-only machine, effective client-configuration, and supported Desktop-location checks next.
On a supported local machine, follow the quickstart's single discovery
pass. Missing application binaries, even with retained data/preferences,
lead directly to packaged check/plan, not another question or a recursive
directory scan. Read the full installation contract only for a specific
warning/failure; do not ask whether to generate a read-only plan. Repair an
existing selected service instead of replacing it.
Treat plan_ready as internal progress. Reuse existing explicit installation
or setup authorization when it covers the concrete transaction; do not ask
again to inspect, plan, resume a bounded download, or continue after a user
action. If authorization is missing, ask one short confirmation after the
plan is ready. Keep the full plan, paths and hashes in tool evidence unless
needed to resolve a discrepancy or requested by the user.
On both platforms, run bounded download calls with the same valid plan
until downloaded, then execute. download_pending means continue, not
stop after reporting progress. Honor download_waiting retry intervals.
Pause for actual OS, installer, agreement, OAuth or client-trust prompts;
after the user acts, verify completion and continue automatically. Ask again
only for uncovered material changes or genuinely missing authorization.
Follow the setup guide's expiry and failure rules; never alter signed plans,
bypass consent or repeatedly execute an installer with an unknown outcome.
Begin research, source transfer, or deliverable generation only after a real host capability call, required runtime readiness, and the task's destination and write authorization pass. A healthy endpoint, saved URL, installed app, or remembered KB is insufficient.
After installed, continue the quickstart's Connect after installation
steps. Verify service health in a separate tool call after launch returns,
then configure and load the connector through supported host controls yourself.
Keep routine configuration work with the Agent when those controls are available;
request user action only for a real presence prompt or a proven missing host
capability. For supported initial-consent or owner-consent, use native OAuth
without management-password setup. The user completes Trust/OAuth; allow
automatic return before using a manual fallback. Do not start Connect again
while the original callback is pending. A browser success page alone is not readiness. Read only the
relevant onboarding or runtime-preparation section of the full
setup guide when those details are needed.
Do not offer or recommend a "PDF fast path", "skip JishuDB", "local files first", or "archive later" choice, including through a question tool. JishuDB is a prerequisite of this Skill, not optional storage for its deliverables. A preference for speed or a particular output format does not waive it.
When installation approval is missing, ask whether to execute the concrete plan just produced; proceeding or postponing setup are valid choices. Do not replace that approval with an "install DB or produce local files?" menu. Do not ask about optional format, depth, variants, or style before readiness. Reuse explicit preferences from the original request; ask later only if a consequential ambiguity actually prevents the task. Necessary material-selection, source-access, transfer, and retention consent remain task-specific requirements; installation approval does not grant them.
Return USER_ACTION_REQUIRED for pending approval, OAuth, or a required client
action that the Agent cannot perform through available supported controls.
Return BLOCKED for unsupported or declined setup, with the observed reason
and next action. If inspection or plan generation fails, report that exact
failure rather than inventing a plan or offering a local-only substitute.
Do not start research, transfer source material, or generate task deliverables
while this prerequisite is unmet. If the user explicitly declines JishuDB and
requests a different workflow, explain that this Skill is blocked; do not label
a separate local-only workflow as successful execution of this Skill.
| Item | Details |
|---|---|
| Use when | A report or topic needs evidence-backed content adapted for several platforms. |
| Delivers | Article, Xiaohongshu post, video script, visual plan, citations, and JishuDB records. |
| Requires | JishuDB write access, authorized research, and local text output. |
| Does not | Publish posts, produce finished videos, or require finished cover images. |
Do not use this skill alone when finished Xiaohongshu covers are required;
use xiaohongshu-content-factory for that part without dropping requested
article or script deliverables. Use
industry-report-sprint for an analytical report, or research-report-hunter
for a reading list. This workflow does not publish posts or produce finished videos.
Read the packaged evidence contract before discovery.
Apply these task defaults after the readiness step. They do not authorize a pre-setup preference questionnaire or bypass the required connection.
kb_read_handbook({})
only for unfamiliar behavior. Continue with the verified connector and
existing consent; do not repeat successful setup or authorization.kb_list({}) and resolve the previously selected or authorized default
KB to a returned ID. Reuse consent covering this task's source and output
retention. If missing, propose one suitable returned destination and obtain
only the missing consent once. If creating a KB is necessary and authorized,
call kb_create({name: approvedName, description: approvedPurpose}), retain
its returned id, and verify it using kb_list({}). Reconcile uncertain
creation by listing before retrying; never guess IDs or create duplicates.Before generation, verify the required connection, write scope, destination,
and output capability. A profile name alone does not prove readiness.
Allocate a filesystem-safe run ID (UTC YYYYMMDDTHHMMSSZ plus a random suffix)
and keep it, record UUIDs, timestamps, and retry keys stable on resume.
report-to-content-factory-<runId> directory in the user's
output directory or approved host workspace. Preserve existing files.
Retain run ID, revision, record UUIDs/timestamps, and source/upload retry keys.kb_search({kbId, query, topK: 5}) and
kb_read_document_text({kbId, documentId}). For complete usage or file
enumeration call kb_list_documents({kbId, limit: 100}) and follow every
nextCursor. Search absence alone cannot prove an angle has never been
used. Reuse verified source IDs while preserving previous content versions.article.md, xiaohongshu-post.md,
or video-script.md), plus citations.md and revision.md. Add
visual-plan.md only for requested visual planning. Use the user's language.
Inspect actual drafts for completeness, original wording, truthful claims,
and citation agreement. Persist final text and usage status as drafted or
delivered, not published. Do not publish or schedule anything automatically.| Record | Required content |
|---|---|
| Reports and evidence | Source cards, permitted inspected material/excerpts, evidence cards, coverage, and retained source document IDs |
| Angles and brief | Approved brand preferences, topic ideas, titles, selected/rejected angles, intended readers, and reasons |
| Draft | Actual first drafts for the requested formats with paragraph/scene IDs |
| Final and citations | Final copy, visual suggestions, claim-to-evidence-to-source mappings, and reader-facing source notes |
| Revision and usage | Run/Skill version, predecessor IDs, actual edits, relative artifact names, archival IDs, and honestly recorded drafted/delivered usage |
These are real ordered host calls with approved values and live schemas, not a new runtime. Split long manuscripts into numbered Notes within write/read limits and retain a manifest so every required part can be read back.
Choose upload routes from mcp.upload.modes. Call kb_get_config({}) for
its upload format and size information, and inspect live write/read schemas.
Do not assume generic extensions or text limits are present in capabilities.
Confirm raw-byte HTTP support before preparing a direct upload; check maxBytes and
expiresAt before sending. Reconcile an expired or uncertain session before
requesting another descriptor. Never log credentials or signed URLs. If Note
readback differs from the approved record, stop and resolve it; do not link
someone else's latest content merely to satisfy the version guard.
For kb_list_jobs reconciliation, use the submitted sourceItemId as
clientItemId for URL imports, or the returned descriptor's clientItemId
for direct uploads.
kb_import_url({kbId, url: readableUrl, async: true, idempotencyKey: sourceKey, clientItemId: sourceItemId}).
Retain job.id and job.documentId; keep source-revision keys stable.
If only metadata or limited excerpts may be retained, save a source Note
with that coverage. Never silently downgrade a failed required import or
imply that an archived public summary is the original full report.kb_prepare_upload({kbId, filename, mime, sizeBytes: exactBytes, sha256: exactSha256, idempotencyKey: uploadKey}).
Send actual bytes with the returned method, uploadUrl, and headers
through an approved host HTTP tool, without unrelated credentials or
unexpected redirects. A committed replay returns an existing job instead
of requiring another upload. Retain uploadId, clientItemId, and raw
response job.id; use kb_get_job({kbId, jobId}) for native documentId,
not HTTP docId. Never save signed URLs or headers in logs/artifacts.
If direct upload cannot be used, supported small UTF-8 text within live
limits may use
kb_upload({kbId, filename, mime, contentBase64: encodedActualTextBytes}).
Retain document.id; this call has no idempotency key. Do not blindly
repeat it or enable server-side path upload. Optional image exports can
remain local; their descriptions and rights belong in the saved text.note_create({noteId: recordUuid, title: recordTitle, content: recordMarkdown, createdAt: recordCreatedAt}).
Retain note.id and note.updatedAt; read note_get({noteId}), compare
actual saved content, and use its current timestamp in
note_link_to_kb({noteId, kbId, expectedUpdatedAt: savedUpdatedAt}).
Retain membership.documentId and membership.jobId. note_create
alone is source-only and NOT searchable.kb_get_job({kbId, jobId}) every 2 seconds, at most 120 seconds per
job and 10 minutes total per run; then return pending work as PARTIAL. queued,
processing, and cancel_requested are pending; require completed.
failed and cancelled require recovery. For synchronous uploads use
returned document IDs rather than invented jobs. Read required material
with kb_get_document({kbId, documentId}) and
kb_read_document_text({kbId, documentId}); check KB, full article/script
text, citations, and current revision. Do not count unseen truncated text
as inspected. For each linked record require
kb_search({kbId, query: recordMarkerAndTopic, topK: 5}) to return the
correct document with the current marker, not an old copy version.note_get({noteId}), then
note_update({noteId, title, content, expectedUpdatedAt: latestUpdatedAt}).
Retain the new timestamp. Linked Notes refresh after their inactivity
debounce; do not relink. Reread memberships, poll the current refresh job,
and verify the new marker. On CONFLICT, inspect and resolve current
content instead of forcing an overwrite.note_get for the allocated UUID,
kb_list_jobs({kbId, clientItemId}) with pagination for URL/direct work,
or paginated kb_list_documents plus identity/hash/content for text uploads.
Replay Note creation only with identical UUID, timestamp, title, and
content; replay URL/preparation only with identical supported keys and
arguments. After repair and reconciliation within the authorized scope use
kb_retry_job({kbId, jobId}) for the existing failed/cancelled job. Do not
rotate identities, repeatedly upload, delete evidence, or poll endlessly.
Retain sanitized errors and non-secret recovery IDs.Return one state with output paths, selected KB ID, saved record IDs, actual source coverage, and any precise outstanding step:
COMPLETE: all requested format drafts and citations exist; include visual
suggestions only when requested. Required records are linked, processed,
and read back. This means content drafts were delivered, not published or promoted.PARTIAL: useful drafts exist but agreed content, critical evidence, or
required persistence is incomplete. Preserve output and identify missing
material or exact Note/document/job IDs, last states, errors, and recovery.
Post-generation archival failure must not be labeled complete.BLOCKED: required setup, write permission, research, or file-output
capability is absent or declined before work can proceed.USER_ACTION_REQUIRED: approval or a setup user-presence gate is pending.FAILED: an attempted operation failed before usable output; give its
actual sanitized cause and recovery prerequisite.Do not promise publishing, engagement, universal PDF availability, mainland connectivity, or end-to-end host execution that has not actually occurred.
xiaohongshu-content-factory.industry-report-sprint.