Skip to content

engineering: add repository-local Agent engineering Skills #55

Description

@ULookup

Target Version

3.0-dev

Evidence

仓库目前缺少根级 AGENTS.md、仓库级 Agent Skills、结构化 Agent Issue/PR 约束及自动策略门禁。设计规格位于 docs/superpowers/specs/2026-07-16-chatnow-agent-engineering-skills-design.md

Problem or Goal

建立仅服务于编码 Agent 的工程治理体系,使 Agent 能从有效 Issue 自主推进到已推送的 Draft PR,同时以 Skill、模板和 CI 门禁约束架构理解、测试先行、版本分支、验证、安全及文档同步。

Scope

  • 九个 .agents/skills/chatnow-* Skills 及必要 references
  • 根级 AGENTS.md
  • GitHub Issue Forms 与 PR 模板
  • 纯 Go Agent policy CLI 与测试
  • GitHub Actions policy workflow
  • Skill RED/GREEN 压力验证与端到端验收

Non-goals

  • 不创建面向人类贡献者的传统贡献指南
  • 不允许 Agent 自动合并 PR
  • 不引入全仓 C++ 格式化
  • 不建立第二套测试框架

Acceptance Criteria

  • 九个 Skills 均通过结构校验和独立行为验证
  • Issue、版本分支、TDD、Draft-first、验证证据及人工合并边界被明确约束
  • 架构或 core-flow 变化未同步相关 Skill 时策略检查失败
  • Agent 可在无需常规人工确认的情况下推进到 Draft PR
  • 策略 CLI 使用 Go、测试先行且通过验证

Test-first Plan

先为每个流程 Skill 运行无 Skill 压力场景并记录失败,再编写最小 Skill 并复测。策略 CLI 的每个 validator 先写失败的 Go 测试,再实现最小逻辑并运行同层回归,最后执行完整 workflow 压力场景。

Risk and Security

主要风险是错误 Skill 触发、规则重复或冲突、PR head 修改自身策略、模板与 parser 漂移。CI 必须使用受信任 base ref 构建 policy binary,不执行不受信任 head 提供的策略程序。生产、真实凭据、不可逆数据和合并仍需人工批准。

Architecture Impact

no。本 Issue 不改变 ChatNow 生产服务架构,但新增 Agent 工程治理结构。

Core-flow Impact

no。不改变 IM 核心业务链路。

Required Skill Updates

创建并维护本 Issue 定义的九个 ChatNow Agent Skills;未来架构或 core-flow 变化必须在同一 PR 同步相关 Skill/reference。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions