mcpField
S
setup-ouyangjiahong-skills

setup-ouyangjiahong-skills

github.com/ouyangjiahong26Agent workflows592 installsUpdated 2d ago
Repository

About setup-ouyangjiahong-skills

A workflow skill for applying writing standards and planning engineering-agent configuration in a repository. It syncs and verifies AGENTS.md, then guides decisions about issue tracking, triage labels, and domain documentation.

Key features

  1. 01Sync and verify AGENTS.md
  2. 02Inspect repository context and hosting
  3. 03Configure issue tracking and triage labels
  4. 04Plan domain docs and confirm writes

Use cases

  1. 01Apply writing standards to a repository
  2. 02Choose an issue tracker for engineering agents
  3. 03Configure labels for an available triage skill

Install

Copy the command and run it in a terminal.

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

After installing, type/setup-ouyangjiahong-skillsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project 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 里现存的节。从标准中删掉的节(如早期的交流语言一节)不会从目标文件移除,需要时手动删除该节。
  • 标准同步成功后,重启会话,让新标准进入上下文。

Comments

Markdown supported