jiangxinke/harness-rl/deerflow-maintainer-orchestrator
Claude Code and agent skill by jiangxinke/harness-rl
- community
Checking that the SKILL.md file is still in the repository.
Use when a DeerFlow maintainer needs comment-only GitHub issue or PR handling: resolve issue/PR scopes with gh, analyze issues, post or draft issue comments, perform PR review comments, review PR or issue batches, compare competing PRs that target the same issue, give fix strategy, risk classification, and validation guidance. Intended for maintainers and trusted local agents, not general contributors.
Install
npx vskill@latest install jiangxinke/harness-rl/deerflow-maintainer-orchestratorSKILL.md
The same SKILL.md was published earlier as jiangxinke/harness-rl/deerflow-maintainer-orchestrator.
DeerFlow Maintainer Orchestrator
Core Rule
This is a comment-plane skill: resolve GitHub scope, inspect evidence, and prepare or post DeerFlow issue comments and PR review comments. Keep the work comment-scoped; do not turn it into coding, branch management, release work, artifact closure, or other maintainer operations.
When the maintainer asks to process, handle, comment on, or review a bounded set of issues or PRs, proceed without asking follow-up questions. Treat that request as authorization for one public issue comment per selected non-skipped issue and one PR review comment per selected PR with high-confidence findings. If a PR has no high-confidence findings, do not post a public comment; report that result to the maintainer only. If the maintainer explicitly asks for analysis only, return comment-ready drafts without posting.
The maintainer's normal interaction should be: provide scope; receive posted comment URLs, PR review URLs, clean results, skipped items, failures, or drafts. Do not offload technical analysis to the maintainer. Make the best evidence-backed recommendation in the comment itself: describe the risk, impact, likely fix, and validation path. Ask the reporter or PR author for missing evidence only when the artifact lacks enough data to diagnose.
Output only the maintainer run result or comment draft. Do not announce the skill name, mode, or that no code was edited unless the user asks for process details.
Match the dominant language of the issue or PR unless the maintainer asks for another language. Chinese issue or PR text gets Chinese output; English issue or PR text gets English output. For mixed artifacts, use the body language, not logs or code.
Artifact Resolution
Use GitHub tooling to resolve artifact type and scope. Do not ask the maintainer to clarify when gh or GitHub API can determine the answer.
- Default repository is
bytedance/deer-flowunless a URL or explicit repo says otherwise. - For URLs, route
/issues/<number>to Issue Flow and/pull/<number>to PR Review Flow. - For typed numbers, use the typed command:
- Issue:
gh issue view <number> --repo <repo> --json number,title,url,state,body,labels,author,comments - PR:
gh pr view <number> --repo <repo> --json number,title,url,state,body,author,files,comments,reviews,statusCheckRollup,baseRefName,headRefName
- Normalize multiple explicit references such as
#123,# 123, and bare123into a number list, preserving order and de-duplicating exact repeats. - For untyped numbers, try
gh pr view <number> --repo <repo> --json number,urlfirst. If it fails, usegh issue view <number> --repo <repo> --json number,url. Do not ask which type it is. - For issue batches, use
gh issue list, not the mixed GitHub issues endpoint. For PR batches, usegh pr list. - Respect maintainer-provided count or time window. There is no hard five-item cap. If the scope is broad and underspecified, choose a practical recent slice, state the slice used, prioritize newest and highest-risk items, and report any unprocessed remainder.
- For "recent/latest" wording without a count, use a small default recent slice. For "recent hours" wording without a number, use six hours. Do not ask.
- Use
gh apiwhengh issue/pr view/listlacks required fields such as timeline events, review threads, or precise search filters. - Use GitHub search only as a fallback for natural-language filters that cannot be represented by view/list/API calls. Do not use web search for artifact routing unless GitHub tooling is unavailable.
- When an issue has more than one candidate resolving PR, gather them all before reviewing: the issue's linked/Development PRs, closing keywords (
Closes/Fixes #<issue>) found viagh apitimeline cross-reference events, and PRs that mention the issue. Route them into Competing PR Comparison. - If no artifact type, number, URL, count, time window, or searchable GitHub scope can be resolved, stop with a compact "scope unresolved" report. Do not ask a follow-up question.
Use concise repo-local references such as #123 and PR #123 in maintainer reports and comments. Include full GitHub URLs only for posted comment/review links returned by GitHub or when the maintainer supplied an explicit URL.
Existing Coverage and Re-Runs
Existing comments suppress duplicate posting, not analysis. Always analyze the artifact in full, then post only the net-new delta over what is already covered.
- Read existing maintainer/trusted-agent comments and reviews as prior coverage.
- Analyze the artifact fully regardless of what already exists. A prior comment may be partial — catching A while missing B.
- Keep only net-new, high-confidence items not already materially covered.
- Non-empty delta: post one comment that explicitly builds on the prior coverage (for example
Adding to @reviewer's review:) and states only the new items. Do not restate covered points. - Empty delta: post nothing public; report
Already coveredto the maintainer with the existing comment/review URL. - Idempotency: treat your own earlier skill-authored comments as already-covered. On a re-run, never stack a second comment that repeats an earlier one — post only genuinely new delta, or nothing.
RFC issues are the one hard skip: no analysis and no post unless the maintainer overrides.
Issue Flow
Use Issue Flow for GitHub issues, bug reports, feature requests, support questions, and issue batches.
Start every issue with a cheap precheck:
- Fetch issue metadata, labels, author, body, and existing comments.
- If labels, title, or body mark the issue as RFC (
rfc,[RFC],RFC:, orRequest for Comments), classify it asrfc-no-comment, skip deep analysis, and do not post anything public unless the maintainer explicitly overrides the RFC skip for that item. - Existing maintainer or trusted-agent comments are prior coverage, not an automatic skip. Analyze fully and post only the net-new delta (see Existing Coverage and Re-Runs).
- Treat ordinary reporter replies, thanks, unrelated discussion, or incomplete guesses as non-blocking.
- Report already-covered or skipped issues to the maintainer only as compact identifiers plus the reason or existing comment URL when available.
For non-skipped issues:
- Read enough context to avoid guessing: issue body, comments, screenshots, logs, reproduction details, linked artifacts, and relevant DeerFlow code/docs.
- Classify the surface:
- Frontend UI
- Backend API
- Agents / LangGraph
- Sandbox
- Skills
- MCP
- Dependencies
- Default behavior
- Docs / tests / CI only
- Classify actionability:
ready-to-fix: bounded, evidence sufficient, validation path clear.needs-more-evidence: repro, logs, environment, screenshots, exact expected behavior, or failing case missing.defer-or-close: duplicate, stale, unsupported, unactionable, or out of scope.rfc-no-comment: RFC issue; skip public comments by default.
- Produce a public-safe comment from the analysis, not the analysis labels:
- Start with one natural opener that connects to the issue context. Prefer
Thanks @author.for reporter-authored issues when it reads naturally; omit the mention for bots, maintainer-authored tracking issues, or cases where it would add noise. - The opener must say something specific about the next step or boundary, not a generic assessment. Do not use generic phrases such as "This is actionable", "I would treat this as", "ready to fix", or surface/actionability/risk labels.
- Use the smallest stable template that fits:
- Add
Evidence:only when citing concrete code, logs, reproduction details, or other proof helps the author act. - Add
Risk:only when architecture, security, public API, default behavior, or compatibility impact must be called out explicitly; make the risk specific. - Add
Missing info:only when the issue cannot be diagnosed without more evidence; ask for the smallest useful data. - Put relevant files/components inside
Evidence:orRecommended solution:bullets instead of separate metadata fields. - Every posted issue comment should contain concrete modification guidance and validation guidance unless the only useful response is
Missing info:.
- Immediately before posting, refresh comments; fold any equivalent comment that appeared during analysis into prior coverage and post only the remaining delta.
- Post one issue comment when posting is authorized; otherwise return the same text as
Reply draft.
Do not expose private reasoning, credentials, internal-only context, or unsupported promises. Do not say a fix was made unless a separate coding workflow actually changed code.
PR Review Flow
Use PR Review Flow for GitHub pull requests and PR batches.
Start every PR with a cheap precheck:
- Fetch PR metadata, changed file list, checks summary, existing PR reviews, existing PR comments, and review threads when available.
- Existing maintainer or trusted-agent reviews are prior coverage, not an automatic skip. Review fully and post only the net-new delta (see Existing Coverage and Re-Runs).
- Read
statusCheckRollupas signal, not verdict. Failing required checks are themselves a reportable finding (build failure = P0; failing tests or lint = P1/P2 by impact). Green checks lower risk but never excuse reading the actual changed code path — confirm suspect logic by reading the source, not by trusting green CI. Tests passing does not prove the changed branch is exercised. - Treat author replies, thanks, unrelated discussion, or incomplete guesses as non-blocking.
- Report already-covered or clean PRs to the maintainer only, with the existing review/comment URL when available.
Diff Base Rule
Before reviewing a local PR branch or local diff, fetch the base repository's target branch and compare against that fresh remote-tracking ref, not a possibly stale local main.
- For fork checkouts, prefer
upstream/<base-branch>whenupstreampoints to the base repository. - For direct upstream checkouts, use the base remote's fetched branch, usually
origin/<base-branch>. - Prefer GitHub PR base metadata for the target branch. For non-PR local diffs, use the base repository default branch. If metadata is unavailable, default to
mainonly after fetching the base remote. - Refresh the comparison ref explicitly, for example
git fetch <base-remote> +refs/heads/<base-branch>:refs/remotes/<base-remote>/<base-branch>, then inspectBASE=$(git merge-base HEAD <base-remote>/<base-branch>)andgit diff "$BASE"...HEAD. - If using
FETCH_HEADfrom a single-branch fetch instead, diff against that verifiedFETCH_HEADimmediately and do not later substitute a possibly stale remote-tracking ref. - Resolve the PR head explicitly. For fork PRs whose head branch is not on the base repo, fetch the PR ref:
git fetch <base-remote> pull/<n>/head:pr-<n>. The fork's own branch ref andgh api .../contents?ref=<fork-branch>will 404 against the base repo. Record the head SHA you reviewed. - Re-check the head SHA immediately before posting. If the PR head moved during analysis, re-review the new diff or abort — never post a review against a diff the PR no longer has.
- For uncommitted local changes, review committed branch changes against the fresh base first, then include working-tree changes separately.
- If the base remote or base branch cannot be established, use the GitHub PR files/diff as the source of truth. If neither local nor GitHub diff can be read, return a compact failure report and do not post a review.
Before posting a PR review comment:
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingStackPlanner2.0/.agent/skills/deerflow-maintainer-orchestrator/SKILL.md
Popularity
- Repository stars
- 442
- Repository forks
- 53
- 7-day trend score
- 30
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/jiangxinke/harness-rl/deerflow-maintainer-orchestrator)