Rijul1204/rashedul-agentic-engineering

## 同伴，而非执行者 AI 编程代理的默认模式是*执行用户的明确请求*。但当请求本身未充分指定时，这就是错误的模式 —— 而在真实工程工作中，未充分指定是常态，而非例外。 本仓库中的制品旨在**翻转极性**：将代理从订单接收者转变为同伴程序员，它会反驳、要求明确答案、揭示隐藏假设，并在关键决策仍停留在用户脑中时拒绝开始工作。最清晰的体现是 [`grill-me`](skills/grill-me/SKILL.md) —— 持续盘问用户，直到决策树的每个分支都得到解决 —— 但相同的基因也贯穿于此处的多个制品： | 制品 | 如何反驳 | |---|---| | [`grill-me`](skills/grill-me/SKILL.md) | 在实现前盘问你；当决策模糊时拒绝开始。 | | [`pair-agent-harness`](skills/pair-agent-harness/SKILL.md) | 让你与第二个 AI 配对，分别担任审查者与实现者 —— 审查者的全部工作就是反驳。 | | [`docs-probe-before-code`](prompts/docs-probe-before-code.md) | 强制采用 *文档 → 探针 → 夹具 → 代码* 的流程，而不是“我认为这就是模式”。 | | [`sprint-execution-protocol`](prompts/sprint-execution-protocol.md) | 每个任务的置信度 < 90% 会触发 `grill-me` 升级；在宣布任务完成前，会运行三个审查视角（高级工程师 / 产品 / UI-UX）。 | | [`quality-gates`](agents/quality-gates.md) | 拒绝通过放宽规则来“修复”失败的门禁 —— 仅报告，从不绕过。 | | [`pyramid-response`](prompts/pyramid-response.md) | 强制在第一个句子中给出建议，避免迂回。 | **论点**：一个会反驳的 AI 同伴能够捕获那些服从型 AI 代理会欣然交付的失败模式。当你希望代理问一次“为什么”，而不是错误地实现三次时，请采用这些制品。

## 目录 | 章节 | 用途 | |---|---| | [包含内容](#whats-here) | 当前类别及未来计划 | | [同伴，而非执行者](#peer-not-executor) | 贯穿各技能的核心论点 | | [技能](#skills) | Claude Code 的即用型 `SKILL.md` 文件夹 | | [代理](#agents) | 用于委托的子代理定义 | | [提示](#prompts) | 可粘贴的提示片段 | | [工作流](#workflows) | 用于其他仓库的即用型 GitHub Actions 模板 | | [布局](#layout) | 仓库结构 | | [安装](#install) | 如何在你的环境中使用这些资源 | | [说明](#notes) | 变体、命名冲突、一次性文件 | | [贡献与反馈](#contributing--feedback) | 如何建议、提交 issue、发起 Pull Request | ## 包含内容 | 类别 | 状态 | 位置 | |---|---|---| | **技能** — Claude Code 的 `SKILL.md` 文件夹 | 已上线 | [`skills/`](skills) | | **代理** — 用于委托的子代理定义 | 已上线 | [`agents/`](agents) | | **提示** — 可粘贴的提示片段 | 已上线 | [`prompts/`](prompts) | | **工作流** — 用于其他仓库的即用型 GitHub Actions 模板 | 已上线 | [`workflows/`](workflows) | | **钩子** — Claude Code 生命周期钩子 | 计划中 | `hooks/` | | **配置** — 可共享的 `settings.json` 片段、快捷键绑定 | 计划中 | `configs/` | 此仓库最初仅收集技能，现正扩展为我在 Claude Code 中使用的所有资源的更广泛家园。新类别仅在具有实际内容时才会创建文件夹 —— 无空架子。 ## 技能 12 项技能，分为四组。点击下方任意卡片查看详情。 | 分组 | 技能 | |---|---| | [通用](#general-purpose) | [`html-output`](skills/html-output/SKILL.md) · [`grill-me`](skills/grill-me/SKILL.md) · [`grill-me-codex`](skills/grill-me-codex/SKILL.md) · [`pair-agent-harness`](skills/pair-agent-harness/SKILL.md) · [`handoff`](skills/handoff/SKILL.md) | | [规格与交付规划](#spec--delivery-planning) | [`srs-documentation`](skills/srs-documentation/SKILL.md) · [`srs-to-delivery-plan`](skills/srs-to-delivery-plan/SKILL.md) | | [供应商集成](#vendor-integrations) | [`recall-ai-integration`](skills/recall-ai-integration/SKILL.md) | | [Fizzy 看板工具包](#fizzy-kanban-toolkit) | [`fizzy-product-manager`](skills/fizzy-product-manager/SKILL.md) · [`fizzy-tasks`](skills/fizzy-tasks/SKILL.md) · [`fizzy-board-monitor`](skills/fizzy-board-monitor/SKILL.md) · [`fizzy-write`](skills/fizzy-write/SKILL.md) | ### 通用 ### 规格与交付规划 ### 供应商集成 ### Fizzy 看板工具包

