diff options
Diffstat (limited to 'doc/Specifications.md')
| -rw-r--r-- | doc/Specifications.md | 15 |
1 files changed, 11 insertions, 4 deletions
diff --git a/doc/Specifications.md b/doc/Specifications.md index 5d21037..007ce51 100644 --- a/doc/Specifications.md +++ b/doc/Specifications.md @@ -310,10 +310,16 @@ Context要約を開始する利用率閾値は設定可能でなければなら ### 10.2 Skill -- SkillはMarkdown instructionである。 -- Skillロードは権限付与を意味しない。 -- 必要なSkillだけを選択する。 -- Skill選択はLLMにより行うが、選択可能集合は設定されたSkill directoryに限定する。 +- Agent Skills open standard (agentskills.io) に準拠する。 +- Skill directory構造は `<skill-name>/SKILL.md` のみを扱う。legacy単一Markdown形式は廃止する。 +- `SKILL.md` はYAML frontmatter + Markdown bodyで構成し、`name` (1-64文字、lowercase英数字+hyphen、親directory名と一致) と `description` (1-1024文字) を必須とする。 +- frontmatterなしのSkillは推測せずrejectする。malformed YAML、duplicate skill nameは起動/check時fatalとする。 +- Progressive Disclosure: Stage 1 Discovery (name + descriptionのみ) → Stage 2 Selection (LLM) → Stage 3 Instructions Load (選択SKILL.md本文) → Stage 4 Resources (scripts/references/assets)。 +- Skill選択はLLMにより行う。選択可能集合は設定されたSkill directoryに限定する。Runtimeは選択結果を検証し、unknown Skill名を読み込まない。 +- Skillロードは権限付与を意味しない。`allowed-tools` metadataはSandbox permissionとして解釈しない。 +- Skillに `scripts/` が含まれていても自動実行許可しない。実行には通常どおりFilesystem execute capability、Process Approval、path + SHA-256、Sandbox Brokerを必須とする。 +- Skill directory内resourceについてcanonicalization、reparse point検査、Skill root外へのescape禁止を行う。 +- Skill選択・本文ロードはInternal Toolとして公開せず、Agent Runtime / Prompt Context Managementの責務として実装する。Internal Toolは既存5群+dir=6群に固定する。 --- @@ -344,6 +350,7 @@ Context要約を開始する利用率閾値は設定可能でなければなら | FS-04 | write権限だけではdeleteできない。 | | FS-05 | ACLとAppContainerの両方で強制可能な形にする。 | | FS-06 | ディレクトリ作成 (mkdir) はwrite権限で許可する。ディレクトリ削除 (rmdir) はdelete権限で許可するが、空ディレクトリのみとする。ディレクトリ列挙 (list) はread権限で許可する。 | +| FS-07 | renameはsource/destination双方にwrite権限を要求する。destination既存時は拒否する。cross-volume renameは不支持とする。 | ### 11.3 Process Policy |