ForgeCode post-forge-feature 技能全解析：基于风格指南与硬性约束自动生成开发者向 Twitter/X 功能宣传帖

人工智能AI Agent代码智能体AI 应用CLI开发工具【免费下载链接】forgecodeAI enabled pair programmer for Claude, GPT, O Series, Grok, Deepseek, Gemini and 300 models项目地址https://gitcode.com/gh_mirrors/forge39/forgecode点击查看免费下载这篇指南以 ForgeCode 仓库中的 post-forge-feature 技能定义 及其配套 风格指南 为主体系统讲解 ForgeCode 如何通过技能Skill机制把一条关于新功能的技术内容加工为一条 280 字符以内、面向开发者的 Twitter/X 帖子。读完本文你将掌握该技能的三步工作流、七条硬性约束、写作风格与话题标签体系并能结合 ForgeCode 的源码级技能加载机制仓库解析、优先级、工具调用理解这类技能文件为何能被 Agent 自动发现与执行进而举一反三地编写自己的技能。一、技能是什么一个宣传文案生成器的自我描述在 ForgeCode 中post-forge-feature是一个典型的技能Skill。它的定义文件位于仓库根目录下的 .forge/skills/post-forge-feature/SKILL.md文件开头的 YAML frontmatter 就是它的自我描述--- name: post-forge-feature description: Generate a Twitter/X post highlighting a Forge feature. Use when the user asks to write a tweet, create a Twitter post, or promote a ForgeCode feature on social media. The post always accompanies an attached video demonstrating the feature. ---这两项字段在技能加载系统中承担关键作用name是技能的唯一标识description则既是给 Agent 的触发条件说明也是技能与用户请求匹配的依据。从源码看crates/forge_domain/src/skill.rs 中Skill结构体包含name、path、command即 Markdown 正文内容、description、resources技能目录下的资源文件列表五个字段而 crates/forge_repo/src/skill.rs 中的extract_skill函数使用gray_matter解析 frontmatter把name与description抽取出来组装成Skill实例Markdown 正文则作为command注入给 Agent。换句话说frontmatter 是技能被发现的入口正文才是技能真正执行的指令。技能的设计意图非常聚焦当用户说帮我写一条推文给某个 ForgeCode 功能发一条 Twitter 宣传帖时Agent 应当调用该技能产出一条配合演示视频使用的精炼帖子——因此它明确约定帖子总是伴随一段演示该功能的视频正文不需要事无巨细地描述功能细节展示的工作交给视频完成。二、源码视角技能如何被加载、匹配与调用要真正理解这个技能需要先看清 ForgeCode 的技能加载链路。从源码结构看技能来源有四类且在 crates/forge_repo/src/skill.rs 的注释中有明确说明来源目录约定说明内置技能Built-in内嵌于应用二进制仓库中可见 crates/forge_repo/src/skills/ 下的create-skill、execute-plan、github-pr-description全局自定义技能Global~/forge/skills/skill-name/SKILL.md用户级全局技能Agent 技能Agents~/.agents/skills/skill-name/SKILL.md随 Agent 分发的技能项目本地技能CWD./.forge/skills/skill-name/SKILL.md当前工作目录下的项目技能本文主角即此类当技能重名时加载优先级为CWD项目本地 Agents Global Built-in。也就是说项目仓库内的post-forge-feature可以覆盖全局同名技能。缺失的目录会被优雅跳过不影响其他来源的加载。加载完成的技能由 crates/forge_services/src/tool_services/skill.rs 中的ForgeSkillFetch服务对外提供fetch_skill按名精确查找与list_skills枚举全部两个接口且技能列表通过OnceCell缓存首次加载后不会重复读盘。对应的skill工具则把技能的 Markdown 正文作为指令注入当前会话让 Agent 按照技能内容执行任务。理解了这条链路就能明白本文主角post-forge-feature/SKILL.md之所以会被 Agent 自动采用正是因为它的description精确描述了触发场景而其正文Workflow、Key Constraints、Reference Files定义了执行细节。三、三步工作流从理解功能到定稿技能的正文主体是三条工作流步骤它把一次宣传帖的产出过程收敛为可复现的流程第 1 步理解功能Understand the feature使用工具阅读相关源码、文档或变更日志changelog并回答三个问题What does it do?——这个功能做什么When would a developer reach for it?——开发者什么时候会想到用它What pain does it remove?——它消除了什么痛点这一步决定了帖子是否成立只有先弄清开发者价值后续的写作约束才有落点。在 ForgeCode 的技能体系里先调研再执行是通用范式例如 create-plan 技能 也要求在制定计划前使用search、sem_search、read等工具深入阅读代码库并以filepath:line格式引用来源。第 2 步撰写帖子Craft the post严格按照 references/style-guide.md 中的约束撰写。风格指南是这份技能的灵魂下一节会展开详解。第 3 步提交审批Present for approval先把帖子展示给用户询问是否需要调整再最终定稿。这体现了技能设计对输出需人审的坚持——宣传文案代表产品形象Agent 不应当直接发布未经确认的内容。四、七条硬性约束把开发者友好变成可检查的规则技能正文用## Key Constraints列出七条不可违反的硬性规则它们共同定义了 ForgeCode 品牌在社交平台上的表达边界2-3 句话封顶整体适配约 280 字符的推文长度禁用填充式套话如 excited to announce、game changer、introducing 这类空洞表达一律禁止产品名必须用 ForgeCode不允许单独使用 Forge——品牌一致性被写入规则全帖禁止使用破折号em dash,--改用逗号、冒号或句号以开发者收益或解决的问题开头而不是以功能名称开头——先讲为什么再讲是什么视频已附带不要写 watch the video 或描述视频内容——避免与视频内容重复以相关话题标签行收尾标签需从风格指南中的批准清单选取。这些约束的组合效果是每条帖子都短、具体、以用户价值为先、无营销腔。它们也与风格指南中让功能自己说话Let the feature speak for itself的总基调一致。五、风格指南详解语气、词汇与结构模板配套的 风格指南 将抽象的风格要求拆解为可直接执行的选择清单。语气Tone直接、技术化由开发者写给开发者自信但不过度吹嘘让功能自己说话口语化而非公司腔像同行聊天不像公关通稿。词汇Vocabulary优先使用ForgeCode、agent、task、context、codebase、workflow使用短小主动语态的句子用具体名词代替抽象表述例如说 file watcher 而不是 intelligent monitoring capability。坚决避免单独用 Forge 指代产品任何位置的破折号--excited to announce、thrilled、proud to share 等情绪套话game changer、revolutionary、supercharge、unlock、seamlessly 等营销词被动语态如 it can be used to...非 Rust 开发者不理解的术语除非该功能本身就是 Rust 特性。结构模板Structure Template[问题陈述或开发者收益1 句] [功能是什么 / 如何工作1 句] [可选何时使用或一个具体例子1 句] #ForgeCode #[FeatureTag] #AICode注意标签行必须以#ForgeCode开头这是品牌的强制锚点。六、批准的话题标签体系帖子结尾必须带上#ForgeCode再从风格指南给出的批准清单中挑选 1-2 个最贴合主题的标签标签适用场景#AICode通用的 AI 辅助编程帖子#DevTools工具链与工作流改进#RustLangRust 专属功能#CLI命令行界面功能#CodeReview评审与 diff 相关功能#AgentsAgent 编排功能#ContextWindow上下文管理功能#Autocomplete代码补全功能标签不是装饰而是帖子被目标受众检索与传播的关键路径因此风格指南将其白名单化避免随意堆砌无关标签。七、示例帖子拆解四条可复用的表达范式风格指南提供了四个完整示例覆盖 ForgeCode 的四类典型功能是理解全部约束如何落地的直接样本自定义 AgentForgeCode lets you define custom agents for specific tasks: code review, refactoring, docs. Each agent gets its own system prompt and tool set. Less context noise, better results.#ForgeCode #Agents #DevToolsShell 集成ForgeCodes shell plugin tracks your terminal history and feeds relevant context to the agent. No more copy-pasting commands to explain what went wrong.#ForgeCode #CLI #DevTools多文件编辑ForgeCode can plan and apply changes across multiple files in a single task. Rename a type, update all call sites, fix the tests, done in one pass.#ForgeCode #AICode #DevTools上下文压缩Context compactionLong tasks no longer blow up the context window. ForgeCode automatically compacts older turns while keeping the essential state. Tasks that used to fail mid-way now run to completion.#ForgeCode #ContextWindow #AICode观察这四条示例可以发现共同规律第一句抛出开发者痛点或收益不再复制粘贴命令长任务不再撑爆上下文窗口第二句说明功能机制可选第三句给出具体场景最后以批准标签收尾全文无破折号、无营销套话、产品名一律为 ForgeCode。其中上下文压缩示例提到的机制与仓库 crates/forge_app/src/compact.rs 及 transformers 目录所实现的历史压缩逻辑相呼应也印证了先读源码再写帖这一步骤的实践价值。八、定稿前的检查清单技能把质量检查固化为可勾选的清单任何一条不满足都不能定稿2-3 句话适配约 280 字符无禁用套话无破折号em dash全文统一使用 ForgeCode以收益或问题开头而非功能名称不提及附带的视频以#ForgeCode 1-2 个相关标签结尾这份清单的价值在于它把好文案的主观判断转译成了可自动或半自动校验的客观条目Agent 在提交审批前即可自查。九、从 post-forge-feature 看技能编写范式这个技能文件本身就是 ForgeCode 技能规范的活教材frontmatter 中的name/description负责触发匹配正文用目标 → 工作流 → 约束 → 参考文件的结构组织指令对外部资料风格指南通过## Reference Files显式引用让 Agent 在动笔前先读取补充文档。仓库中其他技能遵循同样的范式例如 create-agent 技能 详细规定 Agent 文件的存放目录、frontmatter 字段与校验清单create-plan 技能 强制要求用校验脚本验证计划格式。如需为 ForgeCode 新增同类技能只需在项目.forge/skills/技能名/SKILL.md按此结构编写即可被 ForgeSkillRepository 自动发现并以项目本地优先级加载。十、小结post-forge-feature展示了 ForgeCode 技能机制的一个完整切片技能不仅是一段提示词而是一套包含触发条件、执行流程、硬性约束、风格规范与质量清单的复合指令。它把写一条开发者向推文这件事从依赖灵感的写作变成了可重复、可校验、可审阅的工程流程——先读懂功能与价值再按结构与词汇规则落笔最后经用户确认定稿。结合 Skill 数据模型 与 技能加载与解析实现你可以随时在仓库中查阅该技能的原始定义与底层机制并以此为模板为团队定制更多输出型技能。赞分享人工智能AI Agent代码智能体AI 应用CLI开发工具【免费下载链接】forgecodeAI enabled pair programmer for Claude, GPT, O Series, Grok, Deepseek, Gemini and 300 models项目地址https://gitcode.com/gh_mirrors/forge39/forgecode点击查看免费下载相关推荐xiaobei 智能体 Twitter/X 发布技能实战指南基于 camoufox-cli 的纯浏览器自动化发帖方案xiaobei 智能体 Twitter/X 发布技能实战指南基于 camoufox cli 的纯浏览器自动化发帖方案 导读 本文围绕 xiaobei为 OP人工智能AI Agent大模型AI 应用媒体生成IronClaw Reborn 功能开发指南基于 ProductSurface 契约构建 WebUI 特性与自动化能力IronClaw Reborn 功能开发指南基于 ProductSurface 契约构建 WebUI 特性与自动化能力 本文是 IronClaw面向隐私、安人工智能AI 应用交互助手AI AgentFairseq 词法受限解码Lexically Constrained Decoding完全指南基于动态束分配的向量化约束生成Fairseq 词法受限解码Lexically Constrained Decoding完全指南基于动态束分配的向量化约束生成 导读 本篇技术指南围绕 F人工智能深度学习预训练NLP语音上一篇CameraManager性能优化提升iOS相机应用响应速度的10个技巧下一篇Fluor: macOS上的Fn键智能切换工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考