AGENT SKILL

documentation-maintainer

Create and update README files, ADRs, setup guides, API docs, runbooks, and operational documentation.

License 许可
MIT
所属仓库
domehahn/skcr
最近更新
2026-09-11
Stars
★ 0
Forks
0

01 前言 Front Matter

name
documentation-maintainer
since
2026-06-10
authors
[ "platform-engineering" ]
version
1.1.0
replaces
null
changelog
[ { "date": "2026-06-10", "change": "Added production-ready skill-specific operating model, checklist, decision rules, acceptance criteria, and output requirements", "version": "1.1.0" }, { "date": "2025-01-01", "change": "Initial release", "version": "1.0.0" } ]
stability
stable
supersedes
[]
description
Create and update README files, ADRs, setup guides, API docs, runbooks, and operational documentation.
last_modified
2026-06-10
deprecated_since
null
min_platform_version
{ "kiro": "unknown", "codex": "unknown", "junie": "unknown", "cursor": "unknown", "ollama": "unknown", "opencode": "unknown", "roo-code": "unknown", "windsurf": "unknown", "openhands": "unknown", "gemini-cli": "unknown", "gitlab-duo": "unknown", "claude-code": "unknown", "github-copilot": "unknown" }

02 资源文件 6

03 SKILL.md 正文

Documentation Maintainer

Purpose

Create and update README files, ADRs, setup guides, API docs, runbooks, and operational documentation.

When to use

Use this skill when the task matches the description above or when the central agent instructions route work to $documentation-maintainer.

Operating model

  1. Clarify the goal and constraints.
  2. Inspect the minimum relevant repository context.
  3. Produce a concise execution plan for non-trivial work.
  4. Execute with tools when implementation is requested.
  5. Validate the result with repository-native checks.
  6. Summarize changed files, validation results, and residual risks.

DevSecOps guardrails

  • Do not read secrets, .env files, private keys, production credentials, masked CI/CD variables, database dumps, or sensitive logs unless explicitly required.
  • Do not push, deploy, publish, merge, or create releases unless explicitly asked.
  • Prefer merge requests, reviewable diffs, and auditable validation evidence.
  • Prefer least privilege, minimal changes, and explicit rollback notes.
  • Do not fabricate test results, repository state, commands, or security findings.

Skill-Specific Operating Model

  • Identify the audience first: contributor, operator, reviewer, integrator, maintainer, or end user.
  • Verify documentation against current repository behavior, commands, config, generated files, and governance rules.
  • Prefer task-oriented docs with prerequisites, commands, expected outcomes, validation, and troubleshooting.

Skill-Specific Checklist

  • Purpose, repository structure, source-of-truth rules, and manual-edit boundaries are clear.
  • Commands are current, copyable, and include required flags or paths.
  • Security-sensitive instructions avoid exposing secrets or encouraging unsafe shortcuts.

Decision Rules

  • Do not document behavior as supported unless code, config, or tests show it.
  • When desired source-of-truth differs from actual CLI behavior, document the actual behavior and the migration gap.
  • Replace generic marketing language with concrete workflow guidance.

Acceptance Criteria

  • A reader can complete the documented workflow without hidden context.
  • Canonical files, generated copies, and synchronized outputs are identified.
  • Unknown platform or environment requirements are marked explicitly.

Output Requirements

  • Summarize documentation files changed and why.
  • Call out verified commands or repository evidence.
  • List remaining documentation gaps separately from completed updates.

Changelog

1.1.0 - 2026-06-10

  • Added production-ready skill-specific operating model, checklist, decision rules, acceptance criteria, and output requirements.

1.0.0 - 2025-01-01

  • Initial release.

04 同仓库更多 Skills