MikumikuDAIFans/PrivateAgentSkills

私有 Agent 技能

本目录是私有维护、与 harness 无关的 agent 技能的权威工作区。这些技能遵循标准的 SKILL.md 格式，可与任何兼容的 harness 配合使用，包括 Codex、Claude Code 和 DeepSeek Harness（DSH）。

结构

- project-lifecycle-workflow/：在整个生命周期中为软件工作选择路由，并选择正确的分支工作流。
- integrated-development-workflow/：通过生命周期路由、方法选择、比例化门禁、证据、发布和交接来编排完整的项目工作流。
- construction-plan-system/：为大型多阶段软件工作构建带门禁的构建规划系统。
- long-task-planner/：为长时间运行的工作创建或规范化持久任务书。
- execution-launch/：将最终确定的计划转换为全新会话的完整执行启动简报。
- session-handoff/：将当前进度压缩为可重启的交接包。
- company-lab-2-server/：通过 company-lab 跳板主机连接到内部 DGX Spark 服务器。
- scripts/sync_skills.ps1：将选定的技能复制到目标技能根目录（默认为 $HOME\.codex\skills，可通过 -DestinationRoot 或 SKILLS_ROOT 环境变量覆盖）。
- scripts/validate_skills.ps1：对选定的技能运行仓库自带的 quick_validate.py。无需安装 agent。

当前工作流

1. 使用 $integrated-development-workflow 对传入的项目工作进行路由和执行。
2. 对于生命周期分支语义，保留并调用 $project-lifecycle-workflow 作为专业源工作流。
3. 对于方法特定的实践，当集成工作流选择 $agentic-project-development 时调用它。
4. 对于大型多阶段工作，使用 $construction-plan-system 构建或刷新带门禁的规划系统。
5. 使用 $long-task-planner 创建或规范化权威任务书。
6. 一旦计划完全获批，使用 $execution-launch 生成执行优先的启动简报。
7. 执行工作，并在权威进度文件中保持进度台账为最新状态。
8. 在上下文压力或会话切换之前，对于进行中的工作，先更新权威进度文件。
9. 使用 $session-handoff 生成可重启的连续性包。

有关串联全部三个技能的复制粘贴式中文工作流脚本，请参见 workflow-playbook-zh.md。

当前技能

integrated-development-workflow

- 用途：提供默认的端到端项目开发入口点，结合生命周期路由、开发方法选择、比例化规划、实施控制、基于证据的验证、评审、发布、维护和可恢复交接。
- 设计：一个编排器，保留 project-lifecycle-workflow 和 agentic-project-development 的能力，并根据需要升级到 construction-plan-system、long-task-planner、execution-launch 或 session-handoff。
- 主要参考：
- references/stages/
- references/governance/
- assets/templates/

project-lifecycle-workflow

- 用途：在生命周期各阶段之间路由项目工作，并分支到正确的执行工作流。
- 最适用于：项目受理、任务分类、生命周期治理、分支选择，以及决定何时升级到更深入的规划。
- 主要参考：
- governance/
- templates/

construction-plan-system

- 用途：在实施开始之前，为大型软件工作构建一套完整的带门禁的构建规划系统。
- 最适用于：多阶段交付计划、预检审查、长周期执行治理、证据管理，以及就绪门禁。
- 主要参考：
- governance/
- templates/

long-task-planner

- 用途：为长时间运行的执行维护一本稳定的任务簿。
- 最适用于：初始规划、规范化现有治理文档、进度更新、重新规划。
- 主要参考：
- references/task-book-template-zh.md
- references/usage-playbook-zh.md

execution-launch

- 用途：将最终确定的计划转化为面向全新会话的一次性执行简报。
- 最适用于：已批准的设计、执行启动、减少任务中途的检查、以 Agent Team 为先的实施提示。
- 主要参考：
- references/launch-template-zh.md
- references/usage-playbook-zh.md

session-handoff

- 用途：为下一个会话生成一份紧凑、聚焦连续性的交接文档。
- 最适用于：上下文压力检查点、进行中的会话切换、为已有真实执行状态的未完成工作生成重启提示。
- 主要参考：
- references/handoff-template-zh.md
- references/usage-playbook-zh.md

company-lab-2-server

- 用途：通过 company-lab 连接到内部 DGX Spark 服务器，以执行受控的检查与开发命令。
- 最适用于：环境检查、GPU/CPU/内存检查、Docker/软件包发现、模型训练就绪检查，以及 /home/user02 下限定于特定任务的命令。
- 安全说明：可发布的仓库副本不存储服务器密码；请通过经批准的仅本地机制提供密码，例如 DGX_SERVER_PASSWORD 或交互式提示。

维护

- 先在此处编辑技能内容。
- 更改后运行 scripts/validate_skills.ps1。
- 运行 scripts/sync_skills.ps1 以刷新已安装的副本（默认目标为 $HOME\.codex\skills，或传入 -DestinationRoot  / 设置 SKILLS_ROOT 以用于其他 harness）。
- 保持技能文件夹自包含，避免在每个技能目录内添加非必要文件。
- 将 markdown 参考保存为 UTF-8，以避免中文工作流中的模板或提示损坏。

Harness 兼容性

该技能包使用标准的 SKILL.md 布局，并且与 harness 无关：

- Codex：安装到 $CODEX_HOME\skills（默认）——agents/openai.yaml 提供调用元数据。
- Claude Code：将技能目录复制到 ~/.claude/skills（或某个项目的 .claude/skills）。
- DeepSeek Harness (DSH)：此仓库本身就是一个 DSH bundle 插件——package.json 声明了 dsh.bundle.patch（→ cordis.patch.yml），并且 index.js 在 ctx.skills 上注册了七技能套件。一旦 private-agent-skills 包发布到 npm，即可从 DSH 插件市场（或 1024 Store）安装；在此之前，请将七个技能目录复制到 ~/.dsh/skills 或 ~/.agents/skills（或某个项目的 .dsh/skills）。

注意：index.js 通过白名单精确注册七套件技能。此仓库中个人/环境特定的技能（例如 company-lab-2-server）有意不包含在已发布的 bundle 中。

agents/openai.yaml 文件是可选的 Codex 元数据；没有该约定的 harness 会忽略它们，bundle 仍能通过验证。

安装集成工作流 bundle

集成工作流依赖六个配套技能。请安装受支持的 bundle，而不是仅复制 integrated-development-workflow。

git clone https://github.com/MikumikuDAIFans/PrivateAgentSkills.git
Set-Location PrivateAgentSkills
Optional: target a specific harness skills root (default: $CODEX_HOME\skills or $HOME\.codex\skills)
powershell -ExecutionPolicy Bypass -File .\scripts\install_integrated_workflow.ps1 -DestinationRoot "$HOME\.claude\skills"

如果已安装旧版本，请添加 -Force。安装程序会将恰好七个必需的技能目录复制到目标根目录（解析顺序：-DestinationRoot、SKILLS_ROOT 环境变量、$CODEX_HOME\skills、$HOME\.codex\skills）。随后它会验证技能名称、依赖项以及具有代表性的路由用例。安装后请重启 agent harness（或启动新会话）。