No description
  • JavaScript 63.7%
  • Shell 24.4%
  • HTML 11.9%
Find a file
wuqiyang312 d1678a752d feat: 派发前主代理先定位关键文件并同步子代理
- 确定性/探讨执行模板新增必填字段「关键定位信息」与派发前定位要求
- 闭环契约门禁加入四级降级链(搜索定位→源码→提示用户→编译产物/网络搜索)
- 工作流契约子代理章节补充定位同步要求
- 记录 Q018、R18、E011 与实施汇总
2026-10-15 14:40:18 +00:00
brainstorming fix: 强制执行前派发并明确主子代理职责 2026-10-15 06:36:44 +00:00
caveman 更新技能工作流与需求文档 2026-10-14 06:04:48 +00:00
chinese-code-review 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
chinese-commit-conventions 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
chinese-documentation 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
chinese-git-workflow 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
diagnose 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
docs feat: 派发前主代理先定位关键文件并同步子代理 2026-10-15 14:40:18 +00:00
executing feat: 派发前主代理先定位关键文件并同步子代理 2026-10-15 14:40:18 +00:00
executing-plans fix: 强制执行前派发并明确主子代理职责 2026-10-15 06:36:44 +00:00
finishing-a-development-branch 更新技能工作流与需求文档 2026-10-14 06:04:48 +00:00
grill-me 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
grill-with-docs fix: 强制执行前派发并明确主子代理职责 2026-10-15 06:36:44 +00:00
handoff 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
history/2026-10-13-15-workflow 更新技能工作流与需求文档 2026-10-14 06:04:48 +00:00
improve-codebase-architecture 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
prototype 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
receiving-code-review feat: 完善文档管理与子代理审查返修流程 2026-10-15 05:29:21 +00:00
reconcile-qa feat: 完善文档管理与子代理审查返修流程 2026-10-15 05:29:21 +00:00
requesting-code-review feat: 完善文档管理与子代理审查返修流程 2026-10-15 05:29:21 +00:00
scripts feat: 拆分专项技能并改为按名称可选安装 2026-10-14 06:28:04 +00:00
specialized feat: 拆分专项技能并改为按名称可选安装 2026-10-14 06:28:04 +00:00
test-driven-development 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
tests feat: 完善文档管理与子代理审查返修流程 2026-10-15 05:29:21 +00:00
to-issues 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
to-prd 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
user-dialogue-templates 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
using-git-worktrees 更新技能工作流与需求文档 2026-10-14 06:04:48 +00:00
using-oh-my-superpowers feat: 派发前主代理先定位关键文件并同步子代理 2026-10-15 14:40:18 +00:00
writing-plans fix: 强制执行前派发并明确主子代理职责 2026-10-15 06:36:44 +00:00
writing-skills 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
zoom-out 导入全部 28 个 skill 2026-10-13 15:33:01 +00:00
AGENTS.md feat: 完善文档管理与子代理审查返修流程 2026-10-15 05:29:21 +00:00
llms.txt feat: 拆分专项技能并改为按名称可选安装 2026-10-14 06:28:04 +00:00
README.md fix: 强制执行前派发并明确主子代理职责 2026-10-15 06:36:44 +00:00

my-skill

智能体自定义技能(skills)的归档与管理仓库,用于集中维护、版本管理和备份用户级技能。

本仓库是技能的唯一可编辑源。技能在这里修改后,按需同步到 ~/.agents/skills/,并在新的智能体会话中生效。

项目内容

  • 当前包含 27 个通用技能 + 3 个可选专项技能;默认只安装通用技能,覆盖需求探索、方案设计、开发执行、调试、代码审查、中文协作和专项工具使用。
  • 每个技能一个目录,入口为带 YAML frontmatter 的 SKILL.md。
  • 辅助内容包括参考文档、模板、审查提示词和少量 Shell / JavaScript / HTML 文件。
  • 仓库没有统一的构建流程、依赖安装流程或测试套件;使用某个技能的辅助脚本或外部工具时,按该技能文档准备环境。

目录结构

my-skill/
├── README.md                 # 项目说明与技能索引
├── AGENTS.md                 # 仓库维护约定
├── llms.txt                  # 下载、配置、清理与恢复引导
├── scripts/install-skills.sh # 安装与旧目录清理工具
├── docs/qa/                  # 问答历史与当前有效需求
├── docs/design/              # 当前目标设计
├── docs/plans/               # 计划模式按需维护
├── docs/reports/             # 执行说明与偏移交接
├── history/                  # 旧工作流快照,不安装
├── specialized/              # 可选专项工具与学习,不默认安装
│   ├── codex-chat/
│   ├── kicad-parts-cli/
│   └── teach/
├── <skill-name>/
│   ├── SKILL.md              # 技能定义与操作流程
│   └── ...                   # 可选的参考文档、模板或脚本
├── using-oh-my-superpowers/
│   ├── references/           # 不同智能体平台的工具参考
│   └── templates/            # 领域、工单跟踪器和标签模板
└── writing-skills/examples/  # 技能编写示例

当前工作流

默认:brainstorming → executing → grill-with-docs → executing …。 按明确请求可用:brainstorming → writing-plans → executing-plans → grill-with-docs → 更新受影响计划 → executing-plans …。

两种模式共用 QA、当前有效需求、目标设计、执行报告和验收。直接执行指不额外写书面计划,不表示主代理亲自实现。直接执行适合小任务与快速迭代,计划模式适合明确要求排期、分阶段执行、交接或继续已有计划。切换只整理剩余任务,保留已验证成果;只讨论、只写计划与允许实施分别遵循用户授权。

规则统一在 using-oh-my-superpowers 工作流契约。用户指定的 历史路由入口 已追加现行指引,原始正文仍供比较。

文档 用途 更新方式
docs/qa/QA-<项目名>.md 真实需求、问答、确认来源 稳定 Q 编号追加,保留历史
docs/qa/current-<项目名>.md 当前有效需求、冲突、建议 按需整理,已有文件同步受影响结论
docs/design/design-<项目名>.md 目标、范围、约束、验收、探索方向 随明确决定调整
docs/plans/plan-<项目名>.md 任务、依赖、进度、验收 计划模式按需维护
docs/reports/execution-<项目名>.md 结果、验证、偏移、对齐、恢复 executing 必需,每轮稳定 E 编号追加

项目既定路径优先,后缀取主仓库名,worktree 沿用主仓库名。新文件记录精确到分钟且带时区的创建与更新时间;修改保留创建时间。不生成全套空文档、不复制完整实现代码或固定行号。

文档使用 Node docs 管理脚本 创建、追加、更新与检查,自动读取真实 UTC 时间并分配 Q/E 编号。支持 Linux/macOS/Windows 原生 Node.js 18+,无第三方依赖;Windows 可在 PowerShell 使用 docs 工具,技能安装仍使用 Git Bash/WSL。工具兼容 CRLF 和 UTF-8 BOM,写入统一为 UTF-8 / LF。各平台运行 node --test tests/docs-manager.test.mjs 验证;测试需要 Git。运行 node using-oh-my-superpowers/scripts/docs-manager.mjs --help 查看命令。

需求变更导致 QA 无法可靠同步时,建议用户补充必要需求;补充后,在已授权且工具可用时启动两个子代理,分别产出 QA 修复稿和影响检查清单。主代理核查落盘,再进入 grill-with-docs 与用户重新对齐,确认后恢复原执行模式。详细边界见上述脚本文档。

执行途中偏移先写报告,再交 grill-with-docs。子代理提示词分 确定性 与 探讨执行,独立于工作流模式。子代理主动暂停受影响部分,明确哪处从什么改为什么;主代理核查证据,同步受影响依据和计划,发明确恢复指令,再检查集成。报告格式见 执行说明模板。

用户已有要求、适用项目规则或适用技能明确要求派发且上层允许、工具可用时,首次目标实现/每次返修写入前须实际派发实施者,记录真实标识、任务范围、验收与成功派发证据,再安排独立审查;只写技能名、只派调查或只派审查不算实施交接。既有授权不重复索取。主代理治理共享依据和报告、核查与最小集成;skill、README、文档若为目标也属实施,内容/行为变更与冲突解决返派实施者,不能顺手改。已派实施/审查子代理本地完成分配范围,不递归派发,除非明确受派拆分/协调职责。主代理核查后返派修复,循环至无已核实错误;可要求各子代理提交 修改细节汇总。同一代理当前任务累计第 4 个核实出错轮次时升级主代理与用户,暂停相关工作;具体去重、角色隔离、计数与降级规则见 闭环契约。只有上层禁止、真实缺少派发工具或用户明确单代理时明确降级;槽位满、延迟和临时失败先检查、等待/复用/重排,不冒称独立审查。不自动提交、不强制 worktree。reconcile-qa 按需解决冲突,未确认建议不覆盖需求。本次依据与说明:QA、当前需求、设计、执行报告。旧快照与 Git 基线保留,未自动提交。

技能清单

下表用于快速定位。具体触发条件、前置要求和执行规则以各目录中的 SKILL.md 为准。

分类 技能 用途
路由与协作 using-oh-my-superpowers 按用户意图选择技能,配置项目领域与工单上下文,提供中文场景路由。
路由与协作 caveman 压缩沟通篇幅,保留技术信息;支持手动触发及工具链启用。
路由与协作 user-dialogue-templates 需求确认、进展同步、阻塞说明、交付和客户沟通模板。
路由与协作 handoff 将当前对话整理成可供另一个智能体接手的交接文档。
需求与设计 brainstorming 记录原始需求 QA,形成简短目标、完成标准与探索方向。
需求与设计 reconcile-qa 整理 QA 为当前有效需求,用最新确认替代旧结论,通过对话修复冲突并提出改进建议。
需求与设计 grill-me 通过逐项追问对计划或设计进行压力测试。
需求与设计 grill-with-docs 执行途中讨论新增设计需求和项目偏移,同步 QA 与目标设计。
需求与设计 prototype 构建可丢弃的逻辑或 UI 原型,验证设计问题。
需求与设计 to-prd 将已有上下文整理为 PRD,并发布到项目 issue 跟踪器。
需求与设计 to-issues 将计划、规格或 PRD 拆成可独立领取的垂直切片工单。
开发与执行 writing-plans 仅在明确要求书面计划或排期时使用,非默认步骤。
开发与执行 executing 实施、验证并产出执行报告,途中偏移交接讨论。
开发与执行 executing-plans 管理有效计划与进度,共用 executing 实施和报告。
开发与执行 using-git-worktrees 检查并建立隔离的开发工作区。
开发与执行 test-driven-development 按先失败测试、再实现、再重构的流程开发。
开发与执行 finishing-a-development-branch 验证结果后,处理分支合并、PR 或清理等收尾工作。
诊断与架构 diagnose 建立反馈回路、调查根因、验证假设并修复问题。
诊断与架构 improve-codebase-architecture 寻找模块加深和重构机会,改善可测试性与代码导航。
诊断与架构 zoom-out 从更高层次解释相关模块、调用者及其关系。
代码审查 requesting-code-review 请求审查,验证实现是否符合要求。
代码审查 receiving-code-review 理解并验证审查意见,再实施合理建议。
中文参考 chinese-code-review 中文审查话术、反馈分级和团队沟通参考。
中文参考 chinese-commit-conventions 中文提交信息、changelog 和相关工具配置参考。
中文参考 chinese-documentation 中文技术文档的空格、标点、术语和链接排版参考。
中文参考 chinese-git-workflow 国内 Git 平台的接入差异与镜像同步配置参考。
技能维护 writing-skills 创建、编辑及验证技能,包含测试方法和编写参考。

可选专项工具与学习

以下三个技能独立存放于 specialized/,不参加默认安装,也不默认加载。 只有用户需要对应能力时才按名称安装;不会由快速安装自动装齐。

分类 技能 用途
专项工具与学习 codex-chat 通过 codex-cli 进行对话、历史会话管理和图片生成。
专项工具与学习 kicad-parts-cli 指导元器件查询、manifest 准备及后续 KiCad 库导入。
专项工具与学习 teach 维护跨会话学习工作区、课程、参考资料和学习记录。
# 先预览,只安装 teach;其他已安装技能不受影响
sh scripts/install-skills.sh --skill teach
sh scripts/install-skills.sh --apply --skill teach

四个 chinese-* 技能均要求用户显式调用对应技能,不根据上下文自动触发。

查看和维护技能

在仓库根目录查看技能入口:

ls -d */
cat diagnose/SKILL.md
git status --short

新增技能时,创建与技能名称相同的目录,并添加 SKILL.md:

example-skill/
└── SKILL.md

入口文件的基本格式:

---
name: example-skill
description: 当用户需要完成某项具体任务时使用,明确说明适用场景。
---

# 技能标题

说明目标、前置条件、操作步骤和完成标准。

维护时遵循以下约定:

  1. 在本仓库修改技能,避免直接编辑生效目录造成版本分叉。
  2. frontmatter 中的 name 必须与目录名一致;description 应准确描述触发场景。
  3. 辅助文档、模板和脚本放在对应技能目录内,使用有效的相对链接引用。
  4. 增删技能或调整用途时,同步更新本 README 的索引。
  5. 提交前检查 git diff,不要存放密钥、token 等敏感信息。

下载、安装与清理旧目录

完整引导见 llms.txt,包含 Linux/macOS、Windows Git Bash/WSL、认证、安装、更新、验证和恢复。 仓库目前需要账号与读取 Token;凭据由 Git 交互获取,不写入 URL 或文件。

首次下载与安装:

mkdir -p "$HOME/projects"
git clone --depth 1 --branch main \
  https://git.app.wqyblog.cn/wuqiyang312/my-skill.git \
  "$HOME/projects/my-skill"
cd "$HOME/projects/my-skill"
sh scripts/install-skills.sh
sh scripts/install-skills.sh --apply

安装脚本默认只预览,使用 --apply 才执行。默认安装 27 个通用技能,统一到 ~/.agents/skills/, 检查 ~/.kimi-code/skills/、~/.claude/skills/ 和 ~/.codex/skills/ 中本仓库同名技能, 先备份再移出旧地址;保留其他技能和系统目录。默认通用模式也会备份移出生效目录中此前自动安装的三个专项副本。同名目标完整替换,内容一致时跳过。 备份路径会输出到终端,位于 ~/.local/state/my-skill/backups/。 只有技能目录会安装,根目录说明、脚本、docs/、history/ 和 .git/ 不会复制到生效目录。

使用 --no-cleanup 跳过旧地址清理(默认通用模式仍会移出目标中的专项副本);--target 指定安装位置;重复 --legacy-dir 指定旧根列表(替换默认列表)。 清理后只读取旧地址的应用将不再加载这些副本;按应用配置选择目标路径。脚本不修改应用配置。 重复 --skill <名称> 只安装指定技能,并仅清理它们的旧地址副本;不会移出其他已安装技能。选项详情见 sh scripts/install-skills.sh --help。

更新:

cd "$HOME/projects/my-skill"
git status --short
git pull --ff-only origin main
sh scripts/install-skills.sh
sh scripts/install-skills.sh --apply

保留仓库本地修改并先处理更新冲突;同步完成后开启新会话。 从仓库删除或改名的技能需另行核对,脚本只清理当前仓库同名技能。

仅复制单个技能时仍可用:

mkdir -p ~/.agents/skills/executing
cp -a executing/. ~/.agents/skills/executing/
diff -qr executing/ ~/.agents/skills/executing/

更多仓库约定见 AGENTS.md。