Files
qzl d060962a5f feat(agent): redesign project_cli with module/method/input protocol
- Replace command/subcommand/args with module/method/input envelope
- Calendar handler uses discriminated union (mode) for read operations
- Strict Pydantic models with extra='forbid' for all calendar methods
- Worker max_iters=7, router prompt simplified (removed project_cli_defaults)
- Skill index cards + per-action files for progressive disclosure
- Frontend/AG-UI aligned to module/method dispatch
- Protocol docs updated to module/method/input contract

WIP: action cards need envelope fix, 2 tests need update, memory
handler needs Pydantic models.
2026-04-24 13:24:13 +08:00

86 lines
4.2 KiB
JSON

{
"id": "redesign-single-cli-skill-disclosure",
"name": "redesign-single-cli-skill-disclosure",
"title": "Redesign single CLI + progressive skill disclosure protocol",
"description": "Redesign the current single CLI tool into a business-action protocol driven by progressive skill disclosure. Preserve one AgentScope tool, replace legacy command/subcommand/args guessing with strict module/method/input dispatch, align router-worker contracts with actual runtime behavior, and reduce token waste without reintroducing multi-tool schema bloat.",
"status": "in_progress",
"dev_type": "fullstack",
"scope": "cross-domain",
"priority": "P1",
"creator": "qzl",
"assignee": "qzl",
"createdAt": "2026-04-23",
"completedAt": null,
"branch": null,
"base_branch": "dev",
"worktree_path": null,
"current_phase": 6,
"next_action": [
{
"phase": 1,
"action": "implement"
},
{
"phase": 2,
"action": "check"
},
{
"phase": 6,
"action": "finish"
},
{
"phase": 4,
"action": "create-pr"
}
],
"commit": null,
"pr_url": null,
"subtasks": [
{
"name": "Write PRD for single CLI + progressive skill disclosure redesign",
"status": "completed"
},
{
"name": "Define calendar business action protocol from schedule_items and schedule_subscriptions",
"status": "completed"
},
{
"name": "Define router and worker contract changes for lower-token execution",
"status": "completed"
},
{
"name": "Define skill packaging for index-first progressive disclosure",
"status": "completed"
},
{
"name": "Define backend dispatch and validation migration plan",
"status": "completed"
},
{
"name": "Define protocol/frontend alignment and verification plan",
"status": "completed"
}
],
"children": [],
"parent": null,
"relatedFiles": [
"backend/src/core/agentscope/runtime/runner.py",
"backend/src/core/agentscope/runtime/json_react_agent.py",
"backend/src/core/agentscope/tools/internal/project_cli.py",
"backend/src/core/agentscope/tools/internal/view_skill_file.py",
"backend/src/core/agentscope/tools/cli/adapter.py",
"backend/src/core/agentscope/tools/skills/calendar/SKILL.md",
"backend/src/v1/schedule_items/router.py",
"backend/src/v1/schedule_items/service.py",
"backend/src/v1/schedule_items/schemas.py",
"apps/lib/features/calendar/data/apis/calendar_api.dart",
"apps/lib/features/calendar/data/repositories/calendar_repository.dart",
"docs/protocols/agent/sse-events.md",
"docs/protocols/agent/tool-protocol.md"
],
"notes": "This task now supersedes both the older command/subcommand/args direction and the intermediate skill/action/input direction for the CLI input protocol while keeping the validated parts of the prior refactor: one tool entry, AgentScope skills, structured tool outputs, and backend-owned AG-UI compilation. Phase 1 protocol docs are updated to module/method/input. Phase 2 runtime contract is updated with worker max_iters=7 and a lighter router contract that now requires time values in context_summary to be standardized to downstream project_cli input formats, including project_cli_defaults when deterministically known. Phase 3 and the calendar-focused business-method redesign are now in place: project_cli uses module/method/input, runtime-side skill gating was removed from project_cli, the CLI router dispatches by module+method, calendar reads were collapsed into calendar.read with strong typed `date`/timezone-aware `datetime`/`UUID` input variants, calendar mutations use module-scoped methods, contacts/memory align to the same envelope, tool postprocessing resolves ui_hints from module/method, and skill docs now teach module/method usage instead of leaking transport concerns into the tool contract. Backend unit/regression coverage is green for the updated AgentScope/tool stack. Integration/live tests have not yet been rerun after the module/method and strong-typing redesign, so end-to-end verification remains incomplete.",
"meta": {
"feature_summary": "single project_cli redesign + progressive skill disclosure + business action protocol + lower token/runtime ambiguity"
}
}