Kim_Service
面向 Claude Code、Codex 等 AI 编码助手的 Hook 与 Agent Skill 开源合集。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/KimYx0207/Kim_Service with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/KimYx0207/Kim_Service'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/kimyx0207--kim-service)HTML
<a href="/listings/kimyx0207--kim-service"><img src="/api/listings/kimyx0207--kim-service/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 590 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Kim Service
- <p align="center">
- <a href="README.md">简体中文</a> · <a href="README_EN.md">English</a>
- </p>
- **面向开发者、产品团队与内容创作者的开源 AI 角色方法与技能套件(Agent Playbooks & Skill Packs)。**
- Kim Service 将软件工程、产品设计、自媒体创作、商业财务与垂直运营中的实战方法论封装为**可直接安装、可离线检索、带输入输出契约与验证脚本**的标准组件包。无论是用 Claude Code / Codex / Cursor / Antigravity 写代码审接口,还是策划爆款选题、制作动态贴纸、搭建 12 个月现金流预测模型,都可以按领域套件一键装入你的 AI 客户端,把“帮我分析一下”升级为可打开、可复算、可核验的真实交付物。
- **[打开交互式能力工作台](https://kimyx0207.github.io/Kim_Service/?lang=zh-CN)** · **[V1.20 Release 下载](https://github.com/KimYx0207/Kim_Service/releases/tag/V1.20)** · **[更新日志](CHANGELOG.zh-CN.md#v120---2026-11-16)** · **[GitHub 源码](https://github.com/KimYx0207/Kim_Service/tree/main)**
- ---
- ## 30 秒快速安装(零第三方依赖 CLI)
- 无需整仓复制 98 个组件——通过内置 CLI 可按**精选领域套件**、**`--featured` 主力子集**或**单个组件 ID** 精准安装到当前项目或全局目录(原生支持 `claude`、`codex`、`cursor`、`antigravity`、`gemini`、`openclaw`):
- ```bash
- # 1. 查看 6 大精选领域套件与组件概览
- npx github:KimYx0207/Kim_Service packs
- # 2. 按领域套件一键安装到当前项目(示例:研发工程套件 → Claude Code;创作者套件 → Cursor)
- npx github:KimYx0207/Kim_Service install engineering --target claude
- npx github:KimYx0207/Kim_Service install creator-growth --target cursor
- # 3. 首次体验推荐:仅安装全仓 36 个高频主力组件,或安装单个组件到全局环境
- npx github:KimYx0207/Kim_Service install all --featured --target antigravity
- npx github:KimYx0207/Kim_Service install api-contract-review --target codex --scope global
- # 4. 预览将写入的目标文件(不落盘)或查看单个包详情
- npx github:KimYx0207/Kim_Service install product-design --target claude --dry-run
- npx github:KimYx0207/Kim_Service info financial-modeler
- ```
- ## 六大精选领域套件(98 个组件 · 113 项可检索能力)
- **V1.20** 共收录 **61 个专业 Agent、33 个工作流 Skill、2 个 Hook 和 2 个工程 Tool**(含 [跨 Agent 通用思考方法](skills/agent-thinking-patterns/SKILL.md),并与 ZCode `Meta_Kim` v3.16.2 对齐)。全部组件按受众与高频场景划分为 6 大套件:
- | 套件 ID(CLI 安装名) | 适用人群与场景 | 规模 | 代表性主力组件(点击直达) |
- | --- | --- | --- | --- |
- | **`engineering`**<br>研发与 AI 工程套件 | 全栈研发、架构师、测试与安全工程师 | 29 个<br>(8 精选) | [前端工程](agents/frontend-engineer/AGENT.md) · [后端与数据](agents/backend-data-engineer/AGENT.md) · [应用 AI 工程](agents/applied-ai-engineer/AGENT.md) · [API 契约审查](skills/api-contract-review/SKILL.md) · [数据库渐进迁移](skills/database-migration/SKILL.md) · [跨客户端离线评测](skills/agent-evaluation/SKILL.md) · [多 CLI 协同](tools/claudecode-codex-gemini/README.md) |
- | **`product-design`**<br>产品架构与体验设计 | 产品经理、UI/UX 设计师、独立开发者 | 18 个<br>(6 精选) | [产品架构师](agents/product-architect/AGENT.md) · [设计系统](agents/design-system-designer/AGENT.md) · [交互设计](agents/interaction-designer/AGENT.md) · [无障碍审计](skills/accessibility-audit/SKILL.md) · [反馈转需求台账](skills/feedback-to-requirements/SKILL.md) · [游戏经济系统](agents/game-economy-designer/AGENT.md) |
- | **`creator-growth`**<br>创作者与增长视觉 | 自媒体博主、内容团队、品牌市场与短剧策划 | 15 个<br>(7 精选) | [选题策划](agents/topic-planner/AGENT.md) · [脚本与长文写作](agents/script-writer/AGENT.md) · [标题与封面优化](agents/headline-cover-optimizer/AGENT.md) · [小红书图文套图](skills/xiaohongshu-skill/SKILL.md) · [动态表情贴纸包](skills/kim-sticker-pack/SKILL.md) · [分阶段架构图解](skills/visual-explainer/SKILL.md) · [短剧商业策略](agents/short-drama-strategist/AGENT.md) |
- | **`commerce-finance`**<br>商业经营、财务与法务 | 创业者、电商操盘手、财务分析与商务法务 | 18 个<br>(7 精选) | [财务建模与现金预测](agents/financial-modeler/AGENT.md) · [电商经营策略](agents/ecommerce-strategy-planner/AGENT.md) · [出海业务策略](agents/global-expansion-strategist/AGENT.md) · [信用风险分析](agents/credit-risk-analyst/AGENT.md) · [资金流动性](agents/treasury-liquidity-analyst/AGENT.md) · [商业合同审查](agents/contract-review-analyst/AGENT.md) |
- | **`career-education`**<br>求职招聘、教育与办公 | 求职者、招聘面试官、课程讲师与知识工作者 | 8 个<br>(4 精选) | [简历优化](agents/resume-editor/AGENT.md) · [面试辅导](agents/interview-coach/AGENT.md) · [结构化招聘设计](agents/hiring-process-designer/AGENT.md) · [课程设计](agents/curriculum-designer/AGENT.md) · [测评题库设计](skills/learning-assessment-design/SKILL.md) · [SOP 规程](skills/sop-runbook/SKILL.md) |
- | **`industry-ops`**<br>实体运营与垂直工程 | 供应链、制造质量、工程控制、酒旅与农林能源 | 10 个<br>(4 精选) | [供应链计划](agents/supply-chain-planner/AGENT.md) · [设备维护可靠性](agents/maintenance-reliability-engineer/AGENT.md) · [仓储运营](agents/warehouse-operations-analyst/AGENT.md) · [工程项目控制](agents/construction-project-controller/AGENT.md) · [酒店收益管理](agents/hospitality-revenue-analyst/AGENT.md) · [农艺灌溉规划](agents/agronomy-planner/AGENT.md) |
- 你也可以在[在线能力工作台](https://kimyx0207.github.io/Kim_Service/?lang=zh-CN)(或本地打开零依赖单文件 `docs/start.html`)按 **6 大领域套件** 或 **11 个行业、8 个通用领域 → 角色/岗位** 筛选能力,查看输入要求与交付物,一键复制命令或定制完整任务请求。
- ## 电商、出海、短剧:先比较业务路线
- 直接在当前 Agent 对话里说出目标,例如“想做电商,但还没选品类和渠道”。AI 先读取已有材料和决定,实际联网核对会影响选择的官方资料,并按需研究 GitHub 上外部项目的源码、测试、版本和许可,再给出可比较的业务路线。包里的研究笔记提供参考;本次采用的变化事实要重新核实。
- | 你要判断的方向 | 专业方法 | 比较什么 |
- | --- | --- | --- |
- | 电商做什么,怎样经营 | [电商经营策略](agents/ecommerce-strategy-planner/AGENT.md) | 平台经营、内容/达人带货、自营复购、企业补货;再按商品适配、保质、物流、售后等差异细分,核对贡献、现金与履约。 |
- | 什么业务适合出海 | [出海策略](agents/global-expansion-strategist/AGENT.md) | 跨境实物、SaaS/Web、App、内容/IP和专业服务;比较市场、买家、渠道、收款、本地化与支持,先做可逆验证。 |
- | 短剧走哪条商业路线 | [短剧策略](agents/short-drama-strategist/AGENT.md) | 真人原创/委托、AI原创、授权译制;同时检查故事连载、合格成片成本、权利、发行、留存与回本。 |
- 每条候选方案说明目标用户、提供的价值、触达与收费方式、初期和持续成本、适用条件、未知项,以及什么结果会让它停止或转向。AI 给出有依据的建议;已有有效选择直接沿用,影响方向的关键选择尚未决定时,再把方案与取舍交给你。路线明确后,专业 Agent 和 Skill 结合项目规则执行,交付文件、页面、代码或制作成果,实际打开并按标准验收。发现问题就返回受影响的步骤修正,其他独立工作继续。
- 本轮真实研究分别记录在[电商](docs/research/ecommerce-strategy-2026-11-15.md)、[出海](docs/research/global-expansion-2026-11-15.md)、[短剧](docs/research/short-drama-2026-11-15.md)笔记中,注明官方资料日期、GitHub 固定提交、实际阅读范围和未运行项。这些方法与合成案例还不能证明真实市场需求或商业收益。
- ## 先跑通一次:目标、资料、方法、交付
- 如果已经通过 Meta_Kim 或当前客户端接入了 Service,可以直接在实际工作项目的对话里说明目标、材料位置和限制。下面的源码步骤适用于第一次单独接入。
- 1. **取得源码。** 取得 V1.20 完整源码,或用下面两条命令取得 main 源码。
- 2. **让 AI 能读到文件。** 在 Codex、Claude Code、Cursor、Gemini CLI 等项目客户端打开 `Kim_Service` 目录。若任务项目在别处,告诉 AI 方法库和业务材料各自的完整路径。
- 3. **直接说明任务。** 在 AI 客户端的对话里说出要做什么、材料在哪里、有什么要求,让它查找并读取适合的完整方法。需要先浏览能力或整理请求时,可以打开页首目录,或用浏览器打开源码中的 `docs/start.html`;这是可选入口,网页本身只整理请求。
- 4. **打开成果再判断完成。** 让 AI 给出输出文件路径、实际执行的检查和未完成项。检查发现问题后,返回对应步骤修正并保留上一版。
- ```sh
- git clone https://github.com/KimYx0207/Kim_Service.git
- cd Kim_Service
- ```
- 也可以先跳过选任务页面,把下面这段完整请求交给已打开仓库的 AI,使用随仓库提供的合成数据体验财务预测:
- ```text
- 请读取 agents/financial-modeler/AGENT.md、agents/financial-modeler/method.json,以及其中与经营预测有关的资料。
- 输入使用 agents/financial-modeler/examples/operating-forecast/sample-data.js 的合成数据。
- 完成未来 12 个月经营预测,比较基础、乐观、保守情景,解释利润增长但现金不足的月份。
- 实际运行可用计算,把可编辑输入、结果 JSON、月度 CSV 和说明保存到当前项目的 deliveries/forecast/。
- 核对期间、币种、单位和现金勾稽,列出实际输出路径、检查结果、假设及未完成项。
- ```
- **输入 → 输出:** 业务目标+可读取资料+选定方法 → 可编辑产物+计算或操作依据+逐项检查+下一步。先看下面完整流程,再按自己的客户端接入;首次任务直接读取方法即可。
- <p align="center">
- <a href="docs/images/service-system-panorama.zh-CN.svg"><img src="docs/images/service-system-panorama.zh-CN.svg" alt="Kim Service 主流程:在当前 Agent 说明目标,实际联网研究官方资料和外部项目,比较可行路线;已有选择直接沿用,关键选择未定时由用户决定;专业方法执行后打开成果验收,问题返回受影响步骤" width="760"></a>
- <br>
- <a href="docs/images/service-system-panorama.zh-CN.svg">打开原图</a>
- </p>
- 先从顶部的对话目标进入,再看研究怎样影响路线比较。中间两条分支分别表示“已有选择继续用”和“关键方向请你选”,汇合后才进入对应专业工作。底部验收实际成果;右侧回线把问题交回相关步骤。复杂任务由 Meta_Kim 按依赖编排,当前客户端提供模型和工具,Service 提供专业方法与检查标准。能力目录可以随时打开浏览。
- ## 它怎样帮助你把事情做扎实
- 专业工作经常卡在中间:资料口径没统一,结论缺少依据,页面只考虑正常输入,或者交付文件拿回来打不开。Kim Service 把这些容易遗漏的部分写进每个方法包,带着 AI 从材料检查走到交付核验。
- 例如,财务建模会先核对期间、币种和单位,再把销量、单价、成本、回款连接到利润与现金;设计系统会把颜色和字号整理成可复用的设计变量,同时处理焦点、报错、加载、长文本和主题切换。方法包还说明哪些结果需要重做、用什么证据判断,以及材料不全时哪些工作可以先完成。
- ### 四类组件,分别解决什么问题
- - **Agent:把一类专业工作做完整。** 每个角色都有自己的任务范围、输入输出、专业资料、决策步骤、正反例和质量检查。你交给财务建模的是经营资料,交给设计系统的是页面、品牌与交互要求;两者按各自的方法产出模型或页面规范。
- - **Skill:把某一步做得更稳。** 33 个可复用技能覆盖需求追踪、API 合同、数据迁移、无障碍检查、财务情景、实验分析、检索评估、教学测评,也包含团队协作、跨 Agent 思考方法、记忆、技能发现、小红书与贴纸制作等工作流。同一个项目可以按需组合几项。
- - **Hook:在提出需求时补好工作要求。** HookPrompt 补充目标、范围、输出和检查要求;可选本地回执 Hook 在配置后记录选定产物的版本。两者各司其职,保留对话里已经确定的选择。
- - **Tool:接上实际执行工具。** 多 CLI 工具包可把本机已安装的 Codex、Gemini 接入支持 MCP 的客户端,用于代码工作或复核,并提供项目级工作流入口。MCP 契约审计工具离线检查工具定义变化。实际运行范围和文件操作仍由当前客户端管理。
- 它们可以这样配合:专业 Agent 判断任务该怎么做,相关 Skill 提供某一步的做法,Hook 帮助表达需求,工具承担实际操作。你只需要加载与当前任务有关的部分。方法包中的说明、参考资料、案例和检查脚本都随源码保留,成果可以追溯到用了什么材料、做过什么检查。
- <p align="center">
- <a href="docs/images/animated-service-capabilities.zh-CN.svg"><img src="docs/images/animated-service-capabilities.zh-CN.svg" alt="动态能力思维导图:围绕未来一年现金够不够的目标,先选择财务建模 Agent,按需补充 Skill、Hook 和 Tool,再组成包含目标、材料、方法和检查要求的请求" width="520"></a>
- <br>
- <a href="docs/images/animated-service-capabilities.zh-CN.svg">打开原图</a>
- </p>
- **先确定要交付什么,再选择这次需要的组合。** 做一次经营预测,可以直接让 AI 读取财务建模方法;要细化压力情景,再读取相应 Skill。Hook 适合反复整理工作要求,Tool 适合接入已经具备的执行工具。安装哪个、加载多少,取决于本次任务和客户端,不需要把全部组件一次全装上。
- ## 通用方法进入项目,形成项目自己的专业能力
- **全局保留通用基础,每个持续项目维护自己的专业 Agent、Skill 与规则。** 研究当前项目后,把行业知识、品牌风格、数据权限、技术版本、可用工具和验收案例写进本地能力。下一次任务继续加载它,项目经验也随之积累。
- 两项专业方法支持项目研究:**技术方案比较**把候选方案、版本兼容性、证据、代价与验证计划放在一起;**知识架构评估**比较检索、长上下文与缓存、知识 Wiki、图谱等方案如何组合,并检查引用、更新、权限撤回和运行成本。价值判断也会结合商业产品、内部效率或开源项目,以及当前所处阶段。
- 体验设计从通用原则继续细化到领域、品牌和当前任务。设备维护要把告警与操作后果说清楚;国风服装要照顾风格、版型和购买判断。专业方法会要求把规则对应到实际产物、页面状态和观察证据。
- <p align="center">
- <a href="docs/images/animated-service-project-expertise.zh-CN.svg"><img src="docs/images/animated-service-project-expertise.zh-CN.svg" alt="全局专业基础分别形成设备维护与国风服装项目的独立 Agent、Skill、规则和验收案例" width="720"></a>
- <br>
- <a href="docs/images/animated-service-project-expertise.zh-CN.svg">打开原图</a>
- </p>
- 安装好两个项目后,直接在当前 Agent 对话里提出需求。Meta_Kim 组织研究、项目能力创建、执行与验收;Service 提供可阅读、可调用的专业方法。能力目录用于按需浏览,Live 用于按需查看过程和成果。
- ## 例子:为销售团队做一个产品资料助手
- 客户说:“销售同事找产品资料太慢,想做一个 AI 助手。”你可以带来实际询问记录、产品文档、现有流程和权限要求,让下面的方法分工推进。
- 先找出困难是检索、资料缺失还是流程问题,再查原始来源、比较方案。选定检索助手后,设计引用、更新和失败处理,实现一个能演示的切片,用真实问题检查,再把使用反馈送回需求。最终交付可以是一份需求与证据表、一套方案、可运行的助手、问题评测记录,以及后续维护说明。
- | 当前工作 | 复用的现有方法 | 交给下一步的具体产物 |
- | --- | --- | --- |
- | 了解业务、拆解问题 | `agents/user-researcher/`、`skills/feedback-to-requirements/` | 行为证据、来源与分歧、需求候选及待验证问题 |
- | 搜索、核对与研究 | `agents/source-evidence-analyst/`、`skills/evidence-pack/` | 有来源和日期的事实、冲突证据、完整资料包与缺口 |
- | 思考方案和取舍 | `agents/product-architect/` | 范围、备选与推荐依据、系统与模块设计、可演示切片 |
- | 制作和接入 | `agents/applied-ai-engineer/`、`agents/data-pipeline-engineer/`,按任务配合前后端角色 | AI 功能、数据处理和接口等实际产物,评测或运行记录 |
- | 核验、恢复和交接 | `agents/reliability-engineer/`、`agents/delivery-verifier/` | 可靠性与恢复方案、实际文件检查、未验证项和下一步 |
- | 跟进使用与新反馈 | `skills/customer-case-operations/`、`skills/feedback-to-requirements/` | 事项阶段、接收与采用记录、待处理反馈和需求候选 |
- Agent 从各目录的 `AGENT.md` 进入,Skill 从 `SKILL.md` 进入,再按入口读取引用资料。只选择当前任务需要的方法;每一步的产物交给下一步,最后检查助手能否回答实际问题、给出来源,并处理找不到答案的情况。
- 最新方法参考与实际采纳范围见[研究、PRD 图谱及 X 方法的核对记录](docs/verification/reference-adoption-20261116.md):[十种通用思考与行动方法](skills/agent-thinking-patterns/SKILL.md)可由任意专业 Agent 按需复用;希望主动练习时才先提交再获得反馈。图谱由 MetaKim Live 展示。
- ### 完整资料库实操:企业技术支持知识工作台
- `examples/enterprise-knowledge/` 提供可运行的完整案例:导入固定公开 IBM Cloud 历史资料,逐条核对文档与段落,建立关键词和向量索引,用同一组 188 道公开问题比较 BM25、语义检索、RRF 混合与重排。你可以打开原文、查看引用和失败题,继续验证权限撤回、删除、索引回滚与中断恢复。固定原包实数为 8,578 篇文档、72,442 个段落;每次运行仍重新核对。
- 本案例包含在 **V1.20 完整源码**中。下载源码包或用页首的 `git clone` 命令取得完整仓库。在 Linux 或 WSL 中,安装 Python 3.12 后,从仓库根目录运行:
- ```bash
- cd examples/enterprise-knowledge
- python -m venv .venv
- source .venv/bin/activate
- python -m pip install -r requirements.txt
- python scripts/ingest.py
- python scripts/audit_documents.py
- python scripts/download_models.py
- python scripts/build_index.py --generation cloud-minilm-v2 --threads 3 --activate
- python -m app.main --port 4180
- ```
- 打开 `http://127.0.0.1:4180`,输入技术问题并切换检索方式。该目录的 README 给出完整评测、int8 存储对照和真实浏览器截图命令;CI 保留逐题报告与截图。这里验证公开资料上的检索和工程行为,企业实际采用效果需要继续接入自己的资料、权限和用户问题。
- <a id="capability-directory"></a>
- ## 哪些工作可以从这里开始
- **做产品、网站或应用时,** 可以从用户研究和最小产品范围开始,再推进交互、品牌与设计系统、前后端、移动端、AI 应用和数据管道。已有产品也能用同一套入口安排自动化测试、安全复核和可靠性改进。交付会落到方案、接口、代码、页面与检查记录,方便下一位接手。
- **经营店铺、销售或创业项目时,** 可以带来 SKU 销售表、客服问题、供应商报价、库存和成本资料。先解释变化、统一可比口径,再做商品文案、客户回复、采购比较、补货计划、销售预测或定价测算。比如比较供应商,会把起订量、运输等到货成本和交期放在一起,说明缺失条件如何影响选择。
- **看经营财务和投资研究时,** 可以核对账目、解释预算差异、做现金预测、项目估值与压力情景,也能整理投资资料或审查量化回测中的假设。你拿到的是可追到输入的计算、情景比较、关键假设与待核事项,供有权限的负责人做决定。下面的经营预测就是一个完整起点。
- **做内容、营销和日常协作时,** 可以从受众与选题走到正文、口播、分镜、标题、封面和媒体制作,也可以把散乱进度整理成邮件、周报或操作流程。求职、招聘和教学同样有对应方法:岗位匹配与面试练习、结构化招聘标准、课程流程、知识讲解、练习与学习评估,都有明确的输入和可用产物。
- **推进线下运营和工程项目时,** 可以整理制造质量、系统需求与接口、建筑信息、能源项目、碳核算、农田水量以及医疗机构的非临床服务流程。方法会把边界、数据来源、单位、异常和现场待核条件说明白,交付分析、验证安排或试点方案;需要现场资料和专业判断的部分会继续标明。
- 113 项能力是现有任务入口的覆盖范围。选择时先想清楚“我现在要得到什么”,在目录里搜索这个结果,再看需要提供哪些材料。你不用先记住角色的英文名字。
- <a id="task-browser"></a>
- ### 具体业务需要什么输入,会得到什么
- 下面这些方法处理具体业务问题。每个 Agent 都有材料口径、判断分支、完整交付模板、可接受与拒收案例,以及逐项检查依据。角色入口只保留本次工作需要的说明,详细资料按需读取。
- | 在目录里搜索 | 带来什么材料 | 要交付什么 |
- | --- | --- | --- |
- | 信用风险 | 贷款敞口、还款与逾期记录、假设及其来源 | 信用风险拆解、预期损失情景和待核证据 |
- | 资金流动性 | 可用现金、收付款时点、融资约束 | 分期限现金缺口、压力情景和资金安排候选 |
- | 保险理赔 | 保单版本、损失材料、免赔与限额 | 证据对应、条件赔款复算及争议事项 |
- | 合同审查 | 完整条款、附件、交易目标和适用范围 | 条款义务表、风险依据和修改建议 |
- | 设备维护 | 设备台账、故障停机、维修与测量记录 | 可靠性指标、故障判断和维护方案 |
- | 仓储运营 | 库存、预留、收发记录、库位与作业约束 | 可承诺库存核对、作业瓶颈和改善方案 |
- | 建筑项目 | 工作分解、基线、实际进度、成本与变更 | 进度成本偏差、变更影响和恢复方案 |
- | 酒店收益 | 房量、价格、取消、渠道费用和需求 | 净收益比较、库存与价格方案及敏感性分析 |
- | 游戏经济 | 货币来源与消耗、奖励、物品和玩家分层 | 货币收支、通胀风险和可验证的经济调整方案 |
- | 安全事件 | 已授权的告警、日志、时间线和资产范围 | 证据时间线、影响范围及处置与恢复方案 |
- 在上方目录搜索中文业务词,查看“你提供”和“会交付”,复制请求到能读取仓库和材料的客户端即可。材料不全时先完成有依据的部分,把影响结论的缺口列在交付里。
- ### 按需补充某一步的能力
- | 能力 | 实际用途 |
- | --- | --- |
- | 数据血缘与变更影响 | 沿已有数据依赖寻找受影响的表、字段和任务,保留影响路径 |
- | 库存补货 | 按需求、提前期、服务水平和包装约束复算补货候选 |
- | 故障复盘 | 核对事件时间线、影响与后续行动,检查行动是否有负责人和验证方法 |
- | 招投标响应核查 | 把招标要求逐项关联到响应、证据和缺项,区分硬性要求与可说明事项 |
- | MCP 契约审计 | 比较工具清单、输入输出定义和风险提示的变化,形成离线检查结果 |
- | 本地交付回执 Hook | 对明确选定的文件记录哈希,供交接时核对产物版本 |
- 前四项 Skill 和 MCP 审计工具均提供可运行的合成输入与本地脚本,沿用下方统一机器接口。MCP 审计离线运行;本地交付回执 Hook 需显式启用,记录你选定的文件。
- ## 从第一次使用,到完成一个任务
- 已经按开头取得源码后,下面用两个完整例子说明怎样从请求走到交付。任务材料应放在当前客户端可以读取的位置;只支持上传文件的聊天界面,需要附上选中方法的入口、它引用的资料和任务文件。交互样板的本地 `index.html` 可直接用浏览器打开;运行计算或开发脚本时,再使用相应的 Node.js、Python 和客户端工具。
- ### 例一:未来一年,利润增长时现金够用吗?
- 先拿合成数据练一遍,再替换成自己的业务。这个例子会把选任务、准备材料、实际执行、交付检查和下一轮调整连起来。
- <p align="center">
- <a href="docs/images/animated-service-delivery.zh-CN.svg"><img src="docs/images/animated-service-delivery.zh-CN.svg" alt="经营预测动态流程:搜索任务、核对材料与示例、选用方法、由 AI 客户端计算、打开文件复算、保留成果继续迭代;回款假设改变后返回计算步骤" width="440"></a>
- <br>
- <a href="docs/images/animated-service-delivery.zh-CN.svg">打开原图</a>
- </p>
- **第 1 步:从一句话找到对应任务。** 先把问题说清楚:“明年利润看着在涨,现金够不够?”在任务浏览器搜索“经营预测”,打开财务建模。浏览器按任务说明、输入输出和已有别名检索,你可以先比较任务卡上的“你提供”和“会交付”,判断它是否适合这次问题。
- <p align="center">
- <a href="docs/images/task-browser.png?v=V1.13"><img src="docs/images/task-browser.png?v=V1.13" alt="第一步的真实界面:在 Kim Service 任务浏览器搜索工作目标,比较任务卡,打开财务建模的详情" width="900"></a>
- <br>
- <a href="docs/images/task-browser.png?v=V1.13">打开原图</a>
- </p>
- **第 2 步:先看示例,再核对自己的材料。** 任务详情列出所需输入、交付内容、方法入口和示例。第一次使用仓库中的 `agents/financial-modeler/examples/operating-forecast/sample-data.js`,其中已经声明销量、价格、成本、期初资金、回款比例和设备支出,金额是 CNY,全部为合成示例。做自己的业务时,用实际报表与假设替换,明确期间、币种和缺失项。材料栏用于说明文件在哪里,还需要让 AI 能实际读取这些文件。
- **第 3 步:选用方法,把这次要求交给 AI。** 选择你正在使用的 AI 客户端,目标写成:“比较未来 12 个月的基础、乐观、保守情景,找出现金紧张的月份,交付可编辑输入、月表和一份说明。”再填材料位置。页面把方法入口、输入和交付要求整理成完整请求,你可以展开修改,然后点击复制,粘贴到已经打开仓库的客户端。单次任务直接读取方法就能开始;准备反复使用时,再按下文的 DSH、ZCode 或当前客户端方式安装。
- <p align="center">
- <a href="docs/images/task-request.png?v=V1.13"><img src="docs/images/task-request.png?v=V1.13" alt="填写好的财务建模任务:目标、合成样例资料、使用环境,以及可编辑和复制的完整请求" width="760"></a>
- <br>
- <a href="docs/images/task-request.png?v=V1.13">打开原图</a>
- </p>
- **第 4 步:让 AI 按方法处理,看到实际计算。** 这时 AI 才开始读取材料、统一口径、连接收入与现金、比较三种情景。你可以在完整请求后补上下面这段,把执行和结果说清楚:
- ```text
- 请读取 agents/financial-modeler/AGENT.md,以及它引用的 method.json 和本任务所需资料。
- 使用 agents/financial-modeler/examples/operating-forecast/sample-data.js 的合成数据,完成未来 12 个月经营预测。
- 核对期间、币种和单位,解释利润与现金为什么不同;比较基础、乐观、保守三种情景。
- 请实际运行当前环境可用的计算,交付可编辑输入、计算结果 JSON、月度 CSV 和说明。
- 逐项列出检查结果、文件打开位置与未完成项;需要补充的数据请单列为假设。
- ```
- **第 5 步:打开成果,动手验收。** 下面是随仓库提供的可操作样板,用来体验这种交付。在线打开,或在本地打开 `agents/financial-modeler/examples/operating-forecast/index.html`;修改售价、销量或回款比例,查看三种情景与月末现金曲线,下载输入、结果 JSON 和月表 CSV。
- <p align="center">
- <a href="docs/images/operating-forecast-example.png?v=V1.13"><img src="docs/images/operating-forecast-example.png?v=V1.13" alt="12 个月经营预测成果:可编辑的经营假设、三种情景和月末现金曲线" width="900"></a>
- <br>
- <a href="docs/images/operating-forecast-example.png?v=V1.13">打开原图</a>
- </p>
- **[亲手试试经营预测](https://kimyx0207.github.io/Kim_Service/agents/financial-modeler/examples/operating-forecast/index.html?lang=zh-CN)**
- 实际任务交付后,先核对输入与原始材料,再抽查一个月的“期初现金+流入-流出=期末现金”,确认设备支出和回款时间进入模型。检查三种情景究竟改了什么;从交付目录实际打开 JSON、CSV 和说明,确认别人也能使用。这个样板展示经营利润与现金,估值或完整三表需要按任务另外补齐。
- 如果发现问题,先定位它出在哪一步:文件打不开就修交付路径或格式,现金不平就回到输入与公式,材料缺失就把对应假设列出来。让 AI 修正受影响的结果,再按同样的方法复查。已有充分依据的部分可以继续。
- **第 6 步:留下这一轮成果,接着迭代。** 把输入、结果、解释和检查记录保存在这次项目的交付目录,记下确认过的假设、待核项和下一步。下次可以对 AI 说:“保留其他假设,把当月回款从 65% 改成 45%,重新计算三种情景,解释哪些月份受影响,并保留上一版。” 图中的回路线就表示这一轮:改输入,回到计算,复查受影响的结果。后续任务沿用同一套方法和实际文件。
- ### 例二:把预约页面做成一致、可继续开发的设计
- 任务可以这样说:“把这一个预约台的按钮、表单和列表统一起来,支持浅深主题和大字号,补齐报错与失败恢复;保留已有字段,先在这一页试用。”
- 给 AI 当前页面、品牌色、实际文案、使用设备和技术限制;第一次可使用 `agents/design-system-designer/examples/service-console/` 下的样板。请它读取设计系统角色的 `AGENT.md` 和所引用的方法,整理颜色、字号、间距的共同规则,定义组件状态,再在这个页面里实现与检查。
- <p align="center">
- <a href="docs/images/design-system-example.png?v=V1.13"><img src="docs/images/design-system-example.png?v=V1.13" alt="可编辑的预约台设计系统:主题与密度控制、预约表单和示例预约列表" width="900"></a>
- <br>
- <a href="docs/images/design-system-example.png?v=V1.13">打开原图</a>
- </p>
- **[亲手试试预约台](https://kimyx0207.github.io/Kim_Service/agents/design-system-designer/examples/service-console/index.html?lang=zh-CN)**
- 也可以本地打开 `agents/design-system-designer/examples/service-console/index.html`。切换主题、品牌色、字号和密度,看看整页怎样一起变化;故意漏填或输错,再体验一次模拟提交失败和恢复。示例预约使用合成记录,便于反复试。
- 这次希望拿到的是:可编辑的页面源码、可导出的设计变量 JSON、组件正常与异常状态说明,以及从旧页面迁移的安排。验收时用键盘走完表单,检查错误是否说得清楚、失败后输入是否保留、长文字和手机宽度是否可用,再检查中英切换与浅深主题。下一轮可以只调整“紧凑布局在手机上太挤”,沿用已定规则继续改。
- ### 写到一半,怎样继续
- 每项任务单独保存草稿。刷新后可以继续;换设备前点“下载草稿”,在另一处打开同一项任务后导入。你手动修改过请求时,表单变化会保留手写内容;需要重建时点“按表单重新生成”,还可以“恢复上一版”。浏览器不能保存或空间不足时,先下载草稿,保住当前编辑。
- 大型材料超过内联预算时,请求会改为文件引用,并显示“下载完整材料”入口。原文完整保留;把下载的文件附加到当前 AI 对话,或放入 Agent 可读取的工作目录,再让它按当前模块读取相关章节。页面不会上传文件。草稿只保存一份材料,自动请求在恢复时重建;手写请求和撤销版本保留。内联预算和草稿导出、导入的共同上限统一配置在 `config/task-browser.json` 的 `contentPolicy`,当前分别为目标 4 KiB、材料 16 KiB、草稿 16 MiB。超出草稿上限时,页面保留当前编辑并提示先下载完整材料、另存手写请求,再用文件引用整理草稿,不会生成无法重新导入的导出文件。
- ## 单独使用,或让 Meta_Kim 组织整个项目
- **一个明确任务,可以直接用 Kim Service。** 比如修改简历、比较报价、完成上面的预测或设计试点:你选择方法、提供材料,当前 AI 客户端执行,再由你检查交付。专业 Agent、需要的 Skill 和实际工具围绕这一项工作配合。
- **多个相互衔接的任务,可以配合 Meta_Kim。** 比如把预约台做成一个产品:先确定用户需求和功能范围,再统一设计、实现前后端、测试交付,下一次对话还要接着改。Meta_Kim 负责组织这些步骤、分配能够并行的工作、保留决定与进度、审查交接;Kim Service 提供每一步需要的专业方法和资料,AI 客户端承担实际操作。
- <p align="center">
- <a href="docs/images/animated-service-collaboration.zh-CN.svg"><img src="docs/images/animated-service-collaboration.zh-CN.svg" alt="预约产品动态编排:Meta 先形成系统模块 PRD,再细化每个模块;独立页面与接口工作并行,中途待确认字段只阻塞相关接口,补齐后汇合验证并保存下一步" width="520"></a>
- <br>
- <a href="docs/images/animated-service-collaboration.zh-CN.svg">打开原图</a>
- </p>
- **看这张图时,顺着同一个预约项目走。** 两轮设计逐步展开同一份 PRD:第一轮先确定预约、时段、记录等模块及共同约定,第二轮逐个写清输入字段、页面状态、接口和验收要求。Meta 在调研时发现已有方法,在设计时选定本轮需要的组合:页面可用设计系统、前端方法,接口可用后端与数据方法。进入执行阶段,再把选定的方法和具体工作交给当前客户端的执行者。
- 有共同依赖的部分先完成约定,独立部分才并行。如果中途新增一个预约字段,需要确认它的含义,受影响的接口先等待;页面样式、与该字段无关的错误提示仍可推进。字段明确后接续工作,最后把页面和接口接起来,实际完成一次预约,检查异常情况,再保存决定、成果和下一步。这就是图中“分开做、局部等、再汇合”的含义。
- Service 为这条链提供可读取的专业方法、材料说明和检查标准。Meta 负责任务顺序、方法选择和交接,客户端负责实际工具调用与并发执行;一次检索命中后,还会核对方法是否符合当前范围、材料是否可读、所需工具是否可用,再开展相应工作。
- **已有托管来源时直接使用,手动副本按需绑定。** Meta_Kim 安装器登记的受管理 Service 方法源会被自动发现,无需每个项目重复填写路径。如果尚未接入来源,或要改用自行下载的 Service 副本,再明确绑定;把两个文件夹放在一起不会自动接入。需要手动绑定时,在你实际工作的项目根目录创建或编辑 `.meta-kim/local.overrides.json`,保留已有字段,加入:
- ```json
- {
- "dependencyRoots": {
- "kim-service": "/absolute/path/Kim_Service"
- }
- }
- ```
- 把路径替换成自己的 Kim_Service 完整路径,Windows 可以写成 `C:/work/Kim_Service`。如果文件原来已有 `dependencyRoots`,只补其中的 `kim-service`,不要覆盖其他配置。
- 也可以在启动 AI 客户端的同一终端设置 `META_KIM_KIM_SERVICE_ROOT`:macOS/Linux 使用 `export META_KIM_KIM_SERVICE_ROOT="/absolute/path/Kim_Service"`,PowerShell 使用 `$env:META_KIM_KIM_SERVICE_ROOT="C:/work/Kim_Service"`。环境变量优先于项目配置;路径失效时先修正该路径,系统不会悄悄换成另一份副本。
- 完成接入后,在实际工作项目里重新打开 AI 客户端,直接用自然语言说明目标和业务材料的位置。首次使用时,让它确认发现的 Service 来源和相关方法可读。Meta 按任务选择和调度,当前宿主读取方法并执行;`/meta-theory` 是可选的显式入口,任务浏览器也只在需要浏览或整理请求时使用。随后从整体结果检查各项工作是否接上:设计是否符合需求、实现是否遵守设计、测试是否覆盖用户流程。
- 需要这个整体工作方式时,可以使用 [Meta_Kim](https://github.com/KimYx0207/Meta_Kim#readme);继续只做一个任务,也能使用这里完整的方法和示例。
- ## 一件公司的事,跨会话、跨成员继续
- <p align="center">
- <a href="docs/images/service-work-handoff.zh-CN.svg"><img src="docs/images/service-work-handoff.zh-CN.svg" alt="公司事项交接图:宿主保留同一 Work 的目标、权限、来源、有效决定和采用版本;本轮工作形成产物并独立核验,仅未决关键选择需要人参与;产出、验证、采用、效果各自留证,接手者回到同一事项,真实反馈经复核形成待审方法候选" width="1000"></a>
- <br>
- <a href="docs/images/service-work-handoff.zh-CN.svg">打开原图</a>
- </p>
- 先看顶部由宿主持有的 Work,再顺着本轮执行、核验、采用记录和交接包回到同一事项。底部四项是独立事实:产出 v2、验证通过、继续采用 v1 可以同时成立;采用未定就保留待定,没有真实使用观察就保留未知。只有必要的未决关键选择进入橙色分支,已有授权和有效决定继续沿用。反馈经过复核和适用性判断后才用于后续任务。
- 公司现在只有一个人,也需要保留下一位同事能接住的工作现场。宿主把目标、来源、当前采用版和决定挂在同一个 **Work(业务事项)** 上;会话和执行可以有很多次,Service 沿用这个引用提供专业方法。公司资产、个人偏好和敏感决策的可见范围由宿主已有授权决定。
- <p align="center">
- <a href="docs/images/animated-service-work-context.zh-CN.svg"><img src="docs/images/animated-service-work-context.zh-CN.svg" alt="公司事项、交付回执、采用与经验的动态说明" width="460"></a>
- <br>
- <a href="docs/images/animated-service-work-context.zh-CN.svg">打开原图</a>
- </p>
- | 已有方法 | 怎样帮助接续 |
- | --- | --- |
- | `skills/agent-teams-playbook/` | 用可选 WorkContext 关联同一事项的分工、来源和版本,交接含范围、采用稿、下一步与接手回执 |
- | `skills/sop-runbook/` | 把产出、核验、采用、效果分别写进现有规程与交付;人工选择有确切版本、理由或 unknown |
- | `skills/memory-3layer/` | 保留成功、失败、拒用、适用/不适用、过期条件及实际复用反馈;先作为公司内部候选复查 |
- | `agents/delivery-verifier/` | 可选 work_handoff 实读文件、核版本/hash、事项/context/run、采用观察与接手一致性 |
- 例如,课程资料本次生成了 v2,技术检查通过,但负责人仍沿用以前已采用的 v1。交接时两版分别标清;原有效决定继续引用,不请人再批一遍。收到通知不等于接手,接手不等于办完;没有业务效果证据就保留 unknown。拒用新稿的原因也可成为经验候选。
- 从仓库根目录运行完整本地合成演示:
- ```sh
- node agents/delivery-verifier/scripts/demo-work-handoff.mjs
- ```
- 演示会创建临时文件并调用只读核验器,检查正常交接、失败或拒用记录,以及旧上下文和采用版本不一致的情况。完整字段见 [delivery API](agents/delivery-verifier/docs/delivery-api.md)。
- 已有独立任务继续原有用法;需要跨会话交接时再带上 WorkContext。公司内部经验经过复查后用于后续任务,事项记录、定时整理和消息由实际业务宿主管理。
- ## 按你使用的客户端接入
- **专业方法不指定你必须使用哪家模型。** 客户端、模型、可用工具分别由当前任务和宿主配置决定。Claude Code、Codex、Gemini CLI、ZCode、MiniMax Code 或其他能读取方法资料的客户端,可以按自身能力使用同一份方法。任务浏览器的客户端列表统一来自 `config/task-browser.json`;选择“我正在用的 Agent”可直接沿用现有环境。
- **接入条件:** 客户端需要能读取完整方法和业务材料,并具备本次工作需要的工具与授权。导入方法后,请在该客户端实际跑一次样例、打开成果,再确认执行和接续是否正常。
- | 项目 | 配置与行为 |
- | --- | --- |
- | 任务浏览器客户端选项 | 根据配置生成请求文本;选择名称不会启动客户端、连接账户或切换真实模型 |
- | 专业执行与独立评审 | 沿用宿主工具和模型配置;角色职责不固定绑定某一品牌 CLI,重试依据进展、证据与任务预算 |
- | 团队方法安装 | 显式 `--target` 优先,其次 `AGENT_TEAMS_INSTALL_TARGET`;均未提供时显示用法,不默认写入 Claude 目录 |
- | 其他客户端的 Skills 目录 | `--target custom --skills-dir /absolute/host/skills` 只安装通用方法包;目录由宿主提供,原生加载需在该客户端核实 |
- | Memory 的客户端与模型来源 | `MEMORY_HOST` 或载荷中的 `runtime / host / client` 标识宿主;模型单独记录,缺少宿主声明时保留 `manual` |
- 例如,Claude Code 客户端使用 MiniMax 模型时,分别保留客户端和模型信息。账户、模型与工具由宿主配置;可选多 CLI 工具未填写模型时,沿用对应 CLI 的设置。
- ### 普通项目客户端
- Codex、Claude Code、Cursor、Gemini CLI 等客户端,按上面的方式打开仓库或读取指定包即可开始。明确告诉 AI 使用哪个角色、先读取哪些材料、把成果放在哪里,比一次性塞入整个目录更容易核对。常用的 Skill 可以再按客户端支持的技能安装方式启用,并保留它的整个资源目录。
- HookPrompt 和多 CLI 工具是按需接入的组件。需要它们时,让 AI 读取 `hooks/hookprompt/README.md` 或 `tools/claudecode-codex-gemini/README.md`,按当前客户端配置并检查实际加载结果;第一个专业任务可以直接使用前面的仓库读取方式。
- <a id="dsh"></a>
- ### DSH(DeepSeek Harness)
- DSH 里,专业 Agent 方法和 Skill 会作为原生 Skills 被发现,并保留完整方法、知识、案例、脚本与许可。当前适配依据 DSH **0.2.2-rc.1**,需要 **Node.js 24.9.0+**;先准备好 DSH 自己使用的模型和工具配置。尚未安装该客户端时,可运行:
- ```sh
- npm install --global @deepseek-ai/dsh@0.2.2-rc.1
- ```
- **准备 Service 包。** 本版 DSH 包为 `Kim_Service-DSH-V1.20.zip`,下载位置为 [V1.20 Release](https://github.com/KimYx0207/Kim_Service/releases/tag/V1.20);也可从对应源码构建。下面的输出路径要换成自己的完整路径,且目录尚不存在:
- ```sh
- node scripts/build-dsh-package.mjs --output "/absolute/path/kim-service-dsh"
- node scripts/build-dsh-package.mjs --output "/absolute/path/kim-service-dsh" --check
- ```
- **安装到 DSH 并核对。** 这条接入由 Meta_Kim 的安装器管理。已有 Meta_Kim 源码的用户直接进入它的目录;没有时先下载,再执行安装。下面选择的是多个项目共用的用户级安装:
- ```sh
- git clone https://github.com/KimYx0207/Meta_Kim.git
- cd Meta_Kim
- npm install
- node bin/meta-kim.mjs dsh install --service-package "/absolute/path/kim-service-dsh"
- node bin/meta-kim.mjs dsh check
- dsh --profile meta-kim
- ```
- 在 DSH 会话中输入 `/kim-service` 查看实际加载的目录,再选择对应方法,例如 `/kim-financial-modeler`。先确认入口可以读到完整方法,再提交材料。长资料按随包索引分段读取,执行计算时使用完整原脚本。
- **只给一个项目使用时,** 准备好 Meta_Kim 源码后,在它的目录执行以下项目级安装和检查:
- ```sh
- node bin/meta-kim.mjs dsh install --scope project --project-root "/absolute/path/my-project" --service-package "/absolute/path/kim-service-dsh"
- node bin/meta-kim.mjs dsh check --scope project --project-root "/absolute/path/my-project"
- ```
- 项目已有 Git 仓库时使用其根目录;没有 Git 仓库时使用项目目录。然后切换到这个项目目录,执行安装器打印的启动命令。项目模式使用 `dsh --profile web --patch ...`,其中 patch 路径以安装器输出为准。后续检查、更新和卸载带同样的 `--scope project --project-root "/absolute/path/my-project"`。已有自定义 DSH_HOME 时,安装时补 `--dsh-home` 指向同一位置,并继续使用原来的 DSH_HOME。
- **更新与停用。** 下载新版包或构建到一个新目录,然后在 Meta_Kim 目录运行 `node bin/meta-kim.mjs dsh update --service-package "/absolute/path/new-package"`,再运行 `node bin/meta-kim.mjs dsh check`。停用时运行 `node bin/meta-kim.mjs dsh uninstall`。更新、卸载遇到用户修改会保留并报告,按结果处理;文件校验和实际宿主加载分别检查。
- <a id="zcode"></a>
- ### ZCode
- 本版 ZCode 包为 **`Kim-ZCode-V1.20.zip`**,对应 Kim 插件版本 **1.20.0**、Meta_Kim 插件版本 **3.16.2**,下载位置为 [V1.20 Release](https://github.com/KimYx0207/Kim_Service/releases/tag/V1.20)。完整解压到准备长期保留的位置,选择包含 `marketplace.json` 的目录,保留其下全部插件和资料。
- 在 ZCode 打开一个项目,再进入**设置 → 插件 → 创建 → 添加市场**,选择刚才的本地目录。在个人来源里安装并启用 `kim-service-local`;想同时使用 Meta_Kim 的任务组织方法,再安装 `meta-kim-local`。安装后,在插件详情核对角色和技能,在子 Agent 列表找到对应角色,例如 `kim-service-local:financial-modeler`,然后带上目标与材料开始任务。
- 习惯命令行,可以完成同样的添加、安装与列表检查:
- ```sh
- zcode plugins validate "/absolute/path/kim-zcode"
- zcode plugins marketplace add "/absolute/path/kim-zcode" --scope user
- zcode plugins install kim-service-local@kim-local-reviewed -s user
- zcode plugins list --json
- ```
- 需要 Meta_Kim 插件时再运行 `zcode plugins install meta-kim-local@kim-local-reviewed -s user`。Kim 的完整角色资料与 Skills 随插件保留;这个内容包提供 Agent 和 Skill,HookPrompt、MCP、命令桥接按各自支持的客户端另行接入。
- 更新时,保留个人修改,再用新发布的整包更新原市场目录;在来源管理里刷新该市场,再到已安装插件中检查更新,核对实际版本。停用或卸载也在插件管理里操作。本地插件的安装位置和实际加载状态可在这些界面直接核对。
- ### WorkBuddy 与豆包工作:导出一个完整 Skill(beta)
- 这两个客户端当前提供**选定一个 Agent 或 Skill,导出完整技能 ZIP,再在客户端导入**的 beta 接入。包内保留原方法、知识、案例、脚本和许可;Agent 作为 Skill 里的专业方法使用。
- **准备文件。** 先安装 Node.js **22.13.0 或更高版本**,运行 `node --version` 核对。下载并完整解压 [Service V1.20](https://github.com/KimYx0207/Kim_Service/releases/tag/V1.20) 与 [Meta_Kim v3.16.2](https://github.com/KimYx0207/Meta_Kim/releases/tag/v3.16.2)。在终端进入 Kim_Service 根目录,把下面的 Meta 路径改成源码的实际绝对路径。输出目录必须是尚不存在的新目录,其父目录须已存在;例子导出财务建模:
- ```sh
- node scripts/build-desktop-skill-package.mjs --meta-root "/absolute/path/Meta_Kim" --host workbuddy --component financial-modeler --output "/absolute/path/new-workbuddy-finance"
- node scripts/build-desktop-skill-package.mjs --meta-root "/absolute/path/Meta_Kim" --host workbuddy --component financial-modeler --output "/absolute/path/new-workbuddy-finance" --check
- ```
- 豆包工作把两条命令中的 `--host workbuddy` 改为 `--host doubao`,并选新的输出目录。Windows PowerShell 可用以下完整写法,只需修改 Meta 源码目录和客户端选择:
- ```powershell
- $KimMeta = (Resolve-Path 'C:/work/Meta_Kim-3.15.0').Path
- $KimClient = 'workbuddy' # 豆包工作改为 'doubao'
- $KimOutput = Join-Path ([IO.Path]::GetTempPath()) ('kim-finance-' + [guid]::NewGuid().ToString('N'))
- node scripts/build-desktop-skill-package.mjs --meta-root $KimMeta --host $KimClient --component financial-modeler --output $KimOutput
- if ($LASTEXITCODE -ne 0) { throw '导出失败' }
- node scripts/build-desktop-skill-package.mjs --meta-root $KimMeta --host $KimClient --component financial-modeler --output $KimOutput --check
- if ($LASTEXITCODE -ne 0) { throw '输出文件核验失败' }
- Write-Host (Join-Path $KimOutput 'kim-financial-modeler.zip')
- ```
- **导入并实际验收。** 在 WorkBuddy 打开“专家·技能·连接器 → 技能 → 添加技能 → 上传技能”,上传输出目录中的 `kim-financial-modeler.zip`。在豆包工作使用本地技能导入入口选择同一 ZIP。核对名称、版本和启用状态,开新任务要求它读取完整方法,用包内合成样例实际计算,再打开输出文件检查;退出客户端后重新进入,确认能接着处理未完成项。界面名称以本机版本为准。
- `--check` 核对导出内容、ZIP 和来源哈希;客户端的执行与恢复按上面的步骤另行检查。更新时另存个人修改,导出到新目录,在客户端管理同名技能更新并重复核对。
- ## 处理大材料、反馈和交接的本地工具
- **持续推进项目时,直接在已接入 Meta_Kim 的 AI 客户端里继续对话;Kim Service 提供专业方法与工具。** 需要查看、评审或接续已登记的事项时,再打开 Meta Live。当前宿主按实际绑定调用方法或本地 helper。Service 的在线或离线浏览器用于查目录、准备材料和整理请求,是可选辅助入口;它不另起一个持续调度器。单独使用时也可以直接运行下面的 helper。
- | 任务 | 你提供 | 实际得到 | 保留的边界 |
- | --- | --- | --- | --- |
- | 大材料证据包(`skills/evidence-pack/`) | 公司/事项、显式材料目录、UTF-8 原文文件、版本和预算 | 原文完整保留的文件包、来源与分块哈希、分页索引、有限上下文 | 默认 stdout 不回传整本材料;PDF/OCR 提取需由已有工具另行完成 |
- | 跨客户端离线评测(`skills/agent-evaluation/`) | 固定案例、各客户端已有输出、关键断言、实际成本/延迟记录 | 逐题对比、缺失分母、关键回归、分层结果和预算检查 | 不调用模型;没有记录的费用保持未知,语义质量另核 |
- | 反馈转需求(`skills/feedback-to-requirements/`) | 同一项目的反馈、明确重复关系、分组和来源 | 独立客户计数、矛盾材料、可追踪的需求候选与版本绑定采纳 | 不擅自推断语义重复;候选未采用前保持 proposed |
- | 客户事项推进(`skills/customer-case-operations/`) | 可配置阶段、成员角色、材料、事件与决定回执 | 状态投影、缺项、下一步建议、独立的验证/收到/采纳记录 | 不发通知,不代替组织身份鉴权,不运行后台定时任务 |
- | 分阶段图解(`skills/visual-explainer/`) | 来自真实说明的阶段、节点、连线、分支与返回路径 | SVG、可逐步播放的 HTML、文字替代说明 | 采用有界分层布局;动画只是说明,不是执行回执 |
- 这五项都有可运行脚本、输入输出 schema、独立容量配置、合成示例与失败反例。它们复用现有证据分析、检索评价和交付核验职责;具体计算与材料处理由各自的 helper 承担。
- **分阶段图解的实际输出。** 下面由正式 helper 生成的合成示例,展示同一事项如何从资料进入模块设计,再到核验与采纳;紫色回路说明局部修订。顶部和底部节点居中,三个阶段既能合起来看,也能逐步展开说明。
- <p align="center">
- <a href="docs/images/visual-helper.zh-CN.svg"><img src="docs/images/visual-helper.zh-CN.svg" alt="合成示例的三阶段四节点流程:同一 Work 与资料进入目标阶段,模块 PRD 接着细化为模块详细设计,再核验交付回执与采纳;紫色局部修订回路从回执返回详细设计,顶部和底部节点居中;这张说明图不代表任务已经实际执行" width="1120"></a>
- <br>
- <a href="docs/images/visual-helper.zh-CN.svg">打开原图</a>
- </p>
- [下载中文交互 HTML](docs/examples/visual-helper/zh-CN/storyboard.html?raw=1) · [文字替代说明](docs/examples/visual-helper/zh-CN/alternative.txt) · [对应输入 JSON](docs/examples/visual-helper/zh-CN/input.json)
- 把 HTML 下载后用本地浏览器打开,即可上一阶段、下一阶段、播放或显示全图。若打开的是 GitHub 文件页,点击 **Download raw file** 保存文件;源文件页本身不播放交互。HTML 已内嵌 SVG、样式和脚本,无外部依赖。
- 从仓库根目录可以先运行不收费的合成示例:
- ```sh
- node skills/agent-evaluation/scripts/run.mjs --input-json - < skills/agent-evaluation/examples/input.json
- node skills/feedback-to-requirements/scripts/run.mjs --input-json - < skills/feedback-to-requirements/examples/input.json
- node skills/customer-case-operations/scripts/run.mjs --input-json - < skills/customer-case-operations/examples/input.json
- node skills/visual-explainer/scripts/run.mjs --input-json - < skills/visual-explainer/examples/input.json
- ```
- 想直接打开图解文件,可运行 `node skills/visual-explainer/scripts/example.mjs /absolute/path/to/new-diagram-folder`,然后打开该目录里的 `storyboard.html`。
- 大材料请使用文件式入口。下面会在你指定的新目录中建立合成材料和完整证据包,只把有限索引、哈希与上下文送回终端:
- ```sh
- node skills/evidence-pack/scripts/example.mjs /absolute/path/to/new-example-workspace
- ```
- 真实材料按包内示例填写 `workspaceRoot`、源文件相对路径和新 `packPath`,交给 `node skills/evidence-pack/scripts/files.mjs --input-json -`。后续只提交证据包路径、上次返回的文件哈希与分页游标或块 ID;原文不需要反复塞进请求。默认核对原文件变化,完整文件始终可重新组合还原。
- ### 给 Meta Live 与其他宿主的机器接口
- ```sh
- node scripts/service-capabilities.mjs export
- ```
- 此命令实时读取组件 `capability.json`,导出 `kim-service-capabilities-v1`。已有能力继续保留;可直接调用的十项带 `kim-service-helper-v1`、固定参数数组、schema/policy 路径与哈希。宿主只能调用已绑定的本地入口,不能执行材料里的命令;客户端与模型由当前任务配置。输入公共上下文为 `organizationId / workId / revision`,结果保留输入与规则哈希,最终采用仍由宿主记录。[接口与验证说明](docs/service-helper-api.md)。
- ## 应用、数据与展示的边界
- <p align="center">
- <a href="docs/images/animated-service-layers.zh-CN.svg"><img src="docs/images/animated-service-layers.zh-CN.svg" alt="从组件正本到数据目录、应用请求、展示页面,再交给所选客户端执行" width="520"></a>
- <br>
- <a href="docs/images/animated-service-layers.zh-CN.svg">打开原图</a>
- </p>
- **组件定义是方法的正本,页面是这些事实的展示。** 修改专业内容、任务交互或客户端选项时,各自进入对应位置,再生成目录和页面。
- | 层与职责 | 现有位置 | 负责什么 |
- | --- | --- | --- |
- | 方法来源 | 各组件 `capability.json`、`method.json`、专业资料与 `evals/` | 任务边界、输入输出、执行步骤、案例和检查标准 |
- | 数据层 | `src/data/capability-catalog.mjs`、`src/data/service-helper-catalog.mjs`、`src/data/task-browser.mjs` | 读取与校验能力目录和任务配置 |
- | 应用层 | `src/application/task-browser/model.mjs`、`src/application/service-helpers/runtime.mjs`、各包 `scripts/` | 请求构建、有界 JSON 入口与独立业务计算 |
- | 展示层 | `src/presentation/task-browser/` | 中英文界面、状态反馈、请求编辑和复制交互 |
- | 展示与宿主选项配置 | `config/task-browser.json` | 统一管理宿主标签、请求前缀、字段名、搜索词和其他页面配置 |
- | 生成结果 | `catalog.json`、`generated/capabilities.json`、`docs/start.html` | 由构建脚本生成;修改正本后重建,避免另维护一套清单 |
- 新增客户端显示选项只改现有配置;新增原生工具调用需要在实际适配器层实现并验证。方法包、可选本地 helper 和宿主权限各守自己的边界,业务 Work 主记录、外部消息和定时整理继续由业务宿主负责。上面的动态 SVG 由 `scripts/build-readme-animations.mjs` 与本地化文案生成,可用 `--check` 检查一致性;减少动态效果时,完整步骤和说明仍然可读。
- ## 更新源码,继续自己的工作
- 版本变化单独记录在 [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md)。本页说明当前用途和使用路径,升级前可按日志核对变化。
- Git 下载的仓库,在 Kim_Service 目录运行:
- ```sh
- git pull --ff-only
- ```
- 重新打开在线入口或本地 `docs/start.html`。用 ZIP 下载的用户,把新版本解压到新目录,再带回自己的材料和修改。已经填好的草稿可以先导出;包版本变化后,核对目标、输入和原完整请求,再决定是否重新生成。
- 方法包和示例提供的是做事依据。对自己的任务,保留实际产物、计算或操作记录、已通过的检查和剩余事项,下一轮就能从明确的位置接着做。源码里的 `agents/`、`skills/`、`hooks/`、`tools/` 分别保存四类组件;完整任务仍可在页首浏览器搜索,不必逐个翻目录。
- ## 支持项目
- 发现问题或有改进建议,请通过项目的 [Issues](https://github.com/KimYx0207/Kim_Service/issues) 提交。若项目帮到了你,欢迎 [Star 和分享](https://github.com/KimYx0207/Kim_Service)。
- ## 开源与来源
- 仓库级内容采用 [MIT License](LICENSE)。每个能力包保留自己的许可证及来源记录,详见包内 `LICENSE`、`PROVENANCE` 或同类文件。
- FDE 工作背景可参阅 [Palantir 官方说明](https://www.palantir.com/docs/foundry/architecture-center)。专业方法的来源与采用范围保留在各包的 `PROVENANCE.md`。仓库示例用于演示与检查方法;真实行业客户效果仍为 `not_evaluated`,以实际业务使用与验收记录为准。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.