一键在 Manus 中运行任何 Skill

$pwd:

docs-incremental-update

Name: Docs Incremental Update
Author: camel-ai

// Incrementally update Mintlify documentation (.mdx) from Python source changes only. Use when: (1) Python files referenced in doc_code_map frontmatter have changed, (2) a PR touches Python modules documented in docs/mintlify/key_modules/ or docs/mintlify/mcp/, (3) the user asks to sync docs after Python code changes. Prefer minimal diffs and leave correct content untouched.

在 Manus 中运行

$ git log --oneline --stat

stars:17,082

forks:1,921

updated:2026年3月21日 09:03

文件资源管理器

2 个文件

SKILL.md

readonly

name	docs-incremental-update
description	Incrementally update Mintlify documentation (.mdx) from Python source changes only. Use when: (1) Python files referenced in doc_code_map frontmatter have changed, (2) a PR touches Python modules documented in docs/mintlify/key_modules/ or docs/mintlify/mcp/, (3) the user asks to sync docs after Python code changes. Prefer minimal diffs and leave correct content untouched.

Docs Incremental Update

Update Mintlify .mdx documentation so it stays in sync with CAMEL source code.

Scope

Only use this skill when the driver is Python source changes referenced by a target document's doc_code_map.
Do not use it for docs-only edits, workflow/YAML changes, or broad wording cleanups without Python changes.
Prefer no document change when Python edits are internal and do not affect public API, behavior, configuration, examples, or reader understanding.

Edit Rule

Use terminal tools to inspect the target doc, inspect any relevant code, and edit the target doc directly. Keep changes scoped to that doc and preserve its frontmatter. CI treats the run as successful based on the resulting target doc file state, not on any special status token in the chat response.

Quick Reference

Item	Path
Doc roots	`docs/mintlify/`
Mapping utility	`docs/mintlify/scripts/docs_sync/doc_code_map.py`
Auto-sync script	`.camel/skills/docs-incremental-update/scripts/auto_sync_docs_with_chatagent.py`
Workflow	`.github/workflows/docs_release_auto_sync_pr.yml`

Workflow

Step 1 — Identify Impacted Docs

Determine which .mdx files are affected by the code change.

# From repo root, pass only changed Python files
python docs/mintlify/scripts/docs_sync/doc_code_map.py impacted \
  --changed-file <file1> --changed-file <file2>

# Or using git refs
python docs/mintlify/scripts/docs_sync/doc_code_map.py impacted \
  --base-ref <base> --head-ref <head>

Each .mdx file declares a doc_code_map block in its YAML frontmatter:

---
title: MCP Toolkit
doc_code_map:
  - "camel/toolkits/mcp_toolkit.py"
  - "camel/runtimes/llm_guard_runtime.py"
---

Step 2 — Read Current Doc and Relevant Code

For each impacted doc:

Open the target .mdx file and inspect its doc_code_map frontmatter.
Use the provided changed Python file list as initial context.
Read any source files needed to judge whether the doc is still accurate.
Compare the target doc against the current code and decide whether a reader-facing update is actually needed.

Step 3 — Update the Document Body

Rewrite only the parts of the body that are outdated relative to the code.

Rules:

Edit the target doc directly through terminal tools for this run.
Let file changes speak for themselves — if no update is needed, leave the target doc untouched instead of relying on a sentinel reply.
Use changed Python files as context, not a hard boundary — inspect other relevant code when needed to make a correct documentation decision.
Ignore non-Python changes — docs, workflow, YAML, test-only, and release metadata changes should not trigger doc edits by themselves.
Prefer the smallest possible diff — keep all already-correct content.
Preserve frontmatter — never modify the --- block.
Preserve style — keep existing section structure and tone.
Preserve Mintlify components — keep Card, Accordion, Tab, CodeGroup, etc.
Update code snippets — fix imports, class names, method signatures, parameters.
Update prose — fix descriptions that no longer match the code.
Remove references to deleted classes/methods/parameters.
Add references to newly introduced public API when relevant.
Skip the document entirely if the Python change is internal and does not require reader-facing doc updates.
After finishing, either leave the file unchanged or update it in place.
Do not return the full rewritten document body in chat; a short status note is enough.

