Community写作与编辑github.com

peterruiter/claude-build-framework

根据框架模板,为单一工作项(功能、修复、打磨、翻译、无障碍或安全项目)编写完整的代理简报,包含上下文、范围、预留迁移槽位、暂存数据库、端口、文件所有权、常设规则(所有已配置语言、WCAG 2.2 AA、亮色与暗色主题、隐私、数据驻留、新功能说明、无AI归属)、门控和报告格式。当用户或 plan-wave 技能需要简报,或用户说“写一份简报”、“给代理布置任务”、“委托此事”时使用。

claude-build-framework 是什么?

该技能能够根据预定义模板自动生成结构化的代理简报,帮助开发者将工作项(如功能、修复、打磨等)清晰地委托给AI代理。它围绕一个完整的简报生成流程展开:首先收集仓库路径、分支、技术栈、语言配置、数据驻留等事实信息;然后编写用户角度的目标、具体范围及排除项;接着填充模板中的所有占位符,并保留常设规则(如所有语言、WCAG可访问性、隐私设计等);最后通过数字检查和报告格式确保完整性。支持Claude Code等平台,适用于需要将单一工作项明确委托给AI代理的场景。该技能基于SKILL.md文档中的具体步骤和模板,输出可直接作为代理提示的完整简报。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/peterruiter/claude-build-framework/tree/HEAD/skills/agent-brief

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

编写代理简报

模板:${CLAUDE_PLUGIN_ROOT}/templates/agent-brief.md。背景: ${CLAUDE_PLUGIN_ROOT}/docs/waves-and-agents.md。

步骤

  1. 收集事实(不要猜测):
    • 仓库路径、分支、技术栈摘要(CLAUDE.md)、门控命令(CLAUDE.md 或配置文件);
    • 语言:读取 build/contracts/locales.json:计数、源语言、最长语言(通常是德语或芬兰语)以及复数规则重的语言(Intl.PluralRules 需要 few/many 的语言,如果已配置)用于截图;
    • 数据驻留(CLAUDE.md);
    • 字符串文件夹、术语表、变更日志(最高ID:在你编写时写“下一个空闲”);
    • 预留迁移槽位、暂存数据库、端口、暂存文件夹(来自波浪计划,或选择空闲的并记录下来);
    • 需要首先研究的文件以及代理负责的文件。
  2. 用用户术语编写目标,然后写具体的范围要点以及超出范围的内容。
  3. 填写模板中的每个占位符。删除确实不适用的部分(例如,纯后端项目的截图)并用一行说明原因。
  4. 逐字保留常设规则:所有已配置语言及其复数形式、WCAG 2.2 AA、亮色与暗色主题、隐私设计、数据驻留、一条新功能说明、STATE.md 部分、小的针对性编辑、不提交/推送/部署/云端、无秘密、代理编写的任何内容中无AI归属。
  5. 数字检查和结尾的报告格式。
  6. 如果项目涉及安全敏感表面(登录、令牌、链接、Webhook、导出、租户边界),从 ${CLAUDE_PLUGIN_ROOT}/docs/security-review.md 中添加相关行作为带有测试的明确验收标准。
  7. 将简报输出为一个整体,准备好作为代理的提示。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

peterruiter/claude-build-framework

Full accessibility pass to WCAG 2.2 AA - axe-core through Playwright over every main page in light and dark at 1440/390 (and 320 for reflow), probes for skip link, one h1, lang, visible and unobscured focus, 24px targets and sideways scrolling, a keyboard script for dialogs/drawers/tabs, manual checks (text spacing, zoom, dragging alternatives, accessible authentication), contract tests for shared components and theme contrast, fixes, known limitations with reasons and an accessibility statement page. Use when the user asks for an "accessibility pass", "WCAG", "a11y audit", "screen reader", or before the first public release.

peterruiter/claude-build-framework

Check that every tool a profile needs is installed and recent enough (git, GitHub CLI, Node.js, npm, plus the profile's own - e.g. .NET SDK, PowerShell 7, Azure CLI, Power Platform CLI, LocalDB, k6) and give the exact install command per OS for anything missing. Runs automatically at the start of new-project and quality-gate. Use when the user says "check my tools", "what do I need to install", "is my machine ready", or when a command fails with "not recognized" / "command not found".

peterruiter/claude-build-framework

Build a sync from a SaaS product to customers' Dynamics 365 / Dataverse environments and Customer Insights - Journeys (multi-tenant app with admin consent and an application user, Web API upserts, contact matching, leads, timeline notes, custom triggers, marketing lists, deep links), tested against a stand-in and a marked sandbox. Use when the owner asks for a Dynamics 365, Dataverse, Power Platform or Customer Insights - Journeys integration.

peterruiter/claude-build-framework

Apply, switch or regenerate a project's design system (the one source of colours, fonts, logos, chart, email, document and video styles for every output), check its contrast in light and dark, and add a new design system to the framework from a Claude Design System artifact. Uses scripts/design-system.mjs to generate tokens.css, tokens.ts, a Fluent UI theme, a model-driven app theme, email and chart palettes, the video-tour brand block and an Office theme mapping. Use when the user says "design system", "apply the brand", "use our house style", "switch theme", "rebrand", "regenerate the tokens", "check contrast", or "add a design system".

相关技能