Fizzy PM 规则库 — 随 fizzy-product-manager 附带的 20 个参考文件

| 文件 | 主题 | |---|---| | [`kanban-principles.md`](skills/fizzy-product-manager/rules/kanban-principles.md) | 代理应捍卫的核心看板模型 | | [`wip-limits.md`](skills/fizzy-product-manager/rules/wip-limits.md) | 何时对过载列提出异议 | | [`column-structure.md`](skills/fizzy-product-manager/rules/column-structure.md) | 列应如何映射到工作流阶段 | | [`board-management.md`](skills/fizzy-product-manager/rules/board-management.md) | 看板生命周期与所有权 | | [`board-hygiene.md`](skills/fizzy-product-manager/rules/board-hygiene.md) | 例行清理与修剪规则 | | [`board-reports.md`](skills/fizzy-product-manager/rules/board-reports.md) | 报告形态（吞吐量、老化） | | [`card-lifecycle.md`](skills/fizzy-product-manager/rules/card-lifecycle.md) | 打开 → 进行中 → 完成的转换 | | [`card-details.md`](skills/fizzy-product-manager/rules/card-details.md) | 每种卡片类型必填字段 | | [`card-writing.md`](skills/fizzy-product-manager/rules/card-writing.md) | ActionText/Trix HTML规则及 curl 配方 | | [`card-triage.md`](skills/fizzy-product-manager/rules/card-triage.md) | 分诊启发式方法 | | [`tagging-strategy.md`](skills/fizzy-product-manager/rules/tagging-strategy.md) | 标签分类与使用 | | [`assignments-workload.md`](skills/fizzy-product-manager/rules/assignments-workload.md) | 工作负载平衡与重新分配 | | [`comments-collaboration.md`](skills/fizzy-product-manager/rules/comments-collaboration.md) | 评论礼仪与线索 | | [`api-basics.md`](skills/fizzy-product-manager/rules/api-basics.md) | 认证、端点、分页 | | [`api-recipes.md`](skills/fizzy-product-manager/rules/api-recipes.md) | 常用 curl/jq 模式 | | [`webhooks-automation.md`](skills/fizzy-product-manager/rules/webhooks-automation.md) | Webhook 负载形状与使用 | | [`entropy-management.md`](skills/fizzy-product-manager/rules/entropy-management.md) | 防止看板陷入混乱 | | [`tap-games-context.md`](skills/fizzy-product-manager/rules/tap-games-context.md) | Tap Games 特定上下文 | | [`jira-migration.md`](skills/fizzy-product-manager/rules/jira-migration.md) | 一次性 Fizzy → Jira（GCW 上的 `TG` 项目）切换运行手册 |