Step 4 — Verify

# Ensure all patterns still resolve
python docs/mintlify/scripts/docs_sync/doc_code_map.py verify

Check that no frontmatter was accidentally removed or duplicated.

Mintlify Component Cheatsheet

Use these components in .mdx files:

<Card title="Title" icon="icon-name" href="/path">
  Description text.
</Card>

<Accordion title="Click to expand">
  Hidden content revealed on click.
</Accordion>

<Tabs>
  <Tab title="Python">
    Python content here.
  </Tab>
  <Tab title="TypeScript">
    TypeScript content here.
  </Tab>
</Tabs>

<CodeGroup>
```python title="example.py"
print("hello")
```
```bash title="shell"
echo hello
```
</CodeGroup>

<Note>Important information the reader should know.</Note>
<Warning>Critical warning about potential issues.</Warning>
<Tip>Helpful suggestion or best practice.</Tip>

Automated Workflow

The GitHub Actions workflow docs_release_auto_sync_pr.yml runs automatically on each release:

Verifies doc_code_map patterns (doc_code_map.py verify).
Writes changed_python_files.txt from the release diff for all changed *.py files that may match doc_code_map.
Computes impacted_docs.txt from that changed Python file list.
Runs auto_sync_docs_with_chatagent.py with both files so the agent knows which target doc it may inspect and update directly through terminal tools, while using changed_python_files.txt as context. The script accepts success based on whether the target doc actually changed and rejects edits outside the target doc.
Opens a PR with the changes.

related-skills.json

同仓库

skill-creator.md

from "camel-ai/camel"

Guide for creating effective skills. Use when creating a new skill or updating an existing skill that extends agent capabilities with specialized knowledge, workflows, or tool integrations.

2026-02-0717.1k

code-reviewer.md

from "camel-ai/camel"

Review code for quality, bugs, and improvements. Use when user wants code review or quality assessment.

2026-02-0517.1k

data-analyzer.md

from "camel-ai/camel"

Analyze datasets and extract insights. Use when user needs to understand data patterns, statistics, or trends.

2026-02-0517.1k

report-writer.md

from "camel-ai/camel"

Generate professional reports from analysis results. Use when user needs to create formatted documents summarizing findings.

2026-02-0517.1k

package.json

"author": "camel-ai"

"repository": "camel-ai/camel"

打开 GitHub 仓库查看创作者相关仓库

$ install --global

$ download --local

在 Manus 中运行

$ useful --forSOC

软件开发工程师计算机与数学类职业15-1252L4

name	docs-incremental-update
description	Incrementally update Mintlify documentation (.mdx) from Python source changes only. Use when: (1) Python files referenced in doc_code_map frontmatter have changed, (2) a PR touches Python modules documented in docs/mintlify/key_modules/ or docs/mintlify/mcp/, (3) the user asks to sync docs after Python code changes. Prefer minimal diffs and leave correct content untouched.

Docs Incremental Update

Update Mintlify .mdx documentation so it stays in sync with CAMEL source code.

Scope

Only use this skill when the driver is Python source changes referenced by a target document's doc_code_map.
Do not use it for docs-only edits, workflow/YAML changes, or broad wording cleanups without Python changes.
Prefer no document change when Python edits are internal and do not affect public API, behavior, configuration, examples, or reader understanding.

Edit Rule

Quick Reference

Item	Path
Doc roots	`docs/mintlify/`
Mapping utility	`docs/mintlify/scripts/docs_sync/doc_code_map.py`
Auto-sync script	`.camel/skills/docs-incremental-update/scripts/auto_sync_docs_with_chatagent.py`
Workflow	`.github/workflows/docs_release_auto_sync_pr.yml`

Workflow

Step 1 — Identify Impacted Docs

Determine which .mdx files are affected by the code change.

# From repo root, pass only changed Python files
python docs/mintlify/scripts/docs_sync/doc_code_map.py impacted \
  --changed-file <file1> --changed-file <file2>

