Github

Operational Steps

1. 确认输入参数完整
2. 执行核心操作（参考本目录下的 scripts/ 或 references/）
3. 验证输出符合契约
4. 保存结果并报告

Pitfalls

-

-

Verification

-

-

-

-

1. 2. 3.

IO_CONTRACT

• input: request: str, context: dict — 用户请求描述、上下文信息
• output: result: dict — 技能执行结果（结构因技能而异）

对应原则：P2（机械原子暴露输入输出规范）

github

父级技能目录，包含 7 个子技能。 子技能通过Hermes技能加载机制自动发现，无需显式调用。

子技能

• codebase-inspection
• github-auth
• github-code-review
• github-discussions
• github-issues
• github-pr-workflow
• github-repo-management

使用方式

直接调用子技能名称即可：

验证清单 · VERIFICATION

• 确认请求类型可路由到 7 个子技能之一（codebase-inspection / github-auth / github-code-review / github-discussions / github-issues / github-pr-workflow / github-repo-management）
• 输入符合 IO_CONTRACT（request: str 非空，context: dict 包含必要的 owner/repo 等上下文）
• 父级 SKILL.md 仅作目录索引，实际执行由对应子技能完成，未在父级直接实现具体 GitHub 操作
• 子技能通过 Hermes 技能加载机制自动发现（skill_view(name='...')），未硬编码子技能路径
• 涉及状态变更（如创建 PR/Issue/Discussion）前，确认未执行未验证的任意代码

约束规则 · RULES

1. 输入约束: 参数类型、范围、格式必须校验
2. 输出约束: 返回值结构、编码、命名必须一致
3. 异常约束: 错误信息必须包含上下文和恢复建议
4. 安全约束: 不执行未验证的任意代码，不暴露内部状态

Golden 集合 · GOLDEN SET

• Golden Input: 标准输入样本（覆盖正常路径）
• Golden Output: 预期输出（精确匹配或格式校验）
• Golden Error: 预期错误信息（覆盖失败路径）

Golden 集合是测试的单一真理来源。所有改进必须通过 golden 测试。

违反规则的操作视为不安全，必须拒绝或隔离。

每项验证必须可执行、可记录、可复现。验证失败时记录原因和修复。

skill_view(name='codebase-inspection')  # 加载第一个子技能

父级SKILL.md仅作为目录索引，实际执行由子技能完成。

Github

Genes (策略基因)

紧凑策略表示。条件→策略。需要深度时参考完整文档。

• [GITH-001] 执行 GitHub 工作流前 → 必须确认输入参数（request, context）完整且符合 IO_CONTRACT 规范
• [GITH-002] 处理具体 GitHub 任务（如 PR、Issue）时 → 通过 Hermes 机制自动发现并调用对应的子技能，而非在父级技能中直接实现
• [GITH-003] 执行核心操作过程中 → 需进行过程验证，确保中间步骤、转换及计算逻辑正确无误
• [GITH-004] 生成最终结果时 → 必须验证输出格式、内容符合预期契约，并保存结果以报告
• [GITH-005] 遇到空输入、极大值或异常场景时 → 必须执行边界验证，确保系统能正确处理并防止崩溃
• [GITH-006] 发生执行失败或错误时 → 错误信息必须包含具体上下文和明确的恢复指引，以便快速定位问题
• [GITH-007] 涉及代码执行或状态变更时 → 遵循安全约束，拒绝执行未验证的任意代码且不暴露内部状态