The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs: salvage zh-CN core skill translations
Affaan Mustafa3242ed461fda
diff --git a/docs/zh-CN/skills/automation-audit-ops/SKILL.md b/docs/zh-CN/skills/automation-audit-ops/SKILL.mdnew file mode 100644index 000000000..9e7787d34--- /dev/null+++ b/docs/zh-CN/skills/automation-audit-ops/SKILL.md@@ -0,0 +1,142 @@+---+name: automation-audit-ops+description: 面向ECC的以证据为先的自动化清单与重叠审计工作流。当用户希望在修复任何内容之前了解哪些作业、钩子、连接器、MCP服务器或包装器是活跃的、损坏的、冗余的或缺失时使用。+origin: ECC+---++# 自动化审计运维++当用户询问哪些自动化正在运行、哪些任务出现故障、哪里存在重叠,或者哪些工具和连接器当前正在实际发挥作用时,请使用此技能。++这是一项以审计为先的操作技能。其任务是在重写任何内容之前,生成一份有证据支持的清单以及一套保留/合并/删除/下一步修复的建议集。++## 技能栈++在相关时,将这些 ECC 原生技能引入工作流程:++* `workspace-surface-audit` 用于连接器、MCP、钩子和应用清单+* `knowledge-ops` 当审计需要将实时仓库的真实情况与持久上下文进行核对时+* `github-ops` 当答案依赖于 CI、计划工作流、议题或 PR 自动化时+* `ecc-tools-cost-audit` 当真正的问题是兄弟应用仓库中的 webhook 扇出、队列任务或计费消耗时+* `research-ops` 当需要将本地清单与当前平台支持或公开文档进行比较时+* `verification-loop` 用于证明修复后的状态,而不是依赖假设的恢复++## 使用时机++* 用户询问"我有哪些自动化"、"什么在运行"、"什么出故障了"或"什么重叠了"+* 任务涉及 cron 任务、GitHub Actions、本地钩子、MCP 服务器、连接器、包装器或应用集成+* 用户想知道从其他代理系统移植了什么,以及哪些还需要在 ECC 内部重建+* 工作区积累了多种执行同一任务的方式,用户希望有一条规范的路径++## 防护栏++* 除非用户明确要求修复,否则以只读方式开始+* 区分:+ * 已配置+ * 已验证身份+ * 最近已验证+ * 过时或损坏+ * 完全缺失+* 不要仅仅因为某个技能或配置引用了某个工具,就声称该工具正在运行+* 在证据表存在之前,不要合并或删除重叠的表面++## 工作流程++### 1. 盘点真实表面++在理论化之前,先读取当前的实时表面:++* 仓库钩子和本地钩子脚本+* GitHub Actions 和计划工作流+* MCP 配置和已启用的服务器+* 基于连接器或应用的集成+* 包装器脚本和特定仓库的自动化入口点++按表面分组:++* 本地运行时+* 仓库 CI / 自动化+* 连接的外部系统+* 消息传递 / 通知+* 计费 / 客户运营+* 研究 / 监控++### 2. 按实时状态对每个项目进行分类++对于每个发现的自动化,标记:++* 已配置+* 已验证身份+* 最近已验证+* 过时或损坏+* 缺失++然后对问题类型进行分类:++* 活动故障+* 身份验证中断+* 状态过时+* 重叠或冗余+* 功能缺失++### 3. 追溯证据路径++为每个重要声明提供具体来源:++* 文件路径+* 工作流运行+* 钩子日志+* 配置条目+* 最近的命令输出+* 确切的故障特征++如果当前状态不明确,请直接说明,而不是假装审计已完成。++### 4. 以保留 / 合并 / 删除 / 下一步修复结束++对于每个重叠或可疑的表面,返回一个决策:++* 保留+* 合并+* 删除+* 下一步修复++其价值在于将杂乱的自动化整合到一条规范的 ECC 路径中,而不是保留每一条历史路径。++## 输出格式++```text+当前表面+- 自动化+- 来源+- 实时状态+- 证据++发现+- 活跃故障+- 重叠+- 过时状态+- 缺失能力++建议+- 保留+- 合并+- 删除+- 下次修复++下一步ECC行动+- 需加强的具体技能/钩子/工作流/应用通道+```++## 常见陷阱++* 当可以读取实时清单时,不要凭记忆回答+* 不要将"配置中存在"视为"正在工作"+* 在指出故障的高信号路径之前,不要修复低价值的冗余+* 如果用户首先要求的是清单,不要将任务扩大为仓库重写++## 验证++* 重要声明需引用实时证据路径+* 每个发现的自动化都需标有清晰的实时状态类别+* 最终建议需区分保留 / 合并 / 删除 / 下一步修复diff --git a/docs/zh-CN/skills/click-path-audit/SKILL.md b/docs/zh-CN/skills/click-path-audit/SKILL.mdnew file mode 100644index 000000000..a7ceba3f6--- /dev/null+++ b/docs/zh-CN/skills/click-path-audit/SKILL.md@@ -0,0 +1,257 @@+---+name: click-path-audit+description: "追踪每个面向用户的按钮/触点的完整状态变化序列,以发现功能单独工作但相互抵消、产生错误最终状态或使UI处于不一致状态的错误。适用于:系统调试未发现错误但用户报告按钮失效,或在任何涉及共享状态存储的重大重构之后。"+origin: community+---++# /click-path-audit — 行为流审计++发现静态代码审查遗漏的缺陷:状态交互副作用、顺序调用间的竞态条件,以及相互静默撤销的处理程序。++## 解决的问题++传统调试检查:++* 函数是否存在?(缺少连接)+* 是否崩溃?(运行时错误)+* 是否返回正确类型?(数据流)++但未检查:++* **最终 UI 状态是否与按钮标签承诺一致?**+* **函数 B 是否静默撤销了函数 A 刚刚执行的操作?**+* **共享状态(Zustand/Redux/context)是否存在抵消预期操作的副作用?**++真实案例:一个"新邮件"按钮依次调用了 `setComposeMode(true)` 和 `selectThread(null)`。两者单独工作正常。但 `selectThread` 有一个副作用重置了 `composeMode: false`。按钮毫无反应。系统化调试发现了 54 个缺陷——这个被遗漏了。++***++## 工作原理++针对目标区域内的每个交互触点:++```+1. 识别处理函数(onClick、onSubmit、onChange 等)+2. 按顺序追踪处理函数中的每个函数调用+3. 对于每个函数调用:+ a. 它读取了哪些状态?+ b. 它写入了哪些状态?+ c. 它是否对共享状态产生了副作用?+ d. 它是否作为副作用重置/清除了任何状态?+4. 检查:后续调用是否会撤销前面调用的状态变更?+5. 检查:最终状态是否符合用户对按钮标签的预期?+6. 检查:是否存在竞态条件(异步调用以错误顺序解析)?+```++***++## 执行步骤++### 步骤 1:映射状态存储++在审计任何触点之前,构建每个状态存储操作的副作用映射:++```+对于作用域内的每个 Zustand 存储 / React 上下文:+ 对于每个操作/设置器:+ - 它设置了哪些字段?+ - 它是否作为副作用重置了其他字段?+ - 文档:actionName → {sets: [...], resets: [...]}+```++这是关键参考。"新邮件"缺陷在不知道 `selectThread` 重置了 `composeMode` 的情况下是不可见的。++**输出格式:**++```+STORE: emailStore+ setComposeMode(bool) → 设置: {composeMode}+ selectThread(thread|null) → 设置: {selectedThread, selectedThreadId, messages, drafts, selectedDraft, summary} 重置: {composeMode: false, composeData: null, redraftOpen: false}+ setDraftGenerating(bool) → 设置: {draftGenerating}+ ...++危险的重置(清除不属于自身状态的操作):+ selectThread → 重置 composeMode(由 setComposeMode 拥有)+ reset → 重置所有内容+```++### 步骤 2:审计每个触点++针对目标区域内的每个按钮/开关/表单提交:++```+TOUCHPOINT: [按钮标签] 在 [组件:行]+ HANDLER: onClick → {+ 调用 1: functionA() → 设置 {X: true}+ 调用 2: functionB() → 设置 {Y: null} 重置 {X: false} ← 冲突+ }+ EXPECTED: 用户看到 [按钮标签所承诺的描述]+ ACTUAL: X 为 false,因为 functionB 重置了它+ VERDICT: BUG — [描述]+```++**检查以下每种缺陷模式:**++#### 模式 1:顺序撤销++```+handler() {+ setState_A(true) // 设置 X = true+ setState_B(null) // 副作用:重置 X = false+}+// 结果:X 为 false。第一次调用毫无意义。+```++#### 模式 2:异步竞态++```+handler() {+ fetchA().then(() => setState({ loading: false }))+ fetchB().then(() => setState({ loading: true }))+}+// 结果:最终的 loading 状态取决于哪个先完成+```++#### 模式 3:过期闭包++```+const [count, setCount] = useState(0)+const handler = useCallback(() => {+ setCount(count + 1) // 捕获了过时的 count+ setCount(count + 1) // 同样的过时 count — 只增加 1,而不是 2+}, [count])+```++#### 模式 4:缺失状态转换++```+// 按钮显示"保存",但处理程序仅验证,从未实际保存+// 按钮显示"删除",但处理程序设置了一个标志而未调用API+// 按钮显示"发送",但API端点已被移除/损坏+```++#### 模式 5:条件死路径++```+handler() {+ if (someState) { // 此时 someState 始终为 false+ doTheActualThing() // 永远不会执行到+ }+}+```++#### 模式 6:useEffect 干扰++```+// Button 设置 stateX = true+// useEffect 监听 stateX 并将其重置为 false+// 用户看不到任何变化+```++### 步骤 3:报告++针对发现的每个缺陷:++```+CLICK-PATH-NNN: [严重性: 严重/高/中/低]+ 触点: [按钮标签] 位于 [文件:行号]+ 模式: [顺序撤销 / 异步竞态 / 过期闭包 / 缺失过渡 / 死路径 / useEffect 干扰]+ 处理函数: [函数名或内联]+ 追踪:+ 1. [调用] → 设置 {字段: 值}+ 2. [调用] → 重置 {字段: 值} ← 冲突+ 预期: [用户期望的结果]+ 实际: [实际发生的结果]+ 修复: [具体修复方案]+```++***++## 范围控制++此审计成本较高。请适当限定范围:++* **全应用审计:** 在发布或重大重构后使用。按页面启动并行代理。+* **单页面审计:** 在构建新页面或用户报告按钮失效后使用。+* **存储聚焦审计:** 在修改 Zustand 存储后使用——审计所有使用已更改操作的消费者。++### 全应用推荐的代理拆分:++```+Agent 1:映射所有状态存储(步骤 1)——这是所有其他代理的共享上下文+Agent 2:仪表盘(任务、笔记、日志、想法)+Agent 3:聊天(DanteChatColumn、JustChatPage)+Agent 4:邮件(ThreadList、DraftArea、EmailsPage)+Agent 5:项目(ProjectsPage、ProjectOverviewTab、NewProjectWizard)+Agent 6:CRM(所有子标签页)+Agent 7:个人资料、设置、保险库、通知+Agent 8:管理套件(所有页面)+```++代理 1 必须首先完成。其输出是所有其他代理的输入。++***++## 何时使用++* 系统化调试发现"无缺陷"但用户报告 UI 失效后+* 修改任何 Zustand 存储操作后(检查所有调用者)+* 任何涉及共享状态的重构后+* 发布前,针对关键用户流程+* 当按钮"无反应"时——这是解决该问题的工具++## 何时不使用++* 针对 API 级别缺陷(错误的响应结构、缺失端点)——使用系统化调试+* 针对样式/布局问题——视觉检查+* 针对性能问题——性能分析工具++***++## 与其他技能的集成++* 在 `/superpowers:systematic-debugging`(发现其他 54 种缺陷类型)之后运行+* 在 `/superpowers:verification-before-completion`(验证修复是否有效)之前运行+* 反馈至 `/superpowers:test-driven-development`——此处发现的每个缺陷都应添加测试++***++## 示例:启发此技能的缺陷++**ThreadList.tsx "新邮件"按钮:**++```+onClick={() => {+ useEmailStore.getState().setComposeMode(true) // ✓ 设置 composeMode = true+ useEmailStore.getState().selectThread(null) // ✗ 重置 composeMode = false+}}+```++存储定义:++```+selectThread: (thread) => set({+ selectedThread: thread,+ selectedThreadId: thread?.id ?? null,+ messages: [],+ drafts: [],+ selectedDraft: null,+ summary: null,+ composeMode: false, // ← 这个静默重置导致按钮失效+ composeData: null,+ redraftOpen: false,+})+```++**系统化调试遗漏了它**,因为:++* 按钮有 onClick 处理程序(未失效)+* 两个函数都存在(无缺失连接)+* 两个函数均未崩溃(无运行时错误)+* 数据类型正确(无类型不匹配)++**点击路径审计捕获了它**,因为:++* 步骤 1 映射出 `selectThread` 重置了 `composeMode`+* 步骤 2 追踪处理程序:调用 1 设置为 true,调用 2 重置为 false+* 判定:顺序撤销——最终状态与按钮意图矛盾diff --git a/docs/zh-CN/skills/code-tour/SKILL.md b/docs/zh-CN/skills/code-tour/SKILL.mdnew file mode 100644index 000000000..70ac08b29--- /dev/null+++ b/docs/zh-CN/skills/code-tour/SKILL.md@@ -0,0 +1,244 @@+---+name: code-tour+description: 创建 CodeTour `.tour` 文件——针对特定角色的、带有真实文件和行锚点的逐步演练。用于入职引导、架构演练、PR 演练、RCA 演练以及结构化的“解释其工作原理”请求。+origin: ECC+---++# 代码导览++创建 **CodeTour** `.tour` 文件,用于代码库导览,可直接打开真实文件并定位到指定行范围。导览文件存放在 `.tours/` 目录中,专为 CodeTour 格式设计,而非临时性的 Markdown 笔记。++一个好的导览应针对特定读者讲述一个故事:++* 他们正在查看什么+* 为什么重要+* 接下来应该遵循什么路径++仅创建 `.tour` JSON 文件。不要在此技能范围内修改源代码。++## 何时使用++在以下情况下使用此技能:++* 用户请求代码导览、入职导览、架构导览或 PR 导览+* 用户说“解释 X 如何工作”,并希望获得可重用的引导式产物+* 用户希望为新工程师或审阅者提供上手路径+* 相比平铺直叙的摘要,引导式序列更适合该任务++示例:++* 新维护者入职+* 单个服务或包的架构导览+* 锚定到变更文件的 PR 审查导览+* 展示故障路径的根本原因分析导览+* 信任边界和关键检查的安全审查导览++## 何时不使用++| 不使用代码导览的情况 | 使用 |+| --- | --- |+| 在聊天中一次性解释就足够了 | 直接回答 |+| 用户想要散文式文档,而不是 `.tour` 产物 | `documentation-lookup` 或仓库文档编辑 |+| 任务是实现或重构 | 执行实现工作 |+| 任务是没有导览产物的广泛代码库入职 | `codebase-onboarding` |++## 工作流程++### 1. 探索++在编写任何内容之前探索仓库:++* README 和包/应用入口点+* 文件夹结构+* 相关配置文件+* 如果导览聚焦于 PR,则查看变更的文件++在理解代码结构之前,不要开始编写步骤。++### 2. 推断读者++根据请求确定角色和深度。++| 请求形式 | 角色 | 建议深度 |+| --- | --- | --- |+| "入职","新成员" | `new-joiner` | 9-13 步 |+| "快速导览","快速了解" | `vibecoder` | 5-8 步 |+| "架构" | `architect` | 14-18 步 |+| "导览此 PR" | `pr-reviewer` | 7-11 步 |+| "为什么这个出错了" | `rca-investigator` | 7-11 步 |+| "安全审查" | `security-reviewer` | 7-11 步 |+| "解释此功能如何工作" | `feature-explainer` | 7-11 步 |+| "调试此路径" | `bug-fixer` | 7-11 步 |++### 3. 读取并验证锚点++每个文件路径和行锚点必须是真实的:++* 确认文件存在+* 确认行号在范围内+* 如果使用选区,验证确切的代码块+* 如果文件易变,优先使用基于模式的锚点++切勿猜测行号。++### 4. 编写 `.tour`++写入:++```text+.tours/<persona>-<focus>.tour+```++保持路径确定且可读。++### 5. 验证++在完成之前:++* 每个引用的路径都存在+* 每行或每个选区都有效+* 第一步锚定到真实文件或目录+* 导览讲述连贯的故事,而非罗列文件++## 步骤类型++### 内容++谨慎使用,通常仅用于结束步骤:++```json+{ "title": "Next Steps", "description": "You can now trace the request path end to end." }+```++不要将第一步设为纯内容。++### 目录++用于引导读者了解模块:++```json+{ "directory": "src/services", "title": "Service Layer", "description": "The core orchestration logic lives here." }+```++### 文件 + 行++这是默认步骤类型:++```json+{ "file": "src/auth/middleware.ts", "line": 42, "title": "Auth Gate", "description": "Every protected request passes here first." }+```++### 选区++当某个代码块比整个文件更重要时使用:++```json+{+ "file": "src/core/pipeline.ts",+ "selection": {+ "start": { "line": 15, "character": 0 },+ "end": { "line": 34, "character": 0 }+ },+ "title": "Request Pipeline",+ "description": "This block wires validation, auth, and downstream execution."+}+```++### 模式++当精确行号可能发生变化时使用:++```json+{ "file": "src/app.ts", "pattern": "export default class App", "title": "Application Entry" }+```++### URI++在需要时用于 PR、问题或文档:++```json+{ "uri": "https://github.com/org/repo/pull/456", "title": "The PR" }+```++## 编写规则:SMIG++每个描述应回答:++* **情境**:读者正在查看什么+* **机制**:它是如何工作的+* **影响**:为什么对此角色重要+* **陷阱**:聪明的读者可能会错过什么++保持描述简洁、具体,并基于实际代码。++## 叙事结构++除非任务明确需要不同结构,否则使用此弧线:++1. 定位+2. 模块地图+3. 核心执行路径+4. 边缘情况或陷阱+5. 结束 / 下一步++导览应感觉像一条路径,而非清单。++## 示例++```json+{+ "$schema": "https://aka.ms/codetour-schema",+ "title": "API Service Tour",+ "description": "Walkthrough of the request path for the payments service.",+ "ref": "main",+ "steps": [+ {+ "directory": "src",+ "title": "Source Root",+ "description": "All runtime code for the service starts here."+ },+ {+ "file": "src/server.ts",+ "line": 12,+ "title": "Entry Point",+ "description": "The server boots here and wires middleware before any route is reached."+ },+ {+ "file": "src/routes/payments.ts",+ "line": 8,+ "title": "Payment Routes",+ "description": "Every payments request enters through this router before hitting service logic."+ },+ {+ "title": "Next Steps",+ "description": "You can now follow any payment request end to end with the main anchors in place."+ }+ ]+}+```++## 反模式++| 反模式 | 修复 |+| --- | --- |+| 平铺直叙的文件列表 | 讲述一个步骤间有依赖关系的故事 |+| 通用描述 | 指明具体的代码路径或模式 |+| 猜测的锚点 | 先验证每个文件和行 |+| 快速导览步骤过多 | 果断精简 |+| 第一步是纯内容 | 将第一步锚定到真实文件或目录 |+| 角色不匹配 | 为实际读者编写,而非通用工程师 |++## 最佳实践++* 步骤数量与仓库大小和角色深度成比例+* 使用目录步骤进行定位,文件步骤用于实质内容+* 对于 PR 导览,首先覆盖变更的文件+* 对于单体仓库,将范围限定在相关包,而非导览所有内容+* 以读者现在可以做什么来结束,而非总结++## 相关技能++* `codebase-onboarding`+* `coding-standards`+* `council`+* 官方上游格式:`microsoft/codetour`diff --git a/docs/zh-CN/skills/ecc-tools-cost-audit/SKILL.md b/docs/zh-CN/skills/ecc-tools-cost-audit/SKILL.mdnew file mode 100644index 000000000..e6ca1540d--- /dev/null+++ b/docs/zh-CN/skills/ecc-tools-cost-audit/SKILL.md@@ -0,0 +1,160 @@+---+name: ecc-tools-cost-audit+description: 证据优先的ECC工具燃烧和计费审计工作流。用于调查ECC工具仓库中的失控PR创建、配额绕过、高级模型泄漏、重复作业或GitHub App成本激增。+origin: ECC+---++# ECC 工具成本审计++当用户怀疑 ECC Tools GitHub App 正在消耗成本、过度创建 PR、绕过使用限制,或将免费用户引导至付费分析路径时,使用此技能。++这是一个针对兄弟仓库 [ECC-Tools](../../../../ECC-Tools) 的聚焦操作者工作流。它不是通用的计费技能,也不是仓库范围的代码审查。++## 技能栈++在相关情况下,将这些 ECC 原生技能拉入工作流:++* `autonomous-loops` 用于跨 webhook、队列、计费和重试的有界多步骤审计+* `agentic-engineering` 用于将请求路径追踪为离散的、可证明的单元+* `customer-billing-ops` 当需要清晰分离仓库行为和客户影响计算时+* `search-first` 在发明辅助函数或重新实现仓库本地工具之前+* `security-review` 当涉及认证、使用限制、授权或密钥时+* `verification-loop` 用于证明重试安全性和精确的修复后状态+* `tdd-workflow` 当修复需要在 worker、路由器或计费路径中添加回归测试覆盖时++## 使用时机++* 用户提及 ECC Tools 消耗率、PR 递归、过度创建的 PR、使用限制绕过或付费模型泄漏+* 任务位于兄弟仓库 `ECC-Tools` 中,并依赖于 webhook 处理器、队列 worker、使用预留、PR 创建逻辑或付费网关强制执行+* 客户报告称应用创建了过多 PR、计费错误,或分析了代码但未产生可用结果++## 范围约束++* 在兄弟仓库 `ECC-Tools` 中工作,而非 `everything-claude-code`+* 除非用户明确要求修复,否则以只读方式开始+* 在追踪分析消耗时,不要修改无关的计费、结账或 UI 流程+* 将应用生成的分支和应用生成的 PR 视为红旗递归路径,除非被证明并非如此+* 明确区分三件事:+ * 仓库侧消耗的根本原因+ * 面向客户的计费影响+ * 需要纳入待办事项跟踪的产品或授权缺口++## 工作流++### 1. 冻结仓库范围++* 切换到兄弟仓库 `ECC-Tools`+* 首先检查分支和本地差异+* 确定审计的具体范围:+ * webhook 路由器+ * 队列生产者+ * 队列消费者+ * PR 创建路径+ * 使用预留 / 计费路径+ * 模型路由路径++### 2. 在理论化之前追踪入口++* 首先检查 `src/index.*` 或主入口点+* 在提出修复建议之前,映射每个入队路径+* 确认哪些 GitHub 事件共享一个队列类型+* 确认 push、pull\_request、synchronize、comment 或手动重新运行事件是否会汇聚到同一个昂贵的路径上++### 3. 追踪 Worker 和副作用++* 检查处理分析的队列消费者或定时 worker+* 确认排队的分析是否总是以以下方式结束:+ * PR 创建+ * 分支创建+ * 文件更新+ * 付费模型调用+ * 使用量增加+* 如果分析可能消耗令牌,然后在输出持久化之前失败,则将其归类为“消耗但输出中断”++### 4. 审计高信号消耗路径++#### PR 倍增++* 检查 PR 辅助函数和分支命名+* 检查去重、synchronize 事件处理以及现有 PR 的复用+* 如果应用生成的分支可以重新进入分析,则将其视为优先级为 0 的递归风险++#### 配额绕过++* 检查配额检查的位置与使用量预留或增加的位置+* 如果在入队前检查配额,但仅在 worker 内部计费使用量,则将并发的前门通过视为真正的竞态条件++#### 付费模型泄漏++* 检查模型选择、层级分支和提供商路由+* 验证当存在付费密钥时,免费或受限用户是否仍能访问付费分析器++#### 重试消耗++* 检查重试循环、重复的队列任务和确定性失败重试+* 如果相同的非临时性错误可以反复消耗分析资源,则先修复此问题,再进行质量改进++### 5. 按消耗顺序修复++如果用户要求代码更改,请按以下顺序优先修复:++1. 阻止自动 PR 倍增+2. 阻止配额绕过+3. 阻止付费模型泄漏+4. 阻止重复任务扇出和无意义的重试+5. 弥补重试/更新安全缺口++除非同一根本原因明显跨越多个文件,否则将修复范围限制在一到三个直接修复。++### 6. 以最小的验证步骤进行验证++* 仅重新运行覆盖已更改路径的目标测试或集成片段+* 验证消耗路径现在是否:+ * 被阻止+ * 已去重+ * 降级为更便宜的分析+ * 或提前被拒绝+* 准确说明最终状态:+ * 本地已更改+ * 本地已验证+ * 已推送+ * 已部署+ * 仍被阻止++## 高信号故障模式++### 1. 所有触发器使用同一队列类型++如果推送、PR 同步和手动审计都入队相同的任务,并且 worker 总是创建 PR,那么分析就等于 PR 垃圾信息。++### 2. 入队后预留使用量++如果在入口处检查使用量,但仅在 worker 中增加,则并发请求可能全部通过关卡并超出配额。++### 3. 免费层级走付费路径++如果存在密钥时,免费的排队任务仍能路由到 Anthropic 或其他付费提供商,即使客户从未看到付费结果,这也是真实的支出泄漏。++### 4. 应用生成的分支重新进入 Webhook++如果 `pull_request.synchronize`、分支推送或评论触发的运行在应用拥有的分支上触发,则应用可以递归分析自己的输出。++### 5. 在持久化安全之前执行昂贵操作++如果系统可能消耗令牌,然后在 PR 创建、文件更新或分支冲突时失败,则是在消耗成本而不产生价值。++## 陷阱++* 不要一开始就广泛浏览仓库;先确定 webhook -> 队列 -> worker 的路径+* 不要将客户计费推断与基于代码的产品事实混为一谈+* 在最高消耗路径被控制之前,不要修复价值较低的质量问题+* 在重新运行狭窄的验证步骤之前,不要声称消耗问题已修复+* 除非用户要求,否则不要推送或部署+* 如果无关的仓库本地更改正在进行中,不要触碰它们++## 验证++* 根本原因需引用确切的文件路径和代码区域+* 修复按消耗影响排序,而非代码整洁度+* 需指明验证命令的名称+* 最终状态需区分本地更改、验证、推送和部署diff --git a/docs/zh-CN/skills/gateguard/SKILL.md b/docs/zh-CN/skills/gateguard/SKILL.mdnew file mode 100644index 000000000..7da52bf68--- /dev/null+++ b/docs/zh-CN/skills/gateguard/SKILL.md@@ -0,0 +1,123 @@+---+name: gateguard+description: 强制事实的门控,阻止编辑/写入/Bash(包括MultiEdit),并要求在允许操作之前进行具体调查(导入器、数据模式、用户指令)。与无门控代理相比,可测量地将输出质量提高2.25分。+origin: community+---++# GateGuard — 事实驱动的前置操作门控++一个 PreToolUse 钩子,强制 Claude 在编辑前进行调查。不同于自我评估("你确定吗?"),它要求具体的事实。调查行为本身创造了自我评估永远无法带来的认知。++## 何时激活++* 处理任何文件编辑会影响多个模块的代码库时+* 项目包含具有特定模式或日期格式的数据文件时+* 团队要求 AI 生成的代码必须匹配现有模式时+* 任何 Claude 倾向于猜测而非调查的工作流程中++## 核心概念++LLM 的自我评估不起作用。问"你是否违反了任何策略?"答案永远是"没有"。这已通过实验验证。++但问"列出所有导入此模块的文件"会迫使 LLM 运行 Grep 和 Read。调查本身创造了改变输出的上下文。++**三阶段门控:**++```+1. DENY — 阻止首次编辑/写入/Bash 尝试+2. FORCE — 明确告知模型需要收集哪些事实+3. ALLOW — 在事实呈现后允许重试+```++没有竞争对手能同时做到这三步。大多数止步于拒绝。++## 证据++两个独立的 A/B 测试,相同的代理,相同的任务:++| 任务 | 有门控 | 无门控 | 差距 |+| --- | --- | --- | --- |+| 分析模块 | 8.0/10 | 6.5/10 | +1.5 |+| Webhook 验证器 | 10.0/10 | 7.0/10 | +3.0 |+| **平均** | **9.0** | **6.75** | **+2.25** |++两个代理生成的代码都能运行并通过测试。区别在于设计深度。++## 门控类型++### 编辑/多编辑门控(每个文件的首次编辑)++多编辑的处理方式相同——批次中的每个文件都单独进行门控。++```+在编辑 {file_path} 之前,请先呈现以下事实:++1. 列出所有导入/引用此文件的文件(使用 Grep)+2. 列出受此更改影响的公共函数/类+3. 如果此文件读取/写入数据文件,请显示字段名称、结构以及日期格式(使用脱敏或合成值,而非原始生产数据)+4. 逐字引用用户当前的指令+```++### 写入门控(首次创建新文件)++```+在创建 {file_path} 之前,请先说明以下事实:++1. 命名将调用此新文件的文件及行号+2. 确认没有现有文件具有相同功能(使用 Glob)+3. 如果此文件读取/写入数据文件,请展示字段名称、结构及日期格式(使用脱敏或合成值,而非原始生产数据)+4. 逐字引用用户当前的指令+```++### 破坏性 Bash 门控(每个破坏性命令)++触发条件:`rm -rf`、`git reset --hard`、`git push --force`、`drop table` 等。++```+1. 列出此命令将修改或删除的所有文件/数据+2. 编写一行回滚步骤+3. 逐字引用用户当前的指令+```++### 常规 Bash 门控(每个会话一次)++```+1. 当前用户请求的一句话概括+2. 此特定命令验证或生成的内容+```++## 快速开始++### 选项 A:使用 ECC 钩子(零安装)++`scripts/hooks/gateguard-fact-force.js` 处的钩子已包含在此插件中。通过 hooks.json 启用它。++如果 GateGuard 阻止了设置或修复工作,请使用+`ECC_GATEGUARD=off` 启动会话。如需钩子级别的控制,请继续使用+`ECC_DISABLED_HOOKS` 配合 GateGuard 钩子 ID。++### 选项 B:带配置的完整包++```bash+pip install gateguard-ai+gateguard init+```++这会添加 `.gateguard.yml` 用于按项目配置(自定义消息、忽略路径、门控开关)。++## 反模式++* **不要使用自我评估替代。** "你确定吗?"总是得到"确定。"这已通过实验验证。+* **不要跳过数据模式检查。** 两个 A/B 测试代理都假设了 ISO-8601 日期,而实际数据使用的是 `%Y/%m/%d %H:%M`。检查数据结构(使用脱敏值)可以防止这类错误。+* **不要对每个 Bash 命令都进行门控。** 常规 bash 门控每个会话一次。破坏性 bash 门控每次执行。这种平衡避免了速度下降,同时捕获了真正的风险。++## 最佳实践++* 让门控自然触发。不要试图预先回答门控问题——调查本身才是提高质量的关键。+* 为你的领域自定义门控消息。如果你的项目有特定约定,请将其添加到门控提示中。+* 使用 `.gateguard.yml` 忽略 `.venv/`、`node_modules/`、`.git/` 等路径。++## 相关技能++* `safety-guard` — 运行时安全检查(互补,不重叠)+* `code-reviewer` — 编辑后审查(GateGuard 是编辑前调查)diff --git a/docs/zh-CN/skills/git-workflow/SKILL.md b/docs/zh-CN/skills/git-workflow/SKILL.mdnew file mode 100644index 000000000..7de224a5e--- /dev/null+++ b/docs/zh-CN/skills/git-workflow/SKILL.md@@ -0,0 +1,720 @@+---+name: git-workflow+description: Git工作流模式,包括分支策略、提交约定、合并与变基、冲突解决以及适用于各种规模团队的协作开发最佳实践。+origin: ECC+---++# Git 工作流模式++Git 版本控制、分支策略与协作开发的最佳实践。++## 何时启用++* 为新项目设置 Git 工作流+* 决定分支策略(GitFlow、主干开发、GitHub Flow)+* 编写提交信息和 PR 描述+* 解决合并冲突+* 管理发布和版本标签+* 让新团队成员熟悉 Git 实践++## 分支策略++### GitHub Flow(简单,推荐大多数场景使用)++最适合持续部署以及中小型团队。++```+main (protected, always deployable)+ │+ ├── feature/user-auth → PR → merge to main+ ├── feature/payment-flow → PR → merge to main+ └── fix/login-bug → PR → merge to main+```++**规则:**++* `main` 始终可部署+* 从 `main` 创建功能分支+* 准备就绪后发起 Pull Request+* 审核通过且 CI 通过后,合并到 `main`+* 合并后立即部署++### 主干开发(高速度团队)++最适合具备强大 CI/CD 和功能开关的团队。++```+main (主干)+ │+ ├── 短期功能分支(最长1-2天)+ ├── 短期功能分支+ └── 短期功能分支+```++**规则:**++* 所有人直接提交到 `main` 或使用极短生命周期的分支+* 功能开关隐藏未完成的工作+* 合并前必须通过 CI+* 每天多次部署++### GitFlow(复杂,基于发布周期)++适合计划性发布和企业级项目。++```+main (生产发布版本)+ │+ └── develop (集成分支)+ │+ ├── feature/user-auth+ ├── feature/payment+ │+ ├── release/1.0.0 → 合并到 main 和 develop+ │+ └── hotfix/critical → 合并到 main 和 develop+```++**规则:**++* `main` 仅包含生产就绪代码+* `develop` 是集成分支+* 功能分支从 `develop` 创建,合并回 `develop`+* 发布分支从 `develop` 创建,合并到 `main` 和 `develop`+* 热修复分支从 `main` 创建,合并到 `main` 和 `develop`++### 何时使用哪种策略++| 策略 | 团队规模 | 发布频率 | 最佳适用场景 |+|----------|-----------|-----------------|----------|+| GitHub Flow | 任意 | 持续 | SaaS、Web 应用、初创公司 |+| 主干开发 | 5 人以上有经验 | 每天多次 | 高速度团队、功能开关 |+| GitFlow | 10 人以上 | 计划性 | 企业、受监管行业 |++## 提交信息++### 常规提交格式++```+<type>(<scope>): <subject>++[optional body]++[optional footer(s)]+```++### 类型++| 类型 | 用途 | 示例 |+|------|---------|---------|+| `feat` | 新功能 | `feat(auth): add OAuth2 login` |+| `fix` | 错误修复 | `fix(api): handle null response in user endpoint` |+| `docs` | 文档 | `docs(readme): update installation instructions` |+| `style` | 格式调整,无代码变更 | `style: fix indentation in login component` |+| `refactor` | 代码重构 | `refactor(db): extract connection pool to module` |+| `test` | 添加/更新测试 | `test(auth): add unit tests for token validation` |+| `chore` | 维护任务 | `chore(deps): update dependencies` |+| `perf` | 性能改进 | `perf(query): add index to users table` |+| `ci` | CI/CD 变更 | `ci: add PostgreSQL service to test workflow` |+| `revert` | 回滚之前的提交 | `revert: revert "feat(auth): add OAuth2 login"` |++### 好与坏的示例++```+# 不好:模糊,无上下文+git commit -m "修复了一些东西"+git commit -m "更新"+git commit -m "进行中"++# 好:清晰,具体,解释原因+git commit -m "fix(api): 在 503 服务不可用时重试请求++外部 API 在高峰时段偶尔会返回 503 错误。+添加了指数退避重试逻辑,最多尝试 3 次。++关闭 #123"+```++### 提交信息模板++在仓库根目录创建 `.gitmessage`:++```+# <type>(<scope>): <subject>+# # 类型:feat, fix, docs, style, refactor, test, chore, perf, ci, revert+# 范围:api, ui, db, auth 等+# 主题:祈使语气,无句号,最多50个字符+#+# [可选正文] - 解释原因,而非内容+# [可选脚注] - 破坏性变更,关闭 #issue+```++启用方式:`git config commit.template .gitmessage`++## 合并 vs 变基++### 合并(保留历史)++```bash+# Creates a merge commit+git checkout main+git merge feature/user-auth++# Result:+# * merge commit+# |\+# | * feature commits+# |/+# * main commits+```++**适用场景:**++* 将功能分支合并到 `main`+* 希望保留完整历史+* 多人共同开发该分支+* 分支已推送,其他人可能基于它开展工作++### 变基(线性历史)++```bash+# Rewrites feature commits onto target branch+git checkout feature/user-auth+git rebase main++# Result:+# * feature commits (rewritten)+# * main commits+```++**适用场景:**++* 用最新的 `main` 更新本地功能分支+* 希望获得线性、干净的历史+* 分支仅存在于本地(未推送)+* 只有你一个人在该分支上工作++### 变基工作流++```bash+# Update feature branch with latest main (before PR)+git checkout feature/user-auth+git fetch origin+git rebase origin/main++# Fix any conflicts+# Tests should still pass++# Force push (only if you're the only contributor)+git push --force-with-lease origin feature/user-auth+```++### 何时不应变基++```+# 切勿变基以下分支:+- 已推送至共享仓库的分支+- 他人已基于其工作的分支+- 受保护分支(main、develop)+- 已合并的分支++# 原因:变基会重写历史,破坏他人的工作+```++## Pull Request 工作流++### PR 标题格式++```+<type>(<scope>): <description>++示例:+feat(auth): add SSO support for enterprise users+fix(api): resolve race condition in order processing+docs(api): add OpenAPI specification for v2 endpoints+```++### PR 描述模板++```markdown+## 内容++简要描述此 PR 的内容。++## 动机++解释动机和背景。++## 实现方式++值得强调的关键实现细节。++## 测试++- [ ] 新增/更新单元测试+- [ ] 新增/更新集成测试+- [ ] 执行手动测试++## 截图(如适用)++UI 变更的前后对比截图。++## 检查清单++- [ ] 代码遵循项目风格指南+- [ ] 完成自我审查+- [ ] 为复杂逻辑添加注释+- [ ] 更新文档+- [ ] 未引入新警告+- [ ] 测试在本地通过+- [ ] 关联问题已链接++关闭 #123+```++### 代码审查清单++**审查者:**++* \[ ] 代码是否解决了所述问题?+* \[ ] 是否处理了所有边界情况?+* \[ ] 代码是否可读且易于维护?+* \[ ] 是否有足够的测试?+* \[ ] 是否存在安全问题?+* \[ ] 提交历史是否干净(必要时已压缩)?++**作者:**++* \[ ] 在请求审查前已完成自我审查+* \[ ] CI 通过(测试、lint、类型检查)+* \[ ] PR 大小合理(理想情况下 <500 行)+* \[ ] 与单个功能/修复相关+* \[ ] 描述清晰解释了变更内容++## 冲突解决++### 识别冲突++```bash+# Check for conflicts before merge+git checkout main+git merge feature/user-auth --no-commit --no-ff++# If conflicts, Git will show:+# CONFLICT (content): Merge conflict in src/auth/login.ts+# Automatic merge failed; fix conflicts and then commit the result.+```++### 解决冲突++```bash+# See conflicted files+git status++# View conflict markers in file+# <<<<<<< HEAD+# content from main+# =======+# content from feature branch+# >>>>>>> feature/user-auth++# Option 1: Manual resolution+# Edit file, remove markers, keep correct content++# Option 2: Use merge tool+git mergetool++# Option 3: Accept one side+git checkout --ours src/auth/login.ts # Keep main version+git checkout --theirs src/auth/login.ts # Keep feature version++# After resolving, stage and commit+git add src/auth/login.ts+git commit+```++### 冲突预防策略++```bash+# 1. Keep feature branches small and short-lived+# 2. Rebase frequently onto main+git checkout feature/user-auth+git fetch origin+git rebase origin/main++# 3. Communicate with team about touching shared files+# 4. Use feature flags instead of long-lived branches+# 5. Review and merge PRs promptly+```++## 分支管理++### 命名规范++```+# 功能分支+feature/user-authentication+feature/JIRA-123-payment-integration++# 错误修复+fix/login-redirect-loop+fix/456-null-pointer-exception++# 热修复(生产问题)+hotfix/critical-security-patch+hotfix/database-connection-leak++# 发布版本+release/1.2.0+release/2024-01-hotfix++# 实验/概念验证+experiment/new-caching-strategy+poc/graphql-migration+```++### 分支清理++```bash+# Delete local branches that are merged+git branch --merged main | grep -v "^\*\|main" | xargs -n 1 git branch -d++# Delete remote-tracking references for deleted remote branches+git fetch -p++# Delete local branch+git branch -d feature/user-auth # Safe delete (only if merged)+git branch -D feature/user-auth # Force delete++# Delete remote branch+git push origin --delete feature/user-auth+```++### 暂存工作流++```bash+# Save work in progress+git stash push -m "WIP: user authentication"++# List stashes+git stash list++# Apply most recent stash+git stash pop++# Apply specific stash+git stash apply stash@{2}++# Drop stash+git stash drop stash@{0}+```++## 发布管理++### 语义化版本++```+MAJOR.MINOR.PATCH++MAJOR:破坏性变更+MINOR:新功能,向后兼容+PATCH:错误修复,向后兼容++示例:+1.0.0 → 1.0.1(补丁:错误修复)+1.0.1 → 1.1.0(次要:新功能)+1.1.0 → 2.0.0(主要:破坏性变更)+```++### 创建发布++```bash+# Create annotated tag+git tag -a v1.2.0 -m "Release v1.2.0++Features:+- Add user authentication+- Implement password reset++Fixes:+- Resolve login redirect issue++Breaking Changes:+- None"++# Push tag to remote+git push origin v1.2.0++# List tags+git tag -l++# Delete tag+git tag -d v1.2.0+git push origin --delete v1.2.0+```++### 变更日志生成++```bash+# Generate changelog from commits+git log v1.1.0..v1.2.0 --oneline --no-merges++# Or use conventional-changelog+npx conventional-changelog -i CHANGELOG.md -s+```++## Git 配置++### 基本配置++```bash+# User identity+git config --global user.name "Your Name"+git config --global user.email "[email protected]"++# Default branch name+git config --global init.defaultBranch main++# Pull behavior (rebase instead of merge)+git config --global pull.rebase true++# Push behavior (push current branch only)+git config --global push.default current++# Auto-correct typos+git config --global help.autocorrect 1++# Better diff algorithm+git config --global diff.algorithm histogram++# Color output+git config --global color.ui auto+```++### 实用别名++```bash+# Add to ~/.gitconfig+[alias]+ co = checkout+ br = branch+ ci = commit+ st = status+ unstage = reset HEAD --+ last = log -1 HEAD+ visual = log --oneline --graph --all+ amend = commit --amend --no-edit+ wip = commit -m "WIP"+ undo = reset --soft HEAD~1+ contributors = shortlog -sn+```++### Gitignore 模式++```gitignore+# Dependencies+node_modules/+vendor/++# Build outputs+dist/+build/+*.o+*.exe++# Environment files+.env+.env.local+.env.*.local++# IDE+.idea/+.vscode/+*.swp+*.swo++# OS files+.DS_Store+Thumbs.db++# Logs+*.log+logs/++# Test coverage+coverage/++# Cache+.cache/+*.tsbuildinfo+```++## 常见工作流++### 开始新功能++```bash+# 1. Update main branch+git checkout main+git pull origin main++# 2. Create feature branch+git checkout -b feature/user-auth++# 3. Make changes and commit+git add .+git commit -m "feat(auth): implement OAuth2 login"++# 4. Push to remote+git push -u origin feature/user-auth++# 5. Create Pull Request on GitHub/GitLab+```++### 用新变更更新 PR++```bash+# 1. Make additional changes+git add .+git commit -m "feat(auth): add error handling"++# 2. Push updates+git push origin feature/user-auth+```++### 同步 Fork 与上游++```bash+# 1. Add upstream remote (once)+git remote add upstream https://github.com/original/repo.git++# 2. Fetch upstream+git fetch upstream++# 3. Merge upstream/main into your main+git checkout main+git merge upstream/main++# 4. Push to your fork+git push origin main+```++### 撤销错误操作++```bash+# Undo last commit (keep changes)+git reset --soft HEAD~1++# Undo last commit (discard changes)+git reset --hard HEAD~1++# Undo last commit pushed to remote+git revert HEAD+git push origin main++# Undo specific file changes+git checkout HEAD -- path/to/file++# Fix last commit message+git commit --amend -m "New message"++# Add forgotten file to last commit+git add forgotten-file+git commit --amend --no-edit+```++## Git 钩子++### 预提交钩子++```bash+#!/bin/bash+# .git/hooks/pre-commit++# Run linting+npm run lint || exit 1++# Run tests+npm test || exit 1++# Check for secrets+if git diff --cached | grep -E '(password|api_key|secret)'; then+ echo "Possible secret detected. Commit aborted."+ exit 1+fi+```++### 预推送钩子++```bash+#!/bin/bash+# .git/hooks/pre-push++# Run full test suite+npm run test:all || exit 1++# Check for console.log statements+if git diff origin/main | grep -E 'console\.log'; then+ echo "Remove console.log statements before pushing."+ exit 1+fi+```++## 反模式++```+# 错误:直接提交到主分支+git checkout main+git commit -m "修复bug"++# 正确:使用功能分支和拉取请求++# 错误:提交机密信息+git add .env # 包含API密钥++# 正确:添加到.gitignore,使用环境变量++# 错误:巨大的拉取请求(超过1000行)+# 正确:拆分为更小、更聚焦的拉取请求++# 错误:"更新"类提交信息+git commit -m "更新"+git commit -m "修复"++# 正确:描述性信息+git commit -m "fix(auth): 解决登录后的重定向循环问题"++# 错误:重写公共历史+git push --force origin main++# 正确:对公共分支使用回退+git revert HEAD++# 错误:长期存在的功能分支(数周/数月)+# 正确:保持分支短期(数天),频繁变基++# 错误:提交生成的文件+git add dist/+git add node_modules/++# 正确:添加到.gitignore+```++## 快速参考++| 任务 | 命令 |+|------|---------|+| 创建分支 | `git checkout -b feature/name` |+| 切换分支 | `git checkout branch-name` |+| 删除分支 | `git branch -d branch-name` |+| 合并分支 | `git merge branch-name` |+| 变基分支 | `git rebase main` |+| 查看历史 | `git log --oneline --graph` |+| 查看变更 | `git diff` |+| 暂存变更 | `git add .` 或 `git add -p` |+| 提交 | `git commit -m "message"` |+| 推送 | `git push origin branch-name` |+| 拉取 | `git pull origin branch-name` |+| 暂存 | `git stash push -m "message"` |+| 撤销上次提交 | `git reset --soft HEAD~1` |+| 回滚提交 | `git revert HEAD` |diff --git a/docs/zh-CN/skills/github-ops/SKILL.md b/docs/zh-CN/skills/github-ops/SKILL.mdnew file mode 100644index 000000000..b67aaa4bd--- /dev/null+++ b/docs/zh-CN/skills/github-ops/SKILL.md@@ -0,0 +1,145 @@+---+name: github-ops+description: GitHub 仓库操作、自动化与管理。使用 gh CLI 进行问题分类、PR 管理、CI/CD 操作、发布管理和安全监控。当用户想要管理 GitHub 问题、PR、CI 状态、发布、贡献者、过期项目或任何超出简单 git 命令的 GitHub 操作任务时使用。+origin: ECC+---++# GitHub 操作++管理 GitHub 仓库,重点关注社区健康、CI 可靠性和贡献者体验。++## 何时激活++* 对议题进行分类(分类、打标签、回复、去重)+* 管理 PR(审查状态、CI 检查、过期 PR、合并就绪状态)+* 调试 CI/CD 失败+* 准备发布和变更日志+* 监控 Dependabot 和安全告警+* 管理开源项目的贡献者体验+* 用户说“检查 GitHub”、“分类议题”、“审查 PR”、“合并”、“发布”、“CI 坏了”++## 工具要求++* 所有 GitHub API 操作均使用 **gh CLI**+* 通过 `gh auth login` 配置仓库访问权限++## 议题分类++按类型和优先级对每个议题进行分类:++**类型:** bug, feature-request, question, documentation, enhancement, duplicate, invalid, good-first-issue++**优先级:** critical(破坏性/安全相关), high(重大影响), medium(锦上添花), low(外观/体验优化)++### 分类工作流程++1. 阅读议题标题、正文和评论+2. 检查是否与现有议题重复(通过关键词搜索)+3. 通过 `gh issue edit --add-label` 应用适当的标签+4. 对于问题:起草并发布有帮助的回复+5. 对于需要更多信息的 Bug:要求提供复现步骤+6. 对于适合新手的议题:添加 `good-first-issue` 标签+7. 对于重复议题:评论并附上原始议题链接,添加 `duplicate` 标签++```bash+# Search for potential duplicates+gh issue list --search "keyword" --state all --limit 20++# Add labels+gh issue edit <number> --add-label "bug,high-priority"++# Comment on issue+gh issue comment <number> --body "Thanks for reporting. Could you share reproduction steps?"+```++## PR 管理++### 审查清单++1. 检查 CI 状态:`gh pr checks <number>`+2. 检查是否可合并:`gh pr view <number> --json mergeable`+3. 检查 PR 的创建时间和最后活动时间+4. 标记超过 5 天未审查的 PR+5. 对于社区 PR:确保包含测试并遵循项目规范++### 过期策略++* 超过 14 天无活动的议题:添加 `stale` 标签,评论要求更新+* 超过 7 天无活动的 PR:评论询问是否仍在进行+* 30 天内无回复的过期议题自动关闭(添加 `closed-stale` 标签)++```bash+# Find stale issues (no activity in 14+ days)+gh issue list --label "stale" --state open++# Find PRs with no recent activity+gh pr list --json number,title,updatedAt --jq '.[] | select(.updatedAt < "2026-03-01")'+```++## CI/CD 操作++当 CI 失败时:++1. 检查工作流运行:`gh run view <run-id> --log-failed`+2. 识别失败的步骤+3. 判断是不稳定测试还是真正的失败+4. 对于真正的失败:确定根本原因并提出修复建议+5. 对于不稳定测试:记录模式以便未来调查++```bash+# List recent failed runs+gh run list --status failure --limit 10++# View failed run logs+gh run view <run-id> --log-failed++# Re-run a failed workflow+gh run rerun <run-id> --failed+```++## 发布管理++准备发布时:++1. 确保主分支上的所有 CI 检查通过+2. 审查未发布的更改:`gh pr list --state merged --base main`+3. 根据 PR 标题生成变更日志+4. 创建发布:`gh release create`++```bash+# List merged PRs since last release+gh pr list --state merged --base main --search "merged:>2026-03-01"++# Create a release+gh release create v1.2.0 --title "v1.2.0" --generate-notes++# Create a pre-release+gh release create v1.3.0-rc1 --prerelease --title "v1.3.0 Release Candidate 1"+```++## 安全监控++```bash+# Check Dependabot alerts+gh api repos/{owner}/{repo}/dependabot/alerts --jq '.[].security_advisory.summary'++# Check secret scanning alerts+gh api repos/{owner}/{repo}/secret-scanning/alerts --jq '.[].state'++# Review and auto-merge safe dependency bumps+gh pr list --label "dependencies" --json number,title+```++* 审查并自动合并安全的依赖项更新+* 立即标记任何严重/高严重性告警+* 至少每周检查一次新的 Dependabot 告警++## 质量门禁++在完成任何 GitHub 操作任务之前:++* 所有已分类的议题都带有适当的标签+* 没有超过 7 天未收到审查或评论的 PR+* CI 失败已被调查(不仅仅是重新运行)+* 发布包含准确的变更日志+* 安全告警已被确认并跟踪diff --git a/docs/zh-CN/skills/hookify-rules/SKILL.md b/docs/zh-CN/skills/hookify-rules/SKILL.mdnew file mode 100644index 000000000..145de33d6--- /dev/null+++ b/docs/zh-CN/skills/hookify-rules/SKILL.md@@ -0,0 +1,139 @@+---+name: hookify-rules+description: 当用户要求创建hookify规则、编写hook规则、配置hookify、添加hookify规则或需要关于hookify规则语法和模式的指导时,应使用此技能。+---++# 编写 Hookify 规则++## 概述++Hookify 规则是带有 YAML 前置元数据的 Markdown 文件,用于定义要监控的模式以及匹配时显示的消息。规则存储在 `.claude/hookify.{rule-name}.local.md` 文件中。++## 规则文件格式++### 基本结构++```markdown+---+name: rule-identifier+enabled: true+event: bash|file|stop|prompt|all+pattern: regex-pattern-here+---++当此规则触发时向 Claude 显示的消息。+可包含 Markdown 格式、警告、建议等内容。+```++### 前置元数据字段++| 字段 | 必填 | 值 | 描述 |+|-------|----------|--------|-------------|+| name | 是 | kebab-case 字符串 | 唯一标识符(动词优先:warn-*、block-*、require-*) |+| enabled | 是 | true/false | 无需删除即可切换 |+| event | 是 | bash/file/stop/prompt/all | 触发规则的钩子事件 |+| action | 否 | warn/block | warn(默认)显示消息;block 阻止操作 |+| pattern | 是* | 正则表达式字符串 | 要匹配的模式(\*或使用 conditions 实现复杂规则) |++### 高级格式(多条件)++```markdown+---+name: warn-env-api-keys+enabled: true+event: file+conditions:+ - field: file_path+ operator: regex_match+ pattern: \.env$+ - field: new_text+ operator: contains+ pattern: API_KEY+---++你正在向 .env 文件中添加 API 密钥。请确保该文件已包含在 .gitignore 中!+```++**按事件划分的条件字段:**++* bash:`command`+* file:`file_path`、`new_text`、`old_text`、`content`+* prompt:`user_prompt`++**运算符:** `regex_match`、`contains`、`equals`、`not_contains`、`starts_with`、`ends_with`++所有条件必须同时满足才能触发规则。++## 事件类型指南++### bash 事件++匹配 Bash 命令模式:++* 危险命令:`rm\s+-rf`、`dd\s+if=`、`mkfs`+* 权限提升:`sudo\s+`、`su\s+`+* 权限问题:`chmod\s+777`++### file 事件++匹配编辑/写入/多重编辑操作:++* 调试代码:`console\.log\(`、`debugger`+* 安全风险:`eval\(`、`innerHTML\s*=`+* 敏感文件:`\.env$`、`credentials`、`\.pem$`++### stop 事件++完成检查与提醒。模式 `.*` 始终匹配。++### prompt 事件++匹配用户提示内容以强制执行工作流程。++## 模式编写技巧++### 正则表达式基础++* 转义特殊字符:`.` 转义为 `\.`,`(` 转义为 `\(`+* `\s` 空白字符,`\d` 数字,`\w` 单词字符+* `+` 一个或多个,`*` 零个或多个,`?` 可选+* `|` 或运算符++### 常见陷阱++* **过于宽泛**:`log` 会匹配 "login"、"dialog"——请使用 `console\.log\(`+* **过于具体**:`rm -rf /tmp`——请使用 `rm\s+-rf`+* **YAML 转义**:使用无引号模式;带引号的字符串需要 `\\s`++### 测试++```bash+python3 -c "import re; print(re.search(r'your_pattern', 'test text'))"+```++## 文件组织++* **位置**:项目根目录下的 `.claude/` 目录+* **命名**:`.claude/hookify.{descriptive-name}.local.md`+* **Gitignore**:将 `.claude/*.local.md` 添加到 `.gitignore`++## 命令++* `/hookify [description]` - 创建新规则(无参数时自动分析对话)+* `/hookify-list` - 以表格形式查看所有规则+* `/hookify-configure` - 交互式切换规则开关+* `/hookify-help` - 完整文档++## 快速参考++最小可行规则:++```markdown+---+name: my-rule+enabled: true+event: bash+pattern: dangerous_command+---+此处显示警告信息+```diff --git a/docs/zh-CN/skills/jira-integration/SKILL.md b/docs/zh-CN/skills/jira-integration/SKILL.mdnew file mode 100644index 000000000..1b7072192--- /dev/null+++ b/docs/zh-CN/skills/jira-integration/SKILL.md@@ -0,0 +1,302 @@+---+name: jira-integration+description: 在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。+origin: ECC+---++# Jira 集成技能++直接从 AI 编码工作流中检索、分析和更新 Jira 工单。支持 **基于 MCP**(推荐)和 **直接 REST API** 两种方式。++## 何时激活++* 获取 Jira 工单以理解需求+* 从工单中提取可测试的验收标准+* 向 Jira 问题添加进度评论+* 转换工单状态(待办 → 进行中 → 完成)+* 将合并请求或分支链接到 Jira 问题+* 通过 JQL 查询搜索问题++## 前提条件++### 选项 A:MCP 服务器(推荐)++安装 `mcp-atlassian` MCP 服务器。这将向您的 AI 代理直接暴露 Jira 工具。++**要求:**++* Python 3.10++* `uvx`(来自 `uv`),通过您的包管理器或官方 `uv` 安装文档进行安装++**添加到您的 MCP 配置**(例如,`~/.claude.json` → `mcpServers`):++```json+{+ "jira": {+ "command": "uvx",+ "args": ["mcp-atlassian==0.21.0"],+ "env": {+ "JIRA_URL": "https://YOUR_ORG.atlassian.net",+ "JIRA_EMAIL": "[email protected]",+ "JIRA_API_TOKEN": "your-api-token"+ },+ "description": "Jira issue tracking — search, create, update, comment, transition"+ }+}+```++> **安全:** 切勿在源代码中硬编码密钥。建议在系统环境(或密钥管理器)中设置 `JIRA_URL`、`JIRA_EMAIL` 和 `JIRA_API_TOKEN`。仅对本地未提交的配置文件使用 MCP `env` 块。++**获取 Jira API 令牌:**++1. 访问 <https://id.atlassian.com/manage-profile/security/api-tokens>+2. 点击 **创建 API 令牌**+3. 复制令牌 — 将其存储在您的环境中,切勿存储在源代码中++### 选项 B:直接 REST API++如果 MCP 不可用,可通过 `curl` 或辅助脚本直接使用 Jira REST API v3。++**所需的环境变量:**++| 变量 | 描述 |+|----------|-------------|+| `JIRA_URL` | 您的 Jira 实例 URL(例如,`https://yourorg.atlassian.net`) |+| `JIRA_EMAIL` | 您的 Atlassian 账户邮箱 |+| `JIRA_API_TOKEN` | 来自 id.atlassian.com 的 API 令牌 |++将这些存储在您的 shell 环境、密钥管理器或未跟踪的本地环境文件中。不要将其提交到仓库。++## MCP 工具参考++当配置了 `mcp-atlassian` MCP 服务器时,以下工具可用:++| 工具 | 用途 | 示例 |+|------|---------|---------|+| `jira_search` | JQL 查询 | `project = PROJ AND status = "In Progress"` |+| `jira_get_issue` | 按键获取完整问题详情 | `PROJ-1234` |+| `jira_create_issue` | 创建问题(任务、缺陷、故事、史诗) | 新建缺陷报告 |+| `jira_update_issue` | 更新字段(摘要、描述、经办人) | 更改经办人 |+| `jira_transition_issue` | 更改状态 | 移至“评审中” |+| `jira_add_comment` | 添加评论 | 进度更新 |+| `jira_get_sprint_issues` | 列出冲刺中的问题 | 活跃冲刺评审 |+| `jira_create_issue_link` | 链接问题(阻塞、关联) | 依赖跟踪 |+| `jira_get_issue_development_info` | 查看关联的 PR、分支、提交 | 开发上下文 |++> **提示:** 在转换前始终调用 `jira_get_transitions` — 转换 ID 因项目工作流而异。++## 直接 REST API 参考++### 获取工单++```bash+curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \+ -H "Content-Type: application/json" \+ "$JIRA_URL/rest/api/3/issue/PROJ-1234" | jq '{+ key: .key,+ summary: .fields.summary,+ status: .fields.status.name,+ priority: .fields.priority.name,+ type: .fields.issuetype.name,+ assignee: .fields.assignee.displayName,+ labels: .fields.labels,+ description: .fields.description+ }'+```++### 获取评论++```bash+curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \+ -H "Content-Type: application/json" \+ "$JIRA_URL/rest/api/3/issue/PROJ-1234?fields=comment" | jq '.fields.comment.comments[] | {+ author: .author.displayName,+ created: .created[:10],+ body: .body+ }'+```++### 添加评论++```bash+curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \+ -H "Content-Type: application/json" \+ -d '{+ "body": {+ "version": 1,+ "type": "doc",+ "content": [{+ "type": "paragraph",+ "content": [{"type": "text", "text": "Your comment here"}]+ }]+ }+ }' \+ "$JIRA_URL/rest/api/3/issue/PROJ-1234/comment"+```++### 转换工单++```bash+# 1. Get available transitions+curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \+ "$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions" | jq '.transitions[] | {id, name: .name}'++# 2. Execute transition (replace TRANSITION_ID)+curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \+ -H "Content-Type: application/json" \+ -d '{"transition": {"id": "TRANSITION_ID"}}' \+ "$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions"+```++### 使用 JQL 搜索++```bash+curl -s -G -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \+ --data-urlencode "jql=project = PROJ AND status = 'In Progress'" \+ "$JIRA_URL/rest/api/3/search"+```++## 分析工单++当为开发或测试自动化检索工单时,提取:++### 1. 可测试的需求++* **功能需求** — 功能的作用+* **验收标准** — 必须满足的条件+* **可测试的行为** — 具体操作和预期结果+* **用户角色** — 谁使用此功能及其权限+* **数据需求** — 需要哪些数据+* **集成点** — 涉及的 API、服务或系统++### 2. 所需的测试类型++* **单元测试** — 单个函数和工具+* **集成测试** — API 端点和服务交互+* **端到端测试** — 面向用户的 UI 流程+* **API 测试** — 端点契约和错误处理++### 3. 边界情况与错误场景++* 无效输入(空值、过长、特殊字符)+* 未授权访问+* 网络故障或超时+* 并发用户或竞态条件+* 边界条件+* 数据缺失或为空+* 状态转换(返回导航、刷新等)++### 4. 结构化分析输出++```+Ticket: PROJ-1234+Summary: [工单标题]+Status: [当前状态]+Priority: [高/中/低]+Test Types: 单元测试, 集成测试, 端到端测试++Requirements:+1. [需求1]+2. [需求2]++Acceptance Criteria:+- [ ] [验收标准1]+- [ ] [验收标准2]++Test Scenarios:+- Happy Path: [描述]+- Error Case: [描述]+- Edge Case: [描述]++Test Data Needed:+- [测试数据1]+- [测试数据2]++Dependencies:+- [依赖项1]+- [依赖项2]+```++## 更新工单++### 何时更新++| 工作流步骤 | Jira 更新 |+|---|---|+| 开始工作 | 转换为“进行中” |+| 编写测试 | 评论并附上测试覆盖率摘要 |+| 创建分支 | 评论并附上分支名称 |+| 创建 PR/MR | 评论并附上链接,链接问题 |+| 测试通过 | 评论并附上结果摘要 |+| PR/MR 合并 | 转换为“完成”或“评审中” |++### 评论模板++**开始工作:**++```+开始实现此工单。+分支:feat/PROJ-1234-feature-name+```++**测试已实现:**++```+已实现的自动化测试:++单元测试:+- [测试文件1] — [覆盖内容]+- [测试文件2] — [覆盖内容]++集成测试:+- [测试文件] — [覆盖的端点/流程]++所有测试在本地通过。覆盖率:XX%+```++**PR 已创建:**++```+Pull request created:+[PR Title](https://github.com/org/repo/pull/XXX)++Ready for review.+```++**工作完成:**++```+Implementation complete.++PR merged: [link]+Test results: All passing (X/Y)+Coverage: XX%+```++## 安全指南++* **切勿在**源代码或技能文件中硬编码 Jira API 令牌+* **始终使用**环境变量或密钥管理器+* **将 `.env`** 添加到每个项目的 `.gitignore` 中+* **如果令牌暴露在 git 历史中,立即轮换**+* **使用最小权限** API 令牌,范围限定在所需项目+* **在发出 API 调用前验证**凭据是否已设置 — 快速失败并给出清晰消息++## 故障排除++| 错误 | 原因 | 修复 |+|---|---|---|+| `401 Unauthorized` | API 令牌无效或已过期 | 在 id.atlassian.com 重新生成 |+| `403 Forbidden` | 令牌缺少项目权限 | 检查令牌范围和项目访问权限 |+| `404 Not Found` | 工单键或基础 URL 错误 | 验证 `JIRA_URL` 和工单键 |+| `spawn uvx ENOENT` | IDE 在 PATH 中找不到 `uvx` | 使用完整路径(例如,`~/.local/bin/uvx`)或在 `~/.zprofile` 中设置 PATH |+| 连接超时 | 网络/VPN 问题 | 检查 VPN 连接和防火墙规则 |++## 最佳实践++* 边工作边更新 Jira,而不是最后一次性更新+* 保持评论简洁但信息丰富+* 链接而非复制 — 指向 PR、测试报告和仪表板+* 如果需要他人输入,使用 @提及+* 在开始前检查关联问题以了解完整功能范围+* 如果验收标准模糊,在编写代码前要求澄清diff --git a/docs/zh-CN/skills/knowledge-ops/SKILL.md b/docs/zh-CN/skills/knowledge-ops/SKILL.mdnew file mode 100644index 000000000..577ecb98f--- /dev/null+++ b/docs/zh-CN/skills/knowledge-ops/SKILL.md@@ -0,0 +1,177 @@+---+name: knowledge-ops+description: 知识库管理、摄取、同步和跨多个存储层(本地文件、MCP内存、向量存储、Git仓库)的检索。当用户想要保存、组织、同步、去重或搜索其知识系统时使用。+origin: ECC+---++# 知识操作++管理一个多层知识系统,用于跨多个存储库进行知识的摄取、组织、同步和检索。++推荐使用实时工作区模型:++* 代码工作存在于实际克隆的仓库中+* 活跃执行上下文存在于 GitHub、Linear 和仓库本地的上下文文件中+* 面向人类更广泛的笔记可以存放在非仓库的上下文/归档文件夹中+* 跨机器的持久化记忆应属于知识库,而非影子仓库工作区++## 何时激活++* 用户希望将信息保存到其知识库+* 将文档、对话或数据摄取到结构化存储中+* 跨系统同步知识(本地文件、MCP 记忆、Supabase、Git 仓库)+* 对现有知识进行去重或整理+* 用户说“保存到知识库”、“同步知识”、“关于 X 我知道什么”、“摄取这个”、“更新知识库”+* 任何超出简单记忆回忆的知识管理任务++## 知识架构++### 第一层:活跃执行真相++* **来源:** GitHub 议题、PR、讨论、发布说明、Linear 议题/项目/文档+* **用途:** 工作的当前操作状态+* **规则:** 如果某事物影响活跃的工程计划、路线图、发布或版本,优先将其放在此处++### 第二层:Claude Code 记忆(快速访问)++* **路径:** `~/.claude/projects/*/memory/`+* **格式:** 带有前置元数据的 Markdown 文件+* **类型:** 用户偏好、反馈、项目上下文、参考+* **用途:** 跨对话持久化的快速访问上下文+* **会话启动时自动加载**++### 第三层:MCP 记忆服务器(结构化知识图谱)++* **访问:** MCP 记忆工具(create\_entities、create\_relations、add\_observations、search\_nodes)+* **用途:** 对所有存储记忆进行语义搜索、关系映射+* **跨会话持久化,具有可查询的图谱结构**++### 第四层:知识库仓库 / 持久化文档存储++* **用途:** 精选的持久化笔记、会话导出、综合研究、操作员记忆、长文文档+* **规则:** 当内容不属于仓库拥有的代码时,这是跨机器上下文的首选持久化存储++### 第五层:外部数据存储(Supabase、PostgreSQL 等)++* **用途:** 结构化数据、大型文档存储、全文搜索+* **适用场景:** 对于记忆文件过大的文档、需要 SQL 查询的数据++### 第六层:本地上下文/归档文件夹++* **用途:** 面向人类的笔记、归档的游戏计划、本地媒体整理、临时非代码文档+* **规则:** 可写入用于信息存储,但非影子代码工作区+* **禁止用于:** 应存在于上游的活跃代码更改或仓库真相++## 摄取工作流++当需要捕获新知识时:++### 1. 分类++这是什么类型的知识?++* 业务决策 -> 记忆文件(项目类型)+ MCP 记忆+* 活跃路线图 / 发布 / 实现状态 -> 优先使用 GitHub + Linear+* 个人偏好 -> 记忆文件(用户/反馈类型)+* 参考信息 -> 记忆文件(参考类型)+ MCP 记忆+* 大型文档 -> 外部数据存储 + 记忆中的摘要+* 对话/会话 -> 知识库仓库 + 记忆中的简短摘要++### 2. 去重++检查此知识是否已存在:++* 搜索记忆文件中的现有条目+* 使用相关术语查询 MCP 记忆+* 在创建另一个本地笔记之前,检查信息是否已存在于 GitHub 或 Linear 中+* 不要创建重复项。而是更新现有条目。++### 3. 存储++写入适当的层级:++* 始终更新 Claude Code 记忆以便快速访问+* 使用 MCP 记忆实现语义可搜索性和关系映射+* 当信息改变实时项目真相时,首先更新 GitHub / Linear+* 提交到知识库仓库以进行持久的、长格式的添加++### 4. 索引++更新任何相关的索引或摘要文件。++## 同步操作++### 对话同步++定期将会话历史同步到知识库:++* 来源:Claude 会话文件、Codex 会话、其他代理会话+* 目标:知识库仓库+* 生成会话索引以便快速浏览+* 提交并推送++### 工作区状态同步++将重要的工作区配置和脚本镜像到知识库:++* 生成目录映射+* 在提交前编辑敏感配置+* 随时间跟踪更改+* 不要将知识库或归档文件夹视为实时代码工作区++### GitHub / Linear 同步++当信息影响活跃执行时:++* 更新相关的 GitHub 议题、PR、讨论、发布说明或路线图线程+* 当工作需要持久的规划上下文时,将支持文档附加到 Linear+* 之后仅当本地笔记仍能增加价值时才进行镜像++### 跨源知识同步++将来自多个来源的知识汇集到一处:++* Claude/ChatGPT/Grok 对话导出+* 浏览器书签+* GitHub 活动事件+* 写入状态摘要,提交并推送++## 记忆模式++```+# 短期:当前会话上下文+使用 TodoWrite 进行会话内任务追踪++# 中期:项目记忆文件+写入 ~/.claude/projects/*/memory/ 以实现跨会话回溯++# 长期:GitHub / Linear / 知识库+将活跃执行事实置于 GitHub + Linear+将持久化综合上下文置于知识库仓库++# 语义层:MCP 知识图谱+使用 mcp__memory__create_entities 创建永久结构化数据+使用 mcp__memory__create_relations 进行关系映射+使用 mcp__memory__add_observations 添加关于已知实体的新事实+使用 mcp__memory__search_nodes 查找已有知识+```++## 最佳实践++* 保持记忆文件简洁。归档旧数据,而不是让文件无限增长。+* 在所有知识文件上使用前置元数据(YAML)作为元数据。+* 存储前进行去重。先搜索,然后创建或更新。+* 每个事实集优先使用一个权威存放位置。避免在本地笔记、仓库文件和跟踪器文档中并行复制同一计划。+* 在提交到 Git 之前编辑敏感信息(API 密钥、密码)。+* 对知识文件使用一致的命名约定(小写-连字符-分隔)。+* 使用主题/类别标记条目,以便于检索。++## 质量门控++在完成任何知识操作之前:++* 没有创建重复条目+* 任何 Git 跟踪的文件中的敏感数据已被编辑+* 索引和摘要已更新+* 为数据类型选择了适当的存储层+* 在相关处添加了交叉引用diff --git a/docs/zh-CN/skills/project-flow-ops/SKILL.md b/docs/zh-CN/skills/project-flow-ops/SKILL.mdnew file mode 100644index 000000000..8a3f77f5a--- /dev/null+++ b/docs/zh-CN/skills/project-flow-ops/SKILL.md@@ -0,0 +1,111 @@+---+name: project-flow-ops+description: 通过分类问题和拉取请求、关联活跃工作、保持GitHub对外可见而Linear作为内部执行层,来协调GitHub和Linear之间的执行流程。当用户需要待办事项控制、PR分类或GitHub与Linear协调时使用。+origin: ECC+---++# 项目流程运营++此技能将分散的 GitHub Issue、PR 和 Linear 任务整合为一条执行流程。++当问题在于协调而非编码时使用。++## 使用时机++* 梳理开放的 PR 或 Issue 积压+* 决定哪些应放入 Linear,哪些应保留在 GitHub 中+* 将活跃的 GitHub 工作与内部执行通道关联+* 将 PR 分类为:合并、移植/重建、关闭或搁置+* 审查评论、CI 失败或过时 Issue 是否阻碍执行++## 运营模式++* **GitHub** 是公开和社区的真实来源+* **Linear** 是内部执行的真实来源,用于活跃的已排期工作+* 并非每个 GitHub Issue 都需要创建 Linear Issue+* 仅当工作满足以下条件时,才创建或更新 Linear:+ * 活跃+ * 已委派+ * 已排期+ * 跨职能+ * 重要到需要内部跟踪++## 核心工作流++### 1. 首先阅读公开信息++收集:++* GitHub Issue 或 PR 状态+* 作者和分支状态+* 审查评论+* CI 状态+* 关联的 Issue++### 2. 对工作进行分类++每个项目应归入以下状态之一:++| 状态 | 含义 |+|-------|---------|+| 合并 | 独立完整、符合策略、准备就绪 |+| 移植/重建 | 有用的想法,但应在 ECC 内部手动重新落地 |+| 关闭 | 方向错误、过时、不安全或重复 |+| 搁置 | 可能有用,但当前未排期 |++### 3. 判断是否需要 Linear++仅在以下情况下创建或更新 Linear:++* 执行正在积极规划中+* 涉及多个仓库或工作流+* 工作需要内部所有权或排序+* 该 Issue 是更大项目通道的一部分++不要机械地镜像所有内容。++### 4. 保持两个系统一致++当工作活跃时:++* GitHub Issue/PR 应说明公开进展+* Linear 应在内部跟踪负责人、优先级和执行通道++当工作完成或被拒绝时:++* 将公开解决方案发布回 GitHub+* 相应地标记 Linear 任务++## 审查规则++* 切勿仅凭标题、摘要或信任进行合并;需使用完整差异+* 当外部来源的功能有价值但不独立完整时,应在 ECC 内部重建+* CI 红色表示需分类并修复或阻止;不要假装其已可合并+* 如果真正的阻碍是产品方向,请直接说明,而非隐藏在工具背后++## 输出格式++返回:++```text+公开状态+- 议题 / 拉取请求状态+- 持续集成 / 审查状态++分类+- 合并 / 移植重建 / 关闭 / 搁置+- 一段理由说明++线性操作+- 创建 / 更新 / 无需线性项+- 项目 / 泳道(如适用)++下一步操作者行动+- 确切的下一个步骤+```++## 良好用例++* "审查开放的 PR 积压,告诉我哪些应合并,哪些应重建"+* "将 GitHub Issue 映射到我们的 ECC 1.x 和 ECC 2.0 项目通道"+* "检查这是否需要创建 Linear Issue,还是应保留在 GitHub 中"diff --git a/docs/zh-CN/skills/repo-scan/SKILL.md b/docs/zh-CN/skills/repo-scan/SKILL.mdnew file mode 100644index 000000000..2797a2903--- /dev/null+++ b/docs/zh-CN/skills/repo-scan/SKILL.md@@ -0,0 +1,79 @@+---+name: repo-scan+description: 跨栈源代码资产审计——对每个文件进行分类,检测嵌入的第三方库,并为每个模块提供可操作的四级判定结果,附带交互式HTML报告。+origin: community+---++# repo-scan++> 每个生态系统都有自己的依赖管理器,但没有工具能跨 C++、Android、iOS 和 Web 告诉你:有多少代码真正属于你,哪些是第三方代码,哪些是冗余负担。++## 适用场景++* 接手大型遗留代码库,需要了解整体结构+* 重大重构前——识别核心代码、重复代码和废弃代码+* 审计直接嵌入源码(而非通过包管理器声明)的第三方依赖+* 为单体仓库重组准备架构决策记录++## 安装++```bash+# Fetch only the pinned commit for reproducibility+mkdir -p ~/.claude/skills/repo-scan+git init repo-scan+cd repo-scan+git remote add origin https://github.com/haibindev/repo-scan.git+git fetch --depth 1 origin 2742664+git checkout --detach FETCH_HEAD+cp -r . ~/.claude/skills/repo-scan+```++> 安装任何代理技能前,请先审查源码。++## 核心能力++| 能力 | 描述 |+|---|---|+| **跨技术栈扫描** | 一次扫描 C/C++、Java/Android、iOS(OC/Swift)、Web(TS/JS/Vue) |+| **文件分类** | 每个文件标记为项目代码、第三方代码或构建产物 |+| **库检测** | 识别 50+ 已知库(FFmpeg、Boost、OpenSSL…)并提取版本号 |+| **四级判定** | 核心资产 / 提取合并 / 重建 / 废弃 |+| **HTML 报告** | 交互式深色主题页面,支持逐层下钻导航 |+| **单体仓库支持** | 分层扫描,提供摘要 + 子项目报告 |++## 分析深度级别++| 级别 | 读取文件数 | 适用场景 |+|---|---|---|+| `fast` | 每模块 1-2 个 | 快速盘点大型目录 |+| `standard` | 每模块 2-5 个 | 默认审计,含完整依赖 + 架构检查 |+| `deep` | 每模块 5-10 个 | 增加线程安全、内存管理、API 一致性检查 |+| `full` | 所有文件 | 合并前全面审查 |++## 工作原理++1. **分类仓库表面**:枚举文件,将每个文件标记为项目代码、嵌入的第三方代码或构建产物。+2. **检测嵌入的库**:检查目录名、头文件、许可证文件和版本标记,识别捆绑的依赖及其可能版本。+3. **为每个模块评分**:按模块或子系统分组文件,根据所有权、重复度和维护成本分配四种判定之一。+4. **突出结构风险**:指出冗余产物、重复的封装器、过时的供应商代码,以及应提取、重建或废弃的模块。+5. **生成报告**:返回简洁摘要及交互式 HTML 输出,支持按模块下钻,便于异步审查审计结果。++## 示例++在一个 50,000 文件的 C++ 单体仓库中:++* 发现仍在使用 FFmpeg 2.x(2015 年版本)+* 发现同一 SDK 封装器重复了 3 次+* 识别出 636 MB 已提交的 Debug/ipch/obj 构建产物+* 分类结果:3 MB 项目代码 vs 596 MB 第三方代码++## 最佳实践++* 首次审计时从 `standard` 深度开始+* 对包含 100+ 模块的单体仓库使用 `fast` 快速盘点+* 对标记为需重构的模块增量运行 `deep`+* 审查跨模块分析结果,检测子项目间的重复代码++## 链接++* [GitHub 仓库](https://github.com/haibindev/repo-scan)diff --git a/docs/zh-CN/skills/research-ops/SKILL.md b/docs/zh-CN/skills/research-ops/SKILL.mdnew file mode 100644index 000000000..9b059c959--- /dev/null+++ b/docs/zh-CN/skills/research-ops/SKILL.md@@ -0,0 +1,112 @@+---+name: research-ops+description: 以证据为先的ECC当前状态研究工作流程。当用户希望基于当前公开证据和提供的本地上下文获取最新事实、比较、丰富信息或建议时使用。+origin: ECC+---++# 研究运营++当用户要求研究当前信息、比较选项、丰富人员或公司信息,或将重复查询转化为可监控的工作流时,使用此功能。++这是仓库研究栈的操作封装。它并非 `deep-research`、`exa-search` 或 `market-research` 的替代品;而是指示何时以及如何将它们结合使用。++## 技能栈++在相关场景下,将这些 ECC 原生技能纳入工作流:++* `exa-search`:用于快速发现当前网络信息+* `deep-research`:用于多源综合并附带引用+* `market-research`:当最终结果应为建议或排序决策时使用+* `lead-intelligence`:当任务针对人员/公司而非通用研究时使用+* `knowledge-ops`:当结果需持久存储于后续上下文时使用++## 使用时机++* 用户提及“研究”、“查找”、“比较”、“我应该联系谁”或“最新情况”+* 答案依赖于当前的公开信息+* 用户已提供证据,并希望将其纳入新的建议中+* 任务可能具有重复性,应转为监控而非一次性查询++## 防护措施++* 当新鲜搜索成本低廉时,不要依赖过时记忆回答当前问题+* 区分:+ * 有来源的事实+ * 用户提供的证据+ * 推断+ * 建议+* 如果答案已存在于本地代码或文档中,不要启动繁重的研究流程++## 工作流++### 1. 从用户已提供的信息出发++将任何提供的材料规范化为:++* 已有证据的事实+* 需要验证的内容+* 未解决的问题++如果用户已构建部分模型,不要从零开始重新分析。++### 2. 对请求进行分类++在搜索前选择正确的路径:++* 快速事实性回答+* 比较或决策备忘录+* 线索/丰富化处理+* 重复监控候选++### 3. 优先采用最轻量的有效证据路径++* 使用 `exa-search` 进行快速发现+* 当需要综合或多源信息时,升级至 `deep-research`+* 当结果需以建议形式呈现时,使用 `market-research`+* 当实际需求是目标排序或温暖路径发现时,转交至 `lead-intelligence`++### 4. 报告时明确证据边界++对于重要声明,说明其属于:++* 有来源的事实+* 用户提供的上下文+* 推断+* 建议++对时效性敏感的答案应包含具体日期。++### 5. 决定任务是否应保持手动++如果用户可能反复提出相同的研究问题,请明确说明,并建议采用监控或工作流层,而非永远重复相同的手动搜索。++## 输出格式++```text+问题类型+- 事实性 / 比较性 / 补充性 / 监控性++证据+- 有来源的事实+- 用户提供的上下文++推论+- 从证据中得出的结论++建议+- 答案或下一步行动+- 是否应将其设为监控项+```++## 常见陷阱++* 不要将推断混入有来源的事实而不加标注+* 不要忽略用户提供的证据+* 不要对本地仓库上下文能回答的问题使用繁重的研究路径+* 不要给出不含日期的时效性敏感答案++## 验证++* 重要声明需标注证据类型+* 时效性敏感的输出需包含日期+* 最终建议需与实际使用的研究模式匹配diff --git a/docs/zh-CN/skills/terminal-ops/SKILL.md b/docs/zh-CN/skills/terminal-ops/SKILL.mdnew file mode 100644index 000000000..35e4fb21c--- /dev/null+++ b/docs/zh-CN/skills/terminal-ops/SKILL.md@@ -0,0 +1,109 @@+---+name: terminal-ops+description: 基于证据优先的仓库执行工作流,适用于ECC。当用户需要运行命令、检查仓库、调试CI失败或推送带有精确执行和验证证明的窄修复时使用。+origin: ECC+---++# 终端操作++当用户需要真实的仓库执行时使用此技能:运行命令、检查 git 状态、调试 CI 或构建、进行窄幅修复,并准确报告更改和验证的内容。++此技能有意比通用编码指导更窄。它是一种以证据为先的终端执行操作工作流。++## 技能栈++在相关时,将这些 ECC 原生技能引入工作流:++* `verification-loop` 用于更改后的精确验证步骤+* `tdd-workflow` 当正确的修复需要回归覆盖时+* `security-review` 当涉及密钥、认证或外部输入时+* `github-ops` 当任务依赖于 CI 运行、PR 状态或发布状态时+* `knowledge-ops` 当需要将验证结果捕获到持久的项目上下文中时++## 使用时机++* 用户说"修复"、"调试"、"运行这个"、"检查仓库"或"推送它"+* 任务依赖于命令输出、git 状态、测试结果或已验证的本地修复+* 答案必须区分:本地已更改、本地已验证、已提交和已推送++## 安全护栏++* 先检查再编辑+* 如果用户仅要求审计/审查,则保持只读+* 优先使用仓库本地的脚本和辅助工具,而非即兴的临时封装+* 在验证命令重新运行之前,不得声称已修复+* 除非分支确实已推送到上游,否则不得声称已推送++## 工作流++### 1. 确定工作表面++明确:++* 确切的仓库路径+* 分支+* 本地差异状态+* 请求的模式:+ * 检查+ * 修复+ * 验证+ * 推送++### 2. 首先读取失败表面++在更改任何内容之前:++* 检查错误+* 检查文件或测试+* 检查 git 状态+* 在盲目重新读取之前,使用任何已提供的日志或上下文++### 3. 保持修复的窄幅++一次解决一个主要失败:++* 首先使用最小的有用验证命令+* 仅在本地失败解决后,才升级到更大的构建/测试流程+* 如果某个命令持续以相同特征失败,停止广泛重试并缩小范围++### 4. 报告确切的执行状态++使用确切的状态词:++* 已检查+* 本地已更改+* 本地已验证+* 已提交+* 已推送+* 已阻塞++## 输出格式++```text+表面+- 仓库+- 分支+- 请求模式++证据+- 失败的命令 / 差异 / 测试++操作+- 变更内容++状态+- 已检查 / 本地已更改 / 本地已验证 / 已提交 / 已推送 / 已阻止+```++## 陷阱++* 当可以读取实时仓库状态时,不要依赖过时的记忆+* 不要将窄幅修复扩大为仓库范围的变动+* 不要使用破坏性的 git 命令+* 不要忽略不相关的本地工作++## 验证++* 响应中需指明验证命令或测试+* 与 git 相关的工作需指明仓库路径和分支+* 任何推送声明需包含目标分支和确切结果diff --git a/docs/zh-CN/skills/workspace-surface-audit/SKILL.md b/docs/zh-CN/skills/workspace-surface-audit/SKILL.mdnew file mode 100644index 000000000..7e7529b58--- /dev/null+++ b/docs/zh-CN/skills/workspace-surface-audit/SKILL.md@@ -0,0 +1,125 @@+---+name: workspace-surface-audit+description: 审计活跃仓库、MCP服务器、插件、连接器、环境表面和工具设置,然后推荐最高价值的ECC原生技能、钩子、代理和操作员工作流。当用户希望帮助设置Claude Code或了解其环境中实际可用的功能时使用。+origin: ECC+---++# 工作区表面审计++只读审计技能,用于回答"这个工作区和机器当前实际上能做什么,以及我们下一步应该添加或启用什么?"++这是 ECC 原生对设置审计插件的回答。除非用户明确要求后续实现,否则不会修改文件。++## 何时使用++* 用户说"设置 Claude Code"、"推荐自动化"、"我应该使用什么插件或 MCP?"或"我缺少什么?"+* 在安装更多技能、钩子或连接器之前审计机器或仓库+* 比较官方市场插件与 ECC 原生覆盖范围+* 审查 `.env`、`.mcp.json`、插件设置或连接的应用表面,以发现缺失的工作流层+* 决定某项能力应该是技能、钩子、代理、MCP 还是外部连接器++## 不可协商的规则++* 绝不打印秘密值。仅显示提供商名称、能力名称、文件路径以及密钥或配置是否存在。+* 当 ECC 能够合理拥有该表面时,优先选择 ECC 原生工作流,而非通用的"安装另一个插件"建议。+* 将外部插件视为基准和灵感,而非权威的产品边界。+* 清晰区分三件事:+ * 当前已可用的+ * 可用但 ECC 封装不佳的+ * 不可用且需要新集成的++## 审计输入++仅检查回答该问题所需的文件和设置:++1. 仓库表面+ * `package.json`、锁定文件、语言标记、框架配置、`README.md`+ * `.mcp.json`、`.lsp.json`、`.claude/settings*.json`、`.codex/*`+ * `AGENTS.md`、`CLAUDE.md`、安装清单、钩子配置+2. 环境表面+ * 活动仓库及明显相邻的 ECC 工作区中的 `.env*` 文件+ * 仅显示密钥名称,如 `STRIPE_API_KEY`、`TWILIO_AUTH_TOKEN`、`FAL_KEY`+3. 连接工具表面+ * 已安装的插件、已启用的连接器、MCP 服务器、LSP 和应用集成+4. ECC 表面+ * 已覆盖需求的现有技能、命令、钩子、代理和安装模块++## 审计流程++### 阶段 1:盘点现有内容++生成简洁的清单:++* 活动的工具链目标+* 已安装的插件和连接的应用+* 已配置的 MCP 服务器+* 已配置的 LSP 服务器+* 由密钥名称暗示的基于环境的服务+* 与工作区相关的现有 ECC 技能++如果某个表面仅以原始形式存在,请指出。例如:++* "Stripe 可通过连接的应用使用,但 ECC 缺少计费操作技能"+* "Google Drive 已连接,但 ECC 没有原生的 Google Workspace 操作工作流"++### 阶段 2:与官方和已安装表面进行基准比较++将工作区与以下内容进行比较:++* 与设置、审查、文档、设计或工作流质量重叠的官方 Claude 插件+* Claude 或 Codex 中本地安装的插件+* 用户当前连接的应用表面++不要仅列出名称。对于每个比较,回答:++1. 它们实际做什么+2. ECC 是否已具备同等能力+3. ECC 是否仅有原始形式+4. ECC 是否完全缺失该工作流++### 阶段 3:将差距转化为 ECC 决策++对于每个实际差距,推荐正确的 ECC 原生形态:++| 差距类型 | 首选 ECC 形态 |+|----------|---------------------|+| 可重复的操作工作流 | 技能 |+| 自动执行或副作用 | 钩子 |+| 专门的委派角色 | 代理 |+| 外部工具桥接 | MCP 服务器或连接器 |+| 安装/引导指南 | 设置或审计技能 |++当需求是操作性的而非基础设施性的时,默认使用面向用户的技能来编排现有工具。++## 输出格式++按此顺序返回五个部分:++1. **当前表面**+ * 当前已可用的内容+2. **同等能力**+ * ECC 已匹配或超越基准的地方+3. **仅有原始形式的差距**+ * 工具存在,但 ECC 缺少简洁的操作技能+4. **缺失的集成**+ * 尚不可用的能力+5. **前 3-5 个下一步行动**+ * 具体的 ECC 原生新增内容,按影响排序++## 推荐规则++* 每个类别最多推荐 1-2 个最高价值的想法。+* 优先选择具有明显用户意图和商业价值的技能:+ * 设置审计+ * 计费/客户运营+ * 问题/项目运营+ * Google Workspace 运营+ * 部署/运营控制+* 如果连接器是公司特定的,仅在其确实可用或对用户工作流明显有用时才推荐。+* 如果 ECC 已有强大的原始形式,建议封装技能而非发明全新的子系统。++## 良好结果++* 用户可以立即看到已连接的内容、缺失的内容以及 ECC 下一步应拥有的内容。+* 推荐足够具体,无需再次发现即可在仓库中实现。+* 最终答案围绕工作流而非 API 品牌组织。