# Or using git refs
python docs/mintlify/scripts/docs_sync/doc_code_map.py impacted \
  --base-ref <base> --head-ref <head>

Each .mdx file declares a doc_code_map block in its YAML frontmatter:

---
title: MCP Toolkit
doc_code_map:
  - "camel/toolkits/mcp_toolkit.py"
  - "camel/runtimes/llm_guard_runtime.py"
---

Step 2 — Read Current Doc and Relevant Code

For each impacted doc:

Open the target .mdx file and inspect its doc_code_map frontmatter.
Use the provided changed Python file list as initial context.
Read any source files needed to judge whether the doc is still accurate.
Compare the target doc against the current code and decide whether a reader-facing update is actually needed.

Step 3 — Update the Document Body

Rewrite only the parts of the body that are outdated relative to the code.

Rules:

Edit the target doc directly through terminal tools for this run.
Let file changes speak for themselves — if no update is needed, leave the target doc untouched instead of relying on a sentinel reply.
Use changed Python files as context, not a hard boundary — inspect other relevant code when needed to make a correct documentation decision.
Ignore non-Python changes — docs, workflow, YAML, test-only, and release metadata changes should not trigger doc edits by themselves.
Prefer the smallest possible diff — keep all already-correct content.
Preserve frontmatter — never modify the --- block.
Preserve style — keep existing section structure and tone.
Preserve Mintlify components — keep Card, Accordion, Tab, CodeGroup, etc.
Update code snippets — fix imports, class names, method signatures, parameters.
Update prose — fix descriptions that no longer match the code.
Remove references to deleted classes/methods/parameters.
Add references to newly introduced public API when relevant.
Skip the document entirely if the Python change is internal and does not require reader-facing doc updates.
After finishing, either leave the file unchanged or update it in place.
Do not return the full rewritten document body in chat; a short status note is enough.

Step 4 — Verify

# Ensure all patterns still resolve
python docs/mintlify/scripts/docs_sync/doc_code_map.py verify

Check that no frontmatter was accidentally removed or duplicated.

Mintlify Component Cheatsheet

Use these components in .mdx files:

<Card title="Title" icon="icon-name" href="/path">
  Description text.
</Card>

<Accordion title="Click to expand">
  Hidden content revealed on click.
</Accordion>

<Tabs>
  <Tab title="Python">
    Python content here.
  </Tab>
  <Tab title="TypeScript">
    TypeScript content here.
  </Tab>
</Tabs>

<CodeGroup>
```python title="example.py"
print("hello")
```
```bash title="shell"
echo hello
```
</CodeGroup>

<Note>Important information the reader should know.</Note>
<Warning>Critical warning about potential issues.</Warning>
<Tip>Helpful suggestion or best practice.</Tip>

Automated Workflow

The GitHub Actions workflow docs_release_auto_sync_pr.yml runs automatically on each release:

Verifies doc_code_map patterns (doc_code_map.py verify).
Writes changed_python_files.txt from the release diff for all changed *.py files that may match doc_code_map.
Computes impacted_docs.txt from that changed Python file list.
Runs auto_sync_docs_with_chatagent.py with both files so the agent knows which target doc it may inspect and update directly through terminal tools, while using changed_python_files.txt as context. The script accepts success based on whether the target doc actually changed and rejects edits outside the target doc.
Opens a PR with the changes.

docs-incremental-update

Docs Incremental Update

Scope

Edit Rule

Quick Reference

Workflow

Step 1 — Identify Impacted Docs

Step 2 — Read Current Doc and Relevant Code

Step 3 — Update the Document Body

Step 4 — Verify

Mintlify Component Cheatsheet

Automated Workflow

同仓库更多 Skills

同仓库更多 Skills

Docs Incremental Update

Scope

Edit Rule

Quick Reference

Workflow

Step 1 — Identify Impacted Docs

Step 2 — Read Current Doc and Relevant Code

Step 3 — Update the Document Body

Step 4 — Verify

Mintlify Component Cheatsheet

Automated Workflow