## 代理 ## 提示 可粘贴的提示片段 —— 每个文件一条规则，kebab-case 命名，正文为提示文本。可放入新对话、系统提示顶部或项目的 `CLAUDE.md`。详见 [`prompts/README.md`](prompts/README.md)。 ## 工作流 可共享的 GitHub Actions 模板。每个条目是一个自包含的文件夹，镜像目标仓库的 `.github/` 树 —— 通过 `cp -R` 放入后即可使用。 ## 布局 ``` skills/ └── / ├── SKILL.md # required — YAML frontmatter + body └── rules/ # optional — reference files the skill can load agents/ └── .md # YAML frontmatter (name, description, tools, model) + body prompts/ ├── README.md # category convention └── .md # optional YAML frontmatter + paste-ready prompt text workflows/ └── / ├── README.md # how to install in a target repo └── .github/ # mirror of target repo's .github tree — copy in with one cp -R ├── workflows/.yml ├── scripts/ # support scripts ├── instructions/ # review rubrics, prompt templates └── *.env # optional config (version pins, checksums) ``` 每个**技能**是一个自包含的文件夹；`SKILL.md` 包含 YAML 前置元数据（`name`, `description`），Claude Code 在启动时读取；文件夹名称应与 `name:` 字段匹配，以便 `/skill-name` 调用能够清晰解析。 每个**代理**是 `agents/` 下的一个 `.md` 文件。前置元数据声明代理的 `name`、`description`（父代理用于判断何时委托）、允许的 `tools` 以及 `model` 覆盖。 每个**工作流**位于 `workflows//` 下，包含完整的 `.github/` 子树及每个工作流的 `README.md`。内部的 `.github/` 故意下沉一层，以使本仓库自己的 Actions 运行器忽略它 —— 这些是模板，而非活动工作流。 ## 安装 ### 技能与代理 **零克隆安装（一行命令）：** ``` curl -fsSL https://raw.githubusercontent.com/Rijul1204/rashedul-agentic-engineering/main/scripts/bootstrap.sh | bash ``` 克隆到 `~/.claude/rashedul-agentic-engineering/` 并将每个技能 + 代理符号链接到 `~/.claude/`。重新运行同一行以更新 —— `bootstrap.sh` 会检测现有克隆并执行 `git pull` + 重新符号链接。 使用 `bash -s --` 向安装程序传递标志： ``` curl -fsSL https://raw.githubusercontent.com/Rijul1204/rashedul-agentic-engineering/main/scripts/bootstrap.sh | bash -s -- --target ~/Projects/foo --only skills curl -fsSL https://raw.githubusercontent.com/Rijul1204/rashedul-agentic-engineering/main/scripts/bootstrap.sh | bash -s -- --dry-run ``` 通过管道前的环境变量覆盖克隆位置（或源仓库）： ``` INSTALL_DIR=~/work/agentic-engineering curl -fsSL | bash REPO_URL=https://github.com//.git BRANCH=develop curl -fsSL | bash ``` **已克隆？** 直接运行安装程序： ``` ./scripts/install.sh # user-scope (~/.claude/), symlink, all categories ./scripts/install.sh --target ~/Projects/foo # project-scope (/.claude/) ./scripts/install.sh --only skills --dry-run # preview only — no filesystem changes ./scripts/install.sh --copy --force # snapshot copy, overwrite existing ``` 该脚本将每个 `skills//` 和 `agents/*.md` 符号链接（或复制）到目标的 `.claude/` 树中。除非传递 `--force`，否则现有目标会被跳过并显示警告。 **单项安装**（当你只需要一个时）： ``` # 技能 — 用户范围在每个 Claude Code 会话中可用） ln -s "$PWD/skills/html-output" ~/.claude/skills/html-output # 技能 — 项目范围（仅在一个 repo 内） ln -s "$PWD/skills/fizzy-tasks" /.claude/skills/fizzy-tasks # agents — 项目范围（通常；agents 通常与 repo 的 tooling 绑定） ln -s "$PWD/agents/quality-gates.md" /.claude/agents/quality-gates.md # 或复制而非 symlink cp -R skills/html-output ~/.claude/skills/html-output cp agents/quality-gates.md /.claude/agents/quality-gates.md ``` ### 工作流 每个工作流自带安装步骤 —— 参见每个工作流的 README： - [`workflows/cursor-review/README.md`](workflows/cursor-review/README.md) —— 将内部的 `.github/` 树放入目标仓库根目录，替换评估标准，设置 `CURSOR_API_KEY`。 ## 说明 - **唯一真理来源。** 本仓库是权威的。其他地方（`~/Projects/*/.claude/skills/` 和 `~/Projects/*/.claude/agents/`）的项目本地副本是历史遗留的，可能存在差异 —— 如有疑问，以本仓库为准。 - **无运行时依赖。** 技能和代理是纯 Markdown。它们由 Claude Code 消费，而非执行。 - **添加新技能。** 在 `skills/` 下创建一个文件夹，为其 `SKILL.md` 添加包含 `name:` 和 `description:` 的前置元数据，并从上表中链接。 - **添加新代理。** 在 `agents/` 下创建一个 `.md` 文件，在其前置元数据中添加 `name:` / `description:` / `tools:` / `model:`，并从[代理](#agents)章节链接。 - **添加新提示。** 在 `prompts/` 下创建一个 `.md` 文件，kebab-case 命名，正文为提示文本。可选的 YAML 前置元数据（`name`, `description`）。从[提示](#prompts)章节链接。完整约定参见 [`prompts/README.md`](prompts/README.md)。 - **添加新的工作流模板。** 创建 `workflows//`，包含一个 `README.md` 和一个 `.github/` 子树。保持内部的 `.github/` 下沉一层，以便本仓库自己的 Actions 运行器忽略它。 - **添加新类别。** 仅当你有实际内容时，才创建顶层文件夹（`hooks/`、`configs/` 等）。创建后更新[包含内容](#whats-here)表格。

标签：AI代理, AI辅助编程, Claude Code, GitHub Actions, Linux 内核安全, 二进制发布, 人工智能, 代理工程, 代码审查, 决策驱动, 协作工具, 同级编程, 威胁情报, 子代理, 安全可观测性, 工作流自动化, 工程实践, 应用安全, 开发者工具, 开源工具, 开源框架, 技能库, 持续集成, 数据管道, 版本控制, 用户模式Hook绕过, 自动笔记, 质量门禁, 软件工程, 防御加固, 项目管理