humanize-writing
xgent-ai/skills · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por xgent-ai/skills no skills.sh. Instale com: npx skills add xgent-ai/skills@humanize-writing
Details
- Kind
- Agent skills
- Publisher
- xgent-ai
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 1
- Last push
- 2026-10-06T23:22:37Z
- Repository state
- ativo
- Language
- HTML
- License
- MIT
- Added
- 2026-10-07 06:33:01
- Updated
- 2026-10-07 06:33:01
- Origin id
xgent-ai/skills/humanize-writing
README
# XGENT Skills
XGENT 的 [Agent Skills](https://skills.sh) 集合,可安装到 Claude Code、Cursor、Codex 等支持 skill 的 Agent 中。
## 安装
列出并选择安装公开的 skills (`xgent-init` 是内部初始化 skill,不在默认列表中):
```bash
npx skills add XGENT-ai/skills
```
只安装指定 skill:
```bash
npx skills add XGENT-ai/skills --skill dev-plan
```
## 项目辅助工具（Claude Code / Codex）
本仓库同时以 [`@xgent-ai/skills`](https://www.npmjs.com/package/@xgent-ai/skills) 发布到 npm,自带 `xgent-skills` 命令,可为任意项目安装 XGENT 的 Claude Code hooks(当前包含 statusline)、在项目 `.claude/settings.json` 中启用对应配置,装上随包 vendor 的 [impeccable](#vendor-的-impeccable),并可选创建通用的 `AGENTS.md`、安装 Codex 或 Claude Code 的 goal 上下文收尾提醒:
```bash
# 在目标项目根目录执行(也可显式传目录:npx @xgent-ai/skills install <dir>)
npx @xgent-ai/skills install
```
选项:
| 选项 | 说明 |
| --- | --- |
| `--no-impeccable` | 跳过 impeccable,仍安装 XGENT 的 hooks 与 settings |
| `--xgent-init` | 直接创建仓根 `AGENTS.md` (已有则跳过),不再询问 |
| `--no-xgent-init` | 跳过创建 `AGENTS.md`,不再询问 |
| `--context-goal-guard` | 显式安装 Codex goal 上下文收尾提醒(默认不安装);需要 Python 3.9+ |
| `--no-context-goal-guard` | 跳过 Codex goal guard(默认行为);已有 guard 保留 |
| `--context-goal-guard-threshold=N` | Codex guard 的触发阈值百分比(1–99 整数,默认 65),同时表示安装;重装不给则沿用已装的值 |
| `--claude-context-goal-guard` | 显式安装 Claude Code goal 上下文收尾提醒(默认不安装) |
| `--no-claude-context-goal-guard` | 跳过 Claude Code goal guard(默认行为);已有 guard 保留 |
| `--claude-context-goal-guard-threshold=N` | Claude Code guard 的触发阈值百分比(1–99 整数,默认 70),同时表示安装;重装不给则沿用已装的值 |
| `--providers=a,b` | 指定 impeccable 装进哪些 harness 目录(如 `--providers=.claude,.cursor`);默认按项目里已有的目录判断,一个都没有时只装 `.claude` |
| `--force` | 强制重装,并允许覆盖非法 JSON 的 hook 配置(先存 `.bak`);不覆盖已有 `AGENTS.md` |
安装是幂等的:hook 文件与 skill 目录按内容比对,只在有变化时覆盖;`settings.json` 按顶层 key 合并,impeccable 的 hook 按标记剔旧再合并,项目自己的 hook 与其他配置都保持不动。
`install` 会询问是否同时创建仓根 `AGENTS.md`,输入 `y` 或 `yes` 确认,回车默认跳过。确认后直接复制 [通用模板](https://github.com/xgent-ai/skills/blob/HEAD/skills/xgent-init/references/external-app-AGENTS.template.md),只创建 `AGENTS.md`,不安装 `xgent-init` skill,不生成 `CLAUDE.md` / `PRODUCT.md` / `DESIGN.md`。已有 `AGENTS.md` 时直接跳过并保留原文,包括使用 `--force` 时。
非交互环境默认跳过,可用 `--xgent-init` 显式创建,或用 `--no-xgent-init` 跳过询问。文件位于仓根,不受 `--providers` 影响。模板没有待填占位,通用编码准则支持不同 coding agent;Portal App 的 onebox 联调与有前端改动时的真实浏览器验收分别按适用条件执行。
`install` 默认不安装 Codex goal 上下文收尾提醒,也不询问;仅在显式传入 `--context-goal-guard` 或 `--context-goal-guard-threshold=N` 时安装。此选项不受 `--providers` 或 `--no-impeccable` 影响。请安装到 Git 仓库根目录;Codex 运行环境需要 git 和 Python 3.9+。显式安装时先检查含 SQLite 标准库的 Python 3.9+,复制脚本到 `.codex/hooks/context-goal-guard.py`,合并 `.codex/hooks.json` 的同步 `PreToolUse` / `Stop` handler（3 秒超时）,运行时从 Git 根目录定位脚本,配置不包含本机项目绝对路径,保留其他 hooks 与配置;重复安装只更新 guard,不重复添加。
安装后会显示用户必须完成的步骤:从目标项目启动 Codex、信任项目 `.codex/` 层,在 `/hooks` 中审阅、信任并启用两个 handler,对**当前 goal** 明确超过阈值(默认 65%)时先保存进度和交接、再暂停的策略。安装输出提供可复制的指令;安装和信任本身不构成暂停授权。恢复 goal 或新开对话后需重新明确策略。当前仅验证 Codex 0.160.0、macOS arm64,完整限制与停用方法见 [启用说明](https://github.com/xgent-ai/skills/blob/HEAD/docs/codex-context-goal-guard.md)。
Codex guard 已接入源码与 npm 打包清单,尚未发布到 npm;发布后可用 `npx @xgent-ai/skills install --context-goal-guard`。当前可从本仓库源码为目标项目安装:
```bash
node bin/xgent-skills.js install /absolute/path/to/project --context-goal-guard
```
`install` 默认不安装 Claude Code goal 上下文收尾提醒,也不询问;仅在显式传入 `--claude-context-goal-guard` 或 `--claude-context-goal-guard-threshold=N` 时安装,不受 `--providers` 或 `--no-impeccable` 影响。显式安装时复制脚本到 `.claude/hooks/context-goal-guard.js`,在个人的 `.claude/settings.local.json` 合并 `PostToolBatch` / `Stop` 两个 handler(5 秒超时),保留其他 hooks 与设置;重复安装只更新 guard。guard 只读当前会话记录:本会话 `/goal` 仍 active 且估算上下文严格超过阈值(默认 70%)时提醒 agent 按既有约定更新进度并交接,回合结束时由 Stop hook 结束回合,Claude Code 原生把 goal 置为 Goal paused,再由你在同一项目目录新开对话或 `/clear` 后重新设置 goal。hook 不写任何文件,也不清除或转移 goal。
安装后需重启会话、信任工作区,并在 `/hooks` 中确认两个 handler 来源为 local settings。当前仅验证 Claude Code 2.1.288 交互式 CLI、macOS arm64 与 Opus 5.5 / Sonnet 5.5 / Haiku 4.5,完整限制、接续与停用方法见 [启用说明](https://github.com/xgent-ai/skills/blob/HEAD/docs/claude-context-goal-guard.md)。从源码安装:`node bin/xgent-skills.js install /absolute/path/to/project --claude-context-goal-guard`。
Portal 的产品和设计规范仍保留在 [PRODUCT 模板](https://github.com/xgent-ai/skills/blob/HEAD/skills/xgent-init/references/external-app-PRODUCT.template.md) 与 [DESIGN 模板](https://github.com/xgent-ai/skills/blob/HEAD/skills/xgent-init/references/external-app-DESIGN.template.md) 中。需要生成项目上下文时,显式安装并在 Agent 对话中使用 [xgent-init](https://github.com/xgent-ai/skills/blob/HEAD/skills/xgent-init/SKILL.md),它读取清单与代码事实,补齐 PRODUCT.md / DESIGN.md (无前端的 service 型不新生成 DESIGN.md),已有文件保留:
```bash
npx skills add XGENT-ai/skills --skill xgent-init
```
## vendor 的 impeccable
[impeccable](https://github.com/pbakaus/impeccable)(Apache-2.0)整个 vendor 在 `vendor/impeccable/` 里:skill bundle 以去重形态随 npm 包发布,十几 MB 的 engine 二进制不进包、改放自家 R2,由 `install` 按 `VERSION.json` 里的地址与 sha256 取。官方的 `npx impeccable install` 要先从 GitHub 下 bundle、首次跑 hook 时再下 engine,墙内经常卡在 `Download failed`;这里 bundle 一步不联网,engine 只走一次 R2(装过一次就落在 `~/.impeccable/` 里,之后都不用了)。
`vendor/impeccable/bundle/` 不是 `universal.zip` 解开的样子,而是它的去重形态:文件内容存在 `blobs/<sha256>`,`manifest.json` 里每个 harness 一张 `路径 → sha` 的清单。上游给 19 个 harness 目录各放了一整套 skill,其中 83% 的字节是同一批文件(光 `scripts/data/font-index.json` 就是 1.1 MB × 19 份、内容完全相同),各 harness 真正不同的只有 43 个路径 —— 有的差在路径 token(`.claude/skills/...` vs `.cursor/skills/...`),有的差在按 harness 改写过的措辞(有 `AskUserQuestion` 工具的 harness 写"调用该工具",没有的写"直接问用户")。`install` 按清单把文件写回去,装出来的结果与直接展开 zip 逐字节一致(上游 `impeccable doctor` 报 no drift)。当前 bundle 展开约 39.4 MiB,去重后约 6.7 MiB。
装出来的东西和上游 `impeccable install` 的工程内安装一致(`impeccable doctor` 报 no drift):
- `<harness>/skills/impeccable/`、`<harness>/agents/`、`<harness>/commands/`:按项目里已有的 harness 目录装,可用 `--providers` 指定;
- hook manifest:Claude Code 写 `.claude/settings.local.json`(共享的 `settings.json` 里已有 impeccable hook 时以它为准),Cursor 写 `.cursor/hooks.json`,Codex 写 `.codex/hooks.json`,Copilot / Grok 写各自的 `hooks/impeccable.json`;
- engine 二进制:只收 Apple Silicon macOS(darwin-arm64),放进 `~/.impeccable/bin/<版本>/`,一台机器一份,所有项目和 `npx impeccable` 共用。缓存里已是对的那份就不再下;从本仓源码跑时直接用 `vendor/impeccable/engine/` 里的,不联网。Intel Mac、其它平台以及 R2 拉不动时都只是跳过这一步,安装照常完成,由 launcher 首次运行时自己下载。
升级 vendor 的版本(维护者执行,需要 curl、unzip 与 aws CLI):
```bash
node scripts/vendor-impeccable.mjs # 抓上游 bundle + engine 到 vendor/
node scripts/publish-vendor-r2.mjs # engine 传 R2,下载地址回写 VERSION.json
```
第一步取上游最新 release,按 ed25519 签名验 bundle、按 `.sha256` 验 engine 二进制,全部通过才落盘,并把版本与校验和写进 `vendor/impeccable/VERSION.json`;bundle 在落盘前按内容去重成 `blobs/` + `manifest.json`。要加别的平台,改脚本里的 `ENGINE_TARGETS`。
第二步把 engine 传到 R2 的 `vendor/impeccable/engine/v<版本>/<平台>/impeccable`,传完回读公共地址核一遍 sha256,再把 url 写进 `VERSION.json` 的 `engines`。凭据读仓库根的 `.env.cf`(`AGENT_RELEASE_R2_*`,已 gitignore,不在库里)。两步的顺序不能反 —— 第一步会重写 `VERSION.json`,先传就把 url 冲掉了;漏了第二步,发出去的包里 engine 没有下载地址,用户那边只会看到"跳过"。
当前收录:skill 4.5.0 / engine 0.1.11(darwin-arm64)。上游许可与三方声明见 `vendor/impeccable/LICENSE` 与 `vendor/impeccable/NOTICE.md`。
## Skills 列表
以下按用途分组列出 `skills/` 中的 skill。点击名称查看使用条件与完整流程。
### 需求、计划与评审
| Skill | 说明 |
| --- | --- |
| [prd](https://github.com/xgent-ai/skills/blob/HEAD/skills/prd/SKILL.md) | 撰写或优化 PRD，明确产品目标、FR/NFR、UAT、分期与终验，可按授权录入 SPMS |
| [crd](https://github.com/xgent-ai/skills/blob/HEAD/skills/crd/SKILL.md) | 以整份 CRD 往返协作：起草需求、文末追加答复、整合对方返回版本并维护 Q&A |
| [dev-plan](https://github.com/xgent-ai/skills/blob/HEAD/skills/dev-plan/SKILL.md) | 基于需求、仓库规则与代码事实撰写或评审可执行、可跨对话续做的开发计划 |
| [test-plan](https://github.com/xgent-ai/skills/blob/HEAD/skills/test-plan/SKILL.md) | 从需求与验收标准生成测试用例，覆盖正常、边界、权限和并发场景，可按授权写入 SPMS |
| [story-points](https://github.com/xgent-ai/skills/blob/HEAD/skills/story-points/SKILL.md) | 按客观因子估算故事点，回写 SPMS 规划点数并复核 Sprint 容量 |
| [review-prd](https://github.com/xgent-ai/skills/blob/HEAD/skills/review-prd/SKILL.md) | 核实代码现状，评审产品价值、体验、AI、SMAR、UAT 与分期终验，默认将完整报告落盘并回读核验 |
| [review-dev-plan](https://github.com/xgent-ai/skills/blob/HEAD/skills/review-dev-plan/SKILL.md) | 评审开发计划的代码事实、技术方案、需求映射、依赖编排与交付可用性，输出评审报告 |
| [review-code](https://github.com/xgent-ai/skills/blob/HEAD/skills/review-code/SKILL.md) | 评审未提交变更、commit 或分支差异，可对照开发计划，输出有证据的代码评审报告 |
| [review-prd-dev-gaps](https://github.com/xgent-ai/skills/blob/HEAD/skills/review-prd-dev-gaps/SKILL.md) | 核对 PRD 与开发交付，将遗漏、合理变更和待拍板差异分流，交互 Triage 后按需调用 dev-plan 生成 gaps plan |
| [apply-code-review](https://github.com/xgent-ai/skills/blob/HEAD/skills/apply-code-review/SKILL.md) | 核实代码评审意见，实施合理修复、验证结果并回写实现记录与必要进度 |
| [apply-doc-review](https://github.com/xgent-ai/skills/blob/HEAD/skills/apply-doc-review/SKILL.md) | 可只传评审报告，沿报告的原文档引用定位并修订 PRD 或开发计划，复核并记录逐条处置结果 |
| [resolve-blocked](https://github.com/xgent-ai/skills/blob/HEAD/skills/resolve-blocked/SKILL.md) | 逐项讲清开发计划中的阻塞事项，先查证、需拍板的交互确认并给推荐，存 decisions 文档并回改计划 |
把上述 skill 串成完整交付流水线（想法 → PRD → 分期 → 每期开发与并行测试 → 交付）的方法见 [AI Native SDLC](https://github.com/xgent-ai/skills/blob/HEAD/docs/ai-native-sdlc.md)，含各环节产物路径约定与测试线待补环节的现状核对。
**手动闭环**：各 SDLC skill 结束时先给明确判定，再给可直接复制的下一条命令（Codex 写作 `$<skill>`，Claude Code 写作 `/<skill>`），由你决定是否执行。`P1`、`P2` 表示期次（Phase）。
1. （可选）`prd` → `review-prd <PRD>`：需要修改时 `apply-doc-review <报告>`；可交接后 `dev-plan <PRD> P1`。临时或小任务可直接从 `dev-plan` 开始。
2. `dev-plan` → `review-dev-plan <计划>`：需要修改时 `apply-doc-review <报告>`；之后 `Blocked` 用 `resolve-blocked <计划>`（可多次，直至 Ready），`Ready` 用 `/goal 按 <计划> 开发`。从 PRD 派生的计划在顶部「需求来源」记录 PRD 与期次。
3. `/goal` 开发：按计划的提交点分阶段提交，全部里程碑完成后最终提交，SHA 记入完成记录，结束时提示 `review-code <计划>`。
4. `review-code <计划>` 从完成记录登记的提交与未提交改动确定范围：需要修改时 `apply-code-review <报告>`（按计划约定提交修复并登记 SHA），再回到 `review-code <计划>` 复审，直到通过验收或你明确本期放过。
5. 通过后，计划来自 PRD 时可选 `review-prd-dev-gaps <计划>`；生成 gaps plan 时从第 2 步的 `review-dev-plan <gaps 计划>` 继续。
在任意阶段通过 `$agi-mode sdlc <问题>` 或自然语言获取 [SDLC 指引](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/playbooks/sdlc.md)：解释 PRD、CRD、计划与测试的分工，判断交接条件，选择下一步。手册随 agi-mode 分发；咨询默认只读，涉及项目现状时复用 what-next 核对证据，实际能力以当前项目和已安装技能为准。
这 11 个 SDLC skill 及 `agi-mode` 均在 `SKILL.md` 的 `argument-hint` 中提供参数提示。`<…>` 表示任务所需输入，可沿已有上下文或文档引用定位；`[…]` 是可选补充，`/` 分隔同一位置的备选，不是要求照抄的参数或新增命令解析器。例如：
```text
$review-prd <PRD路径/链接/内容> [上轮报告] [复审/完整评审] [问题ID/范围] [报告路径] [仅聊天]
$review-code [开发计划] [未提交/commit/A..B/基准分支] [上轮报告] [复审/完整评审] [问题ID/文件范围] [报告路径] [仅聊天]
$apply-doc-review <文档评审报告> [原文路径] [上轮报告/处置记录] [修复/仅复核] [问题ID/范围]
$agi-mode <任务描述> 或 sdlc [流程/阶段/问题] 或 init-sdlc [PRD/计划/范围] 或 what-next [查询/更新] [PRD/计划/范围]
```
提示的展示取决于客户端：[Claude Code](https://code.claude.com/docs/en/skills#frontmatter-reference) 在 `/skill` 补全中支持 `argument-hint`；Codex 的 `$skill` 参数预览仍有[未关闭的功能请求](https://github.com/openai/codex/issues/31014)，不能仅凭新增字段保证弹出提示。未展示时可直接参考上述用法或各技能的 frontmatter。
4 个 `review-*` 支持“对照上轮报告复审修复效果”：逐项保留来源 ID，区分已解决、仍存在、部分解决、回归、待核实、不再适用和本轮未复核；新增问题单列，默认另存报告。代码旧问题的复核不受本次修复 diff 限制。`review-prd-dev-gaps` 会先核对已有 gaps plan，支持“仅报告”，避免重复规划。
2 个 `apply-*` 支持“继续修复”与“仅复核”：前者处理剩余问题，后者保留目标产物并保存必要处置记录；完全只读则仅聊天交付。重复执行先核对已有证据，无实质变化不改文件或时间；apply 的复核不自动成为新一轮独立 review。
项目状态与下一步能力已合并到 `agi-mode` 的 [what-next 流程](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/playbooks/what-next.md)，不再单独发布 `what-next` skill。查询默认只读；初始化/更新才保存，既有执行授权继续有效。
```text
使用 $agi-mode sdlc，解释从需求、CRD 往返到开发、验收和发布的交接。
使用 $agi-mode init-sdlc 初始化项目状态跟进。
使用 $agi-mode what-next 看当前项目状态和下一步。
使用 $agi-mode what-next 更新状态，核对并行计划和最近几轮评审。
```
`init-sdlc` 按需创建状态目录和索引，核实并登记现有材料；可重复运行，沿用已有台账并补齐缺项，不重置历史。兼容原有 `what-next 初始化` 写法。其他 SDLC skill 在台账启用后维护相关状态，首次启用可直接运行上述初始化入口。
[状态目录约定](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/references/workspace-layout.md)使用仓根 `.xgent-ai/sdlc/` **只保存开发状态**。PRD、开发计划、评审报告、实施/验收记录和证据继续按用户习惯存放，台账通过链接引用，不改变其路径或复制正文。
```text
.xgent-ai/
index.md 工作状态总入口
sdlc/
index.md 本层导航与当前重点
protocol.md 状态回写和索引维护协议
state-model.md 固定状态、证据门槛和自愈规则
event-template.md 状态变化模板
status/
index.md 类型入口
<prd|plan|review>/
index.md 对象目录
<对象UUID>.md 各 PRD、计划、评审的状态
events/
index.md 事件类型入口
<类型>/
index.md 对象入口
<对象UUID>/
index.md 事件清单
<事件UUID>.md 单次变化
```
每个实际创建的状态目录都有 `index.md`，非开发任务的 `tasks/` 及任务子目录也一样；不预建空目录。索引只列本层内容，数量增多后可按领域/年份分片。写入者按[索引维护规范](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/assets/sdlc/protocol.md#目录索引维护)同步受影响入口，无变化不重写；多机合并保留双方条目并核对实际文件，查询只报告缺项。索引文件不算事件。
状态按对象拆分、历史按需读取。PRD 与计划保持多对多关系，每轮评审有独立状态 ID，原报告文件名不必改变。UUID 事件保留并发记录，冲突待核对，不用机器时间覆盖。
[固定状态模型](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/assets/sdlc/state-model.md)将文档就绪、计划实施、每轮评审及处置分开：例如 `dev-plan-ready` 表示可开工，`dev-plan-completed` 表示实施范围和规定验证已完成。what-next 会从 `.review.md`、`.codereview.md`、`.code-review.md` 等候选补查漏记评审，并从报告处置节、`.applied.md` 或实施记录核实整改。状态取原文记录（完成记录、登记的提交、报告判定行、处置与决策记录）支持的最强状态，证据质量单独标注：只有自述为 `provisional`，之后相关文件又有改动为 `stale`，依据矛盾为 `conflict`；只有没有可读依据才用 `unknown`。原计划状态滞后时按记录纠正并保留原文自述。查询只读重算，更新才保存修复；旧台账的 v1 状态模型在更新时自动升级到 v2，独立验收线枚举暂为 TBD。
相关撰写、评审、修复技能和计划实施模板仅增加状态回写规则，原产物落盘方式保持原有约定。已有台账可继续使用，不自动迁移或双写。状态协议随仓同步，另一台机器无需安装所有技能也能回写；状态已同步不代表原文和证据已同步。安装 `agi-mode`：`npx skills add XGENT-ai/skills --skill agi-mode`。
### 开发、调试与质量
| Skill | 说明 |
| --- | --- |
| [architect](https://github.com/xgent-ai/skills/blob/HEAD/skills/architect/SKILL.md) | 实现前先设计类型、签名与模块结构，并在开发过程中持续校准 |
| [debugging](https://github.com/xgent-ai/skills/blob/HEAD/skills/debugging/SKILL.md) | 按四阶段流程调查根因、定位问题并验证修复 |
| [create-verification-skill](https://github.com/xgent-ai/skills/blob/HEAD/skills/create-verification-skill/SKILL.md) | 按应用或场景创建、维护 verify-*，复用现有测试并验证真实入口与交接；不依赖编辑器，可供 agi-mode 复用 |
| [react](https://github.com/xgent-ai/skills/blob/HEAD/skills/react/SKILL.md) | 编写和评审 React 组件，处理 Hooks、Effects、渲染性能、数据请求与 React 19 迁移 |
| [rust](https://github.com/xgent-ai/skills/blob/HEAD/skills/rust/SKILL.md) | 编写和评审 Rust 代码，处理所有权、错误、性能、测试及 Tokio 异步模式 |
| [sql-optimization](https://github.com/xgent-ai/skills/blob/HEAD/skills/sql-optimization/SKILL.md) | 分析 SQL 执行计划，优化查询、索引、分页与批量操作 |
| [security-audit](https://github.com/xgent-ai/skills/blob/HEAD/skills/security-audit/SKILL.md) | 沿数据流与组件交互审查注入、认证授权、密钥泄露、依赖及业务逻辑漏洞 |
| [gdpr-compliant](https://github.com/xgent-ai/skills/blob/HEAD/skills/gdpr-compliant/SKILL.md) | 将 GDPR 隐私工程要求应用到个人数据处理、权限、日志、保留与删除流程 |
| [working-with-mbx](https://github.com/xgent-ai/skills/blob/HEAD/skills/working-with-mbx/SKILL.md) | 安装和排查 Cargo 共享编译缓存 mbx，核对命中、绕过与磁盘使用情况 |
| [working-with-mise](https://github.com/xgent-ai/skills/blob/HEAD/skills/working-with-mise/SKILL.md) | 配置和排查 mise 管理的工具、配置文件、PATH 与激活问题 |
### Agent 协作与实验
| Skill | 说明 |
| --- | --- |
| [agi-mode](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/SKILL.md) | 自主推进复杂任务到可验证交付；含 SDLC 阶段指引、项目状态/what-next 与分类状态记录 |
| [arena](https://github.com/xgent-ai/skills/blob/HEAD/skills/arena/SKILL.md) | agi-mode 的多候选比较兼容入口，选择基础版本并重新验证合成结果 |
| [swarm](https://github.com/xgent-ai/skills/blob/HEAD/skills/swarm/SKILL.md) | 为任务选择多 agent 协作机制，设计角色、分工、执行与收尾流程 |
| [autoresearch](https://github.com/xgent-ai/skills/blob/HEAD/skills/autoresearch/SKILL.md) | agi-mode 的 Hillclimb 兼容入口，在固定协议下搜索并确认改进 |
| [reflect](https://github.com/xgent-ai/skills/blob/HEAD/skills/reflect/SKILL.md) | agi-mode 的 Reflection 兼容入口，从会话证据提炼并验证改进假设 |
| [experience-capture](https://github.com/xgent-ai/skills/blob/HEAD/skills/experience-capture/SKILL.md) | 开发中轻量收集踩坑、纠正及自动化线索，供用户随后发起复盘 |
自进化流程集中在 `agi-mode` 内：[Eval](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/playbooks/eval.md) 建立可信判定，[Hillclimb](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/playbooks/hillclimb.md) 管理搜索，[Arena](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/playbooks/arena.md) 提供不同候选，[Reflection](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/playbooks/reflection.md) 提炼教训。协作与记录约定见 [技能演化](https://github.com/xgent-ai/skills/blob/HEAD/skills/agi-mode/references/skill-evolution.md)。
只需安装 `agi-mode` 即可使用上述流程；保留的 `autoresearch`、`arena`、`reflect` 名称是兼容入口，需要同时安装 `agi-mode`。它们不再独立维护执行规则。
`experience-capture` 可独立安装，默认允许自动选择；本仓 `AGENTS.md` 也提供触发约定。它只在开发的自然间隙，把当前上下文已有的线索用 3–4 行保存到 `.xgent-ai/experience/`，不打断主任务，不额外检索取证或回读完整记录；没有合适间隙则跳过，纯咨询和只读任务不落盘。自动选择不等于可靠的后台事件监听；其他项目可在自己的 `AGENTS.md` 中约定出现这些信号时读取已安装的 skill。任务结束后用 `$agi-mode 复盘` 或 `$agi-mode reflect` 深入挖掘、查找和核对证据；默认给出建议，明确授权沉淀时落实到 know-how、playbook、principle 或自动化工具，并回写处置。
整体方法见 [agi-mode 自进化方法论](https://github.com/xgent-ai/skills/blob/HEAD/docs/agi-mode-evolution-methodology.md)，说明样本沉淀、重放、进化实践和能力评估，以及通用方法与业务实践案例的边界。
### 文档、表达与图示
| Skill | 说明 |
| --- | --- |
| [documentation-writer](https://github.com/xgent-ai/skills/blob/HEAD/skills/documentation-writer/SKILL.md) | 基于代码事实编写和更新 README、API、架构、代码库说明与用户手册 |
| [archify](https://github.com/xgent-ai/skills/blob/HEAD/skills/archify/SKILL.md) | 将架构、流程、时序、数据流与状态关系制作成交互式 HTML 图，支持 Mermaid 输入和多格式导出 |
| [elintp](https://github.com/xgent-ai/skills/blob/HEAD/skills/elintp/SKILL.md) | 将技术主题或文档改写成面向非研发读者、带图示的通俗 HTML 说明 |
| [summarize](https://github.com/xgent-ai/skills/blob/HEAD/skills/summarize/SKILL.md) | 将需求、计划、Issue、文档或主题整理为 HTML 报告，并提交到指定 SPMS 项目的报告区 |
| [humanize-writing](https://github.com/xgent-ai/skills/blob/HEAD/skills/humanize-writing/SKILL.md) | 改写机械、夸大或模板化的文字，使表达自然、直接 |
| [meeting-minutes](https://github.com/xgent-ai/skills/blob/HEAD/skills/meeting-minutes/SKILL.md) | 整理会议议题、决定、负责人、截止日期与后续行动，生成会议纪要 |
| [pardon](https://github.com/xgent-ai/skills/blob/HEAD/skills/pardon/SKILL.md) | 补充必要上下文，用当前会话语言把上一条回答重新讲清楚 |
### 设计与转化
| Skill | 说明 |
| --- | --- |
| [design-reference](https://github.com/xgent-ai/skills/blob/HEAD/skills/design-reference/SKILL.md) | 寻找、比较页面或组件的视觉参考，提炼适合当前产品、有来源的设计方向与 brief |
| [design-md](https://github.com/xgent-ai/skills/blob/HEAD/skills/design-md/SKILL.md) | 从仓库、网站或明确设计决策提炼和维护 DESIGN.md，保留既定规范并报告实现偏差 |
| [ui-pattern-research](https://github.com/xgent-ai/skills/blob/HEAD/skills/ui-pattern-research/SKILL.md) | 比较筛选、权限、表格、批量操作和编辑流程，交付适合现有产品的交互方案与验收条件 |
| [kpi-dashboard-design](https://github.com/xgent-ai/skills/blob/HEAD/skills/kpi-dashboard-design/SKILL.md) | 设计 KPI 仪表盘的指标选择、信息层级与数据可视化 |
| [landing-page-conversion-audit](https://github.com/xgent-ai/skills/blob/HEAD/skills/landing-page-conversion-audit/SKILL.md) | 审查落地页、销售页或结账流程的转化障碍，按预期收入影响排序修复建议 |
### XGENT Portal 接入与发布
| Skill | 说明 |
| --- | --- |
| [xgent-init](https://github.com/xgent-ai/skills/blob/HEAD/skills/xgent-init/SKILL.md) | 内部初始化 skill,补齐 `AGENTS.md` / `PRODUCT.md` / `DESIGN.md`,保留 Portal 产品边界与设计规范;`install` 仅直接创建 AGENTS.md |
| [portal-dev-setup](https://github.com/xgent-ai/skills/blob/HEAD/skills/portal-dev-setup/SKILL.md) | 在 App 仓库中启动、体检和排查 Docker 一盒门户，完成本地联调 |
| [portal-external-app](https://github.com/xgent-ai/skills/blob/HEAD/skills/portal-external-app/SKILL.md) | 接入以 Docker 镜像交付的外部服务，核对 manifest、注册、路由、权限与交付契约 |
| [portal-micro-app](https://github.com/xgent-ai/skills/blob/HEAD/skills/portal-micro-app/SKILL.md) | 开发嵌入门户的微应用前端，处理 SDK 握手、导航、授权与 iframe 交互 |
| [portal-app-exchange](https://github.com/xgent-ai/skills/blob/HEAD/skills/portal-app-exchange/SKILL.md) | 配置和排查跨应用 OAuth Token Exchange、交换白名单、授权与 scope |
| [portal-logging](https://github.com/xgent-ai/skills/blob/HEAD/skills/portal-logging/SKILL.md) | 将应用日志与遥测接入门户，配置采集器、写入身份、日志流和字段口径 |
| [xgent-image-push](https://github.com/xgent-ai/skills/blob/HEAD/skills/xgent-image-push/SKILL.md) | 构建并推送 App 镜像到私有 Harbor，预检链路、镜像架构、tag 与保留策略 |
| [xgent-app-release](https://github.com/xgent-ai/skills/blob/HEAD/skills/xgent-app-release/SKILL.md) | 使用发布令牌提交前端产物、镜像和 manifest 变更，处理发布提案与发布故障 |
## 目录结构
每个 skill 位于 `skills/<name>/` 目录下,包含一个带 `name` 与 `description` frontmatter 的 `SKILL.md`:
`description` 用于加载前的技能选择,按「触发条件与关键排除条件 → 核心产出」组织。整条建议不超过 200 字符,中文尽量在 100 字符左右;前 100 字符应能独立表达适用边界。这是本仓库的编辑目标,不是所有 coding agent 的统一截断上限。
容易混淆的限制要紧跟触发条件,例如「仅写/评审计划,不用于按计划实施」,不能放在长段落末尾或只留在正文。操作步骤、完整错误码清单、工具细节和重复的双语说明放入正文或 references;精简后检查前缀是否仍表达原意,不要直接机械截字。
```
skills/
└── dev-plan/
├── SKILL.md # skill 主体(必需)
├── references/ # 补充参考文档
├── scripts/ # 辅助脚本
└── evals/ # 评测用例
```
## License
[MIT](https://github.com/xgent-ai/skills/blob/HEAD/LICENSE)