Skip to content

docs: document reviewed Experience and Skill workflows - #1334

Open
chenncy wants to merge 4 commits into
oceanbase:masterfrom
chenncy:codex/candidate-review-guide
Open

docs: document reviewed Experience and Skill workflows#1334
chenncy wants to merge 4 commits into
oceanbase:masterfrom
chenncy:codex/candidate-review-guide

Conversation

@chenncy

@chenncy chenncy commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Part of #1226

Summary

  • Add synchronized English and Chinese Candidate Review how-to guides.
  • Explain the Experience and managed Skill lifecycle and review boundary.
  • Document Experience generation, review, replacement, and scheduled incubation.
  • Document managed Skill generation, review, exact reads, evolution, and Codex export.
  • Move procedural guidance out of interface and configuration reference pages.
  • Update English and Chinese documentation navigation.

Validation

  • .\.venv\Scripts\zensical.exe build -s
  • git diff --check
  • Verified commands and behavior against the CLI, OpenAPI, Python Client, Runtime, MCP, and tests.

AI usage

Used the documentation-writer and humanizer skills to draft and edit the documentation. The author manually reviewed the final content.

Copilot AI lite review requested due to automatic review settings August 24, 2026 10:25

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds new, synchronized English and Chinese documentation that explains and operationalizes the Candidate review workflow plus the Experience / managed Skill lifecycle, while trimming procedure-heavy content from the reference pages and updating site navigation accordingly.

Changes:

  • Add new how-to guides for reviewing Candidates, creating/reviewing Experiences, and creating/exporting managed Skills (EN + ZH).
  • Add new explanation pages describing the Experience/Skill evidence → Candidate → Revision lifecycle (EN + ZH).
  • Update nav + index pages, and refactor reference docs to link to the new how-to pages.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
zensical.toml Adds the new EN/ZH pages to the documentation navigation.
docs/en/docs/index.md Adds new “Experience/Skill lifecycle” and workflow entry points to the EN docs landing page.
docs/zh/docs/index.md Adds new “Experience/Skill lifecycle” and workflow entry points to the ZH docs landing page.
docs/en/docs/reference/interfaces.md Moves Candidate procedure out; links to the new how-to and lifecycle explanation.
docs/zh/docs/reference/interfaces.md Moves Candidate procedure out; links to the new how-to and lifecycle explanation.
docs/en/docs/reference/configuration.md Refactors incubation guidance to point to the new how-to.
docs/zh/docs/reference/configuration.md Refactors incubation guidance to point to the new how-to.
docs/en/docs/how-to/review-candidates.md New EN how-to: list/inspect/revise/approve/reject Candidates and verify outcomes.
docs/zh/docs/how-to/review-candidates.md New ZH how-to: list/inspect/revise/approve/reject Candidates and verify outcomes.
docs/en/docs/how-to/create-and-review-experience.md New EN how-to: generate Experience Candidates, review, verify, replace, and schedule incubation.
docs/zh/docs/how-to/create-and-review-experience.md New ZH how-to: generate Experience Candidates, review, verify, replace, and schedule incubation.
docs/en/docs/how-to/create-and-export-skill.md New EN how-to: generate/review Skill Candidates, exact reads, export to Codex, and evolve via usage.
docs/zh/docs/how-to/create-and-export-skill.md New ZH how-to: generate/review Skill Candidates, exact reads, export to Codex, and evolve via usage.
docs/en/docs/explanation/experience-and-skill-lifecycle.md New EN explanation: evidence/Candidate/versioning/Revision lifecycle and boundaries.
docs/zh/docs/explanation/experience-and-skill-lifecycle.md New ZH explanation: evidence/Candidate/versioning/Revision lifecycle and boundaries.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/en/docs/reference/interfaces.md Outdated
Comment on lines +114 to +115
The `candidate` command group exposes the human Review Inbox. See [Review Candidates](../how-to/review-candidates.md)
for the ordered list, inspect, revise, approve, and reject workflow.
Comment thread docs/en/docs/reference/configuration.md Outdated
Comment on lines +108 to +113
Experience incubation is a separate APScheduler job with its own persisted Source cursor. It requires both the
Experience interval and generation model settings. Each activation inspects at most 32 Sources and exposes only
Content Sources whose metadata contains `"kind": "task-outcome"`. The Memory and Experience jobs share the scheduler
sidecar under `POWERCONTEXT_HOME`, but keep independent job identities and business cursors. Unsetting one interval
removes only that job. See [Create and review an Experience](../how-to/create-and-review-experience.md) for setup and
verification steps.
Comment thread docs/zh/docs/reference/configuration.md Outdated
chenncy and others added 2 commits August 24, 2026 18:29
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Comment thread docs/en/docs/how-to/create-and-export-skill.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants