⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

项目文档维护者 - 自动化README与ROADMAP文档维护工具 | 开发效率提升

project-docs-maintainer by gaelic-ghost/productivity-skills

65 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/gaelic-ghost/productivity-skills --skill project-docs-maintainer

项目管理自动化技术文档

🇨🇳中文介绍

项目文档维护者

使用一个规范的技能入口点进行文档维护，然后选择匹配的模式。

输入

mode=skills_readme_maintenance
- 必需: --workspace <路径>
- 可选: --repo-glob <glob>，可重复的 --exclude <路径>，--apply-fixes
mode=roadmap_maintenance
- 必需: --project-root <路径>，--run-mode <check-only|apply>

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

`skills_readme_maintenance`

脚本: scripts/skills_readme_maintenance.py
范围: *-skills 仓库的 README.md 维护
参考:
- references/output-contract.md
- references/section-schema.md
- references/discoverability-rules.md
- references/profile-model.md

`roadmap_maintenance`

脚本: scripts/roadmap_alignment_maintainer.py
范围: 清单式 ROADMAP.md 的验证、迁移和限定规范化
参考:
- references/roadmap-customization.md
- references/roadmap-config-schema.md

skills_readme_maintenance
- 返回 Markdown 加上包含以下内容的 JSON:
  - run_context
  - repos_scanned
  - profile_assignments
  - schema_violations
  - command_integrity_issues
  - fixes_applied
  - post_fix_status
  - errors
- 如果没有问题且没有错误，则精确输出 No findings.
roadmap_maintenance
- 返回 Markdown 加上包含以下内容的 JSON:
  - run_context
  - findings
  - apply_actions
  - errors
- 如果没有发现、没有应用操作且没有错误，则精确输出 No findings.

切勿自动提交、自动推送或打开 PR。
切勿编辑源代码、清单文件、锁文件或 CI 文件。
在 skills_readme_maintenance 中，将编辑范围限定在 README.md 和明确批准插入到 AGENTS.md 的代码片段。
在 roadmap_maintenance 中，apply 模式只能编辑目标 ROADMAP.md。
将已弃用的别名排除在主路径之外，仅在处理遗留提示时提及它们。

references/output-contract.md
references/skills-readme-maintenance-automation-prompts.md
references/roadmap-automation-prompts.md
references/profile-model.md
references/section-schema.md
references/discoverability-rules.md
references/fix-policies.md
references/roadmap-customization.md
references/roadmap-config-schema.md

🇺🇸English

Project Docs Maintainer

Use one canonical skill entrypoint for documentation maintenance, then choose the matching mode.

Inputs

mode=skills_readme_maintenance
- Required: --workspace <path>
- Optional: --repo-glob <glob>, repeatable --exclude <path>, --apply-fixes
mode=roadmap_maintenance
- Required: --project-root <path>, --run-mode <check-only|apply>
- Optional: --roadmap-path <path>
Use canonical mode names in all new prompts.
Treat skills_readme_alignment as compatibility-only.

Workflow

Pick the canonical mode from the user request.
Run the read-only variant first:
- skills_readme_maintenance: audit first
- roadmap_maintenance: --run-mode check-only first
Review findings and keep the fix scope bounded to the selected mode.
If the user requested edits, run the corresponding bounded write path:
- skills_readme_maintenance: --apply-fixes
- roadmap_maintenance: --run-mode apply
Re-run the same mode to confirm remaining issues.
Return the mode-specific Markdown and JSON report shape.

`skills_readme_maintenance`

Script: scripts/skills_readme_maintenance.py
Scope: README.md maintenance for *-skills repositories
References:
- references/output-contract.md
- references/section-schema.md
- references/discoverability-rules.md
- references/profile-model.md

`roadmap_maintenance`

Script: scripts/roadmap_alignment_maintainer.py
Scope: checklist-style ROADMAP.md validation, migration, and bounded normalization
References:
- references/roadmap-customization.md
- references/roadmap-config-schema.md

Output Contract

skills_readme_maintenance
- Return Markdown plus JSON with:
  - run_context
  - repos_scanned
  - profile_assignments
  - schema_violations
  - command_integrity_issues
  - fixes_applied
  - post_fix_status
  - errors

Guardrails

Never auto-commit, auto-push, or open a PR.
Never edit source code, manifests, lockfiles, or CI files.
In skills_readme_maintenance, keep edits bounded to README.md and explicitly approved snippet insertions into AGENTS.md.
In roadmap_maintenance, apply mode may edit only the target ROADMAP.md.
Keep deprecated aliases out of the main path and mention them only when handling legacy prompts.

References

references/output-contract.md
references/skills-readme-maintenance-automation-prompts.md
references/roadmap-automation-prompts.md
references/profile-model.md
references/section-schema.md
references/discoverability-rules.md
references/fix-policies.md
references/roadmap-customization.md
references/roadmap-config-schema.md

Weekly Installs

Repository

gaelic-ghost/pr…y-skills

GitHub Stars

First Seen

Mar 6, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

kimi-cli65

gemini-cli65

github-copilot65

cursor65

opencode65

amp65

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

48,700 周安装

If there are no issues and no errors, output exactly No findings.

roadmap_maintenance

Return Markdown plus JSON with:
- run_context
- findings
- apply_actions
- errors
If there are no findings, no apply actions, and no errors, output exactly No findings.

项目文档维护者 - 自动化README与ROADMAP文档维护工具 | 开发效率提升

🇨🇳中文介绍

项目文档维护者

输入

相关 Skills

工作流程

`skills_readme_maintenance`

`roadmap_maintenance`

输出契约

防护措施

参考

🇺🇸English

Project Docs Maintainer

Inputs

Workflow

`skills_readme_maintenance`

`roadmap_maintenance`

Output Contract

Guardrails

References

最新 Skills