القائمة
将任意 Qoder Skill 项目打包为分发包 zip。自动检测项目结构，包含全部项目文件，仅排除开发者/构建产物。当用户要求打包 skill、生成分发包、创建发布 zip 时使用。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/qiusuo0226/chrono-pm-skill --skill pack-skillيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
给项目集/组合经理用的只读 Skill。跨多个项目 ai 目录归集检索进度、风险、合同、周报。禁止写入成员项目事实源。触发：项目集、组合、跨项目、汇总周报、进度总览、人员排期、跨项目风险、门禁、P&L、合同去重、建议更新清单、共享文件拆分、术语索引、挂载、健康巡检、汇总计划、按时间归集计划、技能缺口、ChronoPM-Portfolio。
Markdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio（只读）。触发：项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/整理记录/补全/回填/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好、画图、责任链图。支持主动变更+人工确认：写入即标记待确认并登记 pm-decisions，确认后生效。需求只绑工作包，计划只绑工作包。
Markdown 驱动的单项目 AI 项目管理技能。覆盖需求、待办、进度、风险问题、里程碑、成本、日报周报、会议纪要、决策、复盘、初始化向导、计划、完整性巡检、历史计划导入、词库、PM 偏好。录入只发生在本项目 ai 目录。跨项目归集/检索请使用伴生技能 ChronoPM-Portfolio（只读）。触发：项目管理、日报、周报、风险登记册、需求追踪、里程碑、ChronoPM、记录/整理记录/补全/回填/更新/归档/入库/评审/验收、会议纪要、合同登记、初始化项目、倒排、待办、完整性巡检、词库、偏好、画图、责任链图。支持主动变更+人工确认：写入即标记待确认并登记 pm-decisions，确认后生效。需求只绑工作包，计划只绑工作包。
عرض SKILL.md
| name | pack-skill |
| description | 将任意 Qoder Skill 项目打包为分发包 zip。自动检测项目结构，包含全部项目文件，仅排除开发者/构建产物。当用户要求打包 skill、生成分发包、创建发布 zip 时使用。 |
用户说"打包 skill"、"生成分发包"、"创建发布 zip"、"导出 skill"时调用。
包含全部，排除已知——不预设任何 Skill 特有的目录结构。 任何符合 Qoder Skill 规范的项目（有 SKILL.md）都能打包。
检查当前工作区：
ChronoPM-Project/SKILL.md → Skill 根目录 = ChronoPM-Project/（v3.1.1 CR-G）SKILL.md → 当前目录即为 Skill 根目录按优先级读取版本号：
VERSION 文件（纯文本）skill.json 的 version 字段同时从 skill.json 读取 name 字段作为包名（缺省用 skill）。
运行本 skill 目录下的打包脚本：
本机主路径（Python）：
python tools/pack-skill/scripts/pack.py --skill-root <path>
跨平台参考实现（PowerShell，执行策略受限时不可用）：
powershell -ExecutionPolicy Bypass -File ~/.qoder/skills/pack-skill/scripts/pack.ps1 -SkillRoot <path>
脚本逻辑：
{BrandName}-Skill-v{version}.zip（BrandName 取自 skill.json displayName 品牌前缀）--skill-root ChronoPM-Project 时自动打包兄弟目录 ChronoPM-Portfolio/ 为第二 zip；zip 默认写仓库根。governance/migrations/（仅当前 upgrade）与 governance/contracts/skill-contract.md 例外放行入包。建议先 DryRun 预览：
python tools/pack-skill/scripts/pack.py --skill-root <path> --dry-run
打包完成后检查：
SKILL.md以下路径/模式始终排除：
| 类别 | 排除项 |
|---|---|
| 版本控制 | .git/、.gitignore |
| IDE/编辑器 | .idea/、.vscode/、.qoder/ |
| 构建缓存 | __pycache__/、*.pyc、*.pyo |
| OS 元数据 | .DS_Store、Thumbs.db |
| 打包产物 | *.zip、*.tar.gz |
| 开发者治理 | governance/（例外放行 governance/contracts/skill-contract.md 与 governance/migrations/ 当前 upgrade） |
| 测试 | tests/（如存在） |
| 架构文档 | SKILL_BLUEPRINT.md（开发者侧架构审查文档） |
| 治理规则 | references/16-skill-governance-rules.md（Skill 自身变更治理规则，开发者侧） |
| 模块图 | SKILL_MODULE_MAP.md（给人看的链路图，不进发行包） |
| 伴生包 | ChronoPM-Portfolio/（仓库根打 Project 包时排除；伴生包自动单独打第二个 zip，v3.0.0 G-3） |
缺
tests/、SKILL_BLUEPRINT.md、references/16-skill-governance-rules.md、SKILL_MODULE_MAP.md不是 bug——这是产品化裁剪。打包脚本会打印「有意排除」表。source-split-skill/必须进包（能力目录，不是第二个 Skill）。包内除根SKILL.md外禁止再有SKILL.md。不要把该目录列入excludeDirs。governance/默认整目录排除，但governance/contracts/skill-contract.md（核心契约）例外放行——因为references/中 7 个运行时规则文件引用了它第 5 条。SKILL_BLUEPRINT.md和references/16-skill-governance-rules.md是开发者侧架构/治理文档，PM 使用者运行时不需要。tests/是"如存在则排除"，不是所有 Skill 都有。 如果某个 Skill 项目有自定义的开发者目录需要排除，用户可在打包前告知 AI，AI 通过脚本-Exclude参数传入。
| 参数 | 说明 |
|---|---|
-SkillRoot <path> | Skill 项目根目录（必填） |
-OutputDir <path> | 输出目录（默认同 SkillRoot） |
-DryRun | 仅预览不打包 |
-Exclude <string[]> | 额外排除的目录名（如 "docs","examples"） |
{BrandName}-Skill-v{version}.zip（BrandName 取自 skill.json displayName 品牌前缀，无 displayName 时脚本拒绝打包）本 skill 应安装到个人 skill 目录 ~/.qoder/skills/pack-skill/。
安装命令（PowerShell）：
Copy-Item -Recurse -Force "<本项目路径>/tools/pack-skill" "$env:USERPROFILE/.qoder/skills/pack-skill"