{"id":51406325,"url":"https://github.com/qxbyte/skills","last_synced_at":"2026-07-04T11:03:40.481Z","repository":{"id":354216379,"uuid":"1221677670","full_name":"qxbyte/skills","owner":"qxbyte","description":"可复用的 CLI coding agent skills 集合。","archived":false,"fork":false,"pushed_at":"2026-05-07T14:41:47.000Z","size":136,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T16:38:04.566Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qxbyte.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T14:40:34.000Z","updated_at":"2026-05-07T14:36:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/qxbyte/skills","commit_stats":null,"previous_names":["qxbyte/skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/qxbyte/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qxbyte","download_url":"https://codeload.github.com/qxbyte/skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35119016,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-04T11:03:39.846Z","updated_at":"2026-07-04T11:03:40.472Z","avatar_url":"https://github.com/qxbyte.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skills\n\n这个仓库用于维护可复用的 CLI coding agent skills。每个 skill 独立放在一个目录中，包含 `SKILL.md`、使用说明、参考模板、脚本和必要的工程规范文档。\n\n## 已创建的 Skills\n\n### obsidian-wiki —— 已迁往 pluginhub\n\n维护 Obsidian LLM-Wiki 的 `obsidian-wiki`（结构层 `wiki-struct`、知识沉淀 `spec-distill`、内容策展 `wiki-curate`、统一编排 `wiki-orchestrate`）已改造为**多 agent 通用插件**，迁出本仓，现作为插件维护在 [`pluginhub`](https://github.com/qxbyte/pluginhub) 仓的 `plugins/obsidian-wiki/`。安装：`/plugin marketplace add qxbyte/pluginhub` → `/plugin install obsidian-wiki@pluginhub`。\n\n### harness-hub\n\n`harness-hub` 是面向项目开发工程师的工程交付工作流。它用于把需求推进到可验证的工程结果：理解需求、建立上下文、设计方案、实现修改、补充测试、运行验证，并输出清晰的交付总结。\n\n适合场景：\n\n- 需求落地、功能开发、bug 修复和小范围重构。\n- 需求文档、PRD 或较长 issue 的逐步解析和实现。\n- PR review 处理、CI 失败排查、测试补齐和发布验收。\n- 多角色协作任务：主代理负责方案、分派、复核和整合；实现、勘察、验证、评审、文档子代理按需协作。\n\n常用触发方式：\n\n```text\n/harness-hub\n\n目标：...\n上下文：...\n约束：...\n验收：...\n```\n\n多角色 Checklist 示例：\n\n```text\n/harness-hub\n\n使用 Harness Hub 多角色模式处理这个任务。\n请开启任务拆分 Checklist，并按“勘察-方案-实现-验证-交付”逐步推进。\n\n目标：...\n上下文：...\n约束：...\n验收：...\n\n交付时请说明：\n1. 完成了什么\n2. 修改了哪些文件\n3. 运行了哪些验证\n4. 未验证项和剩余风险\n```\n\n主要文件：\n\n- `harness-hub/SKILL.md`：skill 入口和核心行为约定。\n- `harness-hub/README.md`：使用说明和 `/harness-hub` 命令示例。\n- `harness-hub/docs/harness/`：工程交付规范、角色契约、质量门禁和验收要求。\n- `harness-hub/references/`：技术方案、任务拆解、测试计划、PR 描述和交接文档模板。\n- `harness-hub/scripts/`：计划、交接和文档检查脚本。\n\n### spec-mode\n\n`spec-mode` 是规范化 Spec 工作流 skill，用于在 CLI Agent（如 Codex、Claude Code）中执行文件优先的规范化开发流程。它以 Markdown 文档作为唯一事实来源，在编码前完成需求确认、技术设计和任务拆分，并通过阶段门禁（phase gates）确保每个环节都经过审查。\n\n适合场景：\n\n- 功能开发或缺陷修复的规范化需求到交付流程。\n- 需要结构化文档（requirements.md / bugfix.md、design.md、tasks.md）来对齐需求、设计和实现。\n- 要求可追踪的验收标准（EARS）和任务执行状态。\n- 需要 Requirements-First、Design-First 或 Bugfix Spec 多种工作流。\n- 需要跨会话持续迭代同一个需求，支持多窗口并行推进不同 spec。\n\n命令说明：\n\n| 命令 | 说明 |\n|------|------|\n| `/spec \u003c需求\u003e` | **一次性模式**。执行完整的 requirements → design → tasks 结构化流程，不保留持续状态，对话结束后不跨会话继续。 |\n| `/spec-mode \u003c需求\u003e` | 同 `/spec`，别名入口。 |\n| `/spec --persist \u003c需求\u003e` | **持续模式**。创建 spec 文档并绑定当前会话，后续补充需求、调整设计、追加任务均自动落在同一个 spec 上。 |\n| `/spec-continue [spec名称]` | **恢复 spec**。从 spec 文档中加载上下文（当前阶段、未完成任务等），恢复跨会话记忆后继续迭代。不指定名称时列出所有可用 spec 供选择。 |\n| `/spec-status` | 查看当前 session 绑定的 spec、阶段、任务完成情况和 active pointer 状态。 |\n| `/spec-end` | 结束当前持续 session，从 active pointer 中移除该 session，不删除任何 spec 文档。 |\n| `/spec --set-vault \u003cvault路径\u003e` | 指定 Obsidian vault，spec 文档存入 `vault/spec-in/\u003cos\u003e-\u003cuser\u003e/specs`。首次设置后写入 `~/.config/spec-mode/config.json`，后续自动使用。 |\n| `/spec --set-root \u003c目录\u003e` | 直接指定 spec 文档根目录（不经过 vault 子目录结构）。 |\n| `/spec --detect-vault` | 检测当前平台已安装的 Obsidian vault，未检测到时提示手动指定。 |\n| `/spec --vault-status` | 显示当前 vault / spec 根目录配置和解析来源。 |\n| `/spec -h` | 显示所有命令速查。 |\n\n示例：\n\n```text\n# 一次性流程\n/spec 为 Markdown 编辑器增加撤销重做支持\n/spec-mode 修复登录接口 500，不能改变现有错误码\n\n# 持续模式：开启\n/spec --persist 为用户中心增加 OAuth2 登录\n\n# 持续模式：跨会话恢复\n/spec-continue oauth2-login\n\n# 持续模式：列出所有 spec 选择恢复\n/spec-continue\n\n# 退出持续模式\n/spec-end\n\n# Obsidian 集成\n/spec --detect-vault\n/spec --set-vault ~/Documents/MyVault\n/spec --vault-status\n```\n\n### Obsidian 集成\n\nspec-mode 支持将 spec 文档直接写入 Obsidian vault，跨平台可用（macOS / Windows / Linux）。\n\n**文档目录结构**\n\n同一个 vault 可被多平台、多用户共享（如通过 iCloud / OneDrive 同步），每台设备的 spec 独立存放，互不干扰：\n\n```text\n\u003cvault\u003e/\n└── spec-in/\n    ├── macos-alice/\n    │   └── specs/\n    │       └── \u003cspec-name\u003e/\n    │           ├── requirements.md\n    │           ├── design.md\n    │           ├── tasks.md\n    │           └── .config.json\n    ├── windows-bob/\n    │   └── specs/\n    └── linux-carol/\n        └── specs/\n```\n\n**根目录解析顺序**（高 → 低优先级）\n\n1. `/spec --root` 参数\n2. `SPEC_MODE_ROOT` 环境变量\n3. `~/.config/spec-mode/config.json`（首次检测时自动写入，或手动 `--set-vault` / `--set-root`）\n4. 自动检测 Obsidian vault → `vault/spec-in/\u003cos\u003e-\u003cuser\u003e/specs`\n5. `\u003c当前项目\u003e/specs`\n6. `~/new project/specs`（兜底）\n\n**Obsidian 配置文件位置**（`spec_vault.py` 自动读取）\n\n| 平台 | 路径 |\n|------|------|\n| macOS | `~/Library/Application Support/obsidian/obsidian.json` |\n| Windows | `%APPDATA%\\obsidian\\obsidian.json` |\n| Linux | `~/.config/obsidian/obsidian.json`（或 `$XDG_CONFIG_HOME`） |\n\n**跨会话说明**\n\nspec 创建后，`documentRoot` 存储在各 spec 的 `.config.json` 中。跨会话恢复（`/spec-continue`）直接读取该路径，不重新走 vault 检测流程。\n\n主要文件：\n\n- `spec-mode/SKILL.md`：skill 入口、Activation Guard、命令集、阶段门禁、document-first 纪律和命令遵从规则。\n- `spec-mode/references/workflow.md`：完整工作流程、上下文加载协议、边界防污染规则。\n- `spec-mode/assets/templates/`：脚本初始化文档时使用的 Markdown 模板（requirements.md、bugfix.md、design.md、tasks.md）。\n- `spec-mode/scripts/spec_vault.py`：跨平台 Obsidian vault 检测、根目录解析与配置管理。\n- `spec-mode/scripts/spec_session.py`：持续 session 生命周期管理（start / continue / status / end / list / load）。\n- `spec-mode/scripts/spec_init.py`：初始化 spec 目录结构和文档。\n- `spec-mode/scripts/spec_lint.py`：校验 spec 结构、session 状态和目录边界。\n- `spec-mode/scripts/spec_status.py`：输出 spec 阶段、session 状态和任务统计。\n- `spec-mode/scripts/spec_choice.py`：CLI 交互式选择器。\n\n## 本地检查\n\n修改 `harness-hub` 文档后，可以运行：\n\n```sh\n./harness-hub/scripts/harness-check.sh\n./harness-hub/scripts/harness-validate-docs.sh\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqxbyte%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqxbyte%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqxbyte%2Fskills/lists"}