mcpField
S
setup-ouyangjiahong-skills

setup-ouyangjiahong-skills

github.com/ouyangjiahong26エージェントワークフロー592 回インストール2 日前に更新
リポジトリ

setup-ouyangjiahong-skills について

リポジトリに文章作成基準を適用し、エンジニアリングエージェントの設定を検討するワークフローです。AGENTS.mdを同期・検証し、課題管理、トリアージラベル、ドメイン文書の設定を順に案内します。

主な機能

  1. 01AGENTS.mdの同期と検証
  2. 02リポジトリの状況とホスティングの確認
  3. 03課題管理とトリアージラベルの設定
  4. 04ドメイン文書の計画と書き込み確認

活用シーン

  1. 01リポジトリに文章作成基準を適用
  2. 02エンジニアリングエージェントの課題管理方法を選定
  3. 03利用可能なtriage skillのラベルを設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ouyangjiahong26/skills --skill setup-ouyangjiahong-skills

インストール後、Claude Code で/setup-ouyangjiahong-skillsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

sync.js
sync.test.js
references/
domain.md
issue-tracker-github.md
issue-tracker-gitlab.md
issue-tracker-local.md
standards.md
triage-labels.md

詳細

プロジェクトの README より

为当前仓库做两件事:注入写作标准,再建立工程技能的 harness 无关配置。只做其中一件时,执行对应小节即可。

目标文件固定为 AGENTS.md。

1. 注入写作标准

  1. 确认目标目录:默认当前工作目录。目标不是仓库根目录时,传入明确路径。

  2. 运行一次:

    # 默认同步当前目录的 AGENTS.md
    node "{{SKILL_DIR}}/sync.js"
    
    # 指定目录
    node "{{SKILL_DIR}}/sync.js" "/path/to/repo"
    

    {{SKILL_DIR}} 是 skill 所在目录的绝对路径,由 harness 替换。

  3. 以退出码判断结果:退出码 0 表示同步并验证成功。非 0 时报告完整错误并停止。

  4. 成功后查看 AGENTS.md 的改动:已跟踪时用 git diff -- AGENTS.md,未跟踪时直接读文件。向用户说明新增、替换或保留的内容。

脚本已经包揽文件读取、节切分、写入、行尾归一化和一致性验证。不要再手动编辑同一批文件,也不要用其他脚本重复实现这些步骤。

完成条件:脚本退出码为 0。AGENTS.md 存在,首行为 # AGENTS.md,包含 ## 写作要求、## 编码准则,两节内容分别与 references/standards.md 逐字一致,源文件与目标文件均为 LF 行尾,其他已有章节保留。

2. 探索

读取,不要假设:

  • git remote -v 和 .git/config,判断 GitHub、GitLab 或其他托管方式。
  • 根目录 AGENTS.md,以及其中的 Agent 协议节。
  • CONTEXT.md、CONTEXT-MAP.md、docs/adr/、*/*/docs/adr/、docs/agents/、.scratch/。
  • 检查 triage skill 是否可用。
  • pnpm-workspace.yaml 与 package.json 的 workspaces,判断是否为明确的大型 monorepo。

3. 决策

先总结现状和缺口。按以下顺序逐项给出推荐,让用户接受、修改或跳过。每项结论确认后再进入下一项。

A. Issue tracker

GitHub remote 默认 GitHub(gh),GitLab remote 默认 GitLab(glab),已采用 .scratch/ 时默认本地 Markdown。其他 tracker 让用户说明工作流。

写入 docs/agents/issue-tracker.md。

选 GitHub 时接着问是否用 GitHub Project 管理工作状态(/github-project、/triage、/open-pr、/merge-pr 依赖它)。用时:

  1. gh project list --owner <owner> 列出候选,让用户选定。owner 是用户账号时裸 login 会报 unknown owner type,改用 --owner "@me"。
  2. gh project view <number> --owner <owner> --format json --jq .id 取 Project ID。gh project field-list <number> --owner <owner> --format json 取 Status 等字段 ID 与选项 ID。
  3. 按模板的“GitHub Project”节填表,标为“是”。Status 缺模板列出的某个选项时,报告缺口,不自行建选项。

gh 报缺 project 权限时,请用户跑 gh auth refresh -s project。不用 Project 时保留“否”。

B. 分诊标签

只有 triage 可用时配置。默认保留:needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。用户拒绝默认值时,再收集覆盖项。

写入 docs/agents/triage-labels.md。

C. 领域文档

默认单一上下文:根目录 CONTEXT.md 与 docs/adr/。只有发现明确 monorepo 信号时才讨论 CONTEXT-MAP.md 和多上下文布局。

写入 docs/agents/domain.md。

4. 确认写入

只展示将写入或更新的文件、使用的种子模板及对已有内容的保留、替换或追加方式。不要输出模板全文。

种子模板在 references/:

目标文件种子模板
docs/agents/issue-tracker.mdissue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md 或从零写
docs/agents/triage-labels.mdtriage-labels.md
docs/agents/domain.mddomain.md

得到确认后才写入。

5. 写入与结束

  • 编辑 AGENTS.md 的 Agent 协议节。文件不存在时创建。
  • 已有 Agent 协议节时在其中更新,避免重复。
  • 完成后说明哪些工程技能会读取 docs/agents/*.md。

维护

  • 只编辑 references/standards.md 更新标准正文。不要直接修改目标文件中的同步章节。
  • 脚本只管理 references/standards.md 里现存的节。从标准中删掉的节(如早期的交流语言一节)不会从目标文件移除,需要时手动删除该节。
  • 标准同步成功后,重启会话,让新标准进入上下文。

